Errori comuni

Questa guida elenca gli errori API comuni e offre strategie per prevenirli e gestirli.

Per un elenco completo di tutti i tipi di errore, consulta il riferimento agli errori dell'API Google Ads. Se hai bisogno di ulteriore assistenza, poni una domanda nel forum dell'API Google Ads.

google.rpc.ErrorInfo
ACCESS_TOKEN_SCOPE_INSUFFICIENT
RiepilogoIl token di accesso OAuth 2.0 non ha gli ambiti richiesti.
Cause comuni La richiesta viene rifiutata perché il token di accesso fornito non include l'ambito OAuth 2.0 dell'API Google Ads.
Come gestirla Assicurati che il token di accesso abbia gli ambiti richiesti. Un motivo comune per questo errore è che stai riutilizzando un token di accesso esistente generato utilizzando un insieme diverso di ambiti OAuth. Consulta i parametri di autorizzazione OAuth per un esempio di come generare un nuovo token di accesso con gli ambiti richiesti.
Suggerimenti per la prevenzione Assicurati che il token di accesso abbia gli ambiti richiesti. Autentica di nuovo l'utente con gli ambiti richiesti per ottenere un accesso con gli ambiti richiesti. Se la tua applicazione utilizza più ambiti OAuth, potrebbe essere necessario implementare le autorizzazioni OAuth granulari.

google.auth.exceptions.RefreshError
invalid_grant
RiepilogoIl token è scaduto o è stato revocato.
Cause comuni A un progetto Google Cloud Platform con una schermata per il consenso OAuth configurata per un tipo di utente esterno e uno stato di pubblicazione Testing viene rilasciato un token di aggiornamento che scade dopo 7 giorni.
Come gestirla Lo stato di pubblicazione del tuo progetto Google è Testing, quindi il token di aggiornamento scade ogni 7 giorni e riceve un errore invalid_grant. Vai alla console API di Google e alla schermata per il consenso OAuth. Poi modifica lo stato di pubblicazione in In production per evitare che il token di aggiornamento scada dopo 7 giorni.
Suggerimenti per la prevenzione Consulta App non verificate.

AuthenticationError
CLIENT_CUSTOMER_ID_INVALID
RiepilogoL'ID cliente non è un numero.
Cause comuni Utilizzo di un ID cliente non corretto.
Come gestirla N/A
Suggerimenti per la prevenzione 123-456-7890 deve essere 1234567890. Per maggiori dettagli, consulta la guida introduttiva.
CLIENT_CUSTOMER_ID_IS_REQUIRED
RiepilogoL'ID cliente non è stato specificato nell'intestazione HTTP.
Cause comuni Non specificare un ID cliente nell'intestazione HTTP.
Come gestirla N/A
Suggerimenti per la prevenzione L'ID cliente è obbligatorio per tutte le chiamate, quindi assicurati di averne specificato uno nell'intestazione HTTP. Valuta la possibilità di utilizzare le nostre librerie client, che gestiscono questo aspetto per te.
CUSTOMER_NOT_FOUND
RiepilogoNessun account trovato per l'ID cliente fornito nell'intestazione.
Cause comuni Tentativo di accedere a un account appena creato prima che venga stabilito nel backend.
Come gestirla Attendi cinque minuti, poi riprova ogni 30 secondi.
Suggerimenti per la prevenzione Attendi qualche minuto dopo la creazione dell'account prima di inviare richieste.
RiepilogoIl token di accesso nell'intestazione della richiesta non è valido o è scaduto.
Cause comuni Il token di accesso è stato invalidato.
Come gestirla Richiedi un nuovo token. Se utilizzi una delle nostre librerie client, consulta la documentazione su come aggiornare il token.
Suggerimenti per la prevenzione Archivia e riutilizza i token di accesso fino alla loro scadenza.
NOT_ADS_USER
RiepilogoL'Account Google utilizzato per generare il token di accesso non è associato ad alcun account Google Ads.
Cause comuni Le informazioni di accesso fornite corrispondono a un Account Google per il quale Google Ads non è attivo.
Come gestirla Assicurati di accedere con un account Google Ads valido (in genere il tuo account amministratore) per il flusso OAuth. Puoi anche invitare l'Account Google ad accedere a un account Google Ads esistente accedendo al tuo account amministratore, selezionando l'account cliente o amministratore in questione, andando a Tools and Settings > Access and security e poi aggiungendo l'indirizzo email dell'Account Google.
Suggerimenti per la prevenzione N/A
OAUTH_TOKEN_INVALID
RiepilogoIl token di accesso OAuth nell'intestazione non è valido.
Cause comuni Il token di accesso passato con l'intestazione HTTP non era corretto.
Come gestirla N/A
Suggerimenti per la prevenzione Assicurati di aver passato il token di accesso corretto associato al tuo account. A volte viene confuso con i token di aggiornamento e i codici di autorizzazione. Se vuoi ottenere una credenziale che possa accedere a tutti gli account cliente di un account amministratore, assicurati di ottenere il token di aggiornamento per l'account amministratore. Consulta la guida all'autenticazione utente.

AuthorizationError
CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION
RiepilogoIl progetto Google Cloud ha solo l'accesso di prova e non può essere utilizzato per accedere agli account di produzione.
Cause comuni È stato utilizzato un progetto Google Cloud con il livello di accesso di prova per effettuare una richiesta a un account Google Ads non di prova (di produzione). (Nelle versioni dell'API v24 e precedenti, questa condizione restituisce AuthorizationError.ACTION_NOT_PERMITTED.)
Come gestirla Se stai eseguendo dei test, assicurati che la richiesta sia indirizzata a un account di prova. Se vuoi accedere a un account Google Ads di produzione, controlla il livello di accesso del tuo progetto Google Cloud nella pagina Panoramica dell'API Google Ads e aggiorna il livello di accesso del progetto ad accesso Explorer, di base o standard.
Suggerimenti per la prevenzione N/A
CUSTOMER_NOT_ENABLED
RiepilogoNon è possibile accedere all'account cliente perché non è in stato attivo.
Cause comuni Questo si verifica quando la registrazione dell'account cliente non è stata completata o l'account è stato disattivato.
Come gestirla Accedi all'interfaccia utente di Google Ads e assicurati di aver completato la procedura di registrazione per questo account. Per gli account disattivati, consulta Riattivare un account Google Ads chiuso.
Suggerimenti per la prevenzione Puoi verificare in modo proattivo se un account cliente è disattivato controllando lo stato ANNULLATO.
USER_PERMISSION_DENIED
RiepilogoIl cliente autorizzato non ha accesso al cliente operativo.
Cause comuni Autenticazione come utente con accesso a un account amministratore, ma senza specificare login-customer-id nella richiesta.
Come gestirla N/A
Suggerimenti per la prevenzione Specifica login-customer-id come ID dell'account amministratore senza trattini (-). Le librerie client hanno il supporto integrato per questa operazione.

Indietro
Gestisci gli errori
Avanti
Passaggi successivi