錯誤代碼

以下是 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` 設為 `adset`，但正確的值應為 `campaign` 時，便有可能發生此錯誤。
`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` 點擊廣告帳號選擇 `Add people` 搜尋系統用戶並將其新增為管理員重試 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（「asset_feed_spec:target_rules」中的預設規則）設為 true。這是用在對伺服器提出的 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 欄位有關。