کدهای پاسخ در Search Ads 360 API
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
اگر درخواستی به Search Ads 360 API موفقیت آمیز باشد، API یک کد وضعیت HTTP 200 را همراه با داده های درخواستی در متن پاسخ برمی گرداند.
اگر درخواستی تأیید نشود ، API یک کد وضعیت HTTP بین 400 و 499 را به همراه شرح خطای اعتبار سنجی برمی‌گرداند.
اگر درخواست معتبر Report.get() ارسال کنید اما Search Ads 360 قادر به ایجاد گزارش نباشد ، API یکی از کدهای وضعیت HTTP که در زیر توضیح داده شده است را برمی گرداند.
| کد | دلیل | توضیحات | اقدام توصیه شده |
|---|
410 | ReportUnavailableRequestTooLarge | این گزارش دیگر در حال پردازش نیست زیرا گزارش بسیار بزرگ است. | در عوض چندین گزارش کوچکتر درخواست کنید. به عنوان مثال، یک گزارش آگهی دهنده را به چندین گزارش حساب موتور تقسیم کنید. یا یک گزارش یک ساله را به گزارش های 12 ماهه تقسیم کنید. |
410 | ReportUnavailableRateLimitExceeded | این گزارش دیگر پردازش نمی‌شود زیرا گزارش‌های زیادی توسط پروژه توسعه‌دهنده در مدت زمان کوتاهی درخواست شده است. | اطمینان حاصل کنید که مشتری شما بیشتر از آنچه شما قصد دارید درخواست ارسال نمی کند. اگر مشتری شما مطابق انتظار عمل می کند، با پشتیبانی مشتری Search Ads 360 تماس بگیرید . شناسه پروژه توسعه‌دهنده خود و کد و دلیل را از ردیف جدول (و نه ردیف زیر) وارد کنید. |
410 | گزارش UnavailableQuota فراتر رفته است | این گزارش دیگر پردازش نمی‌شود زیرا امروز پروژه توسعه‌دهنده داده‌های زیادی درخواست کرده است. | اطمینان حاصل کنید که مشتری شما درخواست های بزرگتر از آنچه شما قصد دارید ارسال نمی کند. می‌توانید میزان استفاده از سهمیه خود را در Google Cloud Console پیگیری کنید. اگر مشتری شما مطابق انتظار عمل می کند، با پشتیبانی مشتری Search Ads 360 تماس بگیرید و درخواست افزایش سهمیه کنید. شناسه پروژه توسعه دهنده خود و کد و دلیل را از ردیف جدول (و نه مورد بالا) وارد کنید. همچنین قیمت و محدودیت های استفاده را ببینید. |
410 | reportUnavailableInternalServerError | Search Ads 360 به دلایلی غیرمنتظره قادر به بازگرداندن یا ایجاد گزارش نیست. | با پشتیبانی مشتری Search Ads 360 تماس بگیرید . شناسه گزارش خود را وارد کنید. |
410 | reportUnavailableRequestError | حتی اگر درخواست تأیید اعتبار را پشت سر بگذارد، Search Ads 360 نمی‌تواند گزارش درخواستی را ایجاد کند زیرا حاوی ترکیب نامعتبری از ستون‌ها، فیلترها و بخش‌بندی‌ها است. | با پشتیبانی مشتری Search Ads 360 تماس بگیرید . شناسه گزارش خود را وارد کنید. |
400 | پشتیبانی نشده ApiVersion | نسخه پشتیبانی نمی شود. | به Search Ads 360 Reporting API مهاجرت کنید. |
برای همه انواع دیگر خطاها، API پاسخ‌های خطای استاندارد را برمی‌گرداند.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده 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)."]]
