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 Informazioni sugli errori dell'API o la guida 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 è che stai riutilizzando 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 abbia gli 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 dopo 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 entro 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 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 precedente. Tuttavia, il campo 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 Una riga di testo troppo lunga. 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 Innanzitutto, verifica 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 è 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. 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 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, poi collegalo nella richiesta successiva oppure utilizza un ID temporaneo nella stessa richiesta. Suggerimenti per la prevenzione N/A
PARTNER_PROMOTION_ID_TYPE_INCOMPATIBLE	Riepilogo L'ID promozione partner utilizza una variante oneof (int_value o string_value) che l'integrazione della promozione dell'account non accetta. Cause comuni Impostazione del campo promotion_asset.external_redeem_info.partner_promotion_id.int_value quando l'integrazione di utilizzo del cliente richiede la variante string_value o impostazione del campo string_value quando l'integrazione richiede la variante int_value. Come gestirla Aggiorna la richiesta di creazione per compilare la variante ExternalPartnerId (int_value o string_value) accettata dall'integrazione delle promozioni dell'account. Per maggiori dettagli, consulta Monitorare gli utilizzi delle promozioni esterne. Suggerimenti per la prevenzione Prima di creare un messaggio PromotionAsset con il campo external_redeem_info, verifica quale formato dell'identificatore della promozione (int_value o string_value) utilizza l'integrazione per l'utilizzo presso il punto vendita (POS).

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 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 è 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 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 per cui Google Ads non è attivo. 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 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 era corretto. Come gestirla 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 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 degli utenti.

AuthorizationError
CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION	Riepilogo Il progetto Google Cloud ha solo l'accesso di test 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 dell'API v24 e precedenti, questa condizione restituisce AuthorizationError.ACTION_NOT_PERMITTED. Come gestirla Se stai eseguendo un test, assicurati che la richiesta abbia come target 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 Questo accade quando l'account cliente non ha completato la registrazione o è stato disattivato. Come gestirla Accedi alla UI 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 chiuso. Suggerimenti per la prevenzione Puoi verificare in modo proattivo se un account cliente è disattivato controllando se lo stato è CANCELLED.
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 dispongono di 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 micros) 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 È in corso l'aggiunta o la ridenominazione 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. 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 su 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 Aggiungi parole chiave.

DemandGenCampaignError

CANNOT_ACTIVATE_MIGRATED_CAMPAIGN

Riepilogo Una campagna Demand Gen di cui è stata eseguita la migrazione non può essere attivata prima della rimozione della campagna originale o mentre è già attiva un'altra campagna di cui è stata eseguita la migrazione per la stessa campagna originale. Cause comuni Aggiornamento dello status di una campagna Demand Gen di cui è stata eseguita la migrazione a ENABLED quando la campagna di origine originale non viene rimossa o un'altra campagna Demand Gen di cui è stata eseguita la migrazione dalla stessa campagna originale è già ENABLED. Nelle versioni API v25 e precedenti, questa condizione restituisce RequestError.UNKNOWN. Come gestirla Rimuovi la campagna di origine originale utilizzando CampaignOperation.remove (in anticipo o nella stessa richiesta di modifica) prima di attivare la campagna Demand Gen di cui è stata eseguita la migrazione e verifica che non siano attive altre campagne Demand Gen di cui è stata eseguita la migrazione dalla stessa campagna originale. Per maggiori dettagli, consulta Attiva le campagne migrate. Suggerimenti per la prevenzione Se monitori gli ID delle campagne di origine originali e delle campagne Demand Gen di cui è stata eseguita la migrazione, esegui una query su campaign.status prima di impostare status su ENABLED in una campagna di cui è stata eseguita la migrazione oppure includi CampaignOperation.remove per la campagna originale nella stessa richiesta di modifica.

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 di dimensioni inferiori 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 inviare 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 rileva internamente un problema temporaneo. Come gestirla Riprova a inviare 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 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 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 utente autorizzante e credenziali 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 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 un numero inferiore di richieste.

RangeError
TOO_LOW	Riepilogo Un valore era inferiore al minimo consentito. Cause comuni Dimenticare di specificare un ID, il che comporta il passaggio di un valore 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 i contenuti della richiesta hanno un formato non corretto. 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 manca. Suggerimenti per la prevenzione Consulta il riferimento API per scoprire quali campi sono obbligatori.

ResourceCountLimitExceededError

RESOURCE_LIMIT

Riepilogo La richiesta sta tentando di creare una risorsa che comporterebbe il superamento di un limite specificato per il numero totale di risorse. Cause comuni Esistono più limiti al numero di risorse che possono esistere in determinati contesti. Come gestirla Identifica il limite che stai riscontrando 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 riscontrato, modifica la stringa di conseguenza e invia nuovamente la richiesta. Suggerimenti per la prevenzione Tieni presente i limiti di lunghezza delle stringhe.