Errori comuni

Questa pagina elenca gli errori più comuni e fornisce suggerimenti per evitarli e gestirli. Per un elenco completo degli errori, consulta i riferimenti all'errore. Per ulteriore assistenza, visita il nostro forum.

google.auth.exceptions.RefreshError
invalid_grant
RiepilogoIl 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 emesso un token di aggiornamento che scade tra 7 giorni.
Come gestire Lo stato di pubblicazione del tuo progetto Google è Testing, pertanto il token di aggiornamento scade ogni 7 giorni e viene visualizzato un errore invalid_grant. Vai alla console dell'API di Google e vai alla schermata del consenso OAuth. Quindi, modifica lo stato di pubblicazione in In production seguendo queste istruzioni per evitare che il token di aggiornamento scada tra 7 giorni.
Suggerimenti per la prevenzione Consulta la sezione App non verificate.

AuthenticationError
CLIENT_CUSTOMER_ID_INVALID
RiepilogoL'ID cliente del cliente non è un numero.
Cause comuni Utilizzo di un ID cliente del cliente non corretto.
Come gestire 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 del cliente non è stato specificato nell'intestazione HTTP.
Cause comuni Non è stato specificato un ID cliente del client nell'intestazione HTTP.
Come gestire N/A
Suggerimenti per la prevenzione L'ID cliente del 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 questa operazione per te.
CUSTOMER_NOT_FOUND
RiepilogoNessun account trovato per l'ID cliente fornito nell'intestazione.
Cause comuni Tentativo di accesso a un account appena creato prima che l'account venga creato nel backend.
Come gestire Attendi inizialmente 5 minuti, quindi 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 gestire Richiedi un nuovo token. Se utilizzi una delle nostre librerie client, consulta la relativa documentazione su come aggiornare il token.
Suggerimenti per la prevenzione Memorizza 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 a nessun account Google Ads.
Cause comuni I dati di accesso forniti corrispondono a un Account Google in cui Google Ads non è attivo.
Come gestire Per il flusso OAuth, assicurati di accedere con un account Google Ads valido (in genere il tuo account amministratore). 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 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 gestire 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. Per maggiori dettagli, consulta la nostra guida su token di accesso e token di aggiornamento e OAuth2.

AuthorizationError
CUSTOMER_NOT_ENABLED
RiepilogoNon è possibile accedere all'account cliente perché non è attivo.
Cause comuni Questo accade quando la registrazione dell'account cliente non è stata completata o è stata disattivata.
Come gestire 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 chiuso.
Suggerimenti per la prevenzione Puoi verificare in modo proattivo se un account cliente è disattivato controllando se lo stato è CANCELED (ANNULLATO).
DEVELOPER_TOKEN_NOT_APPROVED
RiepilogoIl token sviluppatore è approvato solo per l'utilizzo con account di test ed è stato tentato di accedere a un account non di test.
Cause comuni È stato utilizzato un token sviluppatore di prova per accedere a un account non di prova.
Come gestire Assicurati di voler effettivamente accedere a un account non di test. In questo caso, devi richiedere l'upgrade del token sviluppatore all'accesso Standard o di base.
Suggerimenti per la prevenzione N/A
DEVELOPER_TOKEN_PROHIBITED
RiepilogoIl token sviluppatore non è consentito con il progetto inviato nella richiesta.
Cause comuni Ogni progetto della Console API di Google può essere associato al token sviluppatore di un solo account amministratore. Una volta inviata una richiesta all'API Google Ads, il token sviluppatore viene accoppiato definitivamente al progetto della console API di Google. Se non utilizzi un nuovo progetto della console API di Google, riceverai un errore DEVELOPER_TOKEN_PROHIBITED quando effettui una richiesta.
Come gestire N/A
Suggerimenti per la prevenzione Se passi a un token sviluppatore in un nuovo account amministratore, devi creare un nuovo progetto della console API di Google per le richieste all'API Google Ads che utilizzano il token del nuovo amministratore.
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 gestire N/A
Suggerimenti per la prevenzione Specifica login-customer-id come ID account amministratore senza i trattini (-). Le librerie client hanno il supporto integrato per questo.

Indietro
Esegui una chiamata API
Avanti
Passaggi successivi