Errori comuni

Questa pagina elenca gli errori 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.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 gestire 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 l'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

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 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	Riepilogo L'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	Riepilogo L'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	Riepilogo Nessun account trovato per l'ID cliente fornito nell'intestazione. Cause comuni Tentativo di accedere 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.
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 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	Riepilogo L'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	Riepilogo Il 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.
ORGANIZATION_NOT_ASSOCIATED_WITH_DEVELOPER_TOKEN	Riepilogo Il token sviluppatore è già associato a un'organizzazione Google Cloud e non può essere associato a un'altra organizzazione. Cause comuni Il token sviluppatore non è associato a un progetto Google Cloud nella stessa organizzazione Google Cloud del progetto Google Cloud utilizzato per effettuare inizialmente le richieste. Come gestire Se hai già effettuato richieste API con il token sviluppatore, assicurati che l'ID client OAuth sia associato ai progetti Google Cloud della stessa organizzazione Google Cloud. Suggerimenti per la prevenzione Assicurati che tutti i tuoi progetti Google Cloud siano associati alla stessa organizzazione Google Cloud. Un progetto Google Cloud può essere associato a un solo token sviluppatore, ma un token sviluppatore può essere associato a più progetti dell'organizzazione.
DEVELOPER_TOKEN_INVALID	Riepilogo Il token sviluppatore non è valido. Cause comuni Le cause più comuni di questo errore includono errori di battitura nel token sviluppatore o l'impostazione errata del token sviluppatore in un altro intestazione della richiesta. Come gestire Assicurati di copiare il token sviluppatore dal Centro API per evitare errori ortografici. Puoi trovare il Centro API nel tuo account amministratore Google Ads. Inoltre, assicurati di impostare il token sviluppatore nell'intestazione corretta. A volte i token sviluppatore vengono confusi con i token di aggiornamento OAuth e i codici di autorizzazione. Scopri di più sulle diverse intestazioni delle richieste qui. Suggerimenti per la prevenzione N/A

AuthorizationError
CUSTOMER_NOT_ENABLED	Riepilogo Non è 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	Riepilogo Il 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	Riepilogo Il 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	Riepilogo Il 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.