錯誤代碼

以下是 API 傳回的錯誤代碼：

錯誤代碼	說明
`-`	Negative-value error codes are internal Facebook errors. Check `error_subcode` for the actual failure code.
`1`	An unknown error occurred
`1`，子代碼 `99`	發生未知錯誤。若 `level` 的正確值應為 `campaign`，但您卻將其設為 `adset`，便可能發生這項錯誤。
`4`	Application request limit reached
`10`	Application does not have permission for this action
`17`	User request limit reached
`100`	Invalid parameter
`100`，子代碼 `33`	Unsupported post request. 如果您的存取憑證新增至擁有自訂廣告受眾的廣告帳戶時，並非新增為擁有合適權限的系統用戶，則可能會出現此錯誤。請在企業管理平台中驗證廣告帳戶，並確認所有系統用戶在廣告帳戶中均顯示為 `Admin`：點擊 `Business Settings` 點擊廣告帳戶選擇`新增用戶` 搜尋系統用戶並將有關用戶新增為管理員再次嘗試執行 API 呼叫
`100`，子代碼 `1487694`	Invalid parameter. 您選擇的類別不再適用。我們已停用幾個基於行為的受眾目標指定類別。如果您嘗試使用這些類別來建立廣告，您的要求將會失敗，而且系統會傳回此錯誤。請使用目標指定搜尋，以查看可用於受眾目標指定的類別。
`100`，子代碼 `1752129`	Invalid parameter. 不支援此任務組合。如要為此廣告帳戶的有效功能分配用戶，您應該傳遞對應中定義的任務組合。請參閱企業管理平台 API，允許的角色。
`102`	Session key invalid or no longer valid
`104`	Incorrect signature
`190`	Invalid OAuth 2.0 Access Token
`200`	Permission error
`200`，子代碼 `1870034`	未接受自訂廣告受眾條款：您需要先同意自訂廣告受眾條款，才能建立或編輯廣告受眾或廣告組合。請參閱 Facebook 自訂廣告受眾條款。
`200`，子代碼 `1870047`	Audience Size too Low: You cannot remove users from this audience because it will result in a low audience size and may result in under-delivery or non-delivery of your ads.
`294`	Managing advertisements requires the extended permission `ads_management` and an application that is in our allow list to access the Marketing API
`2606`	Unable to display a preview of this ad
`2607`	The given currency is invalid for usage with ads.
`2615`	Invalid call to update this adaccount
`2654`	Failed to create custom audience.
`2654` 子代碼 `1713092`	No write permission for this ad account. Developer making this call must have permissions for the ad account to create an audience for it.
`5000`	Unknown Error Code
`1340029`	目前不允許刪除「活用型廣告創意」廣告。請刪除上一層廣告組合以繼續
`1373054`	沒有可剖析的呼籲字句類型。請參閱呼籲字句 API 文件。
`1404078`	您已暫時被禁止執行此動作。
`1404163`	您不再獲准使用 Facebook 產品刊登廣告。您無法刊登廣告或管理廣告資產，也不得建立新廣告或商業帳戶。了解詳情。
`1487007`	此廣告屬於刊登期限已結束的已排定廣告組合，因此無法編輯。請前往廣告組合的「預算和排定時間」部分，將結束日期改為未來的日期，然後再嘗試編輯。
`1487033`	宣傳活動結束的日期必須在未來。請選擇其他結束日期並再試一次。
`1487056`	此廣告組合已刪除，因此只可編輯名稱。如果您想編輯其他欄位，可以複製此廣告組合，這將建立一個具有相同設定的新廣告組合，然後您便可以編輯這個新廣告組合。
`1487472`	You are using {msg}, which can't be promoted in an ad. Please choose a different Page post to continue.
`1487566`	此宣傳活動已刪除，因此只可編輯名稱。如果您想編輯其他欄位，可以複製此宣傳活動，這將建立一個具有相同設定的新宣傳活動，然後您便可以編輯這個新宣傳活動。
`1487678`	您嘗試為應用程式建立廣告，但應用程式所在的作業系統與此廣告組合的受眾目標設定不同。
`1487831`	無法載入您的商品組合。此商品組合可能不存在，或是因為私隱問題而無法存取。
`1487929`	您嘗試推廣的物件不明確。您只能指定一個推廣的物件。
`1487990`	此廣告帳戶已經有太多封存的廣告群組。您需要刪除其中一些，才能再封存其他廣告群組。
`1815199`	廣告帳戶無法存取此 Instagram 帳戶。請使用獲授權的 Instagram 帳戶，或先將廣告帳戶分配至此 Instagram 帳戶。
`1815629`	所有廣告資產的值皆不得重複。請檢查您的值。
`1815694`	用戶沒有權限執行此操作。
`1870065`	含有至少一個已停用的廣告受眾，因此無法使用。停用的廣告受眾由已停用的帳戶所共用。如要修正這個問題，請移除受影響的廣告受眾。
`1870088`	關係網目標設定已停用。請移除宣傳活動的關係網以發佈宣傳活動。
`1870090`	如要建立或編輯廣告受眾或廣告組合，請同意自訂廣告受眾條款。
`1870092`	如要建立或編輯廣告受眾或廣告組合，請同意 Meta 商業工具使用條款。
`1870165`	您的廣告受眾所包含的受眾目標設定選項無法再用來鎖定向全球未滿 18 歲、泰國未滿 20 歲和印尼未滿 21 歲的用戶刊登廣告。請提高廣告受眾的年齡下限，或移除地點、年齡和性別以外的所有受眾目標設定選項。
`1870199`	所有地點目標設定現在均會用以接觸現時或最近居住在所選地點的用戶。請移除 location_types 欄位中的所有值。
`1885029`	您為廣告所選的專頁與推廣的物件（如專頁帖子或應用程式）所連結的專頁不相符。請確認兩邊的專頁相同。
`1885088`	此廣告已封存，無法編輯。您只能編輯此廣告的名稱。如果您想編輯其他欄位，可以複製此廣告，這將建立一個具有相同設定的新廣告，然後您便可以編輯這個新廣告。
`1885183`	廣告創意帖子是由處於開發模式的應用程式所建立，必須設定為公開才可以建立此廣告，新建立的廣告會沿用相同的設定，您亦可以編輯這些設定。
`1885204`	您需要就所選的優化目標設定自動出價。請移除任何帳單或出價資訊，或更改優化目標。
`1885272`	預算過低。
`1885557`	您的廣告所推廣的帖子不可用。有關帖子可能已被刪除、取消發佈、非廣告所屬的專頁所擁有，或是您沒有權限查看或推廣此帖子。
`1885621`	您只能設定廣告組合預算或宣傳活動預算。
`1885557`	您的廣告所推廣的帖子不可用。有關帖子可能已被刪除、取消發佈、非廣告所屬的專頁所擁有，或是您沒有權限查看或推廣此帖子。
`1885650`	您的預算過低。預算必須達到此金額，才能用以支付您預算更新期間的所有花費，而更新作業最多可能需時 15 分鐘。
`2238055`	您無法在廣告創意規格中同時傳遞 instagram_user_id 和 instagram_actor_id，或 instagram_story_id 和 source_instagram_media_id。
`2446149`	您無法在廣告創意規格中同時傳遞 instagram_user_id 和 instagram_actor_id，或 instagram_story_id 和 source_instagram_media_id。
`2446307`	宣傳活動群組花費上限低於最低金額。
`2238055`	您的宣傳活動預算必須至少為 {minimum_budget}，才足夠這個宣傳活動中的所有廣告組合使用。
`2446173`	名稱為 {label} 的目標規則標籤並未指向任何資產標籤。請移除所有廣告創意以修正問題。
`2446289`	您為廣告選擇的 {post_type} 無法使用。其可能已被刪除，或是您沒有權限查看。請檢查您的廣告創意並再試一次。
`2446347`	現有帖子的廣告應將 use_existing_post 標示設為 true；此標示為「asset_feed_spec:target_rules」中的預設規則。這是向伺服器發出的 POST 要求一部分，無法透過用戶介面完成。
`2446383`	您必須就宣傳活動目標設定外部網站網址。請在廣告創意部分選擇呼籲字句，並輸入網站網址。
`2446394`	此廣告組合所包含的詳細目標設定選項不再適用，或無法同時從廣告受眾排除用戶。您可能需要從詳細目標設定中移除項目，或確認變更以重新啟用。
`2446509`	廣告宣傳活動目的地類型無效。
`2446580`	提供 interactive_components_spec 參數時無法同時指定 components 和 child_attachments 欄位。
`2446712`	使用來店客流量優化目標來建立或刊登廣告組合的功能已停止提供。請改為選擇接觸人數或店內銷量優化目標。
`2446867`	您已達到下列國家／地區 {campaigns_per_country_cap} 個進階高效速成購物宣傳活動的限制：{country_names}。如要為這些國家／地區建立更多宣傳活動，請使用標準轉換宣傳活動。
`2446880`	連結到您 Facebook 專頁或 Instagram 個人檔案的 WhatsApp 電話號碼已取消連結。您可以在重新連結 WhatsApp 帳戶之後，再次刊登這個廣告。
`2490085`	最新版本的廣告 API 不再支援 191x100 裁切格式。建議的裁切格式為 100x100。
`2490155`	與您廣告連結的帖子不可用。有關帖子可能已被移除，或是您沒有權限瀏覽帖子。
`2490372`	您需要選擇商店目的地才能繼續。
`2490427`	您的廣告在最近一次審查時被禁止刊登，目前已停用。若要重新啟用廣告，請更新內容並建立新的廣告。
`2490468`	您的廣告在最近一次審查時被禁止刊登，目前已停用。若要重新啟用廣告，請更新內容並建立新的廣告。
`2708008`	您尚未獲得授權，無法刊登社會議題、選舉或政治相關廣告。請交由獲授權的廣告帳戶用戶刊登這個廣告，或前往 https://www.facebook.com/id，親自完成身分確認程序。
`2859015`	您已暫時被禁止執行此動作。
`3858064`	此宣傳活動包含的選項，無法再用於鎖定全球未滿 18 歲、泰國未滿 20 歲或印尼未滿 21 歲廣告受眾的宣傳活動。請提高廣告受眾的年齡下限，或者除了年齡和城市級別或以上地點（不包括郵遞區號）以外，移除所有其他受眾目標設定選項。
`3858082`	此廣告創意符合資格使用標準強化效果，但未提供 enroll_status。請選擇您是否要啟用標準強化效果。在此了解詳情
`3858152`	此廣告所屬的廣告組合在發佈時必須附上受益人和出資人資料。請前往廣告組合新增或查看這類資訊，然後點擊「發佈」。
`3867105`	合作廣告無法使用此內容。請選擇其他內容。
`3910001`	您的帳戶遇到一些問題，請稍後再試。

請務必只按錯誤代碼來處理錯誤問題。我們可能會隨時修改說明字串，恕不事先告知。

blame_field_specs

在任何導致驗證錯誤的 API 呼叫，其 error_data blob 會包含此屬性，用以指明在驗證錯誤中出錯的欄位。這可以用來實地點出錯誤之處，例如在廣告建立工具 GUI 的出錯欄位旁顯示錯誤。

blame_field_specs 為陣列，此陣列的每一個元素都是一個 blame_field_spec，分別代表 API 規格中出錯的各個單一欄位。

blame_field_spec 本身也是陣列，用以指明出錯欄位的名稱，以及相關欄位在整體 API 規格中的所在位置。

範例：

單一出錯欄位

{  
  "error":{  
    "type":"Exception",
    "message":"The budget for your Ad-Set is too low.  It must be at least $1.00 per day.",
    "code":1487901,
    "is_transient":false,
    "error_data":{  
      "blame_field_specs":[  
        ["daily_budget"]
      ]
    }
  }
}

表示 API 規格的 daily_budget 欄位出錯，在此範例中問題為預算過低。

多個出錯欄位

"blame_field_specs":[  
  ["targeting_spec", "interested_in"], 
  ["bid_info", "impressions"]
]

表示 API 規格 targeting_spec 欄位內的 interested_in 子欄位出現錯誤，而且此錯誤與 API 規格 bid_info 欄位內的 impressions 欄位也有關。