Package google.ads.searchads360.v0.errors

Índice

AuthenticationErrorEnum

Esse tipo não tem campos.

Contêiner para enumeração que descreve possíveis erros de autenticação.

AuthenticationError

Enum que descreve possíveis erros de autenticação.

Enums
UNSPECIFIED Enum não especificado.
UNKNOWN O código de erro recebido não é conhecido nesta versão.
AUTHENTICATION_ERROR Falha na autenticação da solicitação.
CLIENT_CUSTOMER_ID_INVALID O ID de cliente não é um número.
CUSTOMER_NOT_FOUND Nenhum cliente foi encontrado para o ID de cliente fornecido.
GOOGLE_ACCOUNT_DELETED A Conta do Google do cliente é excluída.
GOOGLE_ACCOUNT_AUTHENTICATION_FAILED Ocorreu um problema durante a autenticação da Conta do Google.
GOOGLE_ACCOUNT_USER_AND_ADS_USER_MISMATCH O usuário no token de login da Conta do Google não corresponde ao ID do usuário no cookie.
NOT_ADS_USER A conta do Google que gerou o token de acesso OAuth não está associada a uma conta do Search Ads 360. Crie uma conta ou adicione a conta do Google a uma conta do Search Ads 360.
OAUTH_TOKEN_INVALID O token OAuth no cabeçalho não é válido.
OAUTH_TOKEN_EXPIRED O token OAuth no cabeçalho expirou.
OAUTH_TOKEN_DISABLED O token OAuth no cabeçalho foi desativado.
OAUTH_TOKEN_REVOKED O token OAuth no cabeçalho foi revogado.
OAUTH_TOKEN_HEADER_INVALID O cabeçalho HTTP do token OAuth está com formato inválido.
USER_ID_INVALID O ID do usuário no cabeçalho não é válido.
TWO_STEP_VERIFICATION_NOT_ENROLLED As configurações de autenticação da conta foram alteradas por um administrador. Para acessar essa conta, ative a verificação em duas etapas na sua Conta do Google em https://www.google.com/landing/2step.
ADVANCED_PROTECTION_NOT_ENROLLED As configurações de autenticação da conta foram alteradas por um administrador. Para acessar essa conta, ative a Proteção Avançada na sua Conta do Google em https://landing.google.com/advancedprotection.

AuthorizationErrorEnum

Esse tipo não tem campos.

Contêiner para enumeração que descreve possíveis erros de autorização.

AuthorizationError

Enumeração que descreve possíveis erros de autorização.

Enums
UNSPECIFIED Enum não especificado.
UNKNOWN O código de erro recebido não é conhecido nesta versão.
USER_PERMISSION_DENIED O usuário não tem permissão para acessar o cliente. Observação: se você estiver acessando um cliente do cliente, o ID do cliente do administrador precisa estar definido no cabeçalho login-customer-id. Saiba mais em https://developers.google.com/search-ads/reporting/concepts/call-structure#login_customer_id_header
PROJECT_DISABLED O projeto do Google Cloud enviado na solicitação não tem permissão para acessar a API.
AUTHORIZATION_ERROR Falha na autorização do cliente.
ACTION_NOT_PERMITTED O usuário não tem permissão para realizar essa ação (por exemplo, ADD, UPDATE, REMOVE) no recurso ou chamar um método.
INCOMPLETE_SIGNUP A inscrição não foi concluída.
CUSTOMER_NOT_ENABLED A conta do cliente não pode ser acessada porque ainda não foi ativada ou foi desativada.
MISSING_TOS O desenvolvedor precisa assinar os Termos de Serviço. Confira aqui: https://developers.google.com/terms
INVALID_LOGIN_CUSTOMER_ID_SERVING_CUSTOMER_ID_COMBINATION O cliente de login especificado não tem acesso à conta especificada. Portanto, a solicitação é inválida.
SERVICE_ACCESS_DENIED O desenvolvedor especificado não tem acesso ao serviço.
ACCESS_DENIED_FOR_ACCOUNT_TYPE O cliente (ou cliente de login) não tem permissão na API do Search Ads 360. Ele pertence a outro sistema de anúncios.
METRIC_ACCESS_DENIED O desenvolvedor não tem acesso às métricas consultadas.

CustomColumnErrorEnum

Esse tipo não tem campos.

Contêiner para enumeração que descreve possíveis erros de colunas personalizadas.

CustomColumnError

Enumeração que descreve possíveis erros de colunas personalizadas.

Enums
UNSPECIFIED Enum não especificado.
UNKNOWN O código de erro recebido não é conhecido nesta versão.
CUSTOM_COLUMN_NOT_FOUND A coluna personalizada não foi encontrada.
CUSTOM_COLUMN_NOT_AVAILABLE A coluna personalizada não está disponível.

DateErrorEnum

Esse tipo não tem campos.

Contêiner para enumeração que descreve possíveis erros de data.

DateError

Enumeração que descreve possíveis erros de data.

Enums
UNSPECIFIED Enum não especificado.
UNKNOWN O código de erro recebido não é conhecido nesta versão.
INVALID_FIELD_VALUES_IN_DATE Os valores de campo fornecidos não correspondem a uma data válida.
INVALID_FIELD_VALUES_IN_DATE_TIME Os valores de campo fornecidos não correspondem a uma data e hora válidas.
INVALID_STRING_DATE O formato da data da string precisa ser aaaa-mm-dd.
INVALID_STRING_DATE_TIME_MICROS O formato da data e hora da string precisa ser aaaa-mm-dd hh:mm:ss.ssssss.
INVALID_STRING_DATE_TIME_SECONDS O formato da data e hora da string precisa ser aaaa-mm-dd hh:mm:ss.
INVALID_STRING_DATE_TIME_SECONDS_WITH_OFFSET O formato da data e hora da string precisa ser aaaa-mm-dd hh:mm:ss+|-hh:mm.
EARLIER_THAN_MINIMUM_DATE A data é anterior ao mínimo permitido.
LATER_THAN_MAXIMUM_DATE A data é posterior ao máximo permitido.
DATE_RANGE_MINIMUM_DATE_LATER_THAN_MAXIMUM_DATE Os limites do período não estão em ordem.
DATE_RANGE_MINIMUM_AND_MAXIMUM_DATES_BOTH_NULL As duas datas no período são nulas.

DateRangeErrorEnum

Esse tipo não tem campos.

Contêiner para enumeração que descreve possíveis erros de período.

DateRangeError

Enumeração que descreve possíveis erros de período.

Enums
UNSPECIFIED Enum não especificado.
UNKNOWN O código de erro recebido não é conhecido nesta versão.
INVALID_DATE Data inválida.
START_DATE_AFTER_END_DATE A data de início foi definida para depois da data de término.
CANNOT_SET_DATE_TO_PAST Não é possível definir uma data anterior à atual
AFTER_MAXIMUM_ALLOWABLE_DATE Uma data foi usada que é anterior à "última" data do sistema.
CANNOT_MODIFY_START_DATE_IF_ALREADY_STARTED Tentar mudar a data de início de um recurso que já começou.

DistinctErrorEnum

Esse tipo não tem campos.

Contêiner para enumeração que descreve possíveis erros distintos.

DistinctError

Enumeração que descreve possíveis erros distintos.

Enums
UNSPECIFIED Enum não especificado.
UNKNOWN O código de erro recebido não é conhecido nesta versão.
DUPLICATE_ELEMENT Elemento duplicado.
DUPLICATE_TYPE Tipo duplicado.

ErrorCode

O motivo do erro representado por tipo e tipo enumerado.

Campos
Campo de união error_code. A lista de enumerações de erros error_code só pode ser uma das seguintes:
request_error

RequestError

Um erro causado pela solicitação
query_error

QueryError

Um erro com a consulta
authorization_error

AuthorizationError

Ocorreu um erro ao tentar autorizar um usuário.
internal_error

InternalError

Um erro inesperado no servidor.
quota_error

QuotaError

Um erro com a quantidade de cota restante.
authentication_error

AuthenticationError

Indica falha na autenticação adequada do usuário.
date_error

DateError

Os motivos do erro de data
date_range_error

DateRangeError

Os motivos do erro no período
distinct_error

DistinctError

Os motivos do erro distinto
header_error

HeaderError

Os motivos do erro do cabeçalho.
size_limit_error

SizeLimitError

Os motivos do erro de limite de tamanho
custom_column_error

CustomColumnError

Os motivos do erro da coluna personalizada
invalid_parameter_error

InvalidParameterError

Os motivos dos erros de parâmetro inválido.

ErrorDetails

Mais detalhes do erro.

Campos
unpublished_error_code

string

O código de erro que deveria ter sido retornado, mas não foi. É usado quando o código de erro não é publicado na versão especificada pelo cliente.
quota_error_details

QuotaErrorDetails

Detalhes sobre o erro de cota, incluindo o escopo (conta ou desenvolvedor), o nome do intervalo de taxa e o atraso da nova tentativa.

ErrorLocation

Descreve a parte do proto de solicitação que causou o erro.

Campos
field_path_elements[]

FieldPathElement

Um caminho de campo que indica qual campo foi inválido na solicitação.

FieldPathElement

Uma parte de um caminho de campo.

Campos
field_name

string

O nome de um campo ou de um campo "oneof"
index

int32

Se field_name for um campo repetido, esse será o elemento que falhou.

HeaderErrorEnum

Esse tipo não tem campos.

Contêiner para enumeração que descreve possíveis erros de cabeçalho.

HeaderError

Enumeração que descreve possíveis erros de cabeçalho.

Enums
UNSPECIFIED Enum não especificado.
UNKNOWN O código de erro recebido não é conhecido nesta versão.
INVALID_USER_SELECTED_CUSTOMER_ID Não foi possível validar o ID de cliente selecionado pelo usuário.
INVALID_LOGIN_CUSTOMER_ID Não foi possível validar o ID de cliente de login.

InternalErrorEnum

Esse tipo não tem campos.

Contêiner para enumeração que descreve possíveis erros internos.

InternalError

Enumeração que descreve possíveis erros internos.

Enums
UNSPECIFIED Enum não especificado.
UNKNOWN O código de erro recebido não é conhecido nesta versão.
INTERNAL_ERROR A API encontrou um erro interno inesperado.
ERROR_CODE_NOT_PUBLISHED O código de erro pretendido não existe na versão da API especificada. Ele será lançado em uma versão futura da API.
TRANSIENT_ERROR A API encontrou um erro temporário inesperado. Nesses casos, o usuário precisa tentar novamente.
DEADLINE_EXCEEDED A solicitação demorou mais do que o prazo.

InvalidParameterErrorEnum

Esse tipo não tem campos.

Contêiner para enumeração que descreve possíveis erros de um parâmetro inválido.

InvalidParameterError

Enum que descreve possíveis erros de parâmetro.

Enums
UNSPECIFIED Enum não especificado.
UNKNOWN O código de erro recebido não é conhecido nesta versão.
INVALID_CURRENCY_CODE O código de moeda especificado é inválido.

QueryErrorEnum

Esse tipo não tem campos.

Contêiner para enumeração que descreve possíveis erros de consulta.

QueryError

Enumeração que descreve possíveis erros de consulta.

Enums
UNSPECIFIED Nome não especificado.
UNKNOWN O código de erro recebido não é conhecido nesta versão.
QUERY_ERROR Retornado se todos os outros motivos de erro de consulta não forem aplicáveis.
BAD_ENUM_CONSTANT Uma condição usada na consulta faz referência a uma constante de tipo enumerado inválida.
BAD_ESCAPE_SEQUENCE A consulta contém uma sequência de escape inválida.
BAD_FIELD_NAME O nome do campo é inválido.
BAD_LIMIT_VALUE O valor do limite é inválido (por exemplo, não é um número)
BAD_NUMBER Não foi possível analisar o número encontrado.
BAD_OPERATOR Operador inválido encontrado.
BAD_PARAMETER_NAME Parâmetro desconhecido ou sem suporte.
BAD_PARAMETER_VALUE O parâmetro tem um valor inválido.
BAD_RESOURCE_TYPE_IN_FROM_CLAUSE Um tipo de recurso inválido foi especificado na cláusula FROM.
BAD_SYMBOL Um símbolo não ASCII foi encontrado fora das strings.
BAD_VALUE O valor é inválido.
DATE_RANGE_TOO_WIDE Os filtros de data não conseguem restringir a data a um período menor que 31 dias. Aplicável se a consulta for segmentada por data.
DATE_RANGE_TOO_NARROW Os filtros de data/semana/mês/trimestre têm uma data de início após a data de término.
EXPECTED_AND AND esperado entre valores com o operador BETWEEN.
EXPECTED_BY Espera-se que ORDER BY tenha BY.
EXPECTED_DIMENSION_FIELD_IN_SELECT_CLAUSE Nenhum campo de dimensão foi selecionado.
EXPECTED_FILTERS_ON_DATE_RANGE Filtros ausentes em campos relacionados à data.
EXPECTED_FROM Cláusula FROM ausente.
EXPECTED_LIST O operador usado nas condições exige que o valor seja uma lista.
EXPECTED_REFERENCED_FIELD_IN_SELECT_CLAUSE Os campos usados nas cláusulas WHERE ou ORDER BY estão ausentes na cláusula SELECT.
EXPECTED_SELECT O SELECT está ausente no início da consulta.
EXPECTED_SINGLE_VALUE Uma lista foi transmitida como um valor para uma condição em que o operador espera um único valor.
EXPECTED_VALUE_WITH_BETWEEN_OPERATOR Um ou ambos os valores com o operador BETWEEN estão ausentes.
INVALID_DATE_FORMAT Formato de data inválido. Espera-se 'AAAA-MM-DD'.
MISALIGNED_DATE_FOR_FILTER Valor de data fora do alinhamento para o filtro. A data precisa ser o início de uma semana/mês/trimestre se o campo filtrado for segments.week/segments.month/segments.quarter.
INVALID_STRING_VALUE O valor transmitido não era uma string quando deveria ser. Por exemplo, um número ou um literal sem aspas.
INVALID_VALUE_WITH_BETWEEN_OPERATOR Um valor de string transmitido ao operador BETWEEN não é analisado como uma data.
INVALID_VALUE_WITH_DURING_OPERATOR O valor transmitido para o operador DURING não é um literal de período
INVALID_VALUE_WITH_LIKE_OPERATOR Um valor foi transmitido para o operador LIKE.
OPERATOR_FIELD_MISMATCH Um operador foi fornecido que não é aplicável ao campo filtrado.
PROHIBITED_EMPTY_LIST_IN_CONDITION Uma condição foi encontrada com uma lista vazia.
PROHIBITED_ENUM_CONSTANT Uma condição usada na consulta faz referência a uma constante de tipo enumerado sem suporte.
PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE Os campos que não podem ser selecionados juntos foram incluídos na cláusula SELECT.
PROHIBITED_FIELD_IN_ORDER_BY_CLAUSE Um campo que não pode ser classificado foi incluído na cláusula ORDER BY.
PROHIBITED_FIELD_IN_SELECT_CLAUSE Um campo não selecionável foi incluído na cláusula SELECT.
PROHIBITED_FIELD_IN_WHERE_CLAUSE Um campo que não pode ser filtrado foi incluído na cláusula WHERE.
PROHIBITED_RESOURCE_TYPE_IN_FROM_CLAUSE O tipo de recurso especificado na cláusula FROM não é aceito por este serviço.
PROHIBITED_RESOURCE_TYPE_IN_SELECT_CLAUSE Um campo de um recurso incompatível foi incluído na cláusula SELECT.
PROHIBITED_RESOURCE_TYPE_IN_WHERE_CLAUSE Um campo que vem de um recurso incompatível foi incluído na cláusula WHERE.
PROHIBITED_METRIC_IN_SELECT_OR_WHERE_CLAUSE Uma métrica incompatível com o recurso principal ou outros recursos de segmentação selecionados foi incluída na cláusula SELECT ou WHERE.
PROHIBITED_SEGMENT_IN_SELECT_OR_WHERE_CLAUSE Um segmento incompatível com o recurso principal ou outros recursos de segmentação selecionados foi incluído na cláusula SELECT ou WHERE.
PROHIBITED_SEGMENT_WITH_METRIC_IN_SELECT_OR_WHERE_CLAUSE Um segmento na cláusula SELECT é incompatível com uma métrica na cláusula SELECT ou WHERE.
LIMIT_VALUE_TOO_LOW O valor transmitido para a cláusula de limite é muito baixo.
PROHIBITED_NEWLINE_IN_STRING A consulta tem uma string que contém um caractere de nova linha.
PROHIBITED_VALUE_COMBINATION_IN_LIST A lista contém valores de tipos diferentes.
PROHIBITED_VALUE_COMBINATION_WITH_BETWEEN_OPERATOR Os valores transmitidos ao operador BETWEEN não são do mesmo tipo.
STRING_NOT_TERMINATED A consulta contém uma string não finalizada.
TOO_MANY_SEGMENTS Há muitos segmentos especificados na cláusula SELECT.
UNEXPECTED_END_OF_QUERY A consulta está incompleta e não pode ser analisada.
UNEXPECTED_FROM_CLAUSE A cláusula FROM não pode ser especificada nesta consulta.
UNRECOGNIZED_FIELD A consulta contém um ou mais campos não reconhecidos.
UNEXPECTED_INPUT A consulta tem uma parte extra inesperada.
REQUESTED_METRICS_FOR_MANAGER Não é possível solicitar métricas para uma conta de administrador. Para recuperar as métricas, faça solicitações separadas para cada conta de cliente na conta de administrador.
FILTER_HAS_TOO_MANY_VALUES O número de valores (operandos do lado direito) em um filtro excede o limite.

QuotaErrorDetails

Mais detalhes sobre o erro de cota quando há um QuotaError.

Campos
rate_scope

QuotaRateScope

O escopo da taxa do limite de cota.
rate_name

string

A descrição de alto nível do bucket de cota. Por exemplo, "Receber solicitações de acesso padrão" ou "Solicitações por conta".
retry_delay

Duration

Período de espera que os clientes precisam aguardar antes de enviar a próxima solicitação.

QuotaRateScope

Enum de possíveis escopos aos quais os buckets de cota pertencem.

Enums
UNSPECIFIED Tipo enumerado não especificado
UNKNOWN Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão.
ACCOUNT Cota por conta de cliente
DEVELOPER Cota por projeto

QuotaErrorEnum

Esse tipo não tem campos.

Contêiner para enumeração que descreve possíveis erros de cota.

QuotaError

Enumeração que descreve possíveis erros de cota.

Enums
UNSPECIFIED Enum não especificado.
UNKNOWN O código de erro recebido não é conhecido nesta versão.
RESOURCE_EXHAUSTED Excesso de solicitações.
RESOURCE_TEMPORARILY_EXHAUSTED Muitas solicitações em um curto período.

RequestErrorEnum

Esse tipo não tem campos.

Contêiner para enumeração que descreve possíveis erros de solicitação.

RequestError

Enumeração que descreve possíveis erros de solicitação.

Enums
UNSPECIFIED Enum não especificado.
UNKNOWN O código de erro recebido não é conhecido nesta versão.
RESOURCE_NAME_MISSING O nome do recurso é obrigatório para essa solicitação.
RESOURCE_NAME_MALFORMED O nome do recurso fornecido está incorreto.
BAD_RESOURCE_ID O nome do recurso fornecido está incorreto.
INVALID_PRODUCT_NAME O nome do produto é inválido.
INVALID_CUSTOMER_ID O ID do cliente é inválido.
OPERATION_REQUIRED A operação de mutação precisa ter criação, atualização ou remoção especificada.
RESOURCE_NOT_FOUND O recurso solicitado não foi encontrado.
INVALID_PAGE_TOKEN O token da próxima página especificado na solicitação do usuário é inválido.
EXPIRED_PAGE_TOKEN O token da próxima página especificado na solicitação do usuário expirou.
INVALID_PAGE_SIZE O tamanho da página especificado na solicitação do usuário é inválido.
REQUIRED_FIELD_MISSING Está faltando um campo obrigatório.
IMMUTABLE_FIELD O campo não pode ser modificado porque é imutável. Também é possível modificar o campo usando a operação "criar", mas não a "atualizar".
TOO_MANY_MUTATE_OPERATIONS Recebemos muitas entradas na solicitação.
CANNOT_BE_EXECUTED_BY_MANAGER_ACCOUNT A solicitação não pode ser executada por uma conta de administrador.
CANNOT_MODIFY_FOREIGN_FIELD A solicitação de mutação estava tentando modificar um campo somente leitura. Por exemplo, os campos de orçamento podem ser solicitados para o grupo de anúncios, mas são somente leitura para adGroups:mutate.
INVALID_ENUM_VALUE O valor de enumeração não é permitido.
LOGIN_CUSTOMER_ID_PARAMETER_MISSING O parâmetro "login-customer-id" é obrigatório para essa solicitação.
LOGIN_OR_LINKED_CUSTOMER_ID_PARAMETER_REQUIRED O parâmetro login-customer-id ou linked-customer-id é obrigatório para essa solicitação.
VALIDATE_ONLY_REQUEST_HAS_PAGE_TOKEN page_token é definido na solicitação de validação
CANNOT_RETURN_SUMMARY_ROW_FOR_REQUEST_WITHOUT_METRICS return_summary_row não pode ser ativado se a solicitação não selecionar nenhum campo de métricas.
CANNOT_RETURN_SUMMARY_ROW_FOR_VALIDATE_ONLY_REQUESTS return_summary_row não deve ser ativado para validar apenas solicitações.
INCONSISTENT_RETURN_SUMMARY_ROW_VALUE O valor do parâmetro return_summary_row precisa ser o mesmo entre as solicitações com o campo "page_token" definido e a solicitação original.
TOTAL_RESULTS_COUNT_NOT_ORIGINALLY_REQUESTED A contagem total de resultados não pode ser retornada se não tiver sido solicitada na solicitação original.
RPC_DEADLINE_TOO_SHORT O prazo especificado pelo cliente foi muito curto.
PRODUCT_NOT_SUPPORTED O produto associado à solicitação não é compatível com a solicitação atual.

SearchAds360Error

Erro específico do Search Ads 360.

Campos
error_code

ErrorCode

Um valor de tipo enumerado que indica qual erro ocorreu.
message

string

Uma descrição legível do erro.
trigger

Value

O valor que acionou o erro.
location

ErrorLocation

Descreve a parte do proto de solicitação que causou o erro.
details

ErrorDetails

Mais detalhes do erro, que são retornados por determinados códigos de erro. A maioria dos códigos de erro não inclui detalhes.

SearchAds360Failure

Descreve como uma chamada da API Search Ads 360 falhou. Ele é retornado em google.rpc.Status.details quando uma chamada falha.

Campos
errors[]

SearchAds360Error

A lista de erros que ocorreram.
request_id

string

O ID exclusivo da solicitação usado para fins de depuração.

SizeLimitErrorEnum

Esse tipo não tem campos.

Contêiner para enumeração que descreve possíveis erros de limite de tamanho.

SizeLimitError

Enumeração que descreve possíveis erros de limite de tamanho.

Enums
UNSPECIFIED Enum não especificado.
UNKNOWN O código de erro recebido não é conhecido nesta versão.
REQUEST_SIZE_LIMIT_EXCEEDED O número de entradas na solicitação excede o limite do sistema ou o conteúdo das operações excede os limites de transação devido ao tamanho ou à complexidade. Tente reduzir o número de entradas por solicitação.
RESPONSE_SIZE_LIMIT_EXCEEDED O número de entradas na resposta excede o limite do sistema.