更新广告系列

本页面提供了为您在有专人服务的合作伙伴广告中添加的有专人服务的合作伙伴（卖家）更新广告系列的步骤。

前期准备

请确保您已完成以下步骤，然后再为您的合作伙伴更新广告系列：

需要的权限

如要调用卖家广告更新 API，用户将需要以下权限：

卖家业务管理员

定位《数字服务法》监管的地区（欧盟）

如果广告系列定位欧盟和/或相关地区，dsa_payor 和 dsa_beneficiary 为必要字段。这 2 个字段中提供的信息将向最终用户显示，以表明广告付费方以及广告受益方。如果不提供这 2 个字段，广告主将无法编辑 MPA 广告系列，且 API 将返回失败的响应，其中包含错误代码（见下方列表）。

调用卖家广告更新 API

请求

curl \
  -F 'access_token=<ACCESS_TOKEN>' \
  -F 'asyncbatch=[ 
       { 
         "method": "POST", 
         "relative_url": "act_<ACCOUNT_ID>/managed_partner_ads", 
         "name": "create1", 
         "body": "campaign_group_id=123456789&lifetime_budget=100000" 
       }, 
     ]' \
  "https://graph.facebook.com/v20.0"

系统将立即返回对此 API 调用的响应，响应中包含 ASYNC_SESSION_ID。在继续处理请求的同时，系统应该会持续轮询 ASYNC_SESSION_ID，直到达到终端状态 [COMPLETED|FAILED]。

参数

名称	描述
`campaign_group_id` 字符串	必要。需要更新的广告系列的编号。
`campaign_group_status` 字符串	非必要。 `ACTIVE` 或 `PAUSED`
`dsa_payor` 字符串（不得超过 512 个字符）	非必要。广告系列的付费方。注意：如果广告系列定位欧盟和/或相关地区，此字段为必要项。
`dsa_beneficiary` 字符串（不得超过 512 个字符）	非必要。广告系列的受益方。注意：如果广告系列定位欧盟和/或相关地区，此字段为必要项。
`end_time` datetime	非必要。广告系列的结束时间，采用 UTC UNIX 时间戳。结束时间不能更新为上一个结束时间之前，必须为该时间之后。
`lifetime_budget` 数字字符串	非必要。广告系列的新预算（使用广告账户的货币）。此预算不能更新为小于之前预算的值，必须大于之前的预算。

响应

{
  "async_sessions": [
    {
      "id": "<ASYNC_SESSION_ID>",
      "name": "<ASYNC_SESSION_NAME>"
    }
  ]
}

使用 ASYNC_SESSION_ID 可获取添加到有专人服务的合作伙伴广告的某个卖家的相应编号。

详情请参阅如何轮询异步会话以获取响应。

成功响应

如果状态是 COMPLETED，轮询异步会话得到的数据将如下所示：

{
  "result": "{\"id\":\"<NEWLY_UPDATED_CAMPAIGN_ID>\",\"success\":true}",
  "id": "<ASYNC_SESSION_ID>"
}

失败响应

如果状态是 FAILED，轮询异步会话得到的数据将如下所示：

错误代码

错误代码	错误子代码	描述
1800700	2310172	输入为该广告组付费的用户或组织。
1800701	2310171	输入该广告组的受益用户或组织。

查看更多

如何轮询异步会话以获取响应