Google utilizza la tecnologia AI per tradurre i contenuti nella tua lingua preferita. Le traduzioni generate dall'AI potrebbero contenere errori.

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, fai una domanda sul forum dell'API Google Ads.

`google.rpc.ErrorInfo`

ACCESS_TOKEN_SCOPE_INSUFFICIENT

Riepilogo	Il token di accesso OAuth 2.0 non dispone degli 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 disponga degli ambiti richiesti. Un motivo comune di questo errore è il riutilizzo di 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 disponga degli ambiti richiesti. Esegui nuovamente l'autenticazione dell'utente con gli ambiti richiesti per ottenere un accesso con gli ambiti richiesti. Se la tua applicazione utilizza più ambiti OAuth, potresti dover implementare le autorizzazioni OAuth granulari.

invalid_grant

Riepilogo	Il token è scaduto o è stato revocato.
Cause comuni	A un progetto Google Cloud 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 cambia lo stato di pubblicazione in `In production` per evitare che il token di aggiornamento scada dopo 7 giorni.
Suggerimenti per la prevenzione	Vedi App non verificate.

CLIENT_CUSTOMER_ID_INVALID

Riepilogo	L'ID cliente non è un numero.
Cause comuni	Utilizzo di un ID cliente client non corretto.
Come gestirla	N/A
Suggerimenti per la prevenzione	123-456-7890 deve essere 1234567890. Per maggiori dettagli, consulta la sezione Guida introduttiva.

CLIENT_CUSTOMER_ID_IS_REQUIRED

Riepilogo	L'ID cliente client non è stato specificato nell'intestazione HTTP.
Cause comuni	Mancata specifica di un ID cliente client nell'intestazione HTTP.
Come gestirla	N/A
Suggerimenti per la prevenzione	L'ID cliente client è obbligatorio per tutte le chiamate, quindi assicurati di averne specificato uno nell'intestazione HTTP. Ti consigliamo di utilizzare le nostre librerie client, che gestiscono questa operazione per te.

CUSTOMER_NOT_FOUND

Riepilogo	Nessun 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.

GOOGLE_ACCOUNT_COOKIE_INVALID

Riepilogo	Il 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 relativa documentazione per scoprire come aggiornare il token.
Suggerimenti per la prevenzione	Archivia e riutilizza i token di accesso fino alla loro scadenza.

NOT_ADS_USER

Riepilogo	L'account Google utilizzato per generare il token di accesso non è associato ad alcun account Google Ads.
Cause comuni	I dati di accesso forniti corrispondono a un Account Google su cui Google Ads non è attivato.
Come gestirla	Assicurati di accedere con un account Google Ads valido (in genere l'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 su `Tools and Settings > Access and security` e poi aggiungendo l'indirizzo email dell'Account Google.
Suggerimenti per la prevenzione	N/A

OAUTH_TOKEN_INVALID

Riepilogo	Il token di accesso OAuth nell'intestazione non è valido.
Cause comuni	Il token di accesso trasmesso con l'intestazione HTTP non era corretto.
Come gestirla	N/A
Suggerimenti per la prevenzione	Assicurati di aver superato 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.

CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION

Riepilogo	Il progetto Google Cloud ha accesso di test e non può essere utilizzato per accedere agli account di produzione.
Cause comuni	Un progetto Google Cloud con il livello di accesso test è stato utilizzato per effettuare una richiesta a un account Google Ads non di test (di produzione). Nelle versioni 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

Riepilogo	Non è possibile accedere all'account cliente perché non è in stato abilitato.
Cause comuni	Ciò 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 l'articolo Riattivare un account Google Ads cancellato.
Suggerimenti per la prevenzione	Puoi verificare in modo proattivo se un account cliente è disattivato controllando lo stato CANCELLATO.

USER_PERMISSION_DENIED

Riepilogo	Il cliente autorizzato non ha accesso al cliente operativo.
Cause comuni	Autenticarsi come utente con accesso a un account amministratore, ma non specificare `login-customer-id` nella richiesta.
Come gestirla	N/A
Suggerimenti per la prevenzione	Specifica `login-customer-id` come ID account amministratore senza trattini (`-`). Le librerie client hanno il supporto integrato per questa operazione.