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.
|
Suggerimenti per la prevenzione |
Vedi App non verificate.
|
|
|
CANNOT_USE_AD_SUBCLASS_FOR_OPERATOR |
Riepilogo | 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.
|
|
LINE_TOO_WIDE |
Riepilogo | Uno dei campi di un annuncio superava la lunghezza massima consentita. Consulta Informazioni sugli annunci di testo. |
Cause comuni |
Riga di testo troppo lunga.
|
Gestione |
N/A
|
Suggerimenti per la prevenzione |
Convalida la lunghezza della riga prima di effettuare la richiesta API.
|
|
|
AD_GROUP_AD_LABEL_ALREADY_EXISTS |
Riepilogo | Questa etichetta è già associata ad alcuni annunci. |
Cause comuni |
Stai tentando di associare l'etichetta ad annunci già associati.
|
Gestione |
N/A
|
Suggerimenti per la prevenzione |
Verifica innanzitutto se l'etichetta da aggiungere è già associata agli annunci.
|
|
CANNOT_OPERATE_ON_REMOVED_ADGROUPAD |
Riepilogo | Un'operazione ha tentato di aggiornare un annuncio rimosso. |
Cause comuni |
Una volta rimosso, l'annuncio non può più essere aggiornato e non è più possibile aggiornarne lo stato.
|
Gestione |
N/A
|
Suggerimenti per la prevenzione |
Verifica che il codice non tenti di aggiornare gli annunci rimossi.
|
|
|
INVALID_KEYWORD_TEXT |
Riepilogo | Il testo della parola chiave contiene caratteri non validi. Consulta la sezione Aggiungere parole chiave. |
Cause comuni |
Il testo della parola chiave contiene caratteri non validi.
|
Gestione |
N/A
|
Suggerimenti per la prevenzione |
Convalida il testo della parola chiave nella tua app prima di effettuare una richiesta all'API.
|
|
|
DUPLICATE_ADGROUP_NAME |
Riepilogo | 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.
|
Suggerimenti per la prevenzione |
N/A
|
|
|
DUPLICATE_ASSET |
Riepilogo | 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.
|
Suggerimenti per la prevenzione |
N/A
|
|
|
CLIENT_CUSTOMER_ID_INVALID |
Riepilogo | L'ID cliente non è un numero. |
Cause comuni |
Utilizzo di un ID cliente non corretto.
|
Gestione |
N/A
|
Suggerimenti per la prevenzione |
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.
|
|
|
CUSTOMER_NOT_ENABLED |
Riepilogo | 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.
|
Gestione |
Assicurati di voler accedere effettivamente a un account non di prova. 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 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.
|
Gestione |
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 API Google Ads che utilizzano il token del nuovo gestore.
|
|
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.
|
Gestione |
N/A
|
Suggerimenti per la prevenzione |
Specifica login-customer-id come ID account amministratore senza trattini (- ). Questa funzionalità è integrata nelle librerie client.
|
|
|
BID_TOO_MANY_FRACTIONAL_DIGITS |
Riepilogo | 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. |
Cause comuni |
N/A
|
Gestione |
N/A
|
Suggerimenti per la prevenzione |
Verifica se l'account partecipa a Google Ad Grants. In questo caso, limita le offerte CPC al massimo stabilito dal programma.
|
|
|
MONEY_AMOUNT_LESS_THAN_CURRENCY_MINIMUM_CPC |
Riepilogo | L'importo del budget è troppo basso. |
Cause comuni |
N/A
|
Gestione |
N/A
|
Suggerimenti per la prevenzione |
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.
|
|
|
DUPLICATE_CAMPAIGN_NAME |
Riepilogo | È 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.
|
Suggerimenti per la prevenzione |
N/A
|
|
|
KEYWORD_HAS_INVALID_CHARS |
Riepilogo | Aggiunta o modifica di parole chiave contenenti caratteri non validi. |
Cause comuni |
Utilizza caratteri speciali come ! @ % * nelle parole chiave.
|
Gestione |
N/A
|
Suggerimenti per la prevenzione |
Assicurati di non utilizzare caratteri non consentiti nelle parole chiave. Consulta la sezione Aggiungere parole chiave.
|
|
|
DUPLICATE_ELEMENT |
Riepilogo | 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 .
|
|
|
DEADLINE_EXCEEDED |
Riepilogo | 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.
|
Suggerimenti per la prevenzione |
Esamina la segmentazione per capire come può influire sulla dimensione di una risposta. Tieni presente le limitazioni del livello di trasporto gRPC.
|
|
INTERNAL_ERROR |
Riepilogo | 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.
|
|
|
RESOURCE_NOT_FOUND |
Riepilogo | 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.
|
|
|
EMPTY_LIST |
Riepilogo | Un elenco obbligatorio è vuoto. |
Cause comuni |
Trasferimento di un elenco vuoto di operazioni a un metodo mutate .
|
Gestione |
N/A
|
Suggerimenti per la prevenzione |
N/A
|
|
|
RESOURCE_EXHAUSTED |
Riepilogo | È stato superato un limite di frequenza di sistema. |
Cause comuni |
N/A
|
Gestione |
N/A
|
Suggerimenti per la prevenzione |
Imposta brevi ritardi tra le richieste o combina più operazioni in meno richieste.
|
|
|
TOO_LOW |
Riepilogo | Un valore era inferiore al minimo consentito. |
Cause comuni |
Se non specifichi di specificare un ID, viene generato il valore 0 .
|
Gestione |
N/A
|
Suggerimenti per la prevenzione |
Prendi nota di eventuali limitazioni all'intervallo documentate nel riferimento dell'API.
|
|
|
INVALID_INPUT |
Riepilogo | La richiesta non è nel formato corretto. |
Cause comuni |
Il formato dell'URL o dei contenuti della richiesta non è valido.
|
Gestione |
N/A
|
Suggerimenti per la prevenzione |
N/A
|
|
REQUIRED_FIELD_MISSING |
Riepilogo | Nella richiesta mancano le informazioni richieste. |
Cause comuni |
Campi obbligatori mancanti quando tenti di aggiungere un'entità.
|
Gestione |
Registra l'errore e mostra un messaggio all'utente. L'attributo fieldPath dell'errore indica quale campo manca.
|
Suggerimenti per la prevenzione |
Per sapere quali campi sono obbligatori, consulta il riferimento dell'API.
|
|
|
RESOURCE_LIMIT |
Riepilogo | La richiesta sta tentando di creare una risorsa che fa sì che il numero totale di queste risorse superi un limite specificato. |
Cause comuni |
Esistono più limiti al numero di risorse che possono esistere in determinati contesti.
|
Gestione |
Identifica il limite riscontrato esaminando 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 che presentano limitazioni.
|
|
|
TOO_LONG |
Riepilogo | La stringa assegnata al campo specificato è più lunga del limite. |
Cause comuni |
I titoli o le descrizioni degli annunci contengono troppo testo.
|
Gestione |
Identifica il limite riscontrato, modifica la stringa di conseguenza e invia nuovamente la richiesta.
|
Suggerimenti per la prevenzione |
Fai attenzione ai limiti di lunghezza delle stringhe.
|
|