رموز الأخطاء

فيما يلي رموز الأخطاء التي تم إرجاعها بواسطة واجهة 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 الخاص بمنشور البث. يجب أن يتطابق مع عنوان 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، أو التغيير لاستخدام `LOWEST_COST_WITH_BID_CAP` مع bid_amount. تسري اعتبارًا من الإصدار 3.0.
`1815067`	هدف التحسين غير متاح: لا يمكنك استخدام هدف التحسين المحدد كهدف لحملتك الإعلانية. لذا يرجى تحديد هدف آخر وتعديل حملتك الإعلانية.
`1798130`	لا نسمح بإنشاء مجموعات منتجات فارغة لإعلانات كتالوج Advantage+. لذا يرجى إضافة منتجات إلى كتالوجك وإنشاء مجموعة تحتوي على منتج واحد على الأقل.
`2310025`	يتعذر إنشاء حملة إعلانية باستخدام هذا الحساب الإعلاني. لإنشاء حملات إعلانية تعاونية، يجب أن يستخدم المُعلنون عن العلامة التجارية حسابًا إعلانيًا منفصلًا لكل بائع يكون شريكًا لهم. تأكد من استخدام حساب إعلاني منفصل مرتبط بالبائع الذي يمتلك شريحة الكتالوج هذه. يخضع للتوفر المحدود.
`2310039`	يتعذر إنشاء حملة إعلانية باستخدام شريحة الكتالوج هذه. لا يمكنك استخدام هذا الحساب الإعلاني لتشغيل الإعلانات الخاصة بشريحة الكتالوج هذه. أنشأ النشاط التجاري شريحة الكتالوج هذه للمُعلن عن العلامة التجارية بغرض استخدامها في الإعلانات التعاونية. اختر حسابًا إعلانيًا مختلفًا أو استخدم هذا الحساب الإعلاني لتشغيل الحملات الإعلانية باستخدام كتالوج المنتجات بدلًا من ذلك. يخضع للتوفر المحدود.
`3260011`	لا يمكنك تعديل حدث البيكسل أو حدث التحويل أو التحويل المخصص أو التحسين لأية مجموعة إعلانية بعد نشرها. لتشغيل مجموعة إعلانية مع التغييرات المطلوبة التي أجريتها، أنشئ مجموعة إعلانية جديدة.
`3858064`	تحتوي هذه الحملة الإعلانية على الخيارات التي لم تعد مستخدمة في الحملات الإعلانية التي تتضمن جماهير دون عمر 18 عامًا بشكل عام، أو 20 عامًا في تايلاند أو 21 في إندونيسيا. قم برفع الحد الأدنى لعمر جمهورك أو قم بإزالة كل خيارات الاستهداف باستثناء العمر والمواقع التي تكون في نطاق مُدن أو مناطق أكبر (باستثناء الرمز البريدي ومنطقة التسويق المحددة).
`3858065`	تحتوي هذه الحملة الإعلانية على الخيارات التي لم تعد مستخدمة في الحملات الإعلانية التي تتضمن جماهير دون عمر 18 عامًا بشكل عام، أو 20 عامًا في تايلاند أو 21 في إندونيسيا. قم برفع الحد الأدنى لعمر جمهورك أو قم بإزالة ما يلي: المواضع غير المتوفرة.

يجب ألا تتم معالجة الأخطاء إلا باستخدام رموز الأخطاء. تخضع سلسلة الوصف للتغيير بدون إشعار مسبق.

blame_field_specs

تكون هذه الخاصية مُضمنة في الكائن الثنائي error_data الخاص باستدعاء واجهة API مما يؤدي إلى حدوث خطأ في التحقّق من الصحة بحيث يشير ذلك إلى الحقل (الحقول) الذي به مشكلة نتيجة حدوث خطأ في التحقق من الصحة. يمكن استخدام ذلك لتقديم أخطاء عبر السياق، فعلى سبيل المثال، عرض رسالة الخطأ بجوار الحقل (الحقول) التي بها المشكلة مباشرة في واجهة المستخدم الرسومية لإحدى أدوات إنشاء الإعلانات.

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"]
      ]
    }
  }
}

يشير إلى أن الحقل daily_budget من مواصفات API به مشكلة وكان منخفضًا جدًا في هذه الحالة.

عدة حقول تتضمن خطأ

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

يشير إلى وجود خطأ يتعلق بالحقل الفرعي interested_in داخل الحقل targeting_spec من مواصفات API، وأن الخطأ يتعلق أيضًا بالحقل impressions داخل الحقل bid_info من مواصفات API.