Предыдущий Search Ads 360 Reporting API выведен из эксплуатации. Теперь вы можете создавать свои отчеты с помощью нового Search Ads 360 Reporting API .
Обратите внимание, что методы get и getByCustomerId в Search Ads 360 Conversion API устарели в третьем квартале 2025 года. Чтобы продолжить доступ к данным о конверсиях, необходимо создать отчет с использованием ресурса конверсии с помощью нового Search Ads 360 Reporting API. Подробнее см. здесь.
Остальные функции API конверсий Search Ads 360 будут по-прежнему поддерживаться.
Коды ответов в 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 | ReportUnavailableQuotaExceeded | Отчет больше не обрабатывается, поскольку сегодня проект разработчика запросил слишком много данных. | Убедитесь, что ваш клиент не отправляет запросы большего размера, чем вы намереваетесь. Вы можете отслеживать использование квоты в Google Cloud Console. Если ваш клиент работает должным образом, обратитесь в службу поддержки Search Ads 360 и попросите увеличить квоту. Укажите идентификатор проекта разработчика, а также код и причину из этой строки таблицы (а не из приведенной выше). См. также раздел «Цены и ограничения на использование» . |
410 | ReportUnavailableInternalServerError | Поисковая реклама 360 не может вернуть или создать отчет по какой-то неожиданной причине. | Обратитесь в службу поддержки клиентов Search Ads 360 . Укажите идентификатор отчета. |
410 | ReportUnavailableRequestError | Несмотря на то, что запрос прошел проверку, Search Ads 360 не может создать запрошенный отчет, поскольку он содержит недопустимую комбинацию столбцов, фильтров и сегментаций. | Обратитесь в службу поддержки клиентов Search Ads 360 . Укажите идентификатор отчета. |
400 | неподдерживаемая версия API | Версия не поддерживается. | Перейдите на API отчетов Search Ads 360. |
Для всех остальных типов ошибок API возвращает стандартные ответы на ошибки .
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2024-12-05 UTC.
[null,null,["Последнее обновление: 2024-12-05 UTC."],[[["\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)."]]
