Errori comuni

Questa pagina elenca gli errori comuni e fornisce suggerimenti su come prevenirli e gestirli. Per un elenco completo degli errori, consulta il riferimento agli errori, la guida alla comprensione degli errori API o la guida ai tipi di errori. Per ulteriore assistenza, contatta l'assistenza API Google Ads.

google.rpc.ErrorInfo

ACCESS_TOKEN_SCOPE_INSUFFICIENT

Riepilogo 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 disponga degli ambiti richiesti. Un motivo comune di questo errore è il riutilizzo di 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 disponga degli 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 rilasciato un token di aggiornamento che scade dopo 7 giorni. Come gestirla 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 alla schermata per il consenso OAuth. Poi cambia lo stato di pubblicazione in In production per evitare che il token di aggiornamento scada dopo 7 giorni. Suggerimenti per la prevenzione Vedi App non verificate.

AdError
CANNOT_USE_AD_SUBCLASS_FOR_OPERATOR	Riepilogo Questo operatore non può essere utilizzato con una sottoclasse di Annuncio. Cause comuni Tentativo di modificare attributi diversi da status dell'annuncio. Come gestirla N/A Suggerimenti per la prevenzione Una volta creato, un annuncio non può essere modificato. Se vuoi modificare l'annuncio, devi crearne uno nuovo e poi rimuovere quello vecchio. 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 gestirla 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 era più lungo della lunghezza massima consentita. Consulta la sezione Informazioni sugli annunci di testo. Cause comuni Avere una riga di testo troppo lunga. Come gestirla N/A Suggerimenti per la prevenzione Convalida la lunghezza della linea prima di effettuare la richiesta API.

AdGroupAdError
AD_GROUP_AD_LABEL_ALREADY_EXISTS	Riepilogo Questa etichetta è già associata ad alcuni annunci. Cause comuni Tentativo di associare l'etichetta ad annunci già associati. Come gestirla 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 un annuncio, non può più essere aggiornato, incluse le modifiche al suo stato. Come gestirla 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 gestirla 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 gestirla Registra l'errore e mostra un messaggio di errore all'utente, suggerendo facoltativamente 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 un'unica richiesta contengono un'operazione di creazione per un asset con gli stessi dati binari. Cause comuni Una richiesta di modifica con operazioni di creazione duplicate contenenti gli stessi dati binari. Come gestirla 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 non è un numero. Cause comuni Utilizzo di un ID cliente client non corretto. Come gestirla N/A Suggerimenti per la prevenzione 123-456-7890 deve essere 1234567890. Per maggiori dettagli, consulta la sezione Guida introduttiva.
CLIENT_CUSTOMER_ID_IS_REQUIRED	Riepilogo L'ID cliente client non è stato specificato nell'intestazione HTTP. Cause comuni Mancata specifica di un ID cliente client nell'intestazione HTTP. Come gestirla N/A Suggerimenti per la prevenzione L'ID cliente client è obbligatorio per tutte le chiamate, quindi assicurati di averne specificato uno nell'intestazione HTTP. Ti consigliamo 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 su cui Google Ads non è attivato. Come gestirla Assicurati di accedere con un account Google Ads valido (in genere l'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 poi 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 superato 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.

AuthorizationError
CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION	Riepilogo Il progetto Google Cloud ha accesso di test e non può essere utilizzato per accedere agli account di produzione. Cause comuni Un progetto Google Cloud con il livello di accesso test è stato utilizzato 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. Come gestirla Se stai eseguendo dei test, assicurati che la richiesta sia indirizzata a un account di prova. Se vuoi accedere a un account Google Ads di produzione, controlla il livello di accesso del tuo progetto Google Cloud nella pagina Panoramica dell'API Google Ads e aggiorna il livello di accesso del progetto ad accesso Explorer, di base o standard. Suggerimenti per la prevenzione N/A
CUSTOMER_NOT_ENABLED	Riepilogo Non è possibile accedere all'account cliente perché non è in stato abilitato. Cause comuni Ciò si verifica quando la registrazione dell'account cliente non è stata completata o l'account è stato disattivato. Come gestirla 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 cancellato. Suggerimenti per la prevenzione Puoi verificare in modo proattivo se un account cliente è disattivato controllando lo stato CANCELLATO.
USER_PERMISSION_DENIED	Riepilogo Il cliente autorizzato non ha accesso al cliente operativo. Cause comuni Autenticarsi come utente con accesso a un account amministratore, ma non 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 il supporto integrato per questa operazione.

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

CampaignBudgetError
MONEY_AMOUNT_LESS_THAN_CURRENCY_MINIMUM_CPC	Riepilogo L'importo del budget è troppo basso. Cause comuni N/A Come gestirla 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 micro importo a un importo nella valuta dell'account. Cause comuni N/A Come gestirla 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 Una campagna viene aggiunta o rinominata, 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. Come gestirla Registra l'errore e mostra un messaggio di errore all'utente, suggerendo facoltativamente un nome della campagna univoco o mostrando l'elenco dei nomi in uso. Suggerimenti per la prevenzione N/A
CANNOT_SET_CAMPAIGN_KEYWORD_MATCH_TYPE	Riepilogo Tentativo di modificare l'impostazione del tipo di corrispondenza delle parole chiave a livello di campagna in una campagna con AI Max attivato. Cause comuni Con AI Max attivato, le impostazioni di corrispondenza generica a livello di campagna vengono ritirate perché tutte le parole chiave vengono trattate come corrispondenza generica per impostazione predefinita. Il tentativo di impostare o modificare questo campo attiverà l'errore. Come gestirla Consiglia all'utente di utilizzare il parametro `disable_search_term_matching` a livello di gruppo di annunci anziché impostare la corrispondenza generica a livello di campagna. Suggerimenti per la prevenzione Evita di impostare `keyword_match_type` su `BROAD` (o qualsiasi altro valore) nella campagna se `ai_max_setting.enable_ai_max` è impostato su `true`. Attiva/disattiva la corrispondenza dei termini di ricerca a livello di gruppo di annunci utilizzando `disable_search_term_matching`.

CriterionError
KEYWORD_HAS_INVALID_CHARS	Riepilogo Aggiunta o modifica di parole chiave che contengono caratteri non validi. Cause comuni Utilizza caratteri speciali come ! @ % * nelle parole chiave. Come gestirla 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 gestirla N/A Suggerimenti per la prevenzione Rimuovi i duplicati (operazioni, parametri, elementi di elenco) prima di effettuare la richiesta. Cerca i campi che hanno il vincolo DistinctElements.

InternalError
DEADLINE_EXCEEDED	Riepilogo La richiesta è scaduta 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 oppure una richiesta di modifica troppo grande da elaborare. Come gestirla 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 come 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 gestirla Riprova a effettuare 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 e deve essere eseguito un nuovo tentativo. Cause comuni Questo errore si verifica quando l'API rileva internamente un problema temporaneo. Come gestirla Riprova a effettuare 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 codice di autorizzazione scambiato con i token OAuth non è valido. Cause comuni Ciò si verifica 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 client OAuth e per lo stesso utente autorizzato. Come gestirla Per rigenerare un token di aggiornamento per una determinata combinazione di credenziali client OAuth e utente autorizzante, 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 tutti i token di accesso che sono stati generati utilizzando il token di aggiornamento. Suggerimenti per la prevenzione Assicurati di archiviare il token di aggiornamento in una posizione sicura per evitare la necessità di rigenerarlo.

MutateError

RESOURCE_NOT_FOUND

Riepilogo La richiesta faceva riferimento a una risorsa che non è stato possibile trovare. 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 per la risorsa non è valido. Come gestirla Utilizza una richiesta di ricerca per recuperare il nome della risorsa per 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 ogni lingua supportata. Suggerimenti per la prevenzione Non creare manualmente i nomi delle risorse. Utilizza uno dei metodi helper offerti dalle nostre librerie client.

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

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

RangeError
TOO_LOW	Riepilogo Un valore era inferiore al minimo consentito. Cause comuni Mancato inserimento di un ID, che comporta il passaggio di un valore pari a 0. Come gestirla N/A Suggerimenti per la prevenzione Prendi nota di eventuali limitazioni di intervallo documentate nel riferimento API.

RequestError
INVALID_INPUT	Riepilogo La richiesta non è in un formato corretto. Cause comuni L'URL o il contenuto della richiesta non sono formattati correttamente. Come gestirla N/A Suggerimenti per la prevenzione N/A
REQUIRED_FIELD_MISSING	Riepilogo Nella richiesta mancano informazioni obbligatorie. Cause comuni Campi obbligatori mancanti durante il tentativo di aggiungere un'entità. Come gestirla Registra l'errore e mostra un messaggio di errore all'utente. L'attributo fieldPath dell'errore indica quale campo è mancante. Suggerimenti per la prevenzione Consulta il riferimento API per scoprire quali campi sono obbligatori.

ResourceCountLimitExceededError

RESOURCE_LIMIT

Riepilogo La richiesta tenta di creare una risorsa che farebbe superare il limite specificato per il numero totale di queste risorse. Cause comuni Esistono più limiti al numero di risorse che possono esistere in determinati contesti. Come gestirla Identifica il limite riscontrato esaminando i limiti di sistema. Riutilizza una risorsa esistente o rimuovi le 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.

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