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.
Reports: get
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Sondaggi per verificare lo stato di una richiesta di segnalazione.
Prova subito.
La risposta indica lo stato della segnalazione:
- Se il report è pronto per il download, la risposta contiene
isReportReady: true. La risposta contiene anche informazioni come il numero di file del report.
- Se il rapporto è ancora in fase di elaborazione, la risposta contiene
isReportReady: false.
- Se DoubleClick Search non è in grado di completare il rapporto, la risposta contiene il codice di errore 410 Gone e uno dei motivi documentati in
Codici di risposta.
Richiesta
Richiesta HTTP
GET https://www.googleapis.com/doubleclicksearch/v2/reports/reportId
Parametri
| Nome del parametro |
Valore |
Descrizione |
| Parametri percorso |
reportId |
string |
ID della richiesta di report sottoposta a polling.
|
Autorizzazione
Questa richiesta richiede l'autorizzazione con il seguente ambito:
| Ambito |
|---|
https://www.googleapis.com/auth/doubleclicksearch |
Per ulteriori informazioni, consulta la pagina Autenticazione e autorizzazione.
Corpo della richiesta
Non fornire un corpo della richiesta con questo metodo.
Risposta
In caso di esito positivo, questo metodo restituisce una risorsa di report nel corpo della risposta.
Prova
Usa Explorer API in basso per chiamare questo metodo sui dati in tempo reale e visualizzare la risposta.
In alternativa, prova la
autonomo
Spazio di esplorazione.
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-08-20 UTC.
[null,null,["Ultimo aggiornamento 2024-08-20 UTC."],[[["\u003cp\u003ePolls for the status of a report request to determine if it's ready for download, still processing, or if an error occurred.\u003c/p\u003e\n"],["\u003cp\u003eThe response includes an \u003ccode\u003eisReportReady\u003c/code\u003e flag indicating the report status and, if ready, provides details like the number of report files.\u003c/p\u003e\n"],["\u003cp\u003eUses a GET request to the specified endpoint, including the report ID as a path parameter, to retrieve the report status.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/doubleclicksearch\u003c/code\u003e scope for access.\u003c/p\u003e\n"],["\u003cp\u003eA successful response returns a Reports resource containing information about the requested report.\u003c/p\u003e\n"]]],["This outlines polling a report request's status via a GET request to `https://www.googleapis.com/doubleclicksearch/v2/reports/reportId`, requiring authorization. The `reportId` path parameter identifies the report. A successful response indicates `isReportReady: true` if ready, including file information, or `isReportReady: false` if in progress. A 410 Gone error code signifies report failure. The method returns a Reports resource and doesn't use a request body.\n"],null,["# Reports: get\n\n| **Note:** Requires [authorization](#auth).\n\nPolls for the status of a report request.\n[Try it now](#try-it).\n\nThe response indicates the status of the report:\n\n- If the report is ready for download, the response contains `isReportReady: true`. The response also contains information such as the number of report files.\n- If the report is still being worked on, the response contains `isReportReady: false`.\n- If DoubleClick Search is unable to complete the report, the response contains the error code **410 Gone** and one of the reasons documented in [Response Codes](/search-ads/v2/response-codes).\n\n\u003cbr /\u003e\n\nRequest\n-------\n\n### HTTP request\n\n```\nGET https://www.googleapis.com/doubleclicksearch/v2/reports/reportId\n```\n\n### Parameters\n\n| Parameter name | Value | Description |\n|----------------|----------|----------------------------------------|\n| **Path parameters** |||\n| `reportId` | `string` | ID of the report request being polled. |\n\n### Authorization\n\nThis request requires authorization with the following scope:\n\n| Scope |\n|-----------------------------------------------------|\n| `https://www.googleapis.com/auth/doubleclicksearch` |\n\nFor more information, see the [authentication and authorization](/search-ads/v2/authorizing) page.\n\n### Request body\n\nDo not supply a request body with this method.\n\nResponse\n--------\n\nIf successful, this method returns a [Reports resource](/search-ads/v2/reference/reports#resource) in the response body.\n\nTry it!\n-------\n\n\nUse the APIs Explorer below to call this method on live data and see the response.\nAlternatively, try the\n[standalone\nExplorer](https://developers.google.com/apis-explorer/#p/doubleclicksearch/v2/doubleclicksearch.reports.get)."]]
