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 abbia gli ambiti richiesti. Un motivo comune di 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. 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.
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 gestirla
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 alla schermata per il consenso OAuth. Poi cambia lo stato di pubblicazione in In production per evitare che il token di aggiornamento scada tra 7 giorni.
123-456-7890 deve essere 1234567890. Per maggiori dettagli, consulta Inizia.
CLIENT_CUSTOMER_ID_IS_REQUIRED
Riepilogo
L'ID cliente non è stato specificato nell'intestazione HTTP.
Cause comuni
Non specificare un ID cliente nell'intestazione HTTP.
Come gestirla
N/A
Suggerimenti per la prevenzione
L'ID 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 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 per cui Google Ads non è attivo.
Come gestirla
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
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 trasmesso 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.
Il progetto Google Cloud ha solo l'accesso di prova e non può essere utilizzato per accedere agli account di produzione.
Cause comuni
È stato utilizzato un progetto Google Cloud con il livello di accesso di test 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.
Impossibile accedere all'account cliente perché non è in uno stato abilitato.
Cause comuni
Questo accade quando l'account cliente non ha completato la registrazione o è stato disattivato.
Come gestirla
Accedi alla UI di Google Ads e assicurati di aver completato la procedura di registrazione per questo account. Per gli account disattivati, consulta Riattiva un account Google Ads cancellato.
Suggerimenti per la prevenzione
Puoi verificare in modo proattivo se un account cliente è disattivato controllando se lo stato è CANCELLED.
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 gestirla
N/A
Suggerimenti per la prevenzione
Specifica login-customer-id come ID account amministratore senza trattini (-). Le librerie client hanno un supporto integrato per questa operazione.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Mancano le informazioni di cui ho bisogno","missingTheInformationINeed","thumb-down"],["Troppo complicato/troppi passaggi","tooComplicatedTooManySteps","thumb-down"],["Obsoleti","outOfDate","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Problema relativo a esempi/codice","samplesCodeIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2026-11-13 UTC."],[],[]]