Skip to main content
广告操作将广告平台作为参数，因此同一个操作适用于 Ayrshare 支持的所有广告平台。目前支持 FACEBOOK 和 INSTAGRAM。 每个操作都会调用对应的 REST 广告端点，并原样返回其响应。身份验证和限制与 REST 相同。调用失败时会返回 GraphQL 错误：extensions.status 携带 REST 状态码；当 REST 错误带有 Ayrshare 错误码时，extensions.code 携带该错误码。请参见错误。广告操作需要 Ads 附加组件。如未开通，每次调用都会返回 extensions.status 为 403、extensions.code 为 399 的错误。

​
操作

每个操作还接受可选的 profileKey，用于对某个 User Profile（用户配置文件）执行操作。所有操作都以 JSON 形式返回 REST 响应，因此不接受字段选择。

​
列出广告账户

从这里开始。凡是操作需要 accountId 的地方，都使用响应中的 accountId 值。

​
搜索定向选项

kind 决定搜索类型：INTERESTS 用于受众定向，REGIONS 或 CITIES 用于地理位置。每种类型只接受其自身的参数。例如，countryCode 和 regionId 仅适用于 CITIES，而 INTERESTS 需要 search。

​
列出广告

至少传入 campaignId、accountId、adId、postId 或 socialPostId 中的一个。socialPostId 是社交网络自身的帖子 ID，用于并非通过 Ayrshare 发布的帖子。

​
查看广告花费

​
暂停或恢复广告

updateAd 会改变实际的广告支出。PAUSED 停止支出，ACTIVE 恢复支出，DELETED 或 ARCHIVED 则停用该广告。相同的状态也会设置到该广告所属的广告集和广告活动上，因此该广告集或广告活动中的其他广告也会随之改变。
通过这些操作推广帖子的功能即将推出。在此之前，请使用 boostFacebookPost 或 instagramBoostPost，或者 Facebook 或 Instagram 的 REST 推广端点。
各平台专用的操作（例如 facebookAdAccounts 和 instagramAds）仍然可用，且保持不变。