SearchAds360Row

{
  "resourceName": string,
  "status": enum (AdGroupStatus),
  "type": enum (AdGroupType),
  "adRotationMode": enum (AdGroupAdRotationMode),
  "creationTime": string,
  "targetingSetting": {
    object (TargetingSetting)
  },
  "labels": [
    string
  ],
  "engineId": string,
  "startDate": string,
  "endDate": string,
  "languageCode": string,
  "lastModifiedTime": string,
  "id": string,
  "name": string,
  "cpcBidMicros": string,
  "engineStatus": enum (AdGroupEngineStatus)
}

string

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

customers/{customerId}/adGroups/{ad_group_id}

enum (AdGroupStatus)

O status do grupo de anúncios.

enum (AdGroupType)

O tipo do grupo de anúncios.

enum (AdGroupAdRotationMode)

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

string

O carimbo de data/hora em que este 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".

object (TargetingSetting)

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

string

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

string

ID do grupo de anúncios na conta de mecanismo externo. Este 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 "adGroup.id" como alternativa.

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".

string (int64 format)

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).

string (int64 format)

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

enum (AdGroupEngineStatus)

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

{
  "targetRestrictions": [
    {
      object (TargetRestriction)
    }
  ]
}

object (TargetRestriction)

A configuração de dimensão por segmentação para restringir o alcance da campanha ou do grupo de anúncios.

{
  "targetingDimension": enum (TargetingDimension),
  "bidOnly": boolean
}

enum (TargetingDimension)

A dimensão de segmentação a que essas configurações se aplicam.

boolean

Indica se você deve restringir seus anúncios para serem exibidos somente para os critérios selecionados para essa segmentaçãoDimension ou para segmentar todos os valores para essa segmentaçãoDimension e exibir anúncios com base em sua segmentação em outras TargetingDimensions. Um valor de true significa que esses critérios aplicarão somente modificadores de lance, e não a segmentação. Um valor de false significa que esses critérios restringirão a segmentação e aplicarão modificadores de lance.

{
  "resourceName": string,
  "status": enum (AdGroupAdStatus),
  "ad": {
    object (Ad)
  },
  "creationTime": string,
  "labels": [
    string
  ],
  "engineId": string,
  "engineStatus": enum (AdGroupAdEngineStatus),
  "lastModifiedTime": string
}

string

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

customers/{customerId}/adGroupAds/{ad_group_id}~{adId}

enum (AdGroupAdStatus)

O status do anúncio.

object (Ad)

O anúncio.

string

O carimbo de data/hora em que este adGroupAd 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

É o ID do anúncio na conta de mecanismo externo. Este 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 "adGroupAd.ad.id" como alternativa.

enum (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".

{
  "resourceName": string,
  "finalUrls": [
    string
  ],
  "type": enum (AdType),
  "id": string,
  "displayUrl": string,
  "name": string,

  // Union field ad_data can be only one of the following:
  "textAd": {
    object (SearchAds360TextAdInfo)
  },
  "expandedTextAd": {
    object (SearchAds360ExpandedTextAdInfo)
  },
  "responsiveSearchAd": {
    object (SearchAds360ResponsiveSearchAdInfo)
  },
  "productAd": {
    object (SearchAds360ProductAdInfo)
  },
  "expandedDynamicSearchAd": {
    object (SearchAds360ExpandedDynamicSearchAdInfo)
  }
  // End of list of possible types for union field ad_data.
}

string

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

customers/{customerId}/ads/{adId}

string

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

enum (AdType)

O tipo de anúncio.

string (int64 format)

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.

object (SearchAds360TextAdInfo)

Detalhes relacionados a um anúncio de texto.

object (SearchAds360ExpandedTextAdInfo)

Detalhes relacionados a anúncios de texto expandidos.

object (SearchAds360ResponsiveSearchAdInfo)

Detalhes relacionados a um anúncio responsivo de pesquisa.

object (SearchAds360ProductAdInfo)

Detalhes relacionados a um anúncio de produto.

object (SearchAds360ExpandedDynamicSearchAdInfo)

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

{
  "headline": string,
  "description1": string,
  "description2": string,
  "displayUrl": string,
  "displayMobileUrl": string,
  "adTrackingId": string
}

string

O título do anúncio.

string

A primeira linha da descrição do anúncio.

string

Segunda linha da descrição do anúncio.

string

O URL exibido do anúncio.

string

O URL para dispositivos móveis exibido do anúncio.

string (int64 format)

O ID de acompanhamento do anúncio.

{
  "headline": string,
  "headline2": string,
  "headline3": string,
  "description1": string,
  "description2": string,
  "path1": string,
  "path2": string,
  "adTrackingId": string
}

string

O título do anúncio.

string

O segundo título do anúncio.

string

O terceiro título do anúncio.

string

A primeira linha da descrição do anúncio.

string

Segunda linha da descrição do anúncio.

string

Texto anexado ao URL visível gerado automaticamente com um delimitador.

string

Texto anexado a path1 com um delimitador.

string (int64 format)

O ID de acompanhamento do anúncio.

{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "path1": string,
  "path2": string,
  "adTrackingId": string
}

object (AdTextAsset)

Lista de recursos de texto para títulos. Quando o anúncio for veiculado, os títulos serão selecionados nessa lista.

object (AdTextAsset)

Lista de recursos de texto para descrições. Quando o anúncio for veiculado, as descrições serão selecionadas nessa lista.

string

Texto anexado ao URL visível gerado automaticamente com um delimitador.

string

Texto anexado a path1 com um delimitador.

string (int64 format)

O ID de acompanhamento do anúncio.

{
  "text": string
}

string

Texto do recurso.

{
  "description1": string,
  "description2": string,
  "adTrackingId": string
}

string

A primeira linha da descrição do anúncio.

string

Segunda linha da descrição do anúncio.

string (int64 format)

O ID de acompanhamento do anúncio.

{
  "resourceName": string,
  "adGroupAd": string,
  "label": string
}

string

Nome do recurso do rótulo do anúncio do grupo de anúncios. Os nomes dos recursos do rótulo do anúncio do grupo de anúncios têm o formato: customers/{customerId}/adGroupAdLabels/{ad_group_id}~{adId}~{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.

{
  "resourceName": string,
  "adGroup": string,
  "asset": string,
  "status": enum (AssetLinkStatus)
}

string

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

customers/{customerId}/adGroupAssets/{ad_group_id}~{assetId}~{fieldType}

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.

enum (AssetLinkStatus)

Status do recurso do grupo de anúncios.

{
  "resourceName": string,
  "adGroup": string,
  "assetSet": string,
  "status": enum (AssetSetLinkStatus)
}

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/{customerId}/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 que está vinculado ao grupo de anúncios.

enum (AssetSetLinkStatus)

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

{
  "resourceName": string
}

string

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

customers/{customerId}/adGroupAudienceViews/{ad_group_id}~{criterionId}

{
  "resourceName": string,
  "bidModifier": number,

  // Union field criterion can be only one of the following:
  "device": {
    object (DeviceInfo)
  }
  // End of list of possible types for union field criterion.
}

string

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

customers/{customerId}/adGroupBidModifiers/{ad_group_id}~{criterionId}

number

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.

object (DeviceInfo)

Um critério de dispositivo.

{
  "type": enum (Device)
}

enum (Device)

Tipo de dispositivo.

{
  "resourceName": string,
  "creationTime": string,
  "status": enum (AdGroupCriterionStatus),
  "qualityInfo": {
    object (QualityInfo)
  },
  "type": enum (CriterionType),
  "labels": [
    string
  ],
  "positionEstimates": {
    object (PositionEstimates)
  },
  "finalUrls": [
    string
  ],
  "engineId": string,
  "lastModifiedTime": string,
  "criterionId": string,
  "adGroup": string,
  "negative": boolean,
  "bidModifier": number,
  "cpcBidMicros": string,
  "effectiveCpcBidMicros": string,
  "engineStatus": enum (AdGroupCriterionEngineStatus),
  "finalUrlSuffix": string,
  "trackingUrlTemplate": string,

  // Union field criterion can be only one of the following:
  "keyword": {
    object (KeywordInfo)
  },
  "listingGroup": {
    object (ListingGroupInfo)
  },
  "ageRange": {
    object (AgeRangeInfo)
  },
  "gender": {
    object (GenderInfo)
  },
  "userList": {
    object (UserListInfo)
  },
  "webpage": {
    object (WebpageInfo)
  },
  "location": {
    object (LocationInfo)
  }
  // End of list of possible types for union field criterion.
}

string

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

customers/{customerId}/adGroupCriteria/{ad_group_id}~{criterionId}

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".

enum (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.

object (QualityInfo)

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

enum (CriterionType)

Tipo do critério.

string

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

object (PositionEstimates)

Estimativas de 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. Este 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 "adGroupcri.criterion_id" como alternativa.

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".

string (int64 format)

ID do critério.

string

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

boolean

Define 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.

number

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.

string (int64 format)

Lance de CPC (custo por clique).

string (int64 format)

O lance de CPC (custo por clique) efetivo.

enum (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.

object (KeywordInfo)

Palavra-chave.

object (ListingGroupInfo)

Grupo de produtos anunciados.

object (AgeRangeInfo)

Faixa etária.

object (GenderInfo)

Gênero.

object (UserListInfo)

Lista de usuários.

object (WebpageInfo)

Página da Web

object (LocationInfo)

Local.

{
  "qualityScore": integer
}

integer

Índice de qualidade.

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

{
  "topOfPageCpcMicros": string
}

string (int64 format)

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.

{
  "matchType": enum (KeywordMatchType),
  "text": string
}

enum (KeywordMatchType)

Tipo de correspondência da palavra-chave.

string

O texto da palavra-chave (no máximo 80 caracteres e 10 palavras).

{
  "type": enum (ListingGroupType)
}

enum (ListingGroupType)

Tipo do grupo de produtos anunciados.

{
  "type": enum (AgeRangeType)
}

enum (AgeRangeType)

Tipo de faixa etária.

{
  "type": enum (GenderType)
}

enum (GenderType)

Tipo de gênero.

{
  "userList": string
}

string

O nome do recurso da lista de usuários.

{
  "conditions": [
    {
      object (WebpageConditionInfo)
    }
  ],
  "coveragePercentage": number,
  "criterionName": string
}

object (WebpageConditionInfo)

Condições, ou expressões lógicas, para a segmentação de páginas da Web. A lista de condições de segmentação de páginas da Web é adicionada e combinada quando avaliada. Uma lista vazia de condições indica que todas as páginas do site da campanha estão segmentadas.

Este campo é obrigatório para operações CREATE e é proibido em operações UPDATE.

number

Porcentagem de cobertura dos critérios do site. Essa é a porcentagem calculada da cobertura do site com base na segmentação do site e das palavras-chave negativas no grupo de anúncios e na campanha. Por exemplo, quando a cobertura retorna como 1, isso indica que tem 100% de cobertura. Este campo é somente leitura.

string

O nome do critério definido por esse parâmetro. O valor de nome será usado para identificar, classificar e filtrar critérios com esse tipo de parâmetro.

Este campo é obrigatório para operações CREATE e é proibido em operações UPDATE.

{
  "operand": enum (WebpageConditionOperand),
  "operator": enum (WebpageConditionOperator),
  "argument": string
}

enum (WebpageConditionOperand)

Operando da condição de segmentação da página da Web.

enum (WebpageConditionOperator)

Operador da condição de segmentação da página da Web.

string

Argumento da condição de segmentação da página da Web.

{
  "geoTargetConstant": string
}

string

O nome do recurso constante de destino geográfico.

{
  "resourceName": string,
  "adGroupCriterion": string,
  "label": string
}

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/{customerId}/adGroupCriterionLabels/{ad_group_id}~{criterionId}~{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.

{
  "resourceName": string,
  "adGroup": string,
  "label": string
}

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/{customerId}/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.

{
  "resourceName": string
}

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/{customerId}/ageRangeViews/{ad_group_id}~{criterionId}

{
  "resourceName": string,
  "type": enum (AssetType),
  "finalUrls": [
    string
  ],
  "status": enum (AssetStatus),
  "creationTime": string,
  "lastModifiedTime": string,
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "engineStatus": enum (AssetEngineStatus),

  // Union field asset_data can be only one of the following:
  "youtubeVideoAsset": {
    object (YoutubeVideoAsset)
  },
  "imageAsset": {
    object (ImageAsset)
  },
  "textAsset": {
    object (TextAsset)
  },
  "calloutAsset": {
    object (UnifiedCalloutAsset)
  },
  "sitelinkAsset": {
    object (UnifiedSitelinkAsset)
  },
  "pageFeedAsset": {
    object (UnifiedPageFeedAsset)
  },
  "mobileAppAsset": {
    object (MobileAppAsset)
  },
  "callAsset": {
    object (UnifiedCallAsset)
  },
  "callToActionAsset": {
    object (CallToActionAsset)
  },
  "locationAsset": {
    object (UnifiedLocationAsset)
  }
  // End of list of possible types for union field asset_data.
}

string

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

customers/{customerId}/assets/{assetId}

enum (AssetType)

Tipo do recurso.

string

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

enum (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".

string (int64 format)

O ID do recurso.

string

Nome opcional do recurso.

string

Modelo de URL para criar um URL de rastreamento.

enum (AssetEngineStatus)

O status do mecanismo de um recurso.

object (YoutubeVideoAsset)

Um recurso de vídeo do YouTube.

object (ImageAsset)

Um recurso de imagem.

object (TextAsset)

Um recurso de texto.

object (UnifiedCalloutAsset)

Um recurso de frase de destaque unificado.

object (UnifiedSitelinkAsset)

Um recurso de sitelink unificado.

object (UnifiedPageFeedAsset)

Um recurso de feed de páginas unificado.

object (MobileAppAsset)

Um recurso de app para dispositivos móveis.

object (UnifiedCallAsset)

Um recurso de ligação unificado.

object (CallToActionAsset)

Um recurso de call-to-action.

object (UnifiedLocationAsset)

Um recurso de local unificado.

{
  "youtubeVideoTitle": string,
  "youtubeVideoId": string
}

string

Título do vídeo do YouTube.

string

ID do vídeo do YouTube. É o valor da string de 11 caracteres usado no URL do vídeo do YouTube.

{
  "mimeType": enum (MimeType),
  "fullSize": {
    object (ImageDimension)
  },
  "fileSize": string
}

enum (MimeType)

Tipo MIME do recurso de imagem.

object (ImageDimension)

Metadados desta imagem em tamanho original.

string (int64 format)

É o tamanho do arquivo do recurso de imagem em bytes.

{
  "heightPixels": string,
  "widthPixels": string,
  "url": string
}

string (int64 format)

É a altura da imagem.

string (int64 format)

É a largura da imagem.

string

Um URL que retorna a imagem com essa altura e largura.

{
  "text": string
}

string

Conteúdo de texto do recurso de texto.

{
  "calloutText": string,
  "startDate": string,
  "endDate": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],
  "useSearcherTimeZone": boolean
}

string

O texto da frase de destaque. Esta string conter entre 1 e 25 caracteres (valores inclusivos).

string

Data de início de quando este recurso entra em vigor e pode começar a ser veiculado, no formato aaaa-MM-dd.

string

Última data de quando este recurso entra em vigor e ainda está sendo veiculado, no formato aaaa-MM-dd.

object (AdScheduleInfo)

Lista de programações não sobrepostas que especifica todos os intervalos em que o recurso pode ser veiculado. Cada dia pode ter no máximo 6 programações, com 42 no total.

boolean

Indica se o recurso será mostrado no fuso horário do usuário da pesquisa. Aplicável ao Microsoft Ads.

{
  "startMinute": enum (MinuteOfHour),
  "endMinute": enum (MinuteOfHour),
  "dayOfWeek": enum (DayOfWeek),
  "startHour": integer,
  "endHour": integer
}

enum (MinuteOfHour)

Minutos após o horário de início da programação.

Este campo é obrigatório para operações CREATE e é proibido em operações UPDATE.

enum (MinuteOfHour)

Minutos após o horário de término da programação. A programação exclui o minuto de término.

Este campo é obrigatório para operações CREATE e é proibido em operações UPDATE.

enum (DayOfWeek)

Dia da semana ao qual se aplica a programação.

Este campo é obrigatório para operações CREATE e é proibido em operações UPDATE.

integer

Hora de início no formato 24 horas. Este campo deve estar entre 0 e 23 (valores inclusivos).

Este campo é obrigatório para operações CREATE e é proibido em operações UPDATE.

integer

Hora de término no formato 24 horas. 24 significa o fim do dia. Este campo deve estar entre 0 e 24 (valores inclusivos).

Este campo é obrigatório para operações CREATE e é proibido em operações UPDATE.

{
  "linkText": string,
  "description1": string,
  "description2": string,
  "startDate": string,
  "endDate": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],
  "trackingId": string,
  "useSearcherTimeZone": boolean,
  "mobilePreferred": boolean
}

string

Texto de visualização do URL para o sitelink. Esta string conter entre 1 e 25 caracteres (valores inclusivos).

string

Primeira linha da descrição do sitelink. Se definido, o comprimento deve estar entre 1 e 35, inclusivo, e a description2 também precisa ser definida.

string

Segunda linha da descrição do sitelink. Se definido, o comprimento deve estar entre 1 e 35, sendo inclusivo, e a description1 também precisa ser definida.

string

Data de início de quando este recurso entra em vigor e pode começar a ser veiculado, no formato aaaa-MM-dd.

string

Última data de quando este recurso entra em vigor e ainda está sendo veiculado, no formato aaaa-MM-dd.

object (AdScheduleInfo)

Lista de programações não sobrepostas que especifica todos os intervalos em que o recurso pode ser veiculado. Cada dia pode ter no máximo 6 programações, com 42 no total.

string (int64 format)

ID usado para rastrear os cliques do recurso de sitelink. Esta é uma conta de mecanismo do Yahoo! Japan.

boolean

Indica se o recurso de sitelink será mostrado no fuso horário do usuário da pesquisa. Aplicável ao Microsoft Ads.

boolean

Indica se a preferência é que o recurso de sitelink seja exibido em dispositivos móveis. Aplicável ao Microsoft Ads.

{
  "pageUrl": string,
  "labels": [
    string
  ]
}

string

A página da Web que os anunciantes querem segmentar.

string

Rótulos usados para agrupar os URLs das páginas.

{
  "appId": string,
  "appStore": enum (MobileAppVendor)
}

string

Obrigatório. Uma string que identifica exclusivamente um aplicativo para dispositivos móveis. Ele precisa conter apenas o ID nativo da plataforma, como "com.android.ebay". para Android ou "12345689" para iOS.

enum (MobileAppVendor)

Obrigatório. A loja de aplicativos que distribui o aplicativo específico.

{
  "countryCode": string,
  "phoneNumber": string,
  "callConversionReportingState": enum (CallConversionReportingState),
  "callConversionAction": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],
  "callOnly": boolean,
  "callTrackingEnabled": boolean,
  "useSearcherTimeZone": boolean,
  "startDate": string,
  "endDate": string
}

string

Código de país de duas letras do número de telefone. Exemplos: 'BR', 'nós'.

string

O número de telefone bruto do anunciante. Exemplos: "1234567890", "(123)456-7890"

enum (CallConversionReportingState)

Indica se este CallAsset deve usar sua própria configuração de conversões de chamada, seguir a configuração no nível da conta ou desativar a conversão de chamada.

string

A ação de conversão a que uma conversão de chamada será atribuída. Se ela não for definida, a ação de conversão padrão será usada. Este campo só terá efeito se callConversionReportingState estiver definido como USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION.

object (AdScheduleInfo)

Lista de programações não sobrepostas que especifica todos os intervalos em que o recurso pode ser veiculado. Cada dia pode ter no máximo 6 programações, com 42 no total.

boolean

Se a chamada mostra apenas o número de telefone sem um link para o site. Aplicável ao Microsoft Ads.

boolean

Se a chamada deve ser ativada no acompanhamento de chamadas. Aplicável ao Microsoft Ads.

boolean

Indica se a extensão de chamada será exibida no fuso horário do usuário da pesquisa. Aplicável ao Microsoft Ads.

string

Data de início de quando este recurso entra em vigor e pode começar a ser veiculado, no formato aaaa-MM-dd.

string

Última data de quando este recurso entra em vigor e ainda está sendo veiculado, no formato aaaa-MM-dd.

{
  "callToAction": enum (CallToActionType)
}

enum (CallToActionType)

Call-to-action.

{
  "placeId": string,
  "businessProfileLocations": [
    {
      object (BusinessProfileLocation)
    }
  ],
  "locationOwnershipType": enum (LocationOwnershipType)
}

string

IDs de lugares identificam um local de modo exclusivo no banco de dados do Google Places e no Google Maps. Esse campo é exclusivo para um determinado ID de cliente e tipo de recurso. Consulte https://developers.google.com/places/web-service/place-id para saber mais sobre o ID de lugar.

object (BusinessProfileLocation)

A lista de locais da empresa do cliente. Ele só vai ser retornado se o recurso de local estiver sendo sincronizado com a conta do Perfil da Empresa. É possível ter várias fichas na mesma conta que apontam para o mesmo ID de lugar.

enum (LocationOwnershipType)

O tipo de propriedade de local. Se o tipo for BUSINESS_OWNER, ele será veiculado como uma extensão de local. Se o tipo for AFILIADO, ele será veiculado como um local de afiliado.

{
  "labels": [
    string
  ],
  "storeCode": string,
  "listingId": string
}

string

Rótulo especificado pelo anunciante para o local na conta do Perfil da Empresa. A sincronização é feita com a conta do Perfil da Empresa.

string

Código da loja do Perfil da Empresa deste local. A sincronização é feita com a conta do Perfil da Empresa.

string (int64 format)

ID da ficha da empresa desse local do Perfil da Empresa. Sincronizada na conta vinculada do Perfil da Empresa.

{
  "resourceName": string,
  "assetGroup": string,
  "asset": string,
  "fieldType": enum (AssetFieldType),
  "status": enum (AssetLinkStatus)
}

string

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

customers/{customerId}/assetGroupAssets/{asset_group_id}~{assetId}~{fieldType}

string

O grupo a que este recurso está sendo vinculado.

string

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

enum (AssetFieldType)

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

enum (AssetLinkStatus)

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

{
  "resourceName": string,
  "assetGroup": string,

  // Union field signal can be only one of the following:
  "audience": {
    object (AudienceInfo)
  }
  // End of list of possible types for union field signal.
}

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/{customerId}/assetGroupSignals/{asset_group_id}~{signal_id}

string

O grupo de recursos a que esse indicador pertence.

object (AudienceInfo)

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

{
  "audience": string
}

string

O nome do recurso Audience.

{
  "resourceName": string,
  "assetGroup": string,
  "id": string,
  "type": enum (ListingGroupFilterType),
  "vertical": enum (ListingGroupFilterVertical),
  "caseValue": {
    object (ListingGroupFilterDimension)
  },
  "parentListingGroupFilter": string,
  "path": {
    object (ListingGroupFilterDimensionPath)
  }
}

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/{customerId}/assetGroupListingGroupFilters/{asset_group_id}~{listing_group_filter_id}

string

O grupo de recursos do qual este filtro do grupo de produtos anunciados do grupo de recursos faz parte.

string (int64 format)

O ID do ListingGroupFilter.

enum (ListingGroupFilterType)

Tipo de nó de filtro do grupo de fichas.

enum (ListingGroupFilterVertical)

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

object (ListingGroupFilterDimension)

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

string

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

object (ListingGroupFilterDimensionPath)

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

{

  // Union field dimension can be only one of the following:
  "productBiddingCategory": {
    object (ProductBiddingCategory)
  },
  "productBrand": {
    object (ProductBrand)
  },
  "productChannel": {
    object (ProductChannel)
  },
  "productCondition": {
    object (ProductCondition)
  },
  "productCustomAttribute": {
    object (ProductCustomAttribute)
  },
  "productItemId": {
    object (ProductItemId)
  },
  "productType": {
    object (ProductType)
  }
  // End of list of possible types for union field dimension.
}

object (ProductBiddingCategory)

Categoria de lance de uma oferta de produto.

object (ProductBrand)

Marca de uma oferta de produto.

object (ProductChannel)

Localidade de uma oferta de produto.

object (ProductCondition)

Condição de uma oferta de produto.

object (ProductCustomAttribute)

Atributo personalizado de uma oferta de produto.

object (ProductItemId)

ID do item de uma oferta de produto.

object (ProductType)

Tipo de oferta de um produto.

{
  "level": enum (ListingGroupFilterBiddingCategoryLevel),
  "id": string
}

enum (ListingGroupFilterBiddingCategoryLevel)

Indica o nível da categoria na taxonomia.

string (int64 format)

ID da categoria de lance do produto.

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

{
  "value": string
}

string

Valor de string da marca do produto.

{
  "channel": enum (ListingGroupFilterProductChannel)
}

enum (ListingGroupFilterProductChannel)

Valor da localidade.