Package google.ads.searchads360.v0.errors

Indice

AuthenticationErrorEnum

Questo tipo non contiene campi.

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

AuthenticationError

Enum che descrive possibili errori di autenticazione.

Enum
UNSPECIFIED Enum non specificato.
UNKNOWN Il codice di errore ricevuto non è noto in questa versione.
AUTHENTICATION_ERROR L'autenticazione della richiesta non è riuscita.
CLIENT_CUSTOMER_ID_INVALID L'ID cliente del cliente non è un numero.
CUSTOMER_NOT_FOUND Nessun cliente trovato per l'ID cliente fornito.
GOOGLE_ACCOUNT_DELETED L'Account Google del cliente viene 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 all'ID utente 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 è un ID 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.

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

AuthorizationError

Enum che descrive i possibili errori di autorizzazione.

Enum
UNSPECIFIED Enum non specificato.
UNKNOWN Il codice di errore ricevuto non è noto in questa versione.
USER_PERMISSION_DENIED L'utente non dispone delle autorizzazioni per accedere ai dati del cliente. Nota: se accedi a un cliente del cliente, l'ID cliente dell'amministratore 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 L'autorizzazione del client non è riuscita.
ACTION_NOT_PERMITTED L'utente non dispone dell'autorizzazione per eseguire questa azione (ad esempio, AGGIUNGI, AGGIUNGI, RIMUOVI) sulla risorsa o chiamare un metodo.
INCOMPLETE_SIGNUP Registrazione non completata.
CUSTOMER_NOT_ENABLED Non è possibile accedere all'account cliente perché non è ancora stato attivato o è stato disattivato.
MISSING_TOS Lo sviluppatore deve firmare i Termini di servizio. Puoi trovarli qui: https://developers.google.com/terms
INVALID_LOGIN_CUSTOMER_ID_SERVING_CUSTOMER_ID_COMBINATION Il cliente di 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 eseguito l'accesso) non è consentito nell'API Search Ads 360. Appartiene a un altro sistema pubblicitario.
METRIC_ACCESS_DENIED Lo sviluppatore non ha accesso alle metriche sottoposte a query.

CustomColumnErrorEnum

Questo tipo non contiene campi.

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

CustomColumnError

Enum che descrive i possibili errori delle colonne personalizzate.

Enum
UNSPECIFIED Enum non specificato.
UNKNOWN Il codice di errore ricevuto non è noto in questa versione.
CUSTOM_COLUMN_NOT_FOUND La colonna personalizzata non è stata trovata.
CUSTOM_COLUMN_NOT_AVAILABLE La colonna personalizzata non è disponibile.

DateErrorEnum

Questo tipo non contiene campi.

Contenitore per l'enum che descrive i possibili errori relativi alla data.

DateError

Enum che descrive i possibili errori relativi alla data.

Enum
UNSPECIFIED Enum non specificato.
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 dei campi specificati non corrispondono a una data e un'ora valide.
INVALID_STRING_DATE Il formato della stringa della data deve essere aaaa-mm-gg.
INVALID_STRING_DATE_TIME_MICROS Il formato della stringa data e ora deve essere aaaa-mm-gg hh:mm:ss.ssssss.
INVALID_STRING_DATE_TIME_SECONDS Il formato della data e dell'ora della stringa deve essere aaaa-mm-gg hh:mm:ss.
INVALID_STRING_DATE_TIME_SECONDS_WITH_OFFSET Il formato della stringa data e ora deve essere aaaa-mm-gg hh:mm:ss+|-hh:mm.
EARLIER_THAN_MINIMUM_DATE La data è precedente a quella minima consentita.
LATER_THAN_MAXIMUM_DATE La data è successiva alla data massima consentita.
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 relativi all'intervallo di date.

DateRangeError

Enum che descrive i possibili errori relativi all'intervallo di date.

Enum
UNSPECIFIED Enum non specificato.
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 alla data "ultima" del sistema.
CANNOT_MODIFY_START_DATE_IF_ALREADY_STARTED Si sta tentando di modificare la data di inizio di una risorsa che è già iniziata.

DistinctErrorEnum

Questo tipo non contiene campi.

Contenitore per l'enum che descrive possibili errori distinti.

DistinctError

Enum che descrive possibili errori distinti.

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

ErrorCode

Il motivo dell'errore rappresentato da tipo ed enumerazione.

Campi
Campo unione error_code. L'elenco degli enum di errore error_code può essere solo uno dei seguenti:
request_error

RequestError

Un errore causato dalla richiesta
query_error

QueryError

Si è verificato un errore con la query
authorization_error

AuthorizationError

Si è verificato un errore durante il tentativo di autorizzare un utente.
internal_error

InternalError

Un errore lato server imprevisto.
quota_error

QuotaError

Un errore relativo all'importo della quota rimanente.
authentication_error

AuthenticationError

Indica l'impossibilità di autenticare correttamente l'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 dell'errore distinto
header_error

HeaderError

I motivi dell'errore dell'intestazione.
size_limit_error

SizeLimitError

I motivi dell'errore relativo al limite di dimensioni
custom_column_error

CustomColumnError

I motivi dell'errore della colonna personalizzata
invalid_parameter_error

InvalidParameterError

I motivi degli errori relativi ai parametri non validi.

ErrorDetails

Ulteriori dettagli sull'errore.

Campi
unpublished_error_code

string

Il codice di errore che avrebbe dovuto essere restituito, ma non lo è stato. Viene utilizzato quando il codice di errore non è 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 tariffa e il ritardo del nuovo tentativo.

ErrorLocation

Descrive la parte del proto della richiesta che ha causato l'errore.

Campi
field_path_elements[]

FieldPathElement

Un percorso del campo che indica quale campo non è valido nella richiesta.

FieldPathElement

Una parte del percorso di un campo.

Campi
field_name

string

Il nome di un campo o di un oneof
index

int32

Se field_name è un campo ripetuto, si tratta dell'elemento che ha riscontrato un errore

HeaderErrorEnum

Questo tipo non contiene campi.

Contenitore per l'enum che descrive i possibili errori dell'intestazione.

HeaderError

Enum che descrive i possibili errori dell'intestazione.

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

InternalErrorEnum

Questo tipo non contiene campi.

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

InternalError

Enum che descrive i possibili errori interni.

Enum
UNSPECIFIED Enum non specificato.
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à rilasciata in una versione futura dell'API.
TRANSIENT_ERROR L'API ha riscontrato un errore temporaneo imprevisto. In questi casi l'utente deve riprovare a inviare la richiesta.
DEADLINE_EXCEEDED La richiesta ha richiesto più tempo 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 dei parametri.

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

QueryErrorEnum

Questo tipo non contiene campi.

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

QueryError

Enum che descrive i possibili errori di query.

Enum
UNSPECIFIED Nome non specificato.
UNKNOWN Il codice di errore ricevuto non è noto in questa versione.
QUERY_ERROR Viene restituito se tutti gli altri motivi di errore della query non sono applicabili.
BAD_ENUM_CONSTANT Una condizione utilizzata nella query fa riferimento a una costante enum 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 limite non è valido (ad esempio, non è un numero)
BAD_NUMBER Impossibile analizzare il numero rilevato.
BAD_OPERATOR Operatore non valido rilevato.
BAD_PARAMETER_NAME Parametro sconosciuto o non supportato.
BAD_PARAMETER_VALUE Il parametro ha un valore 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 Il valore non è valido.
DATE_RANGE_TOO_WIDE I filtri 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 Operatore AND previsto tra i valori con l'operatore BETWEEN.
EXPECTED_BY Si prevede che ORDER BY abbia BY.
EXPECTED_DIMENSION_FIELD_IN_SELECT_CLAUSE Non è stato selezionato alcun campo delle dimensioni.
EXPECTED_FILTERS_ON_DATE_RANGE Filtri mancanti nei campi relativi alla data.
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 SELECT non è presente all'inizio della query.
EXPECTED_SINGLE_VALUE È stato passato un elenco 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 data non valido. Era previsto "AAAA-MM-GG".
MISALIGNED_DATE_FOR_FILTER Valore data non allineato per il filtro. La data deve essere l'inizio di una settimana/di un mese/di un trimestre se il campo filtrato è segments.week/segments.month/segments.quarter.
INVALID_STRING_VALUE Il valore passato non era una stringa, anche se avrebbe dovuto esserlo. Ad esempio, si trattava di un numero o di un valore letterale senza virgolette.
INVALID_VALUE_WITH_BETWEEN_OPERATOR Un valore di 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 dell'intervallo di date
INVALID_VALUE_WITH_LIKE_OPERATOR È stato passato un valore all'operatore LIKE.
OPERATOR_FIELD_MISMATCH È stato fornito un operatore non applicabile al campo sottoposto a filtro.
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 enum non supportata.
PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE Nella clausola SELECT sono stati inclusi campi che non possono essere selezionati insieme.
PROHIBITED_FIELD_IN_ORDER_BY_CLAUSE Nella clausola ORDER BY è stato incluso un campo non ordinabile.
PROHIBITED_FIELD_IN_SELECT_CLAUSE Nella clausola SELECT è stato incluso un campo non selezionabile.
PROHIBITED_FIELD_IN_WHERE_CLAUSE Nella clausola WHERE è stato incluso un campo non filtrabile.
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 Nella clausola SELECT è stato incluso un campo proveniente da una risorsa incompatibile.
PROHIBITED_RESOURCE_TYPE_IN_WHERE_CLAUSE Nella clausola WHERE è stato incluso un campo proveniente da una risorsa incompatibile.
PROHIBITED_METRIC_IN_SELECT_OR_WHERE_CLAUSE Nella clausola SELECT o WHERE è stata inclusa una metrica incompatibile con la risorsa principale o con altre risorse di segmentazione selezionate.
PROHIBITED_SEGMENT_IN_SELECT_OR_WHERE_CLAUSE Nella clausola SELECT o WHERE è stato incluso un segmento incompatibile con la risorsa principale o con altre risorse di segmentazione selezionate.
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 LIMIT è 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 tipi diversi.
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 non terminata.
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 contiene un elemento aggiuntivo imprevisto.
REQUESTED_METRICS_FOR_MANAGER Non è possibile richiedere metriche per un account amministratore. Per recuperare le metriche, invia richieste separate per ogni account cliente nell'account amministratore.
FILTER_HAS_TOO_MANY_VALUES Il numero di valori (operandi a destra) in un filtro supera il limite.

QuotaErrorDetails

Ulteriori dettagli sull'errore di quota quando si verifica QuotaError.

Campi
rate_scope

QuotaRateScope

L'ambito della tariffa del limite di quota.
rate_name

string

La descrizione di alto livello del bucket della quota. Alcuni esempi sono "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 delle quote.

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

QuotaErrorEnum

Questo tipo non contiene campi.

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

QuotaError

Enum che descrive i possibili errori di quota.

Enum
UNSPECIFIED Enum non specificato.
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.

Contenitore per l'enum che descrive i possibili errori di richiesta.

RequestError

Enum che descrive i possibili errori di richiesta.

Enum
UNSPECIFIED Enum non specificato.
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 nome della risorsa fornito non è valido.
BAD_RESOURCE_ID Il nome della risorsa fornito non è valido.
INVALID_PRODUCT_NAME Il nome del prodotto non è valido.
INVALID_CUSTOMER_ID L'ID cliente non è valido.
OPERATION_REQUIRED Per l'operazione di mutazione deve essere specificato create, update o remove.
RESOURCE_NOT_FOUND Risorsa richiesta non trovata.
INVALID_PAGE_TOKEN Il token di pagina successiva specificato nella richiesta dell'utente non è valido.
EXPIRED_PAGE_TOKEN Il token di 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 "create", ma non "update".
TOO_MANY_MUTATE_OPERATIONS Sono state ricevute troppe voci nella richiesta.
CANNOT_BE_EXECUTED_BY_MANAGER_ACCOUNT La richiesta non può essere eseguita da un account amministratore.
CANNOT_MODIFY_FOREIGN_FIELD La richiesta di mutazione 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 dell'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 è necessario il parametro login-customer-id o linked-customer-id.
VALIDATE_ONLY_REQUEST_HAS_PAGE_TOKEN page_token è impostato nella richiesta di convalida solo
CANNOT_RETURN_SUMMARY_ROW_FOR_REQUEST_WITHOUT_METRICS return_summary_row non può essere attivato se la richiesta non ha selezionato alcun campo delle metriche.
CANNOT_RETURN_SUMMARY_ROW_FOR_VALIDATE_ONLY_REQUESTS return_summary_row non deve essere attivato per le richieste di sola convalida.
INCONSISTENT_RETURN_SUMMARY_ROW_VALUE Il valore del parametro return_summary_row deve essere lo stesso per le richieste con il campo page_token impostato e per la 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 proto della richiesta che ha causato l'errore.
details

ErrorDetails

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

SearchAds360Failure

Descrive come una chiamata all'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 al limite di dimensioni.

SizeLimitError

Enum che descrive i possibili errori relativi al limite di dimensioni.

Enum
UNSPECIFIED Enum non specificato.
UNKNOWN Il codice di errore ricevuto non è noto in questa versione.
REQUEST_SIZE_LIMIT_EXCEEDED Il numero di voci nella richiesta supera il limite del sistema oppure i contenuti delle operazioni superano i limiti di transazione 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 del sistema.