رموز الاستجابة في Search Ads 360 API
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
إذا كان الطلب الذي تم إرساله إلى Search Ads 360 API ناجحًا، تعرض واجهة برمجة التطبيقات
الرمز البرمجي 200 لحالة HTTP مع البيانات المطلوبة في نص الاستجابة.
إذا تعذّر التحقّق من صحة الطلب، تعرض واجهة برمجة التطبيقات رمز حالة HTTP بين
400 و499 مع وصف لخطأ التحقّق من الصحة.
إذا أرسلت طلبًا صالحًا من نوع Report.get()
ولكن تعذّر على "إعلانات شبكة البحث 360" إنشاء تقرير، تعرض واجهة برمجة التطبيقات
أحد رموز حالة HTTP الموضّحة أدناه.
| الرمز |
السبب |
الوصف |
الإجراء المقترح |
410 |
reportUnavailableRequestTooLarge |
لم تعُد تتم معالجة التقرير لأنّه كبير جدًا. |
اطلب تقارير متعددة أصغر حجمًا بدلاً من ذلك. على سبيل المثال، يمكنك تقسيم تقرير معلِن واحد
إلى تقارير حسابات محرّكات بحث متعددة. أو يمكنك تقسيم تقرير سنوي إلى 12 تقريرًا شهريًا. |
410 |
reportUnavailableRateLimitExceeded |
لم تعُد تتم معالجة التقرير لأنّه تم طلب عدد كبير جدًا من التقارير من قِبل
مشروع المطوّر في فترة زمنية قصيرة. |
تأكَّد من أنّ العميل لا يرسل الطلبات بمعدّل أكبر مما تريد.
إذا كان أداء عميلك على النحو المتوقّع،
تواصَل مع فريق دعم عملاء "إعلانات شبكة البحث 360".
أدرِج رقم تعريف مشروع المطوّر والرمز والسبب من صف الجدول هذا
(وليس الصف أدناه).
|
410 |
reportUnavailableQuotaExceeded |
لم تعُد تتم معالجة التقرير لأنّه تم طلب الكثير من البيانات من قِبل
مشروع المطوّر اليوم. |
تأكَّد من أنّ العميل لا يرسل طلبات أكبر من المطلوب. يمكنك متابعة
استخدام حصتك في Google Cloud Console.
إذا كان أداء عميلك على النحو المتوقّع،
تواصَل مع فريق دعم عملاء "إعلانات شبكة البحث 360" واطلب زيادة الحصة. يجب تضمين رقم تعريف
مشروع المطوّر، والرمز والسبب من صف الجدول هذا (وليس الصف أعلاه).
يُرجى الاطّلاع أيضًا على الأسعار وحدود الاستخدام.
|
410 |
reportUnavailableInternalServerError |
يتعذّر على "إعلانات شبكة البحث 360" عرض التقرير أو إنشاؤه لبعض الأسباب غير المتوقّعة. |
يُرجى التواصل مع فريق دعم عملاء
"إعلانات شبكة البحث 360". يُرجى تضمين رقم تعريف التقرير.
|
410 |
reportUnavailableRequestError |
على الرغم من أنّ الطلب اجتاز عملية التحقّق، لا يمكن لخدمة "إعلانات شبكة البحث 360" إنشاء التقرير المطلوب
لأنّه يحتوي على تركيبة غير صالحة من الأعمدة والفلاتر والتقسيمات. |
يُرجى التواصل مع فريق دعم عملاء "إعلانات شبكة البحث
360". يُرجى تضمين رقم تعريف التقرير. |
400 |
unsupportedApiVersion |
الإصدار غير متوافق. |
نقل البيانات إلى Search Ads 360 Reporting API |
بالنسبة إلى جميع الأنواع الأخرى من الأخطاء، تعرض واجهة برمجة التطبيقات
الردود العادية على الأخطاء.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-12-05 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2024-12-05 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eSearch Ads 360 API returns a \u003ccode\u003e200\u003c/code\u003e HTTP status code for successful requests and a status code between \u003ccode\u003e400\u003c/code\u003e and \u003ccode\u003e499\u003c/code\u003e for validation failures.\u003c/p\u003e\n"],["\u003cp\u003eIf a valid report request cannot be generated, the API returns a \u003ccode\u003e410\u003c/code\u003e status code with a specific reason, such as the report being too large, rate limit exceeded, or internal server error.\u003c/p\u003e\n"],["\u003cp\u003eFor report generation failures, recommended actions include requesting smaller reports, checking client request frequency, contacting support for quota increases, or reviewing report configurations.\u003c/p\u003e\n"],["\u003cp\u003eThe API provides detailed descriptions and recommended actions for each type of report generation failure, helping users troubleshoot and resolve issues effectively.\u003c/p\u003e\n"],["\u003cp\u003eFor other errors, refer to the Standard Error Responses documentation for guidance.\u003c/p\u003e\n"]]],["Successful Search Ads 360 API requests return a `200` status code. Validation failures result in `400-499` codes, with error descriptions. If report generation fails, `410` codes indicate issues like excessive size, rate limits, quota overages, internal errors, or invalid report specifications; each with specific resolution steps. A `400` error indicates an unsupported API version. Other errors follow standard error responses.\n"],null,["# Response Codes in the Search Ads 360 API\n\nIf a request to the Search Ads 360 API is **successful** , the API returns\na `200` HTTP status code along with the requested data in the body of the response.\n\nIf a request **fails to validate** , the API returns an HTTP status code between\n`400` and `499` along with a description of the validation error.\n\nIf you send a valid [`Report.get()`](/search-ads/v2/reference/reports/get)\nrequest but Search Ads 360 is **unable to generate a report**, the API returns\none of the HTTP status codes described below.\n\n| Code | Reason | Description | Recommended action |\n|------|--------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| 410 | reportUnavailableRequestTooLarge | The report is no longer being processed because the report is too large. | Request multiple smaller reports instead. For example, break a single advertiser report into multiple engine account reports. Or break a year-long report into 12 month long reports. |\n| 410 | reportUnavailableRateLimitExceeded | The report is no longer being processed because too many reports were requested by the developer project in a short amount of time. | Make sure your client isn't sending requests more frequently than you intend. If your client is performing as expected, [contact Search Ads 360 customer support](https://support.google.com/searchads/answer/3280641). Include your developer project ID, and the Code and Reason from this table row (and not the one below). |\n| 410 | reportUnavailableQuotaExceeded | The report is no longer being processed because too much data has been requested by the developer project today. | Make sure your client isn't sending larger requests than you intend. You can keep track of your quota usage in Google Cloud Console. If your client is performing as expected, [contact Search Ads 360 customer support](https://support.google.com/searchads/answer/9026876) and ask for a quota increase. Include your developer project ID, and the Code and Reason from this table row (and not the one above). Also see [Pricing and Usage Limits](/pricing). |\n| 410 | reportUnavailableInternalServerError | Search Ads 360 is unable to return or generate the report for some unexpected reason. | [Contact Search Ads 360 customer support](https://support.google.com/searchads/answer/9026876). Include your report ID. |\n| 410 | reportUnavailableRequestError | Even though the request passed validation, Search Ads 360 cannot generate the requested report because it contains an invalid combination of columns, filters, and segmentations. | [Contact Search Ads 360 customer support](https://support.google.com/searchads/answer/9026876). Include your report ID. |\n| 400 | unsupportedApiVersion | Version not supported. | Migrate to the Search Ads 360 Reporting API. |\n\nFor all other types of errors, the API returns\n[Standard Error Responses](/search-ads/v2/standard-error-responses)."]]
