Errori comuni

Questa pagina elenca gli errori più comuni e fornisce suggerimenti per evitarli e gestirli. Per un elenco completo degli errori, consulta i riferimenti all'errore. Per ulteriore assistenza, visita il nostro forum.

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 gestire Lo stato di pubblicazione del tuo progetto Google è Testing, pertanto il token di aggiornamento scade ogni 7 giorni e viene visualizzato un errore invalid_grant. Vai alla console dell'API di Google e vai alla schermata del consenso OAuth. Quindi, modifica lo stato di pubblicazione in In production seguendo queste istruzioni per evitare che il token di aggiornamento scada tra 7 giorni. Suggerimenti per la prevenzione Consulta la sezione App non verificate.

AdError
CANNOT_USE_AD_SUBCLASS_FOR_OPERATOR	Riepilogo Questo operatore non può essere utilizzato con una sottoclasse di Annuncio. Cause comuni Hai provato a modificare attributi diversi da status dell'annuncio. Come gestire N/A Suggerimenti per la prevenzione Una volta creato, l'annuncio non può essere modificato. Se vuoi modificare l'annuncio, devi crearne uno nuovo e rimuovere quello precedente. Il status dell'annuncio è tuttavia modificabile utilizzando MutateAdGroupAds.
INVALID_INPUT	Riepilogo Uno dei campi di un annuncio contiene caratteri non validi. Cause comuni Utilizzo di caratteri speciali negli URL. Come gestire 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 è più lungo della lunghezza massima consentita. Consulta Informazioni sugli annunci di testo. Cause comuni Una riga di testo troppo lunga. Come gestire N/A Suggerimenti per la prevenzione Convalida la lunghezza della riga prima di effettuare la richiesta API.

AdGroupAdError
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. Come gestire N/A Suggerimenti per la prevenzione Controlla 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, incluse le modifiche al relativo stato. Come gestire N/A Suggerimenti per la prevenzione Assicurati che il codice non tenti di aggiornare gli annunci rimossi.

AdGroupCriterionError
INVALID_KEYWORD_TEXT	Riepilogo Il testo della parola chiave contiene caratteri non validi. Consulta Aggiungere parole chiave. Cause comuni Il testo della parola chiave contiene caratteri non validi. Come gestire N/A Suggerimenti per la prevenzione Convalida il testo della parola chiave nella tua app prima di effettuare una richiesta all'API.

AdGroupError

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 Creazione di un nuovo gruppo di annunci con il nome di un gruppo di annunci attivo o in pausa esistente. Come gestire Registra l'errore e mostra un messaggio di errore all'utente, suggerendo eventualmente un nome univoco per il gruppo di annunci o mostrando l'elenco dei nomi in uso. Suggerimenti per la prevenzione N/A

AssetError

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. Come gestire Crea l'asset in una richiesta separata, quindi collegalo nella richiesta successiva oppure utilizza un ID temporaneo all'interno della stessa richiesta. Suggerimenti per la prevenzione N/A

AuthenticationError
CLIENT_CUSTOMER_ID_INVALID	Riepilogo L'ID cliente del cliente non è un numero. Cause comuni Utilizzo di un ID cliente del cliente non corretto. Come gestire N/A Suggerimenti per la prevenzione 123-456-7890 deve essere 1234567890. Per maggiori dettagli, consulta la guida introduttiva.
CLIENT_CUSTOMER_ID_IS_REQUIRED	Riepilogo L'ID cliente del cliente non è stato specificato nell'intestazione HTTP. Cause comuni Non è stato specificato un ID cliente del client nell'intestazione HTTP. Come gestire N/A Suggerimenti per la prevenzione L'ID cliente del 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 accesso a un account appena creato prima che l'account venga creato nel backend. Come gestire Attendi inizialmente 5 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. Come gestire Richiedi un nuovo token. Se utilizzi una delle nostre librerie client, consulta la relativa documentazione su come aggiornare il token. Suggerimenti per la prevenzione Memorizza 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 a nessun account Google Ads. Cause comuni I dati di accesso forniti corrispondono a un Account Google in cui Google Ads non è attivo. Come gestire Per il flusso OAuth, assicurati di accedere con un account Google Ads valido (in genere il tuo account amministratore). 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 a 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 passato con l'intestazione HTTP non era corretto. Come gestire N/A Suggerimenti per la prevenzione Assicurati di aver passato 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.

AuthorizationError
CUSTOMER_NOT_ENABLED	Riepilogo Non è possibile accedere all'account cliente perché non è attivo. Cause comuni Questo accade quando la registrazione dell'account cliente non è stata completata o è stata disattivata. 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 l'articolo Riattivare un account Google Ads chiuso. Suggerimenti per la prevenzione Puoi verificare in modo proattivo se un account cliente è disattivato controllando se lo stato è CANCELED (ANNULLATO).
DEVELOPER_TOKEN_NOT_APPROVED	Riepilogo Il token sviluppatore è approvato solo per l'utilizzo con account di test ed è stato 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 effettivamente 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 inviata una richiesta all'API Google Ads, il token sviluppatore viene accoppiato definitivamente 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 all'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 Autenticazione come utente con accesso a un account amministratore, ma senza specificare login-customer-id nella richiesta. Come gestire N/A Suggerimenti per la prevenzione Specifica login-customer-id come ID account amministratore senza i trattini (-). Le librerie client hanno il supporto integrato per questo.

BiddingError
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 Come gestire 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 Come gestire N/A Suggerimenti per la prevenzione Controlla se l'account partecipa a Google Ad Grants. In questo caso, limita le offerte CPC al valore massimo prescritto dal programma.

CampaignBudgetError
MONEY_AMOUNT_LESS_THAN_CURRENCY_MINIMUM_CPC	Riepilogo L'importo del budget è troppo basso. Cause comuni N/A Come gestire N/A Suggerimenti per la prevenzione Verifica che l'importo del budget sia maggiore o uguale all'unità minima per la valuta dell'account.
NON_MULTIPLE_OF_MINIMUM_CURRENCY_UNIT	Riepilogo L'importo del budget avrà troppe cifre decimali significative quando viene convertito da un microimporto a un importo nella valuta dell'account. Cause comuni N/A Come gestire N/A Suggerimenti per la prevenzione Verifica che l'importo del budget sia divisibile per l'unità minima della valuta dell'account.

CampaignError

DUPLICATE_CAMPAIGN_NAME

Riepilogo Stai aggiungendo o rinominando 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. Come gestire Registra l'errore e mostra un messaggio di errore all'utente, suggerendo eventualmente un nome univoco per la campagna o mostrando l'elenco dei nomi in uso. Suggerimenti per la prevenzione N/A

CriterionError
KEYWORD_HAS_INVALID_CHARS	Riepilogo Aggiunta o modifica di parole chiave contenenti caratteri non validi. Cause comuni Utilizzare caratteri speciali come ! @ % * nelle parole chiave. Come gestire N/A Suggerimenti per la prevenzione Assicurati di non utilizzare caratteri non consentiti nelle parole chiave. Consulta Aggiungere parole chiave.

DistinctError
DUPLICATE_ELEMENT	Riepilogo La richiesta contiene due parametri identici e ridondanti. Cause comuni N/A Come gestire N/A Suggerimenti per la prevenzione Rimuovi i duplicati (operazioni, parametri, elementi dell'elenco) prima di effettuare la richiesta. Cerca i campi con il vincolo DistinctElements.

InternalError
DEADLINE_EXCEEDED	Riepilogo La richiesta ha superato il tempo limite e non è stato possibile completarla abbastanza rapidamente da restituire una risposta. Cause comuni È stata effettuata una richiesta di ricerca che ha generato una risposta troppo grande o una richiesta di mutazione troppo grande per essere elaborata. Come gestire Attendi circa 30 secondi, poi riprova. Se l'errore persiste, prova a suddividere la richiesta in più richieste più piccole che possono essere completate più rapidamente. Suggerimenti per la prevenzione Consulta la sezione Segmentazione per capire in che modo può influire sulle dimensioni 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. Come gestire Riprova tutte le richieste non riuscite con questo errore utilizzando una pianificazione del backoff esponenziale per i nuovi tentativi. Suggerimenti per la prevenzione N/A
TRANSIENT_ERROR	Riepilogo Si è verificato un errore interno temporaneo ed è necessario eseguire un nuovo tentativo. Cause comuni Questo errore si verifica quando l'API riscontra internamente un problema temporaneo. Come gestire Riprova tutte le richieste non riuscite con questo errore utilizzando una pianificazione del backoff esponenziale per i nuovi tentativi. Suggerimenti per la prevenzione N/A

InvalidGrantError

invalid_grant (malformed auth code)

Riepilogo Il codice di autorizzazione scambiato per i token OAuth non è stato formato correttamente. Cause comuni Questo accade quando si tenta 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 esegui l'esempio di generazione delle credenziali utente più di una volta per le stesse credenziali del client OAuth e lo stesso utente che esegue l'autorizzazione. Come gestire Per rigenerare un token di aggiornamento per una determinata combinazione di credenziali dell'utente che effettua l'autorizzazione e del client OAuth, revocale 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 tutti i token di accesso per i quali è stato utilizzato il token di aggiornamento. Suggerimenti per la prevenzione Assicurati di archiviare il token di aggiornamento in un luogo sicuro per evitare di doverlo rigenerare.

MutateError

RESOURCE_NOT_FOUND

Riepilogo La richiesta faceva riferimento a una risorsa non trovata. Cause comuni La richiesta ha tentato di modificare o fare riferimento a una risorsa che non esiste o è stata rimossa. In alternativa, il nome della risorsa specificato non è valido. Come gestire Utilizza una richiesta di ricerca per recuperare il nome di una risorsa esistente prima di inviare una richiesta di modifica. Consulta le nostre guide alla libreria client, che includono la documentazione su come creare nomi di risorse validi in ogni lingua supportata Suggerimenti per la prevenzione Non creare i nomi delle risorse manualmente. Utilizza uno dei metodi di assistenza offerti dalle nostre librerie client.

NotEmptyError
EMPTY_LIST	Riepilogo Un elenco obbligatorio è vuoto. Cause comuni Passare un elenco vuoto di operazioni a un metodo mutate. Come gestire N/A Suggerimenti per la prevenzione N/A

QuotaError
RESOURCE_EXHAUSTED	Riepilogo È stato superato un limite di frequenza di sistema. Cause comuni N/A Come gestire N/A Suggerimenti per la prevenzione Configura brevi ritardi tra le richieste o combina più operazioni in meno richieste.

RangeError
TOO_LOW	Riepilogo Un valore è inferiore al minimo consentito. Cause comuni Se dimentichi di specificare un ID, viene passato un valore 0. Come gestire N/A Suggerimenti per la prevenzione Tieni presente eventuali limitazioni di intervallo documentate nella documentazione di riferimento dell'API.

RequestError
INVALID_INPUT	Riepilogo La richiesta non è valida. Cause comuni L'URL o i contenuti della richiesta non sono validi. Come gestire N/A Suggerimenti per la prevenzione N/A
REQUIRED_FIELD_MISSING	Riepilogo Nella richiesta mancano le informazioni richieste. Cause comuni Mancano i campi obbligatori quando si tenta di aggiungere un'entità. Come gestire Registra l'errore e mostra un messaggio di errore all'utente. L'attributo fieldPath dell'errore indica quale campo manca. Suggerimenti per la prevenzione Consulta il riferimento all'API per scoprire quali campi sono obbligatori.

ResourceCountLimitExceededError

RESOURCE_LIMIT

Riepilogo La richiesta tenta di creare una risorsa che causerebbe il superamento di un limite specificato per il numero totale di risorse. Cause comuni Esistono diversi limiti al numero di risorse che possono esistere in determinati contesti. Come gestire Identifica il limite riscontrato esaminando i 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 con limitazioni.

StringLengthError
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. Come gestire Identifica il limite riscontrato, modifica la stringa di conseguenza e invia di nuovo la richiesta. Suggerimenti per la prevenzione Tieni presente i limiti di lunghezza delle stringhe.