Package google.ads.searchads360.v0.resources

string

O nome do recurso da estratégia de lances acessível. Os nomes dos recursos AccessibleBiddingStrategy têm o seguinte formato:

customers/{customer_id}/accessibleBiddingStrategies/{bidding_strategy_id}

int64

O ID da estratégia de lances.

string

É o nome da estratégia de lances.

BiddingStrategyType

É o tipo de estratégia de lances.

int64

O ID do cliente proprietário da estratégia de lances.

string

descriptive_name do cliente proprietário da estratégia de lances.

MaximizeConversionValue

Uma estratégia de lances automática que ajuda a gerar o maior valor de conversão para suas campanhas sem exceder o orçamento.

MaximizeConversions

Uma estratégia de lances automática para gerar o maior número possível de conversões nas suas campanhas sem ultrapassar o orçamento.

TargetCpa

Uma estratégia de lances que define lances para ajudar a gerar o maior número possível de conversões com o custo por aquisição (CPA) desejado.

TargetImpressionShare

Uma estratégia de lances que otimiza automaticamente para uma porcentagem escolhida de impressões.

TargetRoas

Uma estratégia de lances que ajuda a maximizar a receita enquanto calcula a média de um retorno do investimento em publicidade (ROAS) desejado específico.

TargetSpend

Uma estratégia que define os lances para conseguir o máximo de cliques possível com o orçamento disponível.

double

Opção de retorno do investimento em publicidade (ROAS) desejado Se definida, a estratégia de lances maximizará a receita ao calcular a média do retorno do investimento em publicidade desejado. Se o ROAS desejado for alto, talvez a estratégia de lances não gaste todo o orçamento. Se o ROAS desejado não estiver definido, a estratégia de lances tentará atingir o maior ROAS possível para o orçamento.

int64

A opção de custo por aquisição (CPA) desejado. Esse é o valor médio que você quer gastar por aquisição.

int64

A opção de custo por aquisição (CPA) desejado. Esse é o valor médio que você quer gastar por aquisição.

int64

Meta de CPA médio. Essa meta deve ser maior ou igual ao mínimo de unidades faturáveis baseadas na moeda da conta.

TargetImpressionShareLocation

O local segmentado na página de resultados da pesquisa.

int64

A fração escolhida de anúncios a serem exibidos no local segmentado em micros. Por exemplo, 1% é igual a 10.000.

int64

O lance de CPC mais alto que o sistema de lances automáticos pode especificar. É um campo obrigatório inserido pelo anunciante que estabelece o limite e é especificado nos micros locais.

double

Receita escolhida (com base nos dados de conversão) por unidade de gasto.

int64

A meta de gastos na qual maximizar os cliques. Um bidder TargetSpend tentará gastar o menor valor desse montante ou o valor de gasto de limitação natural. Se não for especificado, o orçamento será usado como a meta de gastos. Este campo foi descontinuado e não deve mais ser usado. Consulte https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html para saber mais.

int64

Limite de lance máximo que pode ser definido pela estratégia de lances. O limite se aplica a todas as palavras-chave gerenciadas pela estratégia.

string

O nome do recurso do anúncio. Os nomes dos recursos de anúncios têm o seguinte formato:

customers/{customer_id}/ads/{ad_id}

string

A lista dos possíveis URLs finais após todos os redirecionamentos de vários domínios do anúncio.

AdType

O tipo de anúncio.

int64

O ID do anúncio.

string

É o URL exibido na descrição de alguns formatos de anúncio.

string

É o nome do anúncio. Isso é usado apenas para identificar o anúncio. Ele não precisa ser único e não afeta o anúncio veiculado. No momento, o campo de nome só é compatível com DisplayUploadAd, ImageAd, ShoppingComparisonListingAd e VideoAd.

SearchAds360TextAdInfo

Detalhes relacionados a um anúncio de texto.

SearchAds360ExpandedTextAdInfo

Detalhes relacionados a um anúncio de texto expandido.

SearchAds360ResponsiveSearchAdInfo

Detalhes relacionados a um anúncio responsivo de pesquisa.

SearchAds360ProductAdInfo

Detalhes relacionados a um anúncio de produto.

SearchAds360ExpandedDynamicSearchAdInfo

Detalhes relacionados a um anúncio dinâmico expandido de pesquisa.

string

O nome de recurso do grupo de anúncios. Os nomes dos recursos do grupo de anúncios têm o seguinte formato:

customers/{customer_id}/adGroups/{ad_group_id}

AdGroupStatus

O status do grupo de anúncios.

AdGroupType

O tipo do grupo de anúncios.

AdGroupAdRotationMode

Modo de rotação de anúncios do grupo de anúncios.

string

O carimbo de data/hora em que esse ad_group foi criado. O carimbo de data/hora está no fuso horário do cliente e no formato "aaaa-MM-dd HH:mm:ss".

TargetingSetting

Configuração para recursos relacionados à segmentação.

string

Os nomes de recursos dos rótulos anexados a este grupo de anúncios.

string

Os nomes dos recursos dos rótulos efetivos anexados a este grupo de anúncios. Um rótulo efetivo é um rótulo herdado ou atribuído diretamente a esse grupo de anúncios.

string

ID do grupo de anúncios na conta de mecanismo externo. Esse campo é somente para contas que não são do Google Ads (por exemplo, Yahoo Japan, Microsoft, Baidu etc.). Para a entidade do Google Ads, use "ad_group.id".

string

Data em que o grupo de anúncios começa a veicular anúncios. Por padrão, o grupo de anúncios começa agora ou na data de início do grupo de anúncios, o que for posterior. Se esse campo for definido, o grupo de anúncios começará no início da data especificada no fuso horário do cliente. Esse campo só está disponível para contas de gateway do Microsoft Advertising e do Facebook.

Formato: AAAA-MM-DD Exemplo: 2019-03-14

string

Data em que o grupo de anúncios termina de veicular anúncios. Por padrão, o grupo de anúncios termina na data de término do grupo de anúncios. Se esse campo for definido, o grupo de anúncios terminará no final da data especificada no fuso horário do cliente. Esse campo só está disponível para contas de gateway do Microsoft Advertising e do Facebook.

Formato: AAAA-MM-DD Exemplo: 2019-03-14

string

O idioma dos anúncios e das palavras-chave em um grupo de anúncios. Esse campo só está disponível para contas do Microsoft Advertising. Mais detalhes: https://docs.microsoft.com/en-us/advertising/guides/ad-languages?view=bingads-13#adlanguage

string

A data e a hora em que esse grupo de anúncios foi modificado pela última vez. A data e hora está no fuso horário do cliente e no formato "aaaa-MM-dd HH:mm:ss.ssssss".

int64

O ID do grupo de anúncios.

string

O nome do grupo de anúncios.

Este campo é obrigatório e não deve ficar vazio ao criar novos grupos de anúncios.

Ele precisa ter menos de 255 caracteres UTF-8 de largura total.

Ele não pode conter nenhum caractere nulo (ponto de código 0x0), feed de linha NL (ponto de código 0xA) nem retorno de carro (ponto de código 0xD).

int64

É o lance máximo de CPC (custo por clique).

AdGroupEngineStatus

O status do mecanismo para o grupo de anúncios.

string

O nome do recurso do anúncio. Os nomes dos recursos de anúncios do grupo de anúncios têm o seguinte formato:

customers/{customer_id}/adGroupAds/{ad_group_id}~{ad_id}

AdGroupAdStatus

O status do anúncio.

Ad

O anúncio.

string

A data e a hora em que o ad_group_ad foi criado. A data e hora está no fuso horário do cliente e no formato "aaaa-MM-dd HH:mm:ss.ssssss".

string

Os nomes dos recursos dos rótulos anexados ao anúncio do grupo de anúncios.

string

Os nomes dos recursos dos rótulos efetivos anexados a este anúncio. Um rótulo efetivo é um rótulo herdado ou atribuído diretamente a esse anúncio.

string

É o ID do anúncio na conta de mecanismo externo. Esse campo é somente para contas do Search Ads 360, por exemplo, Yahoo Japan, Microsoft, Baidu etc. Para entidades que não são do Search Ads 360, use "ad_group_ad.ad.id".

AdGroupAdEngineStatus

Status adicional do anúncio na conta de mecanismo externo. Os status possíveis (dependendo do tipo de conta externa) incluem ativa, qualificada, revisão pendente etc.

string

A data e a hora em que o anúncio desse grupo de anúncios foi modificado pela última vez. A data e hora está no fuso horário do cliente e no formato "aaaa-MM-dd HH:mm:ss.ssssss".

string

O nome do recurso do rótulo de eficiência do anúncio do grupo de anúncios. Os nomes dos recursos de rótulo efetivo do anúncio do grupo de anúncios têm o seguinte formato: customers/{customer_id}/adGroupAdEffectiveLabels/{ad_group_id}~{ad_id}~{label_id}

string

O anúncio do grupo de anúncios ao qual o rótulo efetivo está anexado.

string

O rótulo efetivo atribuído ao anúncio do grupo de anúncios.

int64

O ID do cliente que possui o rótulo efetivo.

string

Nome do recurso do rótulo do anúncio do grupo de anúncios. Os nomes dos recursos do rótulo de anúncios do grupo de anúncios têm o formato: customers/{customer_id}/adGroupAdLabels/{ad_group_id}~{ad_id}~{label_id}

string

O anúncio de grupo de anúncios ao qual o rótulo está anexado.

string

Rótulo atribuído ao anúncio do grupo de anúncios.

int64

O ID do cliente proprietário do rótulo.

string

O nome do recurso do grupo de anúncios. Os nomes dos recursos de AdGroupAsset têm o seguinte formato:

customers/{customer_id}/adGroupAssets/{ad_group_id}~{asset_id}~{field_type}

string

Obrigatório. O grupo de anúncios ao qual o recurso está vinculado.

string

Obrigatório. O recurso que está vinculado ao grupo de anúncios.

AssetLinkStatus

Status do recurso do grupo de anúncios.

string

O nome do recurso do conjunto de recursos do grupo de anúncios. Os nomes dos recursos do conjunto de recursos do grupo de anúncios têm o seguinte formato:

customers/{customer_id}/adGroupAssetSets/{ad_group_id}~{asset_set_id}

string

O grupo de anúncios ao qual esse conjunto de recursos está vinculado.

string

O conjunto de recursos vinculado ao grupo de anúncios.

AssetSetLinkStatus

O status do conjunto de recursos do grupo de anúncios. Somente leitura.

string

O nome do recurso da visualização do público-alvo do grupo de anúncios. Os nomes dos recursos da visualização do público-alvo do grupo de anúncios têm o formato:

customers/{customer_id}/adGroupAudienceViews/{ad_group_id}~{criterion_id}

string

O nome do recurso do modificador de lance do grupo de anúncios. Os nomes dos recursos do modificador de lance do grupo de anúncios têm o seguinte formato:

customers/{customer_id}/adGroupBidModifiers/{ad_group_id}~{criterion_id}

double

O modificador do lance quando o critério corresponde. O modificador precisa estar no intervalo: 0,1 a 10,0. O intervalo é de 1,0 a 6,0 para PreferredContent. Use 0 para desativar um tipo de dispositivo.

DeviceInfo

Um critério de dispositivo.

string

O nome do recurso do critério do grupo de anúncios. Os nomes dos recursos do critério do grupo de anúncios têm o seguinte formato:

customers/{customer_id}/adGroupCriteria/{ad_group_id}~{criterion_id}

string

A data e a hora em que esse critério do grupo de anúncios foi criado. O carimbo de data/hora está no fuso horário do cliente e no formato "aaaa-MM-dd HH:mm:ss".

AdGroupCriterionStatus

O status do critério.

Este é o status da entidade do critério do grupo de anúncios, definido pelo cliente. Observação: os relatórios da interface do usuário podem incorporar informações adicionais que afetam a qualificação de um critério para execução. Em alguns casos, um critério REMOVIDO na API ainda pode aparecer como ativado na IU. Por exemplo, as campanhas são exibidas por padrão para usuários de todas as faixas etárias, a menos que sejam excluídas. A interface vai mostrar cada faixa etária como "ativada", já que elas estão qualificadas para ver os anúncios. mas gclid.status mostrará "removido", já que nenhum critério positivo foi adicionado.

QualityInfo

Informações sobre a qualidade do critério.

CriterionType

Tipo do critério.

string

Os nomes dos recursos dos rótulos anexados a este critério do grupo de anúncios.

string

Os nomes dos recursos dos rótulos efetivos anexados a este critério do grupo de anúncios. Um rótulo eficaz é um rótulo herdado ou atribuído diretamente a esse critério do grupo de anúncios.

PositionEstimates

Estimativas para lances de critério em várias posições.

string

A lista dos possíveis URLs finais após todos os redirecionamentos de vários domínios do anúncio.

string

ID do critério do grupo de anúncios na conta de mecanismo externo. Esse campo é apenas para contas que não são do Google Ads, por exemplo, Yahoo Japan, Microsoft, Baidu etc. Para a entidade do Google Ads, use "ad_group_criterion.criterion_id".

string

A data e a hora em que esse critério do grupo de anúncios foi modificado pela última vez. A data e hora está no fuso horário do cliente e no formato "aaaa-MM-dd HH:mm:ss.ssssss".

int64

ID do critério.

string

O grupo de anúncios ao qual o critério pertence.

bool

Indica se o critério será segmentado (false) ou excluído (true).

Este campo não pode ser modificado. Para mudar um critério de positivo para negativo, remova-o e adicione-o novamente.

double

O modificador do lance quando o critério corresponde. O modificador precisa estar no intervalo: 0,1 a 10,0. A maioria dos tipos de critérios segmentáveis são compatíveis com modificadores.

int64

Lance de CPC (custo por clique).

int64

O lance de CPC (custo por clique) efetivo.

AdGroupCriterionEngineStatus

O status do mecanismo para o critério do grupo de anúncios.

string

Modelo de URL para anexar parâmetros ao URL final.

string

O modelo de URL para criar um URL de rastreamento.

KeywordInfo

Palavra-chave.

ListingGroupInfo

Grupo de produtos anunciados.

AgeRangeInfo

Faixa etária.

GenderInfo

Gênero.

UserListInfo

Lista de usuários.

WebpageInfo

Página da Web

LocationInfo

Local.

int64

A estimativa do lance de CPC necessário para que o anúncio seja exibido na parte superior da primeira página dos resultados de pesquisa.

int32

Índice de qualidade.

Esse campo não será preenchido se o Google não tiver informações suficientes para determinar um valor.

string

O nome do recurso do rótulo efetivo do critério do grupo de anúncios. Os nomes dos recursos do rótulo do critério do grupo de anúncios têm o formato: customers/{customer_id}/adGroupCriterionEffectiveLabels/{ad_group_id}~{criterion_id}~{label_id}

string

O critério do grupo de anúncios ao qual o rótulo efetivo está anexado.

string

O rótulo efetivo atribuído ao critério do grupo de anúncios.

int64

O ID do cliente que possui o rótulo efetivo.

string

Nome do recurso do rótulo do critério do grupo de anúncios. Os nomes dos recursos do rótulo do critério do grupo de anúncios têm o formato: customers/{customer_id}/adGroupCriterionLabels/{ad_group_id}~{criterion_id}~{label_id}

string

O critério do grupo de anúncios ao qual o rótulo está anexado.

string

Rótulo atribuído ao critério do grupo de anúncios.

int64

O ID do cliente proprietário do rótulo.

string

O nome do recurso do rótulo eficaz do grupo de anúncios. Os nomes dos recursos do rótulo eficaz do grupo de anúncios têm o formato: customers/{customer_id}/adGroupEffectiveLabels/{ad_group_id}~{label_id}

string

O grupo de anúncios ao qual o rótulo eficaz está anexado.

string

O rótulo efetivo atribuído ao grupo de anúncios.

int64

O ID do cliente que possui o rótulo efetivo.

string

Nome do recurso do rótulo do grupo de anúncios. Os nomes dos recursos do rótulo do grupo de anúncios têm o formato: customers/{customer_id}/adGroupLabels/{ad_group_id}~{label_id}

string

O grupo de anúncios ao qual o rótulo está anexado.

string

Rótulo atribuído ao grupo de anúncios.

int64

O ID do cliente proprietário do rótulo.

string

O nome do recurso da visualização de faixa etária. Os nomes dos recursos de visualização de faixa etária têm o seguinte formato:

customers/{customer_id}/ageRangeViews/{ad_group_id}~{criterion_id}

string

O nome do recurso. Os nomes dos recursos de recursos têm o seguinte formato:

customers/{customer_id}/assets/{asset_id}

AssetType

Tipo do recurso.

string

Uma lista de possíveis URLs finais após todos os redirecionamentos entre domínios.

AssetStatus

O status do recurso.

string

O carimbo de data/hora em que o recurso foi criada. O carimbo de data/hora está no fuso horário do cliente e no formato "aaaa-MM-dd HH:mm:ss".

string

A data e a hora em que este recurso foi modificado pela última vez. A data e hora está no fuso horário do cliente e no formato "aaaa-MM-dd HH:mm:ss.ssssss".

int64

O ID do recurso.

string

Nome opcional do recurso.

string

Modelo de URL para criar um URL de rastreamento.

AssetEngineStatus

O status do mecanismo de um recurso.

YoutubeVideoAsset

Um recurso de vídeo do YouTube.

ImageAsset

Um recurso de imagem.

TextAsset

Um recurso de texto.

UnifiedCalloutAsset

Um recurso de frase de destaque unificado.

UnifiedSitelinkAsset

Um recurso de sitelink unificado.

UnifiedPageFeedAsset

Um recurso de feed de páginas unificado.

MobileAppAsset

Um recurso de app para dispositivos móveis.

UnifiedCallAsset

Um recurso de ligação unificado.

CallToActionAsset

Um recurso de call-to-action.

UnifiedLocationAsset

Um recurso de local unificado.

string

O nome do recurso do grupo de recursos. Os nomes dos recursos do grupo de recursos têm o seguinte formato:

customers/{customer_id}/assetGroups/{asset_group_id}

int64

O ID do grupo de recursos.

string

A campanha associada a esse grupo de recursos. O recurso que está vinculado ao grupo.

string

Obrigatório. Nome do grupo de recursos. Obrigatório. Precisa ter no mínimo 1 e no máximo 128 caracteres. Ele precisa ser exclusivo em uma campanha.

string

Uma lista de URLs finais após todos os redirecionamentos entre domínios. Nas campanhas Performance Max, os URLs são qualificados para expansão por padrão, a menos que a expansão seja desativada.

string

Uma lista de URLs finais para dispositivos móveis após todos os redirecionamentos de vários domínios. Nas campanhas Performance Max, os URLs são qualificados para expansão por padrão, a menos que a expansão seja desativada.

AssetGroupStatus

O status do grupo de recursos.

string

Primeira parte do texto que pode aparecer anexado ao URL exibido no anúncio.

string

Segunda parte do texto que pode aparecer anexada ao URL exibido no anúncio. Este campo só pode ser definido quando path1 está definido.

AdStrength

Qualidade geral do anúncio desse grupo de recursos.

string

O nome do recurso do grupo. O nome do recurso do grupo de recursos tem o seguinte formato:

customers/{customer_id}/assetGroupAssets/{asset_group_id}~{asset_id}~{field_type}

string

O grupo a que este recurso está sendo vinculado.

string

O recurso que está vinculado a este grupo de recursos.

AssetFieldType

A descrição da posição do recurso no grupo. Por exemplo: HEADLINE, YOUTUBE_VIDEO etc.

AssetLinkStatus

O status da vinculação entre um recurso e um grupo de recursos.

AssetUsage

Recursos veiculados.

string

O nome do recurso do filtro do grupo de produtos anunciados do grupo de recursos. O nome do recurso do filtro do grupo de produtos anunciados do grupo de recursos tem o seguinte formato:

customers/{customer_id}/assetGroupListingGroupFilters/{asset_group_id}~{listing_group_filter_id}

string

O grupo de recursos ao qual esse filtro pertence.

int64

O ID do ListingGroupFilter.

ListingGroupFilterType

Tipo de nó de filtro de grupo de produtos anunciados.

ListingGroupFilterVertical

A vertical que a árvore de nós atual representa. Todos os nós na mesma árvore precisam pertencer à mesma vertical.

ListingGroupFilterDimension

Valor da dimensão com que esse grupo de produtos anunciados está refinando o pai/mãe. Não definido para o grupo raiz.

string

Nome do recurso da subdivisão do grupo de listagens pai. Nulo para o nó do filtro do grupo de fichas da empresa raiz.

ListingGroupFilterDimensionPath

O caminho das dimensões que definem esse filtro de grupo de fichas.

string

O nome do recurso do indicador do grupo de recursos. O nome do recurso do indicador do grupo de recursos tem o seguinte formato:

customers/{customer_id}/assetGroupSignals/{asset_group_id}~{signal_id}

string

O grupo de recursos ao qual o indicador pertence.

AudienceInfo

O indicador de público-alvo a ser usado pela campanha Performance Max.

string

O nome do recurso da visualização de combinação da parte superior do grupo de recursos. Os nomes dos recursos de visualização de combinação de grupos de ativos mais populares têm o formato: "customers/{customer_id}/assetGroupTopCombinationViews/{asset_group_id}~{asset_combination_category}"

AssetGroupAssetCombinationData

As principais combinações de recursos veiculados juntos.

int64

O ID do conjunto de recursos.

string

O nome do recurso do conjunto de recursos. Os nomes dos recursos de conjuntos de ativos têm o seguinte formato:

customers/{customer_id}/assetSets/{asset_set_id}

string

O nome do recurso do conjunto de recursos. Os nomes dos recursos de um conjunto de ativos têm o seguinte formato:

customers/{customer_id}/assetSetAssets/{asset_set_id}~{asset_id}

string

O conjunto a que o recurso está vinculado.

string

O recurso a que o recurso do conjunto está vinculado.

AssetSetAssetStatus

O status do recurso do conjunto de recursos. Somente leitura.

string

O nome do recurso do público-alvo. Os nomes dos públicos-alvo têm o seguinte formato:

customers/{customer_id}/audiences/{audience_id}

int64

ID do público-alvo.

string

Obrigatório. Nome do público-alvo. Ele precisa ser exclusivo em todos os públicos-alvo. Precisa ter no mínimo 1 e no máximo 255 caracteres.

string

Descrição do público-alvo.

string

O nome do recurso da estratégia de lances. Os nomes dos recursos da estratégia de lances têm o seguinte formato:

customers/{customer_id}/biddingStrategies/{bidding_strategy_id}

BiddingStrategyStatus

É o status da estratégia de lances.

Este campo é somente leitura.

BiddingStrategyType

É o tipo de estratégia de lances. Cria uma estratégia de lances definindo o esquema de lance.

Este campo é somente leitura.

string

A moeda usada pela estratégia de lances (código ISO 4217 de três letras).

Para estratégias de lances em clientes administradores, essa moeda pode ser definida na criação e é padrão para a moeda do cliente administrador. Para clientes de veiculação, esse campo não pode ser definido. Todas as estratégias em um cliente de veiculação usam implicitamente a moeda desse cliente. Em todos os casos, o campo "effective_currency_code" retorna a moeda usada pela estratégia.

int64

O ID da estratégia de lances.

string

É o nome da estratégia de lances. Todas as estratégias de lances em uma conta devem ter nomes diferentes.

A string precisa estar entre 1 e 255, inclusive, em bytes UTF-8 (cortados).

string

A moeda usada pela estratégia de lances (código de três letras do ISO 4217).

Para estratégias de lances em clientes do Gerenciador, essa é a moeda definida pelo anunciante ao criar a estratégia. Para clientes atendidos, este é o currency_code do cliente.

As métricas da estratégia de lances são informadas nessa moeda.

Este campo é somente leitura.

int64

O número de campanhas vinculadas a essa estratégia de lances.

Este campo é somente leitura.

int64

O número de campanhas não removidas anexadas a essa estratégia de lances.

Este campo é somente leitura.

EnhancedCpc

Uma estratégia de lances que aumenta os lances para cliques com maior probabilidade de gerar uma conversão e os reduz para cliques com menor probabilidade.

MaximizeConversionValue

Uma estratégia de lances automática que ajuda a gerar o maior valor de conversão para suas campanhas sem exceder o orçamento.

MaximizeConversions

Uma estratégia de lances automática para gerar o maior número possível de conversões nas suas campanhas sem ultrapassar o orçamento.

TargetCpa

Uma estratégia de lances que define lances para ajudar a gerar o maior número possível de conversões com o custo por aquisição (CPA) desejado.

TargetImpressionShare

Uma estratégia de lances que otimiza automaticamente para uma determinada porcentagem de impressões.

TargetOutrankShare

Uma estratégia de lances que define lances com base na fração de lances de leilões em que o anunciante precisa superar um concorrente específico. Este campo está obsoleto. Não é possível criar uma estratégia de lances com esse campo ou associar estratégias de lances com esse campo a uma campanha. Mutações para estratégias que já têm esse esquema preenchido são permitidas.

TargetRoas

Uma estratégia de lances que ajuda a maximizar a receita e calcular o retorno do investimento em publicidade (ROAS) desejado.

TargetSpend

Uma estratégia que define os lances para conseguir o máximo de cliques possível com o orçamento disponível.

string

O nome do recurso da campanha. Os nomes dos recursos de campanha têm o seguinte formato:

customers/{customer_id}/campaigns/{campaign_id}

CampaignStatus

É o status da campanha.

Quando uma nova campanha é adicionada, o status é ATIVADO.

CampaignServingStatus

O status de veiculação de anúncios da campanha.

BiddingStrategySystemStatus

O status do sistema da estratégia de lances da campanha.

AdServingOptimizationStatus

O status de otimização da veiculação de anúncios da campanha.

AdvertisingChannelType

É a principal meta de veiculação de anúncios na campanha. As opções de segmentação podem ser refinadas em network_settings.

Este campo é obrigatório e não deve ficar vazio ao criar novas campanhas.

Pode ser definido apenas ao criar campanhas. Depois que a campanha é criada, o campo não pode ser alterado.

AdvertisingChannelSubType

Refinamento opcional para advertising_channel_type. Precisa ser um subtipo válido do tipo de canal principal.

Pode ser definido apenas ao criar campanhas. Depois que a campanha é criada, o campo não pode ser alterado.

CustomParameter

É a lista de mapeamentos usados para substituir tags de parâmetros personalizados em um tracking_url_template, final_urls ou mobile_final_urls.

RealTimeBiddingSetting

Configurações para lances em tempo real, um recurso disponível somente para campanhas que segmentam a rede do Ad Exchange.

NetworkSettings

As configurações de rede da campanha.

DynamicSearchAdsSetting

A configuração para controlar os anúncios dinâmicos de pesquisa (DSA).

ShoppingSetting

A configuração para controlar as campanhas do Shopping.

GeoTargetTypeSetting

A configuração de segmentação geográfica de anúncios.

string

Os nomes dos recursos dos rótulos efetivos anexados a esta campanha. Um rótulo efetivo é um rótulo herdado ou atribuído diretamente a essa campanha.

string

Os nomes dos recursos dos rótulos anexados a esta campanha.

BiddingStrategyType

É o tipo de estratégia de lances.

Uma estratégia de lances pode ser criada definindo o esquema de lances para criar uma estratégia de lances padrão ou o campo bidding_strategy para criar uma estratégia de lances de portfólio.

Este campo é somente leitura.

string

Nome do recurso da AccessibleBiddingStrategy, uma visualização somente leitura dos atributos irrestritos da estratégia de lances de portfólio anexada identificada por "bid_strategy". Deixar em branco se a campanha não usar uma estratégia de portfólio. Os atributos de estratégia irrestrita estão disponíveis para todos os clientes com quem a estratégia é compartilhada e são lidos no recurso AccessibleBiddingStrategy. Já os atributos restritos estão disponíveis apenas para o cliente proprietário da estratégia e os gerentes dele. Os atributos restritos só podem ser lidos do recurso BiddingStrategy.

FrequencyCapEntry

Uma lista que limita a frequência com que cada usuário vai ver os anúncios da campanha.

SelectiveOptimization

Configuração de otimização seletiva para essa campanha, que inclui um conjunto de ações de conversão para otimização. Esse recurso só se aplica a campanhas para apps que usam MULTI_CHANNEL como AdvertisingChannelType e APP_CAMPAIGN ou APP_CAMPAIGN_FOR_ENGAGEMENT como AdvertisingChannelSubType.

OptimizationGoalSetting

Configuração da meta de otimização para essa campanha, que inclui um conjunto de tipos de meta de otimização.

TrackingSetting

Configurações no nível da campanha para informações de acompanhamento.

string

ID da campanha na conta de mecanismo externo. Esse campo é somente para contas que não são do Google Ads, por exemplo, Yahoo Japan, Microsoft, Baidu etc. Para a entidade do Google Ads, use "campaign.id".

AssetFieldType

Os tipos de campo de recurso que devem ser excluídos dessa campanha. As vinculações de recursos com esses tipos de campo não serão herdadas do nível superior por esta campanha.

string

O carimbo de data/hora em que a campanha foi criada. O carimbo de data/hora está no fuso horário do cliente e no formato "aaaa-MM-dd HH:mm:ss". O uso de create_time será descontinuado na v1. Use creation_time.

string

O carimbo de data/hora em que a campanha foi criada. O carimbo de data/hora está no fuso horário do cliente e no formato "aaaa-MM-dd HH:mm:ss".

string

A data e a hora em que essa campanha foi modificada pela última vez. A data e hora está no fuso horário do cliente e no formato "aaaa-MM-dd HH:mm:ss.ssssss".

int64

O ID da campanha.

string

O nome da campanha.

Este campo é obrigatório e não deve ficar vazio ao criar novas campanhas.

Ele não pode conter nenhum caractere nulo (ponto de código 0x0), feed de linha NL (ponto de código 0xA) nem retorno de carro (ponto de código 0xD).

string

O modelo de URL para criar um URL de rastreamento.

string

O nome do recurso do orçamento da campanha.

string

A data em que a campanha começou a ser veiculada no fuso horário do cliente no formato AAAA-MM-DD.

string

O último dia da campanha no fuso horário da veiculação no formato AAAA-MM-DD. Na criação, o padrão é 2037-12-30, ou seja, a campanha será exibida indefinidamente. Para definir que uma campanha existente seja exibida indefinidamente, defina esse campo para 2037-12-30.

string

Sufixo usado para anexar parâmetros de consulta às páginas de destino veiculadas com o acompanhamento paralelo.

bool

Representa a desativação da expansão de URLs para mais URLs segmentados. Se desativada (verdadeiro), apenas os URLs finais no grupo de recursos ou especificados no Google Merchant Center ou nos feeds de dados da empresa do anunciante são segmentados. Se a opção estiver ativada (falso), todo o domínio será segmentado. Esse campo só pode ser definido para campanhas Performance Max, em que o valor padrão é "false".

string

O nome do recurso da estratégia de lances de portfólio usada pela campanha.

ManualCpa

Estratégia de lances de CPA manual padrão. Estratégia de lances manual que permite ao anunciante definir o lance por ação especificada pelo anunciante. Disponível apenas para campanhas de Serviços locais.

ManualCpc

Estratégia de lances padrão de CPC manual. Lances manuais com base no clique, em que o usuário paga por clique.

ManualCpm

Estratégia de lances de CPM manual padrão. Lances manuais com base nas impressões em que o usuário paga por mil impressões.

MaximizeConversions

A estratégia de lances padrão "Maximizar conversões" que maximiza automaticamente o número de conversões sem exceder o orçamento.

MaximizeConversionValue

Estratégia de lances padrão que maximiza o valor da conversão e define lances automaticamente para maximizar a receita sem exceder o orçamento.

TargetCpa

Estratégia de lances de CPA desejado padrão que define lances automaticamente para gerar o maior número possível de conversões sem exceder o custo por aquisição (CPA) desejado que você definiu.

TargetImpressionShare

Estratégia de lances de parcela de impressões desejada. Uma estratégia de lances automática que define lances para alcançar uma porcentagem de impressões escolhida.

TargetRoas

A estratégia de lances de ROAS desejado padrão que maximiza automaticamente a receita enquanto faz a média de um retorno do investimento em publicidade desejado (ROAS) específico.

TargetSpend

Estratégia de lances de gasto desejado padrão que define automaticamente seus lances para conseguir o máximo de cliques possível com o orçamento disponível.

PercentCpc

Estratégia de lances de porcentagem padrão de CPC em que os lances são uma fração do preço anunciado de um produto ou serviço.

TargetCpm

Uma estratégia de lances que otimiza automaticamente o custo por mil impressões.

string

Obrigatório. O nome de domínio da Internet que essa configuração representa, por exemplo, "google.com" ou "www.google.com".

string

Obrigatório. O código do idioma que especifica o idioma do domínio, por exemplo, "en".

bool

Indica se a campanha usa apenas URLs fornecidos pelo anunciante.

PositiveGeoTargetType

A configuração usada para a segmentação geográfica positiva nesta campanha específica.

NegativeGeoTargetType

A configuração usada para a segmentação geográfica negativa nessa campanha específica.

bool

Se os anúncios serão veiculados com os resultados da pesquisa do google.com.br.

bool

Indica se os anúncios serão veiculados em sites parceiros na rede de pesquisa do Google (requer que target_google_search também seja true).

bool

Indica se os anúncios serão veiculados em canais específicos na Rede de Display do Google. Os canais são especificados usando o critério Canal.

bool

Indica se os anúncios serão veiculados na rede de parceiros do Google. Esse recurso está disponível apenas para algumas contas de parceiros do Google selecionadas.

OptimizationGoalType

A lista de tipos de meta de otimização.

string

Conjunto selecionado de nomes de recursos para ações de conversão para otimizar esta campanha.

string

Rótulo do feed de produtos a serem incluídos na campanha. Só é possível definir um dos campos feed_label ou sales_country. Se for usado em vez de sales_country, o campo feed_label aceitará códigos de países no mesmo formato, por exemplo, "XX". Caso contrário, pode ser qualquer string usada para o rótulo do feed no Google Merchant Center.

bool

Indica se o inventário de listagem de veículos será segmentado.

int64

ID da conta do Merchant Center. Este campo é obrigatório para operações de criação. Esse campo é imutável para campanhas do Shopping.

string

País de vendas dos produtos a serem incluídos na campanha.

int32

Prioridade da campanha. As campanhas com prioridades numericamente maiores têm precedência sobre as com prioridades mais baixas. Esse campo é obrigatório para campanhas do Shopping, com valores entre 0 e 2. Esse campo é opcional para campanhas inteligentes do Shopping, mas precisa ser igual a 3 se definido.

bool

Se os produtos locais serão incluídos.

string

O URL usado para o acompanhamento dinâmico.

string

O nome do recurso da campanha. Os nomes dos recursos de CampaignAsset têm o seguinte formato:

customers/{customer_id}/campaignAssets/{campaign_id}~{asset_id}~{field_type}

AssetLinkStatus

Status do recurso da campanha.

string

A campanha à qual o recurso está vinculado.

string

O recurso que está vinculado à campanha.

string

O nome do recurso do conjunto de recursos da campanha. Os nomes dos recursos de um conjunto de ativos têm o seguinte formato:

customers/{customer_id}/campaignAssetSets/{campaign_id}~{asset_set_id}

string

A campanha a que este conjunto de recursos está vinculado.

string

O conjunto de recursos vinculado à campanha.

AssetSetLinkStatus

O status do recurso do conjunto de recursos da campanha. Somente leitura.

string

O nome do recurso da visualização do público-alvo da campanha. Os nomes dos recursos de visualização de público-alvo da campanha têm o seguinte formato:

customers/{customer_id}/campaignAudienceViews/{campaign_id}~{criterion_id}

string

O nome do recurso do orçamento da campanha. Os nomes dos recursos de orçamento da campanha têm o seguinte formato:

customers/{customer_id}/campaignBudgets/{campaign_budget_id}

BudgetDeliveryMethod

O método de exibição que determina a taxa em que o orçamento da campanha é gasto.

O padrão será "STANDARD" se não for especificado em uma operação de criação.

BudgetPeriod

Período em que o orçamento será usado. O padrão será DIÁRIO se não for especificado.

int64

É o valor do orçamento, na moeda local da conta. O valor é especificado em micros, em que um milhão é equivalente a uma unidade monetária. O gasto mensal é limitado a 30,4 vezes esse valor.

string

O nome do recurso do critério da campanha. Os nomes dos recursos de critério da campanha têm o seguinte formato:

customers/{customer_id}/campaignCriteria/{campaign_id}~{criterion_id}

string

O nome de exibição do critério.

Este campo é ignorado para mutações.

CriterionType

Tipo do critério.

CampaignCriterionStatus

O status do critério.

string

A data e a hora em que esse critério de campanha foi modificado pela última vez. A data e hora está no fuso horário do cliente e no formato "aaaa-MM-dd HH:mm:ss.ssssss".

int64

ID do critério.

Este campo é ignorado durante a modificação.

float

O modificador dos lances quando o critério corresponde. O modificador precisa estar no intervalo: 0,1 a 10,0. A maioria dos tipos de critérios segmentáveis são compatíveis com modificadores. Use 0 para desativar um tipo de dispositivo.

bool

Define se o critério será segmentado (false) ou excluído (true).

KeywordInfo

Palavra-chave.

LocationInfo

Local.

DeviceInfo

Dispositivo.

AgeRangeInfo

Faixa etária.

GenderInfo

Gênero.

UserListInfo

Lista de usuários.

LanguageInfo

e linguagem Hashicorp.

WebpageInfo

página da Web.

LocationGroupInfo

Grupo por locais

string

Nome do recurso. Os nomes dos recursos de CampaignEffectivelabel têm o seguinte formato: customers/{customer_id}/campaignEffectiveLabels/{campaign_id}~{label_id}

string

A campanha a que o rótulo eficaz está anexado.

string

O rótulo efetivo atribuído à campanha.

int64

O ID do cliente que possui o rótulo efetivo.

string

Nome do recurso. Os nomes dos recursos do rótulo da campanha têm o formato: customers/{customer_id}/campaignLabels/{campaign_id}~{label_id}

string

A campanha a que o rótulo está anexado.

string

Rótulo atribuído à campanha.

int64

O ID do cliente que é proprietário do rótulo.

string

O nome do recurso da visualização de vendas de dados do carrinho. Os nomes dos recursos da visualização de vendas dos dados do carrinho têm o seguinte formato: customers/{customer_id}/cartDataSalesView

string

O nome do recurso da conversão. Os nomes dos recursos de conversão têm o seguinte formato:

customers/{customer_id}/conversions/{ad_group_id}~{criterion_id}~{ds_conversion_id}

int64

O ID da conversão.

int64

ID do critério do Search Ads 360. Um valor de 0 indica que o critério não foi atribuído.

int64

O ID da conta de inventário do Search Ads 360 que contém o produto que recebeu o clique. O Search Ads 360 gera esse ID quando você vincula uma conta de inventário nele.

int64

ID do anúncio. Um valor de 0 indica que o anúncio não foi atribuído.

string

Uma string única para a visita à qual a conversão é atribuída, que é transmitida para a página de destino como o parâmetro de URL do ID de clique.

int64

O ID de visita do Search Ads 360 a que a conversão é atribuída.

string

Em conversões off-line, esse é um ID fornecido pelos anunciantes. Se um anunciante não especificar um ID, o Search Ads 360 vai gerar um. Em conversões on-line, ele é igual à coluna "id" ou à coluna floodlight_order_id, dependendo das instruções do Floodlight fornecidas pelo anunciante.

string

O ID do produto clicado.

ProductChannel

O canal de vendas do produto que foi clicado: on-line ou local.

string

O idioma (ISO-639-1) definido para o feed do Merchant Center que contém dados sobre o produto.

string

A loja no anúncio de inventário local que foi clicada. Precisa corresponder aos IDs de loja usados no feed de produtos locais.

string

O país (formato ISO-3166) registrado no feed de inventário que contém o produto clicado.

AttributionType

A que a conversão é atribuída: visita ou palavra-chave + anúncio.

string

O carimbo de data/hora do evento de conversão.

string

O carimbo de data/hora da última vez em que a conversão foi modificada.

string

O carimbo de data/hora da visita à qual a conversão é atribuída.

int64

A quantidade de itens registrados pela conversão, conforme determinado pelo parâmetro "qty url". O anunciante é responsável por preencher o parâmetro de modo dinâmico (como o número de itens vendidos na conversão). Caso contrário, o padrão será 1.

int64

A receita ajustada em micros para o evento de conversão. Estará sempre na moeda da conta de veiculação.

int64

A receita original e inalterada associada ao evento do Floodlight (na moeda do relatório atual), antes das modificações na instrução de moeda do Floodlight.

string

O ID do pedido do Floodlight fornecido pelo anunciante para a conversão.

ConversionStatus

O status da conversão, que será ATIVADO ou REMOVIDO.

int64

ID do recurso com que houve interação durante o evento de conversão.

AssetFieldType

Tipo de campo do recurso do evento de conversão.

string

O nome do recurso da ação de conversão. Os nomes dos recursos de ações de conversão têm o seguinte formato:

customers/{customer_id}/conversionActions/{conversion_action_id}

string

Carimbo de data/hora da criação da atividade do Floodlight, formatado em ISO 8601.

ConversionActionStatus

É o status desta ação de conversão para acúmulo de eventos de conversão.

ConversionActionType

O tipo dessa ação de conversão.

ConversionActionCategory

A categoria de conversões informada para essa ação.

ValueSettings

Configurações relacionadas ao valor dos eventos de conversão associados a essa ação.

AttributionModelSettings

Configurações relacionadas ao modelo de atribuição da ação de conversão.

FloodlightSettings

Configurações do Floodlight para tipos de conversão do Floodlight.

int64

O ID da ação de conversão.

string

Nome da ação de conversão.

Este campo é obrigatório e não deve ficar em branco ao criar novas ações de conversão.

bool

Se o bit primary_for_goal de uma ação de conversão for falso, ela não poderá ser usada para definir lances em todas as campanhas, independente da meta de conversão do cliente ou da campanha. No entanto, as metas de conversão personalizadas não respeitam a primary_for_goal. Portanto, se uma campanha tiver uma meta de conversão personalizada configurada com uma ação de conversão "primary_for_goal = falsa", essa ação ainda poderá receber lances. Por padrão, primary_for_goal será verdadeiro se não for definido. Na V9, primary_for_goal só pode ser definido como falso após a criação por meio de uma operação de "atualização", porque não é declarado como opcional.

string

O nome do recurso do cliente proprietário da ação de conversão ou nulo se essa for uma ação de conversão definida pelo sistema.

bool

Indica se essa ação de conversão precisa ser incluída na métrica "client_account_conversions".

bool

Indica se essa ação de conversão deve ser incluída na métrica "conversões".

int64

O número máximo de dias entre uma interação (por exemplo, um clique) e um evento de conversão.

string

ID do app para uma ação de conversão de app.

AttributionModel

O tipo de modelo de atribuição dessa ação de conversão.

DataDrivenModelStatus

O status do modelo de atribuição baseada em dados para a ação de conversão.

string

String usada para identificar um grupo de atividades do Floodlight ao registrar as conversões.

string

String usada para identificar uma atividade do Floodlight ao registrar conversões.

int64

ID da atividade do Floodlight no DoubleClick Campaign Manager (DCM).

double

O valor a ser usado quando os eventos de conversão dessa ação forem enviados com um valor inválido, não permitido ou ausente ou quando essa ação de conversão estiver configurada para sempre usar o valor padrão.

string

O código da moeda a ser usado quando os eventos de conversão dessa ação de conversão forem enviados com um código de moeda inválido ou ausente ou quando essa ação de conversão estiver configurada para usar sempre o valor padrão.

bool

Controla se o valor e o código da moeda padrão são usados no lugar do valor e do código da moeda especificados nos eventos de conversão dessa ação de conversão.

string

O nome do recurso da variável personalizada de conversão. Os nomes dos recursos de variáveis personalizadas de conversão têm o seguinte formato:

customers/{customer_id}/conversionCustomVariables/{conversion_custom_variable_id}

int64

O ID da variável personalizada de conversão.

string

Obrigatório. O nome da variável personalizada de conversão. O nome precisa ser exclusivo. O nome pode ter até 100 caracteres. Não deve haver espaços extras antes e depois.

string

Obrigatório. A tag da variável personalizada de conversão. A tag precisa ser exclusiva e consistir em um caractere "u" seguido diretamente por um número menor ou igual a 100. Por exemplo: "u4".

ConversionCustomVariableStatus

O status da variável personalizada de conversão para o acúmulo de eventos de conversão.

string

O nome do recurso do cliente proprietário da variável personalizada de conversão.

ConversionCustomVariableFamily

Família da variável personalizada de conversão.

ConversionCustomVariableCardinality

Cardinalidade da variável personalizada de conversão.

FloodlightConversionCustomVariableInfo

Campos para variáveis personalizadas de conversão do Floodlight no Search Ads 360.

int64

Os IDs das colunas personalizadas que usam essa variável personalizada de conversão.

FloodlightVariableType

Tipo de variável do Floodlight definida no Search Ads 360.

FloodlightVariableDataType

Tipo de dados da variável do Floodlight definido no Search Ads 360.

bool

Se o cliente aceitou os termos de dados do cliente. Se você usar o acompanhamento de conversões de várias contas, esse valor será herdado do administrador. Este campo é somente leitura. Para mais informações, acesse https://support.google.com/adspolicy/answer/7475709.

ConversionTrackingStatus

Status do acompanhamento de conversões. Ele indica se o cliente está usando o acompanhamento de conversões e quem é o proprietário desse acompanhamento. Se esse cliente estiver usando o acompanhamento de conversões de várias contas, o valor retornado vai variar com base no login-customer-id da solicitação.

bool

Indica se o cliente ativou as conversões otimizadas para leads. Se você usar o acompanhamento de conversões de várias contas, esse valor será herdado do administrador. Este campo é somente leitura.

string

O nome do recurso do cliente em que as conversões são criadas e gerenciadas. Este campo é somente leitura.

int64

O ID de acompanhamento de conversões usado para esta conta. Esse ID não indica se o cliente usa o acompanhamento de conversões (conversion_tracking_status faz). Este campo é somente leitura.

int64

O ID de acompanhamento de conversões do administrador do cliente. É definido quando o cliente ativa o acompanhamento de conversões e substitui o conversion_tracking_id. Esse campo só pode ser gerenciado pela interface do Google Ads. Este campo é somente leitura.

int64

O ID de acompanhamento de conversões do administrador do cliente. Esse valor é definido quando o cliente ativa o acompanhamento de conversões de várias contas e substitui o conversion_tracking_id.

string

O nome do recurso da coluna personalizada. Os nomes dos recursos de colunas personalizadas têm o seguinte formato:

customers/{customer_id}/customColumns/{custom_column_id}

int64

ID da coluna personalizada.

string

Nome definido pelo usuário da coluna personalizada.

string

Descrição da coluna personalizada definida pelo usuário.

CustomColumnValueType

O tipo do valor do resultado da coluna personalizada.

bool

Verdadeiro quando a coluna personalizada se refere a um ou mais atributos.

bool

Verdadeiro quando a coluna personalizada se refere a uma ou mais métricas.

bool

Verdadeiro quando a coluna personalizada está disponível para uso na consulta de SearchAds360Service.Search e SearchAds360Service.SearchStream.

string

Lista das colunas do sistema referenciadas por essa coluna personalizada. Por exemplo, uma coluna personalizada "soma de impressões e cliques" tem colunas do sistema referenciadas de {"metrics.clicks", "metrics.impressions"}.

CustomColumnRenderType

Como o valor do resultado da coluna personalizada deve ser interpretado.

string

O nome do recurso do cliente. Os nomes dos recursos do cliente têm o seguinte formato:

customers/{customer_id}

ConversionTrackingSetting

Configuração do acompanhamento de conversões de um cliente.

AccountType

Tipo de conta de mecanismo, por exemplo: Google Ads, Microsoft Advertising, Yahoo Japan, Baidu, Facebook, Engine Track etc.

DoubleClickCampaignManagerSetting

Configuração do DoubleClick Campaign Manager (DCM) para um cliente administrador.

AccountStatus

Status da conta, por exemplo, "Ativado", "Pausado", "Removido" etc.

string

A data e a hora em que o cliente foi modificado pela última vez. A data e hora está no fuso horário do cliente e no formato "aaaa-MM-dd HH:mm:ss.ssssss".

string

ID da conta na conta de mecanismo externo.

CustomerStatus

O status do cliente.

string

O carimbo de data/hora em que o cliente foi criado. O carimbo de data/hora está no fuso horário do cliente e no formato "aaaa-MM-dd HH:mm:ss".

int64

O ID do cliente.

string

Nome descritivo opcional e não exclusivo do cliente.

string

A moeda em que a conta opera. É compatível com um subconjunto dos códigos de moeda do padrão ISO 4217.

string

O ID de fuso horário local do cliente.

string

O modelo de URL para criar um URL de rastreamento com base em parâmetros.

string

O modelo de URL para anexar parâmetros ao URL final.

bool

Indica se a codificação automática está ativada para o cliente.

bool

Se o cliente é um gerente.

string

O nome do recurso do cliente. Os nomes dos recursos CustomerAsset têm o seguinte formato:

customers/{customer_id}/customerAssets/{asset_id}~{field_type}

string

Obrigatório. O recurso vinculado ao cliente.

AssetLinkStatus

Status do recurso do cliente.

string

O nome do recurso do conjunto de recursos do cliente. Os nomes dos recursos de um conjunto de ativos têm o seguinte formato:

customers/{customer_id}/customerAssetSets/{asset_set_id}

string

O conjunto de recursos vinculado ao cliente.

string

O cliente a que este conjunto de recursos está vinculado.

AssetSetLinkStatus

O status do conjunto de recursos do cliente. Somente leitura.

string

O nome do recurso do cliente do cliente. Os nomes dos recursos CustomerClient têm o formato: customers/{customer_id}/customerClients/{client_customer_id}

string

Os nomes dos recursos dos rótulos de propriedade do cliente solicitante que são aplicados ao cliente do cliente. Os nomes dos recursos de rótulos têm o seguinte formato:

customers/{customer_id}/labels/{label_id}

CustomerStatus

O status do cliente. Somente leitura.

string

O nome do recurso do cliente-cliente vinculado ao cliente. Somente leitura.

bool

Especifica se esta é uma conta oculta.

Somente leitura.

int64

Distância entre determinado cliente e cliente. Para o autolink, o valor do nível será 0. Somente leitura.

string

Representação de string do Common Locale Data Repository (CLDR, em inglês) do fuso horário do cliente, por exemplo, America/Los_Angeles. Somente leitura.

bool

Identifica se o cliente é uma conta de teste. Somente leitura.

bool

Identifica se o cliente é um administrador. Somente leitura.

string

Nome descritivo do cliente. Somente leitura.

string

Código da moeda (por exemplo, "USD", "EUR") do cliente. Somente leitura.

int64

O ID do cliente cliente. Somente leitura.

string

Nome do recurso. Os nomes dos recursos CustomerManagerLink têm o seguinte formato: customers/{customer_id}/customerManagerLinks/{manager_customer_id}~{manager_link_id}

ManagerLinkStatus

Status do vínculo entre o cliente e o gerente.

string

O cliente administrador vinculado ao cliente.

int64

ID do link de gerente de clientes. Este campo é somente leitura.

string

O carimbo de data/hora em que o CustomerManagerLink foi criado. O carimbo de data/hora está no fuso horário do cliente e no formato "aaaa-MM-dd HH:mm:ss".

int64

ID do anunciante do Campaign Manager associado a esse cliente.

int64

ID da rede do Campaign Manager associada a esse cliente.

string

Fuso horário da rede do Campaign Manager associada ao cliente no formato do banco de dados de fuso horário IANA, como America/New_York.

string

O nome do recurso da visualização de termos de pesquisa dos anúncios dinâmicos de pesquisa. Os nomes dos recursos da visualização do termo de pesquisa dos anúncios dinâmicos de pesquisa têm o seguinte formato:

customers/{customer_id}/dynamicSearchAdsSearchTermViews/{ad_group_id}~{search_term_fingerprint}~{headline_fingerprint}~{landing_page_fingerprint}~{page_url_fingerprint}

string

O URL da página de destino selecionada dinamicamente da impressão.

Este campo é somente leitura.

string

O nome do recurso da visualização de gênero. Os nomes dos recursos da visualização de gênero têm o seguinte formato:

customers/{customer_id}/genderViews/{ad_group_id}~{criterion_id}

string

O nome do recurso da constante de segmentação por área geográfica. Os nomes das constantes de recursos de segmentação geográfica têm o seguinte formato:

geoTargetConstants/{geo_target_constant_id}

GeoTargetConstantStatus

Status da constante da segmentação geográfica.

int64

O ID da constante de destino geográfico.

string

Nome em inglês da constante de segmentação por área geográfica.

string

O código do país ISO-3166-1 alfa-2 associado à segmentação.

string

Tipo de destino da constante de segmentação por área geográfica.

string

O nome em inglês completo, que consiste no nome da segmentação, da segmentação pai e do país.

string

O nome do recurso da constante de segmentação por área geográfica principal. Os nomes dos recursos de constante de destino geográfico têm este formato:

geoTargetConstants/{parent_geo_target_constant_id}

string

O nome do recurso da visualização de palavra-chave. Os nomes dos recursos de visualização de palavras-chave têm o seguinte formato:

customers/{customer_id}/keywordViews/{ad_group_id}~{criterion_id}

string

Nome do recurso. Os nomes dos recursos de rótulo têm o formato: customers/{customer_id}/labels/{label_id}

LabelStatus

Status do rótulo. Somente leitura.

TextLabel

Um tipo de marcador que mostra texto em um plano de fundo colorido.

int64

ID do rótulo. Somente leitura.

string

Nome do rótulo.

Este campo é obrigatório e não deve ficar vazio ao criar um novo rótulo.

Esta string conter entre 1 e 80 caracteres (valores inclusivos).

string

O nome do recurso da constante de idioma. Os nomes de recursos de constantes de linguagem têm o seguinte formato:

languageConstants/{criterion_id}

int64

O ID da constante de idioma.

string

O código do idioma, por exemplo, "en_US", "en_AU", "es", "fr" etc.

string

O nome completo do idioma em inglês, por exemplo, "English (US)", "Spanish" etc.

bool

Indica se o idioma é segmentável.

ProductBiddingCategory

Categoria do lance de uma oferta de produto.

ProductBrand

Marca de uma oferta de produto.

ProductChannel

Localidade de uma oferta de produto.

ProductCondition

Condição de uma oferta de produto.

ProductCustomAttribute

Atributo personalizado de uma oferta de produto.

ProductItemId

ID do item de uma oferta de produto.

ProductType

Tipo de oferta de produto.

ListingGroupFilterBiddingCategoryLevel

Indica o nível da categoria na taxonomia.

int64

ID da categoria de lances do produto.

Ele é equivalente ao ID "google_product_category", conforme descrito neste artigo: https://support.google.com/merchants/answer/6324436

string

Valor de string da marca do produto.

ListingGroupFilterProductChannel

Valor da localidade.

ListingGroupFilterProductCondition

Valor da condição.

ListingGroupFilterCustomAttributeIndex

Indica o índice do atributo personalizado.

string

Valor de string do atributo personalizado do produto.

string

Valor do ID.

ListingGroupFilterProductTypeLevel

Nível do tipo.

string

Valor do tipo.

ListingGroupFilterDimension

O caminho completo das dimensões na hierarquia do filtro do grupo de fichas (excluindo o nó raiz) até o filtro desse grupo.

string

O nome do recurso da visualização do local. Os nomes dos recursos de visualização de local têm o seguinte formato:

customers/{customer_id}/locationViews/{campaign_id}~{criterion_id}

string

O nome do recurso da categoria de lances do produto. Os nomes dos recursos de categoria de lances de produtos têm o seguinte formato:

productBiddingCategoryConstants/{country_code}~{level}~{id}

ProductBiddingCategoryLevel

Nível da categoria do lance do produto.

ProductBiddingCategoryStatus

Status da categoria de lance do produto.

int64

ID da categoria de lances do produto.

Esse ID é equivalente ao ID google_product_category, conforme descrito neste artigo: https://support.google.com/merchants/answer/6324436.

string

Código de país com duas letras maiúsculas da categoria de lances do produto.

string

Nome do recurso da categoria de lances do produto principal.

string

Código do idioma da categoria de lances do produto.

string

Valor de exibição da categoria de lances do produto localizada de acordo com o código de idioma.

string

O nome do recurso da visualização do grupo de produtos. Os nomes dos recursos de visualização do grupo de produtos têm o seguinte formato:

customers/{customer_id}/productGroupViews/{ad_group_id}~{criterion_id}

string

O nome do recurso do artefato. Os nomes dos recursos do artefato têm o seguinte formato:

SearchAds360Fields/{name}

SearchAds360FieldCategory

A categoria do artefato.

string

Os nomes de todos os recursos, segmentos e métricas que podem ser selecionados com o artefato descrito.

string

Os nomes de todos os recursos que podem ser selecionados com o artefato descrito. Os campos desses recursos não segmentam métricas quando incluídos em consultas de pesquisa.

Esse campo só é definido para artefatos com a categoria RESOURCE.

string

Esse campo lista os nomes de todas as métricas que podem ser selecionadas com o artefato descrito quando ele é usado na cláusula FROM. É definido apenas para artefatos com categoria RESOURCE.

string

Esse campo lista os nomes de todos os artefatos, seja um segmento ou outro recurso, que segmentam métricas quando incluídas em consultas de pesquisa e quando o artefato descrito é usado na cláusula FROM. É definido apenas para artefatos com categoria RESOURCE.

string

Valores que o artefato pode assumir se for um campo do tipo ENUM.

Esse campo é definido apenas para artefatos da categoria SEGMENT ou ATTRIBUTE.

SearchAds360FieldDataType

Esse campo determina os operadores que podem ser usados com o artefato em cláusulas WHERE.

string

O nome do artefato.

bool

Se o artefato pode ser usado em uma cláusula SELECT em consultas de pesquisa.

bool

Indica se o artefato pode ser usado em uma cláusula WHERE em consultas de pesquisa.

bool

Indica se o artefato pode ser usado em uma cláusula ORDER BY em consultas de pesquisa.

string

O URL do proto que descreve o tipo de dados do artefato.

bool

Indica se o artefato de campo é repetido.

string

O nome do recurso da visualização de desempenho do Shopping. Os nomes dos recursos da visualização de desempenho do Shopping têm o seguinte formato: customers/{customer_id}/shoppingPerformanceView

string

O nome do recurso da lista de usuários. Os nomes dos recursos de lista de usuários têm o seguinte formato:

customers/{customer_id}/userLists/{user_list_id}

UserListType

Tipo desta lista.

Este campo é somente leitura.

int64

ID da lista de usuários.

string

Nome dessa lista de usuários. Dependendo de access_reason, o nome da lista de usuários pode não ser exclusivo (por exemplo, se access_reason=SHARED)

string

O nome do recurso da visualização de local do usuário. Os nomes dos recursos da visualização UserLocation têm o seguinte formato:

customers/{customer_id}/userLocationViews/{country_criterion_id}~{targeting_location}

int64

ID do critério do país.

bool

Indica se o local foi segmentado ou não.

string

O nome do recurso da visita. Os nomes dos recursos de visita têm o seguinte formato:

customers/{customer_id}/visits/{ad_group_id}~{criterion_id}~{ds_visit_id}

int64

O ID da visita.

int64

ID de palavra-chave do Search Ads 360. Um valor de 0 indica que a palavra-chave não foi atribuída.

int64

O ID da conta de inventário do Search Ads 360 que contém o produto que recebeu o clique. O Search Ads 360 gera esse ID quando você vincula uma conta de inventário nele.

int64

ID do anúncio. Um valor de 0 indica que o anúncio não foi atribuído.

string

Uma string exclusiva para cada visita transmitida à página de destino como o parâmetro de URL de ID de clique.

string

O carimbo de data/hora do evento da visita. O carimbo de data/hora está no fuso horário do cliente e no formato "aaaa-MM-dd HH:mm:ss".

string

O ID do produto clicado.

ProductChannel

O canal de vendas do produto que foi clicado: on-line ou local.

string

O idioma (ISO-639-1) definido para o feed do Merchant Center que contém dados sobre o produto.

string

A loja no anúncio de inventário local que foi clicada. Precisa corresponder aos IDs de loja usados no feed de produtos locais.

string

O país (formato ISO-3166) registrado no feed de inventário que contém o produto clicado.

int64

ID do recurso com que houve interação durante o evento de visita.

AssetFieldType

Tipo de campo do recurso do evento de visita.

string

O nome do recurso da visualização da página da Web. Os nomes dos recursos de visualização de páginas da Web têm o seguinte formato:

customers/{customer_id}/webpageViews/{ad_group_id}~{criterion_id}