Package google.ads.searchads360.v0.errors

Índice

AuthenticationErrorEnum

Esse tipo não tem campos.

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

AuthenticationError

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

Tipos enumerados
UNSPECIFIED Enumeração não especificada.
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 fornecido.
GOOGLE_ACCOUNT_DELETED A Conta do Google do cliente foi 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 token de login da Conta do Google do usuário 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 nova 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á incorreto.
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 de uma enumeração que descreve possíveis erros de autorização.

AuthorizationError

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

Tipos enumerados
UNSPECIFIED Enumeração não especificada.
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, o ID de cliente do gerente precisa ser 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, ADICIONAR, ATUALIZAR, REMOVER) no recurso ou chamar um método.
INCOMPLETE_SIGNUP Inscrição não concluída.
CUSTOMER_NOT_ENABLED Não é possível acessar a conta do cliente porque ela ainda não foi ativada ou foi desativada.
MISSING_TOS O desenvolvedor precisa assinar os Termos de Serviço. Eles podem ser encontrados 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, por isso 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 é permitido na API Search Ads 360. 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 de enumeração que descreve possíveis erros de coluna personalizada.

CustomColumnError

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

Tipos enumerados
UNSPECIFIED Enumeração não especificada.
UNKNOWN O código de erro recebido não é conhecido nesta versão.
CUSTOM_COLUMN_NOT_FOUND Não foi possível encontrar a coluna personalizada.
CUSTOM_COLUMN_NOT_AVAILABLE A coluna personalizada não está disponível.

DateErrorEnum

Esse tipo não tem campos.

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

DateError

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

Tipos enumerados
UNSPECIFIED Enumeração não especificada.
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álida.
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 deve ser aaaa-mm-dd hh:mm:ss.ssssss.
INVALID_STRING_DATE_TIME_SECONDS O formato da data e hora da string deve ser aaaa-mm-dd hh:mm:ss.
INVALID_STRING_DATE_TIME_SECONDS_WITH_OFFSET O formato da data e hora da string deve 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 de uma enumeração que descreve possíveis erros de período.

DateRangeError

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

Tipos enumerados
UNSPECIFIED Enumeração não especificada.
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 era posterior à data de término.
CANNOT_SET_DATE_TO_PAST Não é possível definir a data como um horário no passado
AFTER_MAXIMUM_ALLOWABLE_DATE Foi usada uma data posterior à "última" data do sistema.
CANNOT_MODIFY_START_DATE_IF_ALREADY_STARTED Tentativa de alterar a data de início de um recurso que já começou.

DistinctErrorEnum

Esse tipo não tem campos.

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

DistinctError

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

Tipos enumerados
UNSPECIFIED Enumeração não especificada.
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 enum.

Campos
Campo de união error_code. A lista de tipos enumerados de erro error_code pode ser apenas uma das seguintes opções:
request_error

RequestError

Um erro causado pela solicitação
query_error

QueryError

Um erro com a consulta
authorization_error

AuthorizationError

Um erro encontrado ao tentar autorizar um usuário.
internal_error

InternalError

Erro inesperado do lado do servidor.
quota_error

QuotaError

Um erro com a quantidade de cota restante.
authentication_error

AuthenticationError

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

DateError

Motivos do erro de data
date_range_error

DateRangeError

Motivos do erro de período
distinct_error

DistinctError

Os motivos para o erro distinto
header_error

HeaderError

Os motivos do erro de cabeçalho.
size_limit_error

SizeLimitError

Motivos para o erro de limite de tamanho
custom_column_error

CustomColumnError

Motivos do erro de coluna personalizada
invalid_parameter_error

InvalidParameterError

Motivos dos erros de parâmetro inválido.

ErrorDetails

Mais detalhes do erro.

Campos
unpublished_error_code

string

O código do 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 bucket de taxa e o tempo de espera para a nova tentativa.

ErrorLocation

Descreve a parte do protótipo de solicitação que causou o erro.

Campos
field_path_elements[]

FieldPathElement

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

FieldPathElement

Parte de um caminho de campo.

Campos
field_name

string

O nome de um campo
index

int32

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

HeaderErrorEnum

Esse tipo não tem campos.

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

HeaderError

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

Tipos enumerados
UNSPECIFIED Enumeração não especificada.
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 de uma enumeração que descreve possíveis erros internos.

InternalError

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

Tipos enumerados
UNSPECIFIED Enumeração não especificada.
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 especificada da API. Ela será lançada em uma versão futura da API.
TRANSIENT_ERROR A API encontrou um erro temporário inesperado. O usuário precisa repetir a solicitação nesses casos.
DEADLINE_EXCEEDED A solicitação demorou mais do que um prazo.

InvalidParameterErrorEnum

Esse tipo não tem campos.

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

InvalidParameterError

Enumeração que descreve possíveis erros de parâmetro.

Tipos enumerados
UNSPECIFIED Enumeração não especificada.
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 de uma enumeração que descreve possíveis erros de consulta.

QueryError

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

Tipos enumerados
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 enumeração 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 é possível analisar o número encontrado.
BAD_OPERATOR Operador inválido encontrado.
BAD_PARAMETER_NAME Parâmetro desconhecido ou incompatível.
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 Símbolo não ASCII encontrado fora das strings.
BAD_VALUE O valor é inválido.
DATE_RANGE_TOO_WIDE Os filtros de data não restringem 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 por data/semana/mês/trimestre têm uma data de início posterior à data de término.
EXPECTED_AND AND esperado entre valores com o operador BETWEEN.
EXPECTED_BY Esperar que ORDER BY tenha BY.
EXPECTED_DIMENSION_FIELD_IN_SELECT_CLAUSE Nenhum campo de dimensão foi selecionado.
EXPECTED_FILTERS_ON_DATE_RANGE Faltam filtros nos 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 Está faltando SELECT 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 Faltam um ou ambos os valores com o operador BETWEEN.
INVALID_DATE_FORMAT Formato de data inválido. Esperado "AAAA-MM-DD".
MISALIGNED_DATE_FOR_FILTER Valor de data desalinhado para o filtro. A data deve 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 passado não era uma string quando deveria ser. Por exemplo, era um número ou literal sem aspas.
INVALID_VALUE_WITH_BETWEEN_OPERATOR Um valor de string passado para o operador BETWEEN não é analisado como uma data.
INVALID_VALUE_WITH_DURING_OPERATOR O valor passado 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 O operador fornecido é inaplicá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 enumeração sem suporte.
PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE Os campos que não podem ser selecionados em conjunto foram incluídos na cláusula SELECT.
PROHIBITED_FIELD_IN_ORDER_BY_CLAUSE Um campo que não pode ser ordenado 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 não filtrável foi incluído na cláusula WHERE.
PROHIBITED_RESOURCE_TYPE_IN_FROM_CLAUSE O tipo de recurso especificado na cláusula FROM não é suportado por este serviço.
PROHIBITED_RESOURCE_TYPE_IN_SELECT_CLAUSE Um campo proveniente de um recurso incompatível foi incluído na cláusula SELECT.
PROHIBITED_RESOURCE_TYPE_IN_WHERE_CLAUSE Um campo proveniente 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 à 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 passados para o operador BETWEEN não são do mesmo tipo.
STRING_NOT_TERMINATED A consulta contém uma string não terminada.
TOO_MANY_SEGMENTS Muitos segmentos foram 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 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 (operadores do lado direito) em um filtro excede o limite.

QuotaErrorDetails

Detalhes extras de erros de cota quando há 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 cotas. 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 esperar antes de enviar a próxima solicitação.

QuotaRateScope

Enumeração dos possíveis escopos aos quais os buckets de cota pertencem.

Tipos enumerados
UNSPECIFIED Enumeração não especificada
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
ACCOUNT Cota da conta do cliente
DEVELOPER Cota por projeto

QuotaErrorEnum

Esse tipo não tem campos.

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

QuotaError

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

Tipos enumerados
UNSPECIFIED Enumeração não especificada.
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 de enumeração que descreve possíveis erros de solicitação.

RequestError

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

Tipos enumerados
UNSPECIFIED Enumeração não especificada.
UNKNOWN O código de erro recebido não é conhecido nesta versão.
RESOURCE_NAME_MISSING O nome do recurso é obrigatório para esta 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 de cliente é inválido.
OPERATION_REQUIRED A operação de modificação deve 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 de 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 com "atualização".
TOO_MANY_MUTATE_OPERATIONS Recebeu 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 modificação estava tentando modificar um campo somente leitura. Por exemplo, os campos "Orçamento" podem ser solicitados para "Grupo de anúncios", mas são somente leitura para "adGroups:mutate".
INVALID_ENUM_VALUE O valor de tipo enumerado 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 somente
CANNOT_RETURN_SUMMARY_ROW_FOR_REQUEST_WITHOUT_METRICS return_summary_row não pode ser ativado se a solicitação não seleciona nenhum campo Metrics.
CANNOT_RETURN_SUMMARY_ROW_FOR_VALIDATE_ONLY_REQUESTS return_summary_row não deve ser ativado para solicitações somente de validação.
INCONSISTENT_RETURN_SUMMARY_ROW_VALUE O valor do parâmetro return_summary_row deve 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 poderá ser retornada se não tiver sido solicitada na solicitação original.
RPC_DEADLINE_TOO_SHORT O prazo especificado pelo cliente era 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 enumeração 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 protótipo de solicitação que causou o erro.
details

ErrorDetails

Detalhes adicionais 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 falha na chamada da API do Search Ads 360. É retornado dentro de 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 de uma enumeração que descreve possíveis erros de limite de tamanho.

SizeLimitError

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

Tipos enumerados
UNSPECIFIED Enumeração não especificada.
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.