Aggiornamento delle norme di utilizzo delle risorse dell'API Google Ads

Mercoledì 1° maggio 2024

Cosa cambierà?

Stiamo aggiornando le norme sull'utilizzo delle risorse dell'API Google Ads per limitare i pattern di query GoogleAdsService.Search e GoogleAdsService.SearchStream che consumano quantità eccessive di risorse API. Se un particolare pattern di query viene limitato, gli altri servizi, metodi e pattern di query continueranno a funzionare senza variazioni.

A partire dalla settimana del 17 giugno 2024, e solo per i pattern di query limitati, le richieste saranno interessate come segue:

  • Se utilizzi la versione v17 o precedente dell'API, riceverai un errore QuotaError.RESOURCE_EXHAUSTED.
  • Se utilizzi la versione v18 o successive dell'API, riceverai un errore QuotaError.EXCESSIVE_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION o QuotaError.EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION, a seconda che il consumo eccessivo di risorse sia avvenuto per un breve periodo di tempo (alcuni minuti) o per un periodo di tempo più lungo.

Per aiutarti a identificare e monitorare i report costosi, restituiremo anche una metrica di costo per i singoli report. Per visualizzare il costo dei report riusciti, consulta i seguenti campi:

Perché questa modifica?

Stiamo apportando questa modifica per preservare l'affidabilità e la stabilità dell'API.

Cosa devo fare?

Prima del 17 giugno 2024, aggiorna le tue applicazioni per eseguire le seguenti operazioni:

  • Gestisci i nuovi codici di errore quando effettui chiamate GoogleAdsService::Search or GoogleAdsService::SearchStream
    • Se utilizzi la versione v17 o precedente dell'API Google Ads, gestisci gli errori QuotaError.RESOURCE_EXHAUSTED.
    • Se utilizzi la versione v18 o successive dell'API, gestisci gli errori QuotaError.EXCESSIVE_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION e QuotaError.EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION.
  • Se uno o più pattern di query dei report sono limitati, devi esaminarli e correggerli. Ecco alcuni modi per migliorare le prestazioni delle query:
    • Esegui la query meno di frequente.
    • Utilizza un pattern di query o una visualizzazione meno costosi.

Per scoprire di più sull'ottimizzazione delle query, consulta Gestisci l'efficienza dei dati.

  • [Facoltativo] Incorpora la nuova metrica query_resource_consumption nei tuoi sistemi di monitoraggio per rilevare e gestire nuove query costose.

Come ricevere assistenza

Se hai domande su questa modifica o hai bisogno di assistenza per ottimizzare pattern di query specifici, consulta la pagina di assistenza dell'API Google Ads per conoscere le opzioni disponibili.

- David Stevens, Product Manager dell'API Google Ads

Labels: google-ads-api