Codes de réponse dans l'API Search Ads 360
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Si une requête envoyée à l'API Search Ads 360 aboutit, l'API renvoie un code d'état HTTP 200, ainsi que les données demandées dans le corps de la réponse.
Si la validation d'une requête échoue, l'API renvoie un code d'état HTTP compris entre 400 et 499, ainsi qu'une description de l'erreur de validation.
Si vous envoyez une requête Report.get() valide, mais que Search Ads 360 ne parvient pas à générer un rapport, l'API renvoie l'un des codes d'état HTTP décrits ci-dessous.
| Code |
Motif |
Description |
Action recommandée |
410 |
reportUnavailableRequestTooLarge |
Le rapport n'est plus traité, car il est trop volumineux. |
Demandez plutôt plusieurs rapports plus petits. Par exemple, divisez un rapport sur un annonceur en plusieurs rapports sur des comptes associés à un moteur. Vous pouvez également diviser un rapport annuel en 12 rapports mensuels. |
410 |
reportUnavailableRateLimitExceeded |
Le rapport n'est plus en cours de traitement, car le projet du développeur a demandé trop de rapports en peu de temps. |
Assurez-vous que votre client n'envoie pas de requêtes plus fréquemment que prévu.
Si les performances de votre client sont conformes aux attentes, contactez le service client de Search Ads 360.
Indiquez l'ID de votre projet de développement, ainsi que le code et le motif de cette ligne de tableau (et non celui ci-dessous).
|
410 |
reportUnavailableQuotaExceeded |
Le rapport n'est plus en cours de traitement, car le projet de développeur a demandé trop de données aujourd'hui. |
Assurez-vous que votre client n'envoie pas de requêtes plus volumineuses que prévu. Vous pouvez suivre votre utilisation des quotas dans la console Google Cloud.
Si les performances de votre client sont conformes aux attentes, contactez le service client Search Ads 360 et demandez une augmentation du quota. Indiquez l'ID de votre projet de développement, ainsi que le code et le motif de cette ligne de tableau (et non celui ci-dessus).
Consultez également la section Tarifs et limites d'utilisation.
|
410 |
reportUnavailableInternalServerError |
Search Ads 360 ne parvient pas à renvoyer ni à générer le rapport pour une raison inattendue. |
Contactez l'assistance client Search Ads 360. Incluez votre ID de rapport.
|
410 |
reportUnavailableRequestError |
Même si la requête a été validée, Search Ads 360 ne peut pas générer le rapport demandé, car il contient une combinaison de colonnes, de filtres et de segmentations non valide. |
Contactez l'assistance client Search Ads 360. Incluez votre ID de rapport. |
400 |
unsupportedApiVersion |
Version non compatible. |
Migrez vers l'API Search Ads 360 Reporting. |
Pour tous les autres types d'erreurs, l'API renvoie des réponses d'erreur standards.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2024/12/05 (UTC).
[null,null,["Dernière mise à jour le 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)."]]
