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.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 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. 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, potresti dover 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 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 gestire 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 dell'API di Google e alla schermata di 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	Riepilogo L'ID cliente non è un numero. Cause comuni Utilizzo di un ID cliente client non corretto. Come gestire 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 gestire N/A Suggerimenti per la prevenzione L'ID cliente è 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 gestire 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 gestire 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 gestire 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 gestire 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. 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 originariamente le richieste. Come gestire Se hai già effettuato richieste API con il token sviluppatore, assicurati che l'ID client OAuth sia associato a progetti Google Cloud nella 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 nell'organizzazione.
DEVELOPER_TOKEN_INVALID	Riepilogo Il token sviluppatore non è valido. Cause comuni Le cause comuni di questo errore includono errori di battitura nel token sviluppatore o l'impostazione errata del token sviluppatore in un'intestazione di richiesta diversa. Come gestire Assicurati di copiare il token sviluppatore dal Centro API per evitare errori di battitura. 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 e i codici di autorizzazione OAuth. 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 è in stato attivo. Cause comuni Ciò si verifica quando la registrazione dell'account cliente non è stata completata o l'account è stato disattivato. 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 Riattivare un account Google Ads chiuso. Suggerimenti per la prevenzione Puoi verificare in modo proattivo se un account cliente è disattivato controllando lo stato CANCELLED.
DEVELOPER_TOKEN_NOT_APPROVED	Riepilogo Il token sviluppatore è approvato solo per l'utilizzo con account di test e ha 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 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 effettuata una richiesta dell'API Google Ads, il token sviluppatore viene associato 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. 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 dell'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 Autenticarsi come utente con accesso a un account amministratore, ma non specificare login-customer-id nella richiesta. Come gestire N/A Suggerimenti per la prevenzione Specifica login-customer-id come ID account amministratore senza trattini (-). Le librerie client supportano questa funzionalità.