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 會停用廣告。相同的狀態也會套用到該廣告所屬的廣告集與活動,因此該廣告集或活動中的其他廣告也會隨之變更。
各平台專屬的操作(例如
facebookAdAccounts 與 instagramAds)仍可正常使用,且維持不變。