Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
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
Riepilogo
Il token è scaduto o revocato.
Cause comuni
Per un progetto Google Cloud Platform con una schermata per il consenso OAuth configurata per un tipo di utente esterno e con stato di pubblicazione Testing viene emesso un token di aggiornamento in scadenza tra 7 giorni.
Gestione
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 API di Google e vai alla schermata per il consenso OAuth. Quindi, modifica lo stato di pubblicazione impostandolo su In production seguendo queste istruzioni per evitare che il token di aggiornamento scada dopo 7 giorni.
Questo operatore non può essere utilizzato con una sottoclasse di Annuncio.
Cause comuni
Stai tentando di modificare attributi diversi da status dell'annuncio.
Gestione
N/A
Suggerimenti per la prevenzione
Una volta creato, l'annuncio non può essere modificato. Se desideri modificare l'annuncio, devi crearne uno nuovo e rimuovere quello vecchio. Il status dell'annuncio, tuttavia, può essere modificato utilizzando MutateAdGroupAds.
INVALID_INPUT
Riepilogo
Uno dei campi di un annuncio contiene caratteri non validi.
Cause comuni
Utilizzo di caratteri speciali negli URL.
Gestione
N/A
Suggerimenti per la prevenzione
Convalida gli URL nella tua app prima di effettuare la richiesta API.
Un gruppo di annunci viene aggiunto o rinominato, ma il nome è già utilizzato da un altro gruppo di annunci.
Cause comuni
Creare un nuovo gruppo di annunci con il nome di un gruppo di annunci attivo o in pausa esistente.
Gestione
Registra l'errore e mostra un messaggio di errore all'utente, facoltativamente suggerendo un nome univoco per il gruppo di annunci o mostrando l'elenco dei nomi in uso.
Due operazioni in una singola richiesta contengono un'operazione di creazione per una risorsa con gli stessi dati binari.
Cause comuni
Una richiesta di modifica con operazioni di creazione duplicate contenenti gli stessi dati binari.
Gestione
Crea la risorsa in una richiesta separata e poi collegala nella richiesta successiva oppure utilizza un ID temporaneo all'interno della stessa richiesta.
123-456-7890 deve essere 1234567890. Per informazioni dettagliate, consulta la Guida introduttiva.
CLIENT_CUSTOMER_ID_IS_REQUIRED
Riepilogo
L'ID cliente del client non è stato specificato nell'intestazione HTTP.
Cause comuni
Non è stato specificato un ID cliente client nell'intestazione HTTP.
Gestione
N/A
Suggerimenti per la prevenzione
L'ID cliente è obbligatorio per tutte le chiamate, quindi assicurati di averne specificato uno nell'intestazione HTTP. Prendi in considerazione l'utilizzo delle nostre librerie client, che si occupano di gestire questo problema.
CUSTOMER_NOT_FOUND
Riepilogo
Nessun account trovato per l'ID cliente fornito nell'intestazione.
Cause comuni
Tentativo di accesso a un account appena creato prima della sua creazione nel backend.
Gestione
Attendi cinque minuti iniziali, quindi riprova ogni 30 secondi.
Suggerimenti per la prevenzione
Attendi alcuni minuti dopo la creazione dell'account prima di inviare delle 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.
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
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 quelli di un Account Google per il quale non è attivato Google Ads.
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 alla pagina 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.
Gestione
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 in grado di accedere a tutti gli account cliente di un account amministratore, verifica di disporre del token di aggiornamento per l'account amministratore. Per ulteriori dettagli, consulta la nostra guida su token di accesso e token di aggiornamento e OAuth2.
Impossibile accedere all'account del cliente perché non è in stato Attivato.
Cause comuni
Questo si verifica quando l'account del cliente non aveva terminato la registrazione o è stato disattivato.
Gestione
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 è stato disattivato controllando lo stato ANNULLATO.
DEVELOPER_TOKEN_NOT_APPROVED
Riepilogo
Il token sviluppatore è approvato solo per l'uso con gli 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.
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 da un solo account amministratore. Una volta effettuata una richiesta API Google Ads, il token sviluppatore viene definitivamente associato 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.
Il valore dell'offerta non è un multiplo esatto dell'unità minima della valuta dell'account. Ad esempio, € 0,015 (15000 in micro) non è un'offerta valida.
Cause comuni
N/A
Gestione
N/A
Suggerimenti per la prevenzione
Verifica che le offerte siano multipli dell'unità minima per la valuta dell'account.
BID_TOO_BIG
Riepilogo
L'errore viene restituito anche se l'offerta rientra nel budget della campagna.
Verifica che l'importo del budget sia maggiore o uguale all'unità minima della valuta dell'account.
NON_MULTIPLE_OF_MINIMUM_CURRENCY_UNIT
Riepilogo
L'importo del budget presenterà troppe cifre decimali significative quando viene convertito da un micro importo a un importo nella valuta dell'account.
Cause comuni
N/A
Gestione
N/A
Suggerimenti per la prevenzione
Verifica che l'importo del budget sia divisibile per l'unità minima impostata nella valuta dell'account.
È in corso l'aggiunta o il nome di una campagna, ma il nome è già utilizzato da un'altra campagna.
Cause comuni
Creazione di una nuova campagna con il nome di una campagna attiva o in pausa esistente.
Gestione
Registra l'errore e mostra un messaggio di errore all'utente, facoltativamente suggerendo un nome univoco per la campagna o mostrando l'elenco dei nomi in uso.
La richiesta contiene due parametri identici e ridondanti.
Cause comuni
N/A
Gestione
N/A
Suggerimenti per la prevenzione
Rimuovi i duplicati (operazioni, parametri, elementi dell'elenco) prima di effettuare la richiesta. Cerca i campi che hanno il vincolo DistinctElements.
La richiesta è scaduta e non è stato possibile completarla abbastanza rapidamente per restituire una risposta.
Cause comuni
È stata effettuata una richiesta di ricerca che ha generato una risposta troppo grande o una richiesta di modifica era troppo grande per essere elaborata.
Gestione
Attendi circa 30 secondi, poi riprova. Se l'errore persiste, prova a suddividerla in più richieste di dimensioni inferiori che possono essere completate più rapidamente.
Si è verificato un problema imprevisto durante l'elaborazione della richiesta.
Cause comuni
L'API non funziona correttamente a causa di un bug.
Gestione
Riprova a inviare le richieste non riuscite a causa di questo errore, utilizzando una pianificazione di backoff esponenziale per i nuovi tentativi.
Suggerimenti per la prevenzione
N/A
TRANSIENT_ERROR
Riepilogo
Si è verificato un errore interno temporaneo. È necessario eseguire un nuovo tentativo.
Cause comuni
Questo errore si verifica quando l'API rileva internamente un problema temporaneo.
Gestione
Riprova a inviare le richieste non riuscite a causa di questo errore, utilizzando una pianificazione di backoff esponenziale per i nuovi tentativi.
Suggerimenti per la prevenzione
N/A
InvalidGrantError
invalid_grant (malformed auth code)
Riepilogo
Il formato del codice di autorizzazione scambiato con i token OAuth non era corretto.
Cause comuni
Questo accade quando si cerca di generare un token di aggiornamento per un utente a cui è già stato concesso l'accesso all'applicazione richiedente. Questo può accadere, ad esempio, quando si esegue l'esempio di generazione di credenziali utente più di una volta per le stesse credenziali client OAuth e si autorizza l'utente.
Gestione
Per rigenerare un token di aggiornamento per una determinata combinazione di autorizzazione delle credenziali dell'utente e del client OAuth, revoca un token di aggiornamento esistente. Tieni presente che la revoca di un token lo rende inutilizzabile per l'accesso all'API Google Ads e rende non validi gli eventuali token di accesso generati dal token di aggiornamento utilizzato.
Suggerimenti per la prevenzione
Assicurati di conservare il token di aggiornamento in un luogo sicuro per evitare la rigenerazione.
La richiesta fa riferimento a una risorsa che non è stato possibile trovare.
Cause comuni
La richiesta ha tentato di modificare o altrimenti fare riferimento a una risorsa che non esiste o è stata rimossa. oppure il nome della risorsa specificata non è nel formato corretto.
Gestione
Utilizza una richiesta di ricerca per recuperare il nome di una risorsa esistente prima di inviare una richiesta di modifica. Consulta le nostre guide alle librerie client, che includono la documentazione su come creare nomi di risorse validi in tutte le lingue supportate
Suggerimenti per la prevenzione
Non creare nomi delle risorse manualmente. Utilizza uno dei metodi helper offerti dalle nostre librerie client.
