錯誤代碼

以下是 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`：點擊`企業管理平台設定` 點擊廣告帳戶選擇`新增用戶` 搜尋系統用戶並將有關用戶新增為管理員再次嘗試執行 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
`1349118`	串流影片帖子網址帳戶安全應用程式設定不允許使用一個或多個指定網址。它必須符合網站網址或全螢幕展示廣告網址，或者網域必須為應用程式其中一個網域的子域。詳閱登入安全以進一步了解與安全有關的應用程式設定。
`1359036`	Ad Create Failed - Too Many Ads: The account {account_id} has reached the maximum number of ads {max}
`1359102`	Invalid Parameter In Spec: Parameter has invalid value or missing required parameter: {param-value}
`1487006`	Invalid Campaign ID: You must specify a campaign, and the campaign specified must belong to the account specified and must not be deleted.
`1487007`	Campaign Ended: You can't edit ads in a campaign that has ended. Please create a new ad within this campaign, update the campaign end time, pick another campaign, or create a new campaign.
`1487010`	Ad Bid Too High: Your bid is above the maximum for its type and placement. Please try again with a value below the maximum if you would like to raise your bid.
`1487013`	Bid Too Low: Your bid is below the minimum for its placement and type. If you don't want your ad to run at the minimum bid rate, please pause it. Otherwise, please increase the bid to be within the suggested range.
`1487014`	Campaign budget was too low. Please increase the daily budget to at least 2 times the amount of the highest CPC ad bid, which is at least {minimum_budget}. You bid {bid}.
`1487015`	The ad creative is invalid
`1487065`	Ad Missing Targeting Spec: Ad spec needs a targeting spec. Please use targeting field to specify what audience the ad should be shown to. Field 'countries' is required; all others are optional.
`1487087`	Ad Create Failed: The Ad Create Failed for the following reason: {reason}
`1487089`	Target Spec Invalid: The target spec is invalid: {reason}
`1487090`	Ad Edit Failed - Spec Errors: {error}
`1487108`	Invalid Cities: Please check that the format in which you are specify the cities is correct, and if you specify IDs, that they are of the correct type. This can not be the the ID of the page for the city; city ids are returned by, `/search?type=adcity`.
`1487124`	Invalid Connection: You can only specify connections to objects you are an administrator or developer of.
`1487133`	Invalid Negative Connections: If you specify negative targeting, you must be the administrator or developer of the objects whose fans you want to specify to exclude. You are not an admin of the following specified connections: {connections}
`1487172`	Could not save creative
`1487174`	Invalid Image Hash: Invalid Image Hash - {hash}
`1487194`	Permission Error: Either the object you are trying to access is not visible to you or the action you are trying to take is restricted to certain account types.
`1487199`	Ad targeting does not match targeting of the story: The targeting specified for this ad is not compatible with the story being boosted. Check the privacy and language/country targeting of the story you are trying to sponsor.
`1487202`	Invalid object - not admin or object not public: The user is not an admin of the object or the object is not publicly accessible.
`1487211`	Invalid URL For Creative Destination: Creative must have a valid destination URL, and if attached object is page, destination must match page.
`1487225`	Ad Creation Limited By Daily Spend: The number of ads you can create in a given period of time has a limit determined by your daily spend level. Higher spend levels allow creation of more ads. Increase your daily spend limit or create fewer ads per time period.
`1487244`	Campaign Update Failed: Campaign {campaign_id}: {reason}
`1487246`	Campaign Creation Failed: {reason}
`1487256`	Targeting declined due to policy: Invalid ads targeting. The targeting spec was declined due to policy restrictions.
`1487283`	Not Allowed To Use View Tags: Only some partners are allowed to use view tags. Please verify that you are using an approved account.
`1487301`	Custom Audience Unavailable: The custom audience you're trying to use hasn't been shared with your ad account. Please create or choose a different custom audience, or ask the owner of the custom audience to let you use it.
`1487346`	The post does not belong to the specified Page: Post to be promoted does not belong to the Page specified. The post belongs to {otherDestination}; try using this as the destination or using a post that belongs to the specified Page. Specified Page: {destination}.
`1487366`	Custom Audience Has Been Deleted: Cannot use deleted custom audience. Please choose another audience.
`1487376`	Conversion Spec Needed: For ads pointing to an offsite location with a non-zero bid on actions, you must specify the conversion spec.
`1487380`	Invalid aggregation day for conversion data. The aggregation day must be larger than or equal to 1.
`1487390`	Adcreative Create Failed: The Adcreative Create Failed for the following reason: {reason}
`1487391`	Cannot Use Syndicated Audiences From Multiple Partners: When specifying partner-created custom audiences for an ad, all audiences must be from the same provider.
`1487396`	Failed to update the creative: Failed to update creative {id}. Failed for the following reason: {reason}
`1487424`	Ad Needs Exclusion Targeting: This ad cannot be created with the targeting spec you selected. Your ad has a conversion objective that users can only do once, so you must target the ad at those users who have not already converted. If you are using the Facebook API, consider including the following string in your targeting spec: {exclusion-targeting-spec}.
`1487465`	Invalid CPA Bid: The action type you selected is not allowed for Cost-Per-Action (CPA) bidding: '{action_type}'. Please change your optimization goal or switch your bid type to regular Optimized CPM.
`1487472`	This type of page post is not eligible to be promoted. {debug_info}
`1487477`	Conversion Tracking Pixel Permission Error: The conversion tracking pixel you're trying to use is owned by another user and hasn't been shared with you. Please use a tracking pixel that's been shared with you or create a new one.
`1487485`	Too many async requests
`1487506`	The new budget value is too low: The new budget value of {new_budget} is too low. The minimum acceptable is {minimum_budget}.
`1487557`	No supported fields were provided for updating the campaign
`1487558`	No supported fields were provided for updating the ad
`1487559`	Ad Update Failed {reason}
`1487573`	You must specify an object_id for this adcreative type (creative type 27)
`1487742`	There have been too many calls from this ad-account. Wait a bit and try again.
`1487756`	You have overlapping locations specified in the geo_locations field. Your broader option will override the narrower option, please remove one to proceed.
`1487790`	The promoted object is invalid: it could have been deleted or never existed.
`1487881`	The given prediction id in a reach and frequency campaign is not reserved.
`1487882`	The given reservation in a reach and frequency campaign is not finalized yet.
`1487884`	The given reservation in a reach and frequency campaign is already finalized
`1487885`	The prediction in a reach and frequency campaign is already reserved.
`1487886`	This indicates the operation fails for an unknown reason.
`1487887`	The given page types are not supported by the inventory manager.
`1487915`	A finalized prediction order can not be cancelled. You can create a new prediction or delete the campaign.
`1634013`	Conversion Spec Targets Invalid ID: You are targeting an ID in your conversion spec without admin permissions on that object. {debug_info}
`1667002`	This Promotion Can't Be Edited: This can't be edited because you promoted it from your Page. Find the post on your Page to pause, delete, or update budget for this promotion.
`1667002`	This Promotion Can't Be Edited: This can't be edited because you promoted it from your Page. Find the post on your Page to pause, delete, or update budget for this promotion.
`1815826`	您的出價策略無效。目前可用的出價策略為 `LOWEST_COST_WITHOUT_CAP`、`LOWEST_COST_WITH_BID_CAP` 和 `TARGET_COST`。請按照您的業務目標，選擇有效的出價策略。從 3.0 開始生效。
`1815829`	您在某個廣告宣傳活動已啟用宣傳活動預算優化的情況下，嘗試為此廣告組合設定出價策略。系統不允許您為此類廣告組合設定出價策略。請移除廣告組合的出價策略，或停用您宣傳活動的宣傳活動預算優化。從 3.0 開始生效。
`1815830`	您在某個廣告宣傳活動沒有使用競投購買類型的情況下，嘗試為此廣告組合設定出價策略。系統不允許您為此類廣告組合設定出價策略。從 3.0 開始生效。
`1815857`	需要提供出價金額：您必須在 bid_amount 欄位中提供出價上限或目標成本。若是 `LOWEST_COST_WITH_BID_CAP`，您必須提供 bid_amount 欄位以設定出價上限。若是 `TARGET_COST`，您必須提供 bid_amount 欄位以設定平均目標成本目標。從 3.0 開始生效。
`1815858`	您無法使用 `LOWEST_COST_WITHOUT_CAP` 出價策略為廣告組合設定出價上限。請移除 bid_amount，或改為同時使用 `LOWEST_COST_WITH_BID_CAP` 與 bid_amount。從 3.0 開始生效。
`1815067`	無法使用優化目標：您無法將所選優化目標用作您的宣傳活動目標。請選擇其他目標，並編輯宣傳活動。
`1798130`	我們不允許為進階高效速成目錄廣告建立空白的商品組合。請將商品新增至目錄，並建立最少包含一件商品的商品組合。
`2310025`	無法使用此廣告帳戶建立宣傳活動。如要建立協作廣告宣傳活動，則品牌廣告客戶必須為每位合作賣家使用獨立的廣告帳戶。請確保您使用獨立的廣告帳戶，此廣告帳戶應與擁有此目錄子集的賣家關聯。僅供部分用戶使用。
`2310039`	無法使用此目錄子集建立宣傳活動。您無法使用此廣告帳戶為此目錄子集刊登廣告。企業建立此目錄子集以供品牌廣告客戶在協作廣告中使用。請選擇不同的廣告帳戶，或使用此廣告帳戶推行使用商品目錄的宣傳活動。僅供部分用戶使用。
`3260011`	廣告組合發佈後，您將無法編輯像素、轉換事件、自訂轉換或廣告組合優化。如要按所需變更來刊登廣告組合，請建立新的廣告組合。
`3858064`	本宣傳活動包含的某些選項，將無法再用於鎖定全球 18 歲以下、泰國 20 歲以下或印尼 21 歲以下廣告受眾的宣傳活動。提高廣告受眾的年齡下限，或移除年齡和城市級別或以上地點（不包括郵遞區號和 Designated Marketing Area）以外的所有目標設定選項。
`3858065`	本宣傳活動包含的某些選項，將無法再用於鎖定全球 18 歲以下、泰國 20 歲以下或印尼 21 歲以下廣告受眾的宣傳活動。提高廣告受眾的年齡下限，或移除以下項目：不可用的版位。

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

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 欄位出現錯誤。