广告账户

作为企业管理员，您可以认领属于企业的广告账户。这样您便可以轻松向广告账户分配应该有权访问这些账户的用户。您还可以向您的广告账户分配已分享的资金来源。

认领账户

如果您在商务管理平台外以管理员身份管理广告账户，您可以为企业认领这些广告账户。这是一次性流程。认领广告账户后，您就只能在该商务管理平台中管理这些广告账户。

创意账户不可认领。

如要为您的企业认领广告账户，请以 act_### 的格式提供广告账户编号。发送 POST 请求：发送请求的用户必须是认领该广告账户的企业的管理员。

curl \
  -F "adaccount_id=act_<AD_ACCOUNT_ID>" \
  -F "access_token=<ACCESS_TOKEN>" \
 "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/owned_ad_accounts"

如果您是该广告账户的管理员，我们会立即批准此认领请求。Facebook 会返回 access_status，该参数将设为 CONFIRMED。

如果您是对该广告账户没有适当权限的用户，我们会向该广告账户的管理员发送所有权请求。在我们发送请求后，回应会包含 access_status，该参数将设为 PENDING。

如要接受所有权请求，您必须是广告账户的管理员，并且您应该登录广告管理工具，然后在该工具中接受所有权请求。

请求账户访问权限

大多数营销公司无需认领其客户的广告账户。如要请求其他商务管理平台拥有的资产的访问权限，请参阅企业对企业的功能。

创建广告账户

如要使用此 API，您必须拥有一个有效的企业和公共主页设置。如果您有任何不完整的广告账户或公共主页被 Facebook 取消发布，您将无法新建广告账户。

使用 API 最多只能创建 5 个广告账户。如要创建 5 个以上广告账户，您必须手动操作。

可用字段如下所示：

如要为企业新建广告账户，请指定 name、currency、timezone_id、end_advertiser、media_agency 以及 partner。请查看以下条件：

• media_agency 和 partner 必须是 Facebook 公共主页别名、Facebook 公共主页编号或 Facebook 应用编号。
• end_advertiser 必须是企业编号。

如果您的广告账户没有广告主、媒体代理商或合作伙伴，请指定 NONE。如果您的广告账户存在广告主、媒体代理商或媒体合作伙伴但他们在 Facebook 上并没有公共主页或应用，请指定 UNFOUND。

如要创建广告账户，请执行以下操作：

curl \
  -F "name=MyAdAccount" \
  -F "currency=USD" \
  -F "timezone_id=1" \
  -F "end_advertiser=<END_ADVERTISER_ID>" \
  -F "media_agency=<MEDIA_AGENCY_ID>" \
  -F "partner=NONE" \
  -F "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/adaccount"

如果您已拥有 Facebook 委托额度，您可以将 invoice 设为 true。然后，我们会将您的新广告账户与委托额度关联。

响应如下所示：

{
  "id": "act_<ADACCOUNT_ID>",
  "account_id": "<ADACCOUNT_ID>",
  "business_id": "<BUSINESS_ID>",
  "end_advertiser_id": "<END_ADVERTISER_ID>",
  "media_agency_id": "<MEDIA_AGENCY_ID>",
  "partner_id": "NONE"
}

查看拥有的账户

查看您的商家可以使用 GET 调用访问的所有广告账户：

curl -G \
-d "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/owned_ad_accounts"

该调用将返回企业拥有的所有广告账户。部分字段专门用于表明企业和广告账户之间的关系。

• permitted_tasks 是一个数组，包含您可以为特定广告账户分配的任务。
• access_type 定义您的企业对于广告账户的身份是 OWNER 还是 AGENCY。

如要查看访问权限仍处于待处理状态的广告账户，请执行以下 GET 调用：

curl -G \
  -d "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/pending_owned_ad_accounts"

移除账户

如果您是 OWNER 或广告账户的状态为 CONFIRMED，则您无法移除您商家的广告账户。如果您拥有处于 PENDING 状态的访问权限请求，或拥有对广告账户的 AGENCY 访问权限，则可以使用以下 DELETE 调用：

curl \
  -X DELETE \
  -F "adaccount_id=act_<AD_ACCOUNT_ID>" \
  -F "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/ad_accounts"

查看账户访问权限

如要查看特定用户在哪些广告账户中拥有权限，可以使用以下 GET 调用：

curl -G \
  -d "access_token=ACCESS_TOKEN" \
"https://graph.facebook.com/<API_VERSION>/<BUSINESS_SCOPED_USER_ID>/assigned_ad_accounts"

如要查看特定用户在广告账户中拥有的权限，可以使用以下 GET 调用：

curl -G \
  -d "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/assigned_users"

将用户添加到账户

在将您的商务管理平台与广告账户关联后，您可以将任务分配给其他企业用户。相关任务包括：

您需要：

• adaccount_id — 广告账户编号，格式为 act_123
• user_id — 要添加的用户编号
• 要分配的任务

如要通过 ['MANAGE', 'ADVERTISE', 'ANALYZE'] 任务新增用户，可以使用以下 POST 调用：

curl \
  -F "user=BUSINESS_SCOPED_USER_ID" \
  -F "tasks=['MANAGE', 'ADVERTISE', 'ANALYZE']" \
  -F "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/assigned_users"

更改账户的权限

如要更改现有用户的任务，可以使用新增用户时所用的 POST 调用：

curl \
  -F "user=BUSINESS_SCOPED_USER_ID" \
  -F "tasks=['ANALYZE']" \
  -F "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/assigned_users"

从广告账户移除用户

如要从广告账户移除用户，您需要采取以下操作：

• adaccount_id — 广告账户编号，格式为 act_123
• user_id — 要移除的用户编号

需要使用以下 DELETE 调用：

curl \
  -X DELETE \
  -F "user=<BUSINESS_SCOPED_USER_ID>" \
  -F "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/assigned_users"