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 supporto, contatta il team di assistenza dell'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 abbia gli 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 emesso un token di aggiornamento che scade tra 7 giorni. Come gestirla 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 alla schermata per il consenso OAuth. Poi cambia lo stato di pubblicazione in In production per evitare che il token di aggiornamento scada tra 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 Ad. 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. Tuttavia, l'elemento status dell'annuncio è 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 l'articolo Informazioni sugli annunci di testo. Cause comuni Righe di testo troppo lunghe. Come gestirla 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 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 Aggiungi 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 unico 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 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 nella 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 non corretto. Come gestirla N/A Suggerimenti per la prevenzione 123-456-7890 deve essere 1234567890. Per maggiori dettagli, consulta Inizia.
CLIENT_CUSTOMER_ID_IS_REQUIRED	Riepilogo L'ID cliente client non è stato specificato nell'intestazione HTTP. Cause comuni Non specificare un ID cliente 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 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 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 trasmesso con l'intestazione HTTP non è 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 solo l'accesso di prova e non può essere utilizzato per accedere agli account di produzione. Cause comuni È stato utilizzato un progetto Google Cloud con il livello di accesso di test 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 ed esegui l'upgrade del livello di accesso del progetto all'accesso Explorer, Base o Standard. Suggerimenti per la prevenzione N/A
CUSTOMER_NOT_ENABLED	Riepilogo Impossibile accedere all'account cliente perché non è in uno 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 Riattiva 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 Autenticazione come utente con accesso a un account amministratore, ma senza 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 un 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 previsto 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 microimporto 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 dell'elenco) prima di effettuare la richiesta. Cerca i campi con 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 era troppo grande per essere elaborata. 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 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 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 ed è necessario riprovare. Cause comuni Questo errore si verifica quando l'API riscontra 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 era nel formato corretto. 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 Genera credenziali utente più di una volta per le stesse credenziali client OAuth e lo stesso utente autorizzante. 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 generati con 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 che non è stato possibile trovare. Cause comuni La richiesta ha tentato di modificare o fare riferimento in altro modo a una risorsa che non esiste o è stata rimossa. In alternativa, il nome della risorsa fornito non è nel formato corretto. Come gestirla 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 ogni linguaggio supportato. 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 Tieni presente eventuali limitazioni degli intervalli 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 La richiesta non contiene le informazioni richieste. 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 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 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.