エラーコード

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
`1349118`	ストリーム投稿URLのセキュリティアプリ設定で許可されていないURLが1つ以上指定されました。URLはウェブサイトURLまたはキャンバスURLと一致するか、ドメインがいずれかのアプリドメインのサブドメインでなければなりません。セキュリティに関連するアプリ設定について詳しくは、「ログインセキュリティ」をご覧ください。
`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を削除するか、bid_amountを残して`LOWEST_COST_WITH_BID_CAP`を使用するように変更してください。3.0以降で有効です。
`1815067`	最適化の目的が使用できません: 選択した最適化の目的は、あなたのキャンペーンの目的に使用できません。別の目的を選択して、キャンペーンを編集してください。
`1798130`	Advantage+ カタログ広告に空の商品セットを作成することはできません。カタログに商品を追加し、最低1つの商品を含むセットを作成してください。
`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仕様の1つのフィールドを示します。

blame_field_spec自体も配列であり、問題のあるフィールドの名前と、指定されたAPI仕様全体におけるこのフィールドの位置を示します。

例:

1つのフィールドにエラーがある

{  
  "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フィールドにも関連しています。