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.auth.exceptions.RefreshError
|
invalid_grant |
Riepilogo | Il token è scaduto o revocato. |
Cause comuni |
A un progetto della piattaforma Google Cloud con una schermata di 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.
|
Modalità di gestione |
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 vai alla schermata per il 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.
|
|
|
CANNOT_USE_AD_SUBCLASS_FOR_OPERATOR |
Riepilogo | Questo operatore non può essere utilizzato con una sottoclasse di annuncio. |
Cause comuni |
Tentativo di modifica di attributi diversi da status dell'annuncio.
|
Modalità di gestione |
N/A
|
Suggerimenti per la prevenzione |
Una volta creato, l'annuncio non può essere modificato. Per modificare l'annuncio, devi crearne uno nuovo e rimuovere quello vecchio. Il valore status dell'annuncio è tuttavia modificabile mediante MutateAdGroupAds.
|
|
INVALID_INPUT |
Riepilogo | Uno dei campi di un annuncio contiene caratteri non validi. |
Cause comuni |
L'uso di caratteri speciali negli URL.
|
Modalità di gestione |
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 Informazioni sugli annunci di testo. |
Cause comuni |
Riga di testo troppo lunga.
|
Modalità di gestione |
N/A
|
Suggerimenti per la prevenzione |
Verifica la lunghezza della riga prima di effettuare la richiesta API.
|
|
|
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.
|
Modalità di gestione |
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.
|
Modalità di gestione |
N/A
|
Suggerimenti per la prevenzione |
Assicurati che il codice non tenti di aggiornare gli annunci rimossi.
|
|
|
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.
|
Modalità di gestione |
N/A
|
Suggerimenti per la prevenzione |
Convalida il testo della parola chiave nella tua app prima di inviare una richiesta all'API.
|
|
|
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.
|
Modalità di gestione |
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
|
|
|
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 mutazione con operazioni di creazione duplicate contenenti gli stessi dati binari.
|
Modalità di gestione |
Crea la risorsa in una richiesta separata e collegala nella richiesta successiva; in alternativa, utilizza un ID temporaneo all'interno della stessa richiesta.
|
Suggerimenti per la prevenzione |
N/A
|
|
|
CLIENT_CUSTOMER_ID_INVALID |
Riepilogo | L'ID cliente non è un numero. |
Cause comuni |
Uso di un ID cliente non corretto.
|
Modalità di gestione |
N/A
|
Suggerimenti per la prevenzione |
123-456-7890 deve essere 1234567890. Consulta la guida introduttiva per i dettagli.
|
|
CLIENT_CUSTOMER_ID_IS_REQUIRED |
Riepilogo | L'ID cliente del cliente non è stato specificato nell'intestazione HTTP. |
Cause comuni |
Non è specificato un ID cliente client nell'intestazione HTTP.
|
Modalità di gestione |
N/A
|
Suggerimenti per la prevenzione |
L'ID cliente è obbligatorio per tutte le chiamate, pertanto assicurati di averlo specificato nell'intestazione HTTP. Ti consigliamo di utilizzare le nostre librerie client per la gestione del tuo problema.
|
|
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 della creazione dell'account nel backend.
|
Modalità di gestione |
Attendi i primi cinque 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.
|
Modalità di gestione |
Richiedi un nuovo token. Se utilizzi una delle nostre librerie client, consulta la relativa documentazione su 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 il quale non è stato attivato Google Ads.
|
Modalità di gestione |
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 è corretto.
|
Modalità di gestione |
N/A
|
Suggerimenti per la prevenzione |
Assicurati di aver trasmesso il token di accesso corretto associato al tuo account. A volte viene confusa con i token di aggiornamento e i codici di autorizzazione. Per ottenere una credenziale che ti consenta di 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.
|
|
|
CUSTOMER_NOT_ENABLED |
Riepilogo | Impossibile accedere all'account cliente perché non è in stato Attivato. |
Cause comuni |
Questo accade quando l'account del cliente non aveva terminato la registrazione o è stato disattivato.
|
Modalità di gestione |
Accedi all'interfaccia utente di Google Ads e accertati 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 controllare in modo proattivo se l'account di un cliente è disattivato controllando lo stato ANNULLATO.
|
|
DEVELOPER_TOKEN_NOT_APPROVED |
Riepilogo | Il token sviluppatore è stato approvato soltanto per l'utilizzo con account di prova e ha tentato di accedere a un account non di prova. |
Cause comuni |
Per accedere a un account non di prova è stato utilizzato un token sviluppatore di prova.
|
Modalità di gestione |
Accertati di voler accedere a un account non di prova. In tal caso, dovrai 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 da un solo account amministratore. Dopo aver effettuato una richiesta API Google Ads, il token sviluppatore viene accoppiato 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.
|
Modalità di gestione |
N/A
|
Suggerimenti per la prevenzione |
Se passi a un token sviluppatore per un nuovo account amministratore, devi creare un nuovo progetto della console API di Google per le richieste API di Google Ads che utilizzano il token del nuovo gestore.
|
|
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.
|
Modalità di gestione |
N/A
|
Suggerimenti per la prevenzione |
Specifica login-customer-id come ID account amministratore senza trattini (- ). Le librerie client hanno un supporto integrato.
|
|
|
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
|
Modalità di gestione |
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
|
Modalità di gestione |
N/A
|
Suggerimenti per la prevenzione |
Verifica se l'account partecipa a Google Ad Grants. In tal caso, limita le offerte CPC al massimo previsto dal programma.
|
|
|
MONEY_AMOUNT_LESS_THAN_CURRENCY_MINIMUM_CPC |
Riepilogo | L'importo del budget è troppo basso. |
Cause comuni |
N/A
|
Modalità di gestione |
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 importo in micro a un importo nella valuta dell'account. |
Cause comuni |
N/A
|
Modalità di gestione |
N/A
|
Suggerimenti per la prevenzione |
Verifica che l'importo del budget sia divisibile per l'unità minima nella valuta dell'account.
|
|
|
DUPLICATE_CAMPAIGN_NAME |
Riepilogo | Una campagna è in fase di aggiunta o rinomina, 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.
|
Modalità di gestione |
Registra l'errore e mostra un messaggio di errore all'utente, suggerendo facoltativamente un nome di campagna univoco o mostrando l'elenco dei nomi in uso.
|
Suggerimenti per la prevenzione |
N/A
|
|
|
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.
|
Modalità di gestione |
N/A
|
Suggerimenti per la prevenzione |
Assicurati di non utilizzare caratteri non consentiti nelle parole chiave. Consulta la sezione Aggiungere parole chiave.
|
|
|
DUPLICATE_ELEMENT |
Riepilogo | La richiesta contiene due parametri identici e ridondanti. |
Cause comuni |
N/A
|
Modalità di gestione |
N/A
|
Suggerimenti per la prevenzione |
Rimuovi i duplicati (operazioni, parametri, elementi dell'elenco) prima di effettuare la richiesta. Cerca i campi che hanno il vincolo DistinctElements .
|
|
|
DEADLINE_EXCEEDED |
Riepilogo | La richiesta è scaduta e non è stato possibile completarla abbastanza rapidamente per restituire una risposta. |
Cause comuni |
È stata effettuata una richiesta di ricerca che ha generato una risposta troppo grande o una richiesta di modifica era troppo grande per essere elaborata.
|
Modalità di gestione |
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 |
Esamina la segmentazione per capire come può influire sulle dimensioni di una risposta. Considera 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.
|
Modalità di gestione |
Riprova 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 ripetere l'operazione. |
Cause comuni |
Questo errore si verifica quando l'API rileva internamente un problema temporaneo.
|
Modalità di gestione |
Riprova 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 formato del codice di autorizzazione scambiato con i token OAuth non è valido. |
Cause comuni |
Questo accade quando si cerca 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 l'esempio di generazione delle credenziali utente viene eseguito più volte per le stesse credenziali client OAuth e l'autorizzazione dell'utente.
|
Modalità di gestione |
Per rigenerare un token di aggiornamento per una determinata combinazione di credenziali utente e client OAuth dell'autorizzazione, 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 qualsiasi token di accesso che è stato utilizzato per generare il token di aggiornamento.
|
Suggerimenti per la prevenzione |
Assicurati di archiviare il token di aggiornamento in una posizione sicura per evitare la necessità di una rigenerazione.
|
|
|
RESOURCE_NOT_FOUND |
Riepilogo | La richiesta si riferiva a una risorsa che non è stata trovata. |
Cause comuni |
La richiesta ha tentato di mutare o altrimenti fare riferimento a una risorsa che non esiste o è stata rimossa. Oppure, il formato del nome della risorsa specificato non è corretto.
|
Modalità di gestione |
Utilizza una richiesta di ricerca per recuperare il nome di una risorsa esistente prima di inviare una richiesta di modifica. Consulta le nostre guide sulla libreria client, che includono la documentazione su come creare nomi di risorse validi in tutte le lingue supportate
|
Suggerimenti per la prevenzione |
Non creare nomi di risorse manualmente. Utilizza uno dei metodi di supporto offerti dalle nostre librerie client.
|
|
|
EMPTY_LIST |
Riepilogo | C'è un elenco obbligatorio vuoto. |
Cause comuni |
Passaggio di un elenco vuoto di operazioni a un metodo mutate .
|
Modalità di gestione |
N/A
|
Suggerimenti per la prevenzione |
N/A
|
|
|
RESOURCE_EXHAUSTED |
Riepilogo | È stato superato un limite di frequenza di sistema. |
Cause comuni |
N/A
|
Modalità di gestione |
N/A
|
Suggerimenti per la prevenzione |
Imposta brevi ritardi tra le richieste o combina più operazioni con meno richieste.
|
|
|
TOO_LOW |
Riepilogo | Un valore era inferiore al minimo consentito. |
Cause comuni |
Se viene dimenticato di specificare un ID, viene trasmesso il valore 0 .
|
Modalità di gestione |
N/A
|
Suggerimenti per la prevenzione |
Prendi nota di eventuali limitazioni di intervallo documentate nel riferimento API.
|
|
|
INVALID_INPUT |
Riepilogo | La richiesta non è corretta. |
Cause comuni |
L'URL o i contenuti della richiesta non sono corretti.
|
Modalità di gestione |
N/A
|
Suggerimenti per la prevenzione |
N/A
|
|
REQUIRED_FIELD_MISSING |
Riepilogo | Nella richiesta mancano informazioni obbligatorie. |
Cause comuni |
Campi obbligatori mancanti quando si tenta di aggiungere un'entità.
|
Modalità di gestione |
Registra l'errore e mostra un messaggio di errore all'utente. L'attributo fieldPath dell'errore indica quale campo manca.
|
Suggerimenti per la prevenzione |
Per sapere quali campi sono obbligatori, consulta il riferimento API.
|
|
|
RESOURCE_LIMIT |
Riepilogo | La richiesta sta tentando di creare una risorsa che causerebbe il superamento di un limite specificato dal numero totale di queste risorse. |
Cause comuni |
Esistono diversi limiti al numero di risorse che possono esistere in determinati contesti.
|
Modalità di gestione |
Identifica il limite che si è verificato esaminando la sezione 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 soggette a limitazioni.
|
|
|
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.
|
Modalità di gestione |
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.
|
|