Package google.ads.searchads360.v0.errors

Indice

AuthenticationErrorEnum

Questo tipo non contiene campi.

Container per l'enum che descrive i possibili errori di autenticazione.

AuthenticationError

Enum che descrive i possibili errori di autenticazione.

Enum
UNSPECIFIED Enum non specificata.
UNKNOWN Il codice di errore ricevuto non è noto in questa versione.
AUTHENTICATION_ERROR Autenticazione della richiesta non riuscita.
CLIENT_CUSTOMER_ID_INVALID L'ID cliente non è un numero.
CUSTOMER_NOT_FOUND Nessun cliente trovato per l'ID cliente fornito.
GOOGLE_ACCOUNT_DELETED L'Account Google del cliente è stato eliminato.
GOOGLE_ACCOUNT_AUTHENTICATION_FAILED Si è verificato un problema durante l'autenticazione dell'Account Google.
GOOGLE_ACCOUNT_USER_AND_ADS_USER_MISMATCH L'utente nel token di accesso all'Account Google non corrisponde allo User-ID nel cookie.
NOT_ADS_USER L'Account Google che ha generato il token di accesso OAuth non è associato a un account Search Ads 360. Crea un nuovo account o aggiungi l'Account Google a un account Search Ads 360 esistente.
OAUTH_TOKEN_INVALID Il token OAuth nell'intestazione non è valido.
OAUTH_TOKEN_EXPIRED Il token OAuth nell'intestazione è scaduto.
OAUTH_TOKEN_DISABLED Il token OAuth nell'intestazione è stato disattivato.
OAUTH_TOKEN_REVOKED Il token OAuth nell'intestazione è stato revocato.
OAUTH_TOKEN_HEADER_INVALID L'intestazione HTTP del token OAuth non è corretta.
USER_ID_INVALID L'ID utente nell'intestazione non è valido.
TWO_STEP_VERIFICATION_NOT_ENROLLED Un amministratore dell'account ha modificato le impostazioni di autenticazione. Per accedere a questo account, attiva la verifica in due passaggi nel tuo Account Google all'indirizzo https://www.google.com/landing/2step.
ADVANCED_PROTECTION_NOT_ENROLLED Un amministratore dell'account ha modificato le impostazioni di autenticazione. Per accedere a questo account, attiva la protezione avanzata nel tuo Account Google all'indirizzo https://landing.google.com/advancedprotection.

AuthorizationErrorEnum

Questo tipo non contiene campi.

Container per l'enum che descrive i possibili errori di autorizzazione.

AuthorizationError

Enum che descrive i possibili errori di autorizzazione.

Enum
UNSPECIFIED Enum non specificata.
UNKNOWN Il codice di errore ricevuto non è noto in questa versione.
USER_PERMISSION_DENIED L'utente non dispone delle autorizzazioni per accedere al cliente. Nota: se accedi a un cliente cliente, l'ID cliente del gestore deve essere impostato nell'intestazione login-customer-id. Scopri di più all'indirizzo https://developers.google.com/search-ads/reporting/concepts/call-structure#login_customer_id_header
PROJECT_DISABLED Il progetto Google Cloud inviato nella richiesta non dispone dell'autorizzazione per accedere all'API.
AUTHORIZATION_ERROR Autorizzazione del client non riuscita.
ACTION_NOT_PERMITTED L'utente non dispone dell'autorizzazione per eseguire questa azione (ad esempio AGGIUNGI, AGGIORNA, RIMUOVI) sulla risorsa o chiama un metodo.
INCOMPLETE_SIGNUP Registrazione non completata.
CUSTOMER_NOT_ENABLED Non è possibile accedere all'account del cliente perché non è ancora abilitato o è stato disattivato.
MISSING_TOS Lo sviluppatore deve firmare i Termini di servizio. Sono disponibili qui: https://developers.google.com/terms
INVALID_LOGIN_CUSTOMER_ID_SERVING_CUSTOMER_ID_COMBINATION L'utente che ha effettuato l'accesso specificato non ha accesso all'account specificato, pertanto la richiesta non è valida.
SERVICE_ACCESS_DENIED Lo sviluppatore specificato non ha accesso al servizio.
ACCESS_DENIED_FOR_ACCOUNT_TYPE Il cliente (o il cliente che ha effettuato l'accesso) non è consentito nell'API Search Ads 360. Appartiene a un altro sistema di annunci.
METRIC_ACCESS_DENIED Lo sviluppatore non ha accesso alle metriche per cui è stata eseguita la query.

CustomColumnErrorEnum

Questo tipo non contiene campi.

Contenitore per l'enum che descrive possibili errori nelle colonne personalizzate.

CustomColumnError

Enum che descrive i possibili errori nelle colonne personalizzate.

Enum
UNSPECIFIED Enum non specificata.
UNKNOWN Il codice di errore ricevuto non è noto in questa versione.
CUSTOM_COLUMN_NOT_FOUND Impossibile trovare la colonna personalizzata.
CUSTOM_COLUMN_NOT_AVAILABLE La colonna personalizzata non è disponibile.

DateErrorEnum

Questo tipo non contiene campi.

Container per l'enum che descrive i possibili errori relativi alle date.

DateError

Enum che descrive i possibili errori relativi alle date.

Enum
UNSPECIFIED Enum non specificata.
UNKNOWN Il codice di errore ricevuto non è noto in questa versione.
INVALID_FIELD_VALUES_IN_DATE I valori dei campi specificati non corrispondono a una data valida.
INVALID_FIELD_VALUES_IN_DATE_TIME I valori del campo specificati non corrispondono a una data e un'ora valide.
INVALID_STRING_DATE Il formato della data della stringa deve essere aaaa-mm-gg.
INVALID_STRING_DATE_TIME_MICROS Il formato di data e ora della stringa deve essere aaaa-mm-gg hh:mm:ss.ssssss.
INVALID_STRING_DATE_TIME_SECONDS Il formato di data e ora della stringa deve essere aaaa-mm-gg hh:mm:ss.
INVALID_STRING_DATE_TIME_SECONDS_WITH_OFFSET Il formato della data e dell'ora della stringa deve essere aaaa-mm-gg hh:mm:ss+|-hh:mm.
EARLIER_THAN_MINIMUM_DATE La data è precedente al minimo consentito.
LATER_THAN_MAXIMUM_DATE La data è successiva al limite massimo consentito.
DATE_RANGE_MINIMUM_DATE_LATER_THAN_MAXIMUM_DATE I limiti dell'intervallo di date non sono in ordine.
DATE_RANGE_MINIMUM_AND_MAXIMUM_DATES_BOTH_NULL Entrambe le date nell'intervallo sono null.

DateRangeErrorEnum

Questo tipo non contiene campi.

Contenitore per l'enum che descrive i possibili errori dell'intervallo di date.

DateRangeError

Enum che descrive i possibili errori dell'intervallo di date.

Enum
UNSPECIFIED Enum non specificata.
UNKNOWN Il codice di errore ricevuto non è noto in questa versione.
INVALID_DATE Data non valida.
START_DATE_AFTER_END_DATE La data di inizio era successiva alla data di fine.
CANNOT_SET_DATE_TO_PAST Impossibile impostare una data nel passato
AFTER_MAXIMUM_ALLOWABLE_DATE È stata utilizzata una data successiva all'"ultima" data del sistema.
CANNOT_MODIFY_START_DATE_IF_ALREADY_STARTED Stai tentando di modificare la data di inizio su una risorsa che è stata avviata.

DistinctErrorEnum

Questo tipo non contiene campi.

Container per l'enum che descrive i possibili errori distinti.

DistinctError

Enum che descrive i possibili errori distinti.

Enum
UNSPECIFIED Enum non specificata.
UNKNOWN Il codice di errore ricevuto non è noto in questa versione.
DUPLICATE_ELEMENT Elemento duplicato.
DUPLICATE_TYPE Tipo duplicato.

ErrorCode

Il motivo dell'errore rappresentato da tipo ed enum.

Campi
Campo di unione error_code. L'elenco di enumerazioni di errori error_code può essere solo uno dei seguenti:
request_error

RequestError

Un errore causato dalla richiesta

query_error

QueryError

Un errore nella query

authorization_error

AuthorizationError

Si è verificato un errore durante il tentativo di autorizzazione di un utente.

internal_error

InternalError

Si è verificato un errore imprevisto lato server.

quota_error

QuotaError

Un errore relativo alla quantità di quota rimanente.

authentication_error

AuthenticationError

Indica una mancata autenticazione dell'utente.

date_error

DateError

I motivi dell'errore relativo alla data

date_range_error

DateRangeError

I motivi dell'errore relativo all'intervallo di date

distinct_error

DistinctError

I motivi dei diversi errori

header_error

HeaderError

I motivi dell'errore di intestazione.

size_limit_error

SizeLimitError

I motivi dell'errore relativo al limite di dimensioni

custom_column_error

CustomColumnError

I motivi dell'errore nella colonna personalizzata

invalid_parameter_error

InvalidParameterError

I motivi degli errori di parametri non validi.

ErrorDetails

Ulteriori dettagli sull'errore.

Campi
unpublished_error_code

string

Il codice di errore che avrebbe dovuto essere restituito, ma che non è stato restituito. Utilizzato quando il codice di errore non viene pubblicato nella versione specificata dal client.

quota_error_details

QuotaErrorDetails

Dettagli sull'errore di quota, tra cui l'ambito (account o sviluppatore), il nome del bucket di tariffe e il ritardo tra tentativi.

ErrorLocation

Descrive la parte del protocollo di richiesta che ha causato l'errore.

Campi
field_path_elements[]

FieldPathElement

Un percorso di campo che indica quale campo non era valido nella richiesta.

FieldPathElement

Una parte del percorso di un campo.

Campi
field_name

string

Il nome di un campo o di un campo

index

int32

Se field_name è un campo ripetuto, significa che l'errore riguarda l'elemento

HeaderErrorEnum

Questo tipo non contiene campi.

Container per l'enum che descrive i possibili errori di intestazione.

HeaderError

Enum che descrive i possibili errori di intestazione.

Enum
UNSPECIFIED Enum non specificata.
UNKNOWN Il codice di errore ricevuto non è noto in questa versione.
INVALID_USER_SELECTED_CUSTOMER_ID Impossibile convalidare l'ID cliente selezionato dall'utente.
INVALID_LOGIN_CUSTOMER_ID Impossibile convalidare l'ID cliente di accesso.

InternalErrorEnum

Questo tipo non contiene campi.

Container per l'enum che descrive i possibili errori interni.

InternalError

Enum che descrive i possibili errori interni.

Enum
UNSPECIFIED Enum non specificata.
UNKNOWN Il codice di errore ricevuto non è noto in questa versione.
INTERNAL_ERROR L'API ha riscontrato un errore interno imprevisto.
ERROR_CODE_NOT_PUBLISHED Il codice di errore previsto non esiste nella versione dell'API specificata. Verrà rilasciato in una versione futura dell'API.
TRANSIENT_ERROR L'API ha riscontrato un errore temporaneo imprevisto. In questi casi, l'utente deve ritentare la richiesta.
DEADLINE_EXCEEDED La richiesta ha richiesto più di una scadenza.

InvalidParameterErrorEnum

Questo tipo non contiene campi.

Contenitore per l'enum che descrive i possibili errori di un parametro non valido.

InvalidParameterError

Enum che descrive i possibili errori relativi ai parametri.

Enum
UNSPECIFIED Enum non specificata.
UNKNOWN Il codice di errore ricevuto non è noto in questa versione.
INVALID_CURRENCY_CODE Il codice di valuta specificato non è valido.

QueryErrorEnum

Questo tipo non contiene campi.

Container per l'enum che descrive i possibili errori di query.

QueryError

Enum che descrive i possibili errori delle query.

Enum
UNSPECIFIED Nome non specificato.
UNKNOWN Il codice di errore ricevuto non è noto in questa versione.
QUERY_ERROR Errore restituito se tutti gli altri motivi per un errore di query non sono applicabili.
BAD_ENUM_CONSTANT Una condizione utilizzata nella query fa riferimento a una costante di enumerazione non valida.
BAD_ESCAPE_SEQUENCE La query contiene una sequenza di escape non valida.
BAD_FIELD_NAME Il nome del campo non è valido.
BAD_LIMIT_VALUE Il valore del limite non è valido (ad esempio non è un numero)
BAD_NUMBER Impossibile analizzare il numero rilevato.
BAD_OPERATOR Rilevato operatore non valido.
BAD_PARAMETER_NAME Parametro sconosciuto o non supportato.
BAD_PARAMETER_VALUE Il valore del parametro non è valido.
BAD_RESOURCE_TYPE_IN_FROM_CLAUSE Nella clausola FROM è stato specificato un tipo di risorsa non valido.
BAD_SYMBOL Simbolo non ASCII rilevato al di fuori delle stringhe.
BAD_VALUE Valore non valido.
DATE_RANGE_TOO_WIDE I filtri della data non riescono a limitare la data a un intervallo inferiore a 31 giorni. Applicabile se la query è segmentata per data.
DATE_RANGE_TOO_NARROW I filtri per data/settimana/mese/trimestre hanno una data di inizio successiva alla data di fine.
EXPECTED_AND È previsto AND tra i valori con l'operatore BETWEEN.
EXPECTED_BY Previsto che ORDER BY sarà di BY.
EXPECTED_DIMENSION_FIELD_IN_SELECT_CLAUSE Nessun campo dimensione selezionato.
EXPECTED_FILTERS_ON_DATE_RANGE Filtri mancanti nei campi relativi alle date.
EXPECTED_FROM Clausola FROM mancante.
EXPECTED_LIST L'operatore utilizzato nelle condizioni richiede che il valore sia un elenco.
EXPECTED_REFERENCED_FIELD_IN_SELECT_CLAUSE I campi utilizzati nelle clausole WHERE o ORDER BY non sono presenti nella clausola SELECT.
EXPECTED_SELECT Manca SELECT all'inizio della query.
EXPECTED_SINGLE_VALUE Un elenco è stato passato come valore a una condizione il cui operatore prevede un singolo valore.
EXPECTED_VALUE_WITH_BETWEEN_OPERATOR Mancano uno o entrambi i valori con l'operatore BETWEEN.
INVALID_DATE_FORMAT Formato della data non valido. Il formato previsto è "AAAA-MM-GG".
MISALIGNED_DATE_FOR_FILTER Valore data disallineato per il filtro. La data deve essere l'inizio di una settimana/mese/trimestre se il campo filtrato è segment.week/segments.month/segments.quarter.
INVALID_STRING_VALUE Il valore trasmesso non era una stringa quando avrebbe dovuto essere. Ad esempio, si trattava di un numero o di un valore letterale senza virgolette.
INVALID_VALUE_WITH_BETWEEN_OPERATOR Un valore stringa passato all'operatore BETWEEN non viene analizzato come data.
INVALID_VALUE_WITH_DURING_OPERATOR Il valore passato all'operatore DURING non è un valore letterale di intervallo di date
INVALID_VALUE_WITH_LIKE_OPERATOR È stato trasmesso un valore all'operatore LIKE.
OPERATOR_FIELD_MISMATCH È stato fornito un operatore non applicabile al campo filtrato.
PROHIBITED_EMPTY_LIST_IN_CONDITION È stata trovata una condizione con un elenco vuoto.
PROHIBITED_ENUM_CONSTANT Una condizione utilizzata nella query fa riferimento a una costante di enumerazione non supportata.
PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE I campi che non possono essere selezionati insieme sono stati inclusi nella clausola SELECT.
PROHIBITED_FIELD_IN_ORDER_BY_CLAUSE Un campo non ordinabile è stato incluso nella clausola ORDER BY.
PROHIBITED_FIELD_IN_SELECT_CLAUSE Un campo non selezionabile è stato incluso nella clausola SELECT.
PROHIBITED_FIELD_IN_WHERE_CLAUSE Un campo non filtrabile è stato incluso nella clausola WHERE.
PROHIBITED_RESOURCE_TYPE_IN_FROM_CLAUSE Il tipo di risorsa specificato nella clausola FROM non è supportato da questo servizio.
PROHIBITED_RESOURCE_TYPE_IN_SELECT_CLAUSE Un campo proveniente da una risorsa incompatibile è stato incluso nella clausola SELECT.
PROHIBITED_RESOURCE_TYPE_IN_WHERE_CLAUSE Un campo che proviene da una risorsa incompatibile è stato incluso nella clausola WHERE.
PROHIBITED_METRIC_IN_SELECT_OR_WHERE_CLAUSE Una metrica incompatibile con la risorsa principale o con altre risorse di segmentazione selezionate è stata inclusa nella clausola SELECT o WHERE.
PROHIBITED_SEGMENT_IN_SELECT_OR_WHERE_CLAUSE Un segmento incompatibile con la risorsa principale o con altre risorse di segmentazione selezionate è stato incluso nella clausola SELECT o WHERE.
PROHIBITED_SEGMENT_WITH_METRIC_IN_SELECT_OR_WHERE_CLAUSE Un segmento nella clausola SELECT non è compatibile con una metrica nella clausola SELECT o WHERE.
LIMIT_VALUE_TOO_LOW Il valore passato alla clausola di limite è troppo basso.
PROHIBITED_NEWLINE_IN_STRING La query contiene una stringa contenente un carattere di nuova riga.
PROHIBITED_VALUE_COMBINATION_IN_LIST L'elenco contiene valori di diversi tipi.
PROHIBITED_VALUE_COMBINATION_WITH_BETWEEN_OPERATOR I valori passati all'operatore BETWEEN non sono dello stesso tipo.
STRING_NOT_TERMINATED La query contiene una stringa senza terminazione.
TOO_MANY_SEGMENTS Nella clausola SELECT sono specificati troppi segmenti.
UNEXPECTED_END_OF_QUERY La query è incompleta e non può essere analizzata.
UNEXPECTED_FROM_CLAUSE La clausola FROM non può essere specificata in questa query.
UNRECOGNIZED_FIELD La query contiene uno o più campi non riconosciuti.
UNEXPECTED_INPUT La query ha una parte aggiuntiva imprevista.
REQUESTED_METRICS_FOR_MANAGER Non è possibile richiedere metriche per un account amministratore. Per recuperare le metriche, invia richieste separate per ciascun account cliente all'interno dell'account amministratore.
FILTER_HAS_TOO_MANY_VALUES Il numero di valori (operandi sul lato destro) in un filtro supera il limite.

QuotaErrorDetails

Ulteriori dettagli sull'errore di quota in caso di QuotaError.

Campi
rate_scope

QuotaRateScope

L'ambito di frequenza del limite di quota.

rate_name

string

La descrizione di alto livello del bucket di quota. ad esempio "Ricevi richieste di accesso standard" o "Richieste per account".

retry_delay

Duration

Periodo di backoff che i clienti devono attendere prima di inviare la richiesta successiva.

QuotaRateScope

Enum dei possibili ambiti a cui appartengono i bucket di quota.

Enum
UNSPECIFIED Enum non specificata
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione.
ACCOUNT Quota di account per cliente
DEVELOPER Quota per progetto

QuotaErrorEnum

Questo tipo non contiene campi.

Container per l'enum che descrive i possibili errori di quota.

QuotaError

Enum che descrive i possibili errori di quota.

Enum
UNSPECIFIED Enum non specificata.
UNKNOWN Il codice di errore ricevuto non è noto in questa versione.
RESOURCE_EXHAUSTED Troppe richieste.
RESOURCE_TEMPORARILY_EXHAUSTED Troppe richieste in un breve periodo di tempo.

RequestErrorEnum

Questo tipo non contiene campi.

Container per l'enum che descrive i possibili errori delle richieste.

RequestError

Enum che descrive i possibili errori nelle richieste.

Enum
UNSPECIFIED Enum non specificata.
UNKNOWN Il codice di errore ricevuto non è noto in questa versione.
RESOURCE_NAME_MISSING Il nome della risorsa è obbligatorio per questa richiesta.
RESOURCE_NAME_MALFORMED Il formato del nome della risorsa fornito non è corretto.
BAD_RESOURCE_ID Il formato del nome della risorsa fornito non è corretto.
INVALID_PRODUCT_NAME Nome del prodotto non valido.
INVALID_CUSTOMER_ID L'ID cliente non è valido.
OPERATION_REQUIRED È necessario specificare la creazione, l'aggiornamento o la rimozione per l'operazione di modifica.
RESOURCE_NOT_FOUND Risorsa richiesta non trovata.
INVALID_PAGE_TOKEN Il token della pagina successiva specificato nella richiesta dell'utente non è valido.
EXPIRED_PAGE_TOKEN Il token della pagina successiva specificato nella richiesta dell'utente è scaduto.
INVALID_PAGE_SIZE Le dimensioni della pagina specificate nella richiesta dell'utente non sono valide.
REQUIRED_FIELD_MISSING Manca un campo obbligatorio.
IMMUTABLE_FIELD Il campo non può essere modificato perché è immutabile. È anche possibile che il campo possa essere modificato utilizzando l'operazione "crea" ma non "aggiorna".
TOO_MANY_MUTATE_OPERATIONS La richiesta ha ricevuto troppe voci.
CANNOT_BE_EXECUTED_BY_MANAGER_ACCOUNT La richiesta non può essere eseguita da un account amministratore.
CANNOT_MODIFY_FOREIGN_FIELD La richiesta di modifica stava tentando di modificare un campo di sola lettura. Ad esempio, i campi Budget possono essere richiesti per il gruppo di annunci, ma sono di sola lettura per adGroups:mutate.
INVALID_ENUM_VALUE Il valore enum non è consentito.
LOGIN_CUSTOMER_ID_PARAMETER_MISSING Il parametro login-customer-id è obbligatorio per questa richiesta.
LOGIN_OR_LINKED_CUSTOMER_ID_PARAMETER_REQUIRED Per questa richiesta è obbligatorio specificare il parametro login-customer-id o collegato-customer-id.
VALIDATE_ONLY_REQUEST_HAS_PAGE_TOKEN page_token è impostato nella richiesta di sola convalida
CANNOT_RETURN_SUMMARY_ROW_FOR_REQUEST_WITHOUT_METRICS Return_summary_row non può essere abilitato se nella richiesta non è stato selezionato alcun campo delle metriche.
CANNOT_RETURN_SUMMARY_ROW_FOR_VALIDATE_ONLY_REQUESTS restituzione_riepilogo_riga non deve essere abilitata per le richieste solo di convalida.
INCONSISTENT_RETURN_SUMMARY_ROW_VALUE Il valore del parametroreturn_summary_row deve essere lo stesso tra le richieste con campo page_token impostato e la relativa richiesta originale.
TOTAL_RESULTS_COUNT_NOT_ORIGINALLY_REQUESTED Il conteggio totale dei risultati non può essere restituito se non è stato richiesto nella richiesta originale.
RPC_DEADLINE_TOO_SHORT La scadenza specificata dal cliente era troppo breve.
PRODUCT_NOT_SUPPORTED Il prodotto associato alla richiesta non è supportato per la richiesta corrente.

SearchAds360Error

Errore specifico di Search Ads 360.

Campi
error_code

ErrorCode

Un valore enum che indica quale errore si è verificato.

message

string

Una descrizione leggibile dell'errore.

trigger

Value

Il valore che ha attivato l'errore.

location

ErrorLocation

Descrive la parte del protocollo di richiesta che ha causato l'errore.

details

ErrorDetails

Ulteriori dettagli sull'errore, che vengono restituiti da determinati codici di errore. La maggior parte dei codici di errore non include dettagli.

SearchAds360Failure

Descrive in che modo una chiamata API Search Ads 360 non è riuscita. Viene restituito all'interno di google.rpc.Status.details quando una chiamata non va a buon fine.

Campi
errors[]

SearchAds360Error

L'elenco degli errori che si sono verificati.

request_id

string

L'ID univoco della richiesta utilizzato per il debug.

SizeLimitErrorEnum

Questo tipo non contiene campi.

Contenitore per l'enum che descrive i possibili errori relativi ai limiti di dimensione.

SizeLimitError

Enum che descrive i possibili errori relativi ai limiti delle dimensioni.

Enum
UNSPECIFIED Enum non specificata.
UNKNOWN Il codice di errore ricevuto non è noto in questa versione.
REQUEST_SIZE_LIMIT_EXCEEDED Il numero di voci nella richiesta supera il limite di sistema oppure i contenuti delle operazioni superano i limiti delle transazioni a causa delle dimensioni o della complessità. Prova a ridurre il numero di voci per richiesta.
RESPONSE_SIZE_LIMIT_EXCEEDED Il numero di voci nella risposta supera il limite di sistema.