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
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.
Questo operatore non può essere utilizzato con una sottoclasse di annuncio.
Cause comuni
Tentativo di modifica di attributi diversi da status dell'annuncio.
Modalità di gestione
N/A
Suggerimenti per la prevenzione
Una volta creato, l'annuncio non può essere modificato. Per modificare l'annuncio, devi crearne uno nuovo e rimuovere quello vecchio. Il valore status dell'annuncio è tuttavia modificabile mediante MutateAdGroupAds.
INVALID_INPUT
Riepilogo
Uno dei campi di un annuncio contiene caratteri non validi.
Cause comuni
L'uso di caratteri speciali negli URL.
Modalità di gestione
N/A
Suggerimenti per la prevenzione
Convalida gli URL nella tua app prima di effettuare la richiesta API.
Un gruppo di annunci è stato aggiunto o rinominato, ma il nome è già utilizzato da un altro gruppo di annunci.
Cause comuni
Creazione di un nuovo gruppo di annunci con il nome di un gruppo di annunci attivo o in pausa esistente.
Modalità di gestione
Registra l'errore e mostra un messaggio di errore all'utente, suggerendo facoltativamente un nome di gruppo di annunci univoco 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 mutazione con operazioni di creazione duplicate contenenti gli stessi dati binari.
Modalità di gestione
Crea la risorsa in una richiesta separata e collegala nella richiesta successiva; in alternativa, utilizza un ID temporaneo all'interno della stessa richiesta.
123-456-7890 deve essere 1234567890. Consulta la guida introduttiva per i dettagli.
CLIENT_CUSTOMER_ID_IS_REQUIRED
Riepilogo
L'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
Riepilogo
Nessun 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.
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.
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
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 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
Riepilogo
Il 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.
Impossibile 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
Riepilogo
Il 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.
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. 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.
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
Modalità di 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.
Una campagna è in fase di aggiunta o rinomina, ma il nome è già utilizzato da un'altra campagna.
Cause comuni
Creazione di una nuova campagna con il nome di una campagna esistente attiva o in pausa.
Modalità di gestione
Registra l'errore e mostra un messaggio di errore all'utente, suggerendo facoltativamente un nome di campagna univoco o mostrando l'elenco dei nomi in uso.
La richiesta contiene due parametri identici e ridondanti.
Cause comuni
N/A
Modalità di 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.
Modalità di gestione
Attendi circa 30 secondi, poi riprova. Se l'errore persiste, prova a suddividere la richiesta 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.
Modalità di gestione
Riprova le richieste non riuscite con 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 ed è necessario ripetere l'operazione.
Cause comuni
Questo errore si verifica quando l'API rileva internamente un problema temporaneo.
Modalità di gestione
Riprova le richieste non riuscite con 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 è valido.
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. Ad esempio, questo può accadere quando l'esempio di generazione delle credenziali utente viene eseguito più volte per le stesse credenziali client OAuth e l'autorizzazione dell'utente.
Modalità di gestione
Per rigenerare un token di aggiornamento per una determinata combinazione di credenziali utente e client OAuth dell'autorizzazione, 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 invalida qualsiasi token di accesso che è stato utilizzato per generare il token di aggiornamento.
Suggerimenti per la prevenzione
Assicurati di archiviare il token di aggiornamento in una posizione sicura per evitare la necessità di una rigenerazione.
La richiesta si riferiva a una risorsa che non è stata trovata.
Cause comuni
La richiesta ha tentato di mutare o altrimenti fare riferimento a una risorsa che non esiste o è stata rimossa. Oppure, il formato del nome della risorsa specificato non è corretto.
Modalità di 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 sulla libreria client, che includono la documentazione su come creare nomi di risorse validi in tutte le lingue supportate
Suggerimenti per la prevenzione
Non creare nomi di risorse manualmente. Utilizza uno dei metodi di supporto offerti dalle nostre librerie client.
La richiesta sta tentando di creare una risorsa che causerebbe il superamento di un limite specificato dal numero totale di queste risorse.
Cause comuni
Esistono diversi limiti al numero di risorse che possono esistere in determinati contesti.
Modalità di gestione
Identifica il limite che si è verificato esaminando la sezione Limiti di sistema. Riutilizza una risorsa esistente o rimuovi risorse per creare spazio per quelle nuove.
Suggerimenti per la prevenzione
Utilizza le query di ricerca per monitorare il numero di risorse soggette a limitazioni.
