L'API Search Ads 360 Reporting precedente è stata ritirata. Ora puoi creare i report utilizzando la nuova API Search Ads 360 Reporting.
Tieni presente che i metodi get e getByCustomerId nell'API Search Ads 360 Conversion verranno ritirati nel terzo trimestre del 2025. Per continuare ad accedere ai dati sulle conversioni, devi creare un report utilizzando la risorsa conversion con la nuova API Search Ads 360 Reporting. Scopri di più qui.
Le restanti funzioni dell'API Search Ads 360 Conversion continueranno a essere supportate.
Codici di risposta nell'API Search Ads 360
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Se una richiesta all'API Search Ads 360 è andata a buon fine, l'API restituisce
un codice di stato HTTP 200 insieme ai dati richiesti nel corpo della risposta.
Se la convalida di una richiesta non va a buon fine, l'API restituisce un codice di stato HTTP compreso tra
400 e 499 insieme a una descrizione dell'errore di convalida.
Se invii una richiesta Report.get() valida, ma Search Ads 360 non è in grado di generare un report, l'API restituisce uno dei codici di stato HTTP descritti di seguito.
| Codice |
Motivo |
Descrizione |
Azione consigliata |
410 |
reportUnavailableRequestTooLarge |
L'elaborazione del report non è più in corso perché il report è troppo grande. |
Richiedi invece più report di dimensioni ridotte. Ad esempio, suddividi un singolo report sull'inserzionista in più report sugli account motore. In alternativa, suddividi un report annuale in report di 12 mesi. |
410 |
reportUnavailableRateLimitExceeded |
Il report non è più in fase di elaborazione perché il progetto sviluppatore ha richiesto troppi report in poco tempo. |
Assicurati che il client non invii richieste più spesso di quanto intendi.
Se il rendimento del cliente è quello previsto,
contatta l'assistenza clienti di Search Ads 360.
Includi l'ID progetto sviluppatore, il codice e il motivo di questa riga della tabella
(non quella di seguito).
|
410 |
reportUnavailableQuotaExceeded |
Il report non è più in fase di elaborazione perché oggi il progetto dello sviluppatore ha richiesto troppi dati. |
Assicurati che il client non invii richieste più grandi del previsto. Puoi monitorare
l'utilizzo della quota in Google Cloud Console.
Se il rendimento del tuo cliente è quello previsto,
contatta l'assistenza clienti di Search Ads 360 e richiedi un aumento della quota. Includi il tuo ID progetto sviluppatore, il codice e il motivo di questa riga della tabella (non quella sopra).
Consulta anche la sezione Prezzi e limiti di utilizzo.
|
410 |
reportUnavailableInternalServerError |
Search Ads 360 non è in grado di restituire o generare il report per un motivo imprevisto. |
Contatta l'assistenza clienti di Search Ads 360. Includi l'ID report.
|
410 |
reportUnavailableRequestError |
Anche se la richiesta ha superato la convalida, Search Ads 360 non può generare il report richiesto
perché contiene una combinazione non valida di colonne, filtri e segmentazioni. |
Contatta l'assistenza clienti di Search Ads 360. Includi l'ID report. |
400 |
unsupportedApiVersion |
Versione non supportata. |
Esegui la migrazione all'API Search Ads 360 Reporting. |
Per tutti gli altri tipi di errori, l'API restituisce
risposte di errore standard.
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2024-12-05 UTC.
[null,null,["Ultimo aggiornamento 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)."]]
