Códigos de respuesta en la API de Search Ads 360
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Si una solicitud a la API de Search Ads 360 es correcta, la API muestra un código de estado HTTP 200 junto con los datos solicitados en el cuerpo de la respuesta.
Si una solicitud no se valida, la API muestra un código de estado HTTP entre 400 y 499 junto con una descripción del error de validación.
Si envías una solicitud Report.get() válida, pero Search Ads 360 no puede generar un informe, la API muestra uno de los códigos de estado HTTP que se describen a continuación.
| Código |
Motivo |
Descripción |
Acción recomendada |
410 |
reportUnavailableRequestTooLarge |
El informe ya no se está procesando porque es demasiado grande. |
En su lugar, solicita varios informes más pequeños. Por ejemplo, divide un solo informe de anunciante en varios informes de cuentas de motor. O bien divide un informe anual en informes de 12
meses. |
410 |
reportUnavailableRateLimitExceeded |
El informe ya no se está procesando porque el proyecto del desarrollador solicitó demasiados informes en poco tiempo. |
Asegúrate de que tu cliente no envíe solicitudes con más frecuencia de la deseada.
Si tu cliente tiene el rendimiento esperado,
comunícate con el servicio de asistencia al cliente de Search Ads 360.
Incluye el ID de tu proyecto de desarrollador, el código y el motivo de esta fila de la tabla
(no la siguiente).
|
410 |
reportUnavailableQuotaExceeded |
El informe ya no se está procesando porque el proyecto del desarrollador solicitó demasiados datos hoy. |
Asegúrate de que tu cliente no envíe solicitudes más grandes de lo que deseas. Puedes hacer un seguimiento del uso de tu cuota en la consola de Google Cloud.
Si tu cliente tiene el rendimiento esperado, comunícate con el servicio de asistencia al cliente de Search Ads 360 y solicita un aumento de cuota. Incluye el ID de tu proyecto de desarrollador, el código y el motivo de esta fila de la tabla (no el anterior).
Consulta también Precios y límites de uso.
|
410 |
reportUnavailableInternalServerError |
Search Ads 360 no puede mostrar ni generar el informe por algún motivo inesperado. |
Comunícate con el servicio de asistencia al cliente de Search Ads 360. Incluye el ID de tu informe.
|
410 |
reportUnavailableRequestError |
Aunque la solicitud pasó la validación, Search Ads 360 no puede generar el informe solicitado porque contiene una combinación no válida de columnas, filtros y segmentaciones. |
Comunícate con el servicio de asistencia al cliente de Search Ads 360. Incluye el ID de tu informe. |
400 |
unsupportedApiVersion |
La versión no es compatible. |
Migra a la API de Search Ads 360 Reporting. |
Para todos los demás tipos de errores, la API muestra respuestas de error estándar.
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2024-12-05 (UTC)
[null,null,["Última actualización: 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)."]]
