Errori comuni

Questa pagina elenca gli errori comuni e fornisce suggerimenti su come prevenirli e gestirli. Per un elenco completo degli errori, consulta i riferimenti agli errori. Per ulteriore assistenza, visita il nostro forum.

google.auth.exceptions.RefreshError

invalid_grant
RiepilogoIl token è scaduto o revocato.
Cause comuni A un progetto della piattaforma Google Cloud con una schermata di 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.
Modalità di gestione Lo stato di pubblicazione del tuo progetto Google è Testing, pertanto il token di aggiornamento scade ogni 7 giorni e riceve un errore invalid_grant. Vai alla console API di Google e vai alla schermata per il consenso OAuth. Poi modifica lo stato di pubblicazione in In production seguendo queste istruzioni per evitare che il token di aggiornamento scada dopo 7 giorni.
Suggerimenti per la prevenzione Vedi App non verificate.

AuthenticationError

CLIENT_CUSTOMER_ID_INVALID
RiepilogoL'ID cliente non è un numero.
Cause comuni Uso di un ID cliente non corretto.
Modalità di gestione N/A
Suggerimenti per la prevenzione 123-456-7890 deve essere 1234567890. Consulta la guida introduttiva per i dettagli.
CLIENT_CUSTOMER_ID_IS_REQUIRED
RiepilogoL'ID cliente del cliente non è stato specificato nell'intestazione HTTP.
Cause comuni Non è specificato un ID cliente client nell'intestazione HTTP.
Modalità di gestione N/A
Suggerimenti per la prevenzione L'ID cliente è obbligatorio per tutte le chiamate, pertanto assicurati di averlo specificato nell'intestazione HTTP. Ti consigliamo di utilizzare le nostre librerie client per la gestione del tuo problema.
CUSTOMER_NOT_FOUND
RiepilogoNessun account trovato per l'ID cliente fornito nell'intestazione.
Cause comuni Tentativo di accesso a un account appena creato prima della creazione dell'account nel backend.
Modalità di gestione Attendi i primi cinque 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.
Modalità di gestione Richiedi un nuovo token. Se utilizzi una delle nostre librerie client, consulta la relativa 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 I dati di accesso forniti corrispondono a un Account Google per il quale non è stato attivato Google Ads.
Modalità di gestione 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 su 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 trasmesso con l'intestazione HTTP non è corretto.
Modalità di gestione N/A
Suggerimenti per la prevenzione Assicurati di aver trasmesso il token di accesso corretto associato al tuo account. A volte viene confusa con i token di aggiornamento e i codici di autorizzazione. Per ottenere una credenziale che ti consenta di 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
RiepilogoImpossibile accedere all'account cliente perché non è in stato Attivato.
Cause comuni Questo accade quando l'account del cliente non aveva terminato la registrazione o è stato disattivato.
Modalità di gestione Accedi all'interfaccia utente di Google Ads e accertati 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 controllare in modo proattivo se l'account di un cliente è disattivato controllando lo stato ANNULLATO.
DEVELOPER_TOKEN_NOT_APPROVED
RiepilogoIl token sviluppatore è stato approvato soltanto per l'utilizzo con account di prova e ha tentato di accedere a un account non di prova.
Cause comuni Per accedere a un account non di prova è stato utilizzato un token sviluppatore di prova.
Modalità di gestione Accertati di voler accedere a un account non di prova. In tal caso, dovrai 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 da un solo account amministratore. Dopo aver effettuato una richiesta API Google Ads, il token sviluppatore viene accoppiato in modo permanente 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.
Modalità di gestione N/A
Suggerimenti per la prevenzione Se passi a un token sviluppatore per un nuovo account amministratore, devi creare un nuovo progetto della console API di Google per le richieste API di Google Ads che utilizzano il token del nuovo gestore.
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.
Modalità di gestione N/A
Suggerimenti per la prevenzione Specifica login-customer-id come ID account amministratore senza trattini (-). Le librerie client hanno un supporto integrato.