适用于广告账户的 Webhooks

通过适用于广告账户的 Webhooks，您可以收到有关特定广告更改的实时通知。

如要设置适用于广告账户的 Webhooks，需要采取以下步骤：

1. 设置端点并配置 Webhooks。
2. 在广告账户下订阅您的应用。

设置端点和 Webhooks

按照我们的 Webhooks 入门指南创建端点并配置 Webhooks。在配置 Webhooks 时，请务必选择 Ad Account。

现在，您可以收到有关 WITH_ISSUES 和 IN_PROCESS 的广告对象状态更改实时通知了。订阅以下一个或多个字段：

订阅您的应用

您需要订阅您的应用，以接收与您广告账户有关的 Webhooks 通知。您的应用需要具备广告账户的编辑权限，才能完成这个步骤。您的应用还需要具备 ads_management 权限。

如要订阅您的应用，请使用该应用向广告账户发送 POST 请求，创建 subscribed_apps：

curl -i -X POST \
  -d "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<VERSION>/act_<AD_ACCOUNT_ID>/subscribed_apps?app_id=<APP_ID>"

成功后，您会收到如下响应：

{"success": "true"}

如要查看您的广告账户订阅了哪些应用，请发送 GET 请求：

curl -i -X GET \
  -d "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<VERSION>/act_<AD_ACCOUNT_ID>/subscribed_apps"

若请求成功，您会收到如下响应：

{
  "data": [
  { 
    "name": "<APP_NAME>", 
    "id": "<APP_ID>" 
  } ]
}

如要从订阅中移除应用，请发送 DELETE 请求：

成功后，您会收到如下响应：

{"success": "true"}

使用图谱 API 探索工具订阅

您还可以使用图谱 API 探索工具订阅应用。

将 me?fields=id,name 查询替换为 act_AD_ACCOUNT_ID/subscribed_apps。它将订阅您在图谱探索工具中发送 POST 请求所使用的应用。或者，您也可以使用应用编号指定 subscribed_apps（作为输入参数），从而订阅其他应用。

如要订阅应用，应用必须有权编辑广告账户。。

[
  {
    "object": "ad_account",
    "entry": [
      {
        "id": "0",
        "time": 1568132516,
        "changes": [
          {
            "field": "with_issues_ad_objects",
            "value": {
              "id": "111111111111",
              "level": "AD",
              "error_code": "567",
              "error_summary": "error summary",
              "error_message": "error message"
            }
          }
        ]
      }
    ]
  }
]