Errori comuni

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.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 gestire 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. Autentica di nuovo l'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 Platform 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 gestire 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 dell'API di Google e alla schermata di consenso OAuth. Poi, modifica lo stato di pubblicazione in In production seguendo queste istruzioni 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 Ad. Cause comuni Tentativo di 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 poi rimuovere quello vecchio. Tuttavia, il 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 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 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 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 Tentativo di associare l'etichetta ad annunci già associati. Come gestire 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, incluse le modifiche al suo 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 la sezione 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 facoltativamente un nome di gruppo di annunci univoco 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 mutazione con operazioni di creazione duplicate contenenti gli stessi dati binari. Come gestire Crea l'asset in una richiesta separata, quindi collegalo alla 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 gestire 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 gestire 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 gestire 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 gestire 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 gestire 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 gestire 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. Per maggiori dettagli, consulta la nostra guida su token di accesso e token di aggiornamento e OAuth2.
ORGANIZATION_NOT_ASSOCIATED_WITH_DEVELOPER_TOKEN	Riepilogo Il token sviluppatore è già associato a un'organizzazione Google Cloud e non può essere associato a un'altra organizzazione. Cause comuni Il token sviluppatore non è associato a un progetto Google Cloud nella stessa organizzazione Google Cloud del progetto Google Cloud utilizzato per effettuare originariamente le richieste. Come gestire Se hai già effettuato richieste API con il token sviluppatore, assicurati che l'ID client OAuth sia associato a progetti Google Cloud nella stessa organizzazione Google Cloud. Suggerimenti per la prevenzione Assicurati che tutti i tuoi progetti Google Cloud siano associati alla stessa organizzazione Google Cloud. Un progetto Google Cloud può essere associato a un solo token sviluppatore, ma un token sviluppatore può essere associato a più progetti nell'organizzazione.
DEVELOPER_TOKEN_INVALID	Riepilogo Il token sviluppatore non è valido. Cause comuni Le cause comuni di questo errore includono errori di battitura nel token sviluppatore o l'impostazione errata del token sviluppatore in un'intestazione di richiesta diversa. Come gestire Assicurati di copiare il token sviluppatore dal Centro API per evitare errori di battitura. Puoi trovare il Centro API nel tuo account amministratore Google Ads. Inoltre, assicurati di impostare il token sviluppatore nell'intestazione corretta. A volte i token sviluppatore vengono confusi con i codici di autorizzazione e i token di aggiornamento OAuth. Scopri di più sulle diverse intestazioni delle richieste qui. Suggerimenti per la prevenzione N/A

AuthorizationError
CUSTOMER_NOT_ENABLED	Riepilogo Non è possibile accedere all'account cliente perché non è in stato attivo. Cause comuni Ciò si verifica quando la registrazione dell'account cliente non è stata completata o l'account è stato disattivato. 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 Riattivare un account Google Ads chiuso. Suggerimenti per la prevenzione Puoi verificare in modo proattivo se un account cliente è disattivato controllando lo stato CANCELLED.
DEVELOPER_TOKEN_NOT_APPROVED	Riepilogo Il token sviluppatore è approvato solo per l'utilizzo con account di test e ha 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 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 effettuata una richiesta dell'API Google Ads, il token sviluppatore viene associato in modo permanente 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 dell'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 Autenticarsi come utente con accesso a un account amministratore, ma non specificare login-customer-id nella richiesta. Come gestire N/A Suggerimenti per la prevenzione Specifica login-customer-id come ID account amministratore senza trattini (-). Le librerie client supportano questa funzionalità.

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 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 micro importo 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 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 attiva o in pausa esistente. Come gestire 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

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 gestire N/A Suggerimenti per la prevenzione Assicurati di non utilizzare caratteri non consentiti nelle parole chiave. Consulta la sezione 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 di 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 troppo grande da elaborare. 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 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 gestire 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 e deve essere eseguito un nuovo tentativo. Cause comuni Questo errore si verifica quando l'API rileva internamente un problema temporaneo. Come gestire 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 è 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 gestire Per rigenerare un token di aggiornamento per una determinata combinazione di credenziali dell'utente autorizzante 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 invalida tutti i token di accesso utilizzati per generare il token di aggiornamento. Suggerimenti per la prevenzione Assicurati di archiviare il token di aggiornamento in un luogo sicuro 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 fornito per la risorsa non è valido. Come gestire 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 gestire 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 gestire 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 Mancata specifica di un ID, che comporta il passaggio di un valore pari a 0. Come gestire N/A Suggerimenti per la prevenzione Prendi nota di eventuali limitazioni di intervallo documentate nel riferimento API.

RequestError
INVALID_INPUT	Riepilogo La richiesta non è formattata correttamente. Cause comuni L'URL o il contenuto della richiesta non è valido. Come gestire 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 gestire 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 risorse. Cause comuni Esistono più 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 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 gestire 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.