AssetGroupListingGroupFilter

AssetGroupListingGroupFilter representa um nó da árvore de filtros do grupo de fichas em um grupo de recursos.

Representação JSON 
{
  "resourceName": string,
  "assetGroup": string,
  "id": string,
  "type": enum (ListingGroupFilterType),
  "listingSource": enum (ListingGroupFilterListingSource),
  "caseValue": {
    object (ListingGroupFilterDimension)
  },
  "parentListingGroupFilter": string,
  "path": {
    object (ListingGroupFilterDimensionPath)
  }
}
Campos
resourceName

string

Imutável. 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}
assetGroup

string

Imutável. O grupo de recursos de que o filtro de grupo de fichas faz parte.
id

string (int64 format)

Apenas saída. O ID do ListingGroupFilter.
type

enum (ListingGroupFilterType)

Imutável. Tipo de um nó de filtro do grupo de fichas.
listingSource

enum (ListingGroupFilterListingSource)

Imutável. A origem das fichas filtradas por este filtro do grupo de fichas.
caseValue

object (ListingGroupFilterDimension)

É o valor de dimensão com que o grupo de fichas está refinando o pai. Indefinido para o grupo raiz.
parentListingGroupFilter

string

Imutável. Nome do recurso da subdivisão do grupo de fichas da empresa pai. Nulo para o nó de filtro do grupo de fichas de empresa raiz.
path

object (ListingGroupFilterDimensionPath)

Apenas saída. O caminho das dimensões que definem o filtro do grupo de fichas.

ListingGroupFilterType

O tipo do filtro do grupo de fichas.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa o valor desconhecido nesta versão.
SUBDIVISION Subdivisão de produtos com algumas dimensões de listagem.
UNIT_INCLUDED Um nó de folha de filtro do grupo de fichas da empresa incluído.
UNIT_EXCLUDED Um nó de folha de filtro do grupo de fichas excluído.

ListingGroupFilterListingSource

A origem das fichas filtradas por um nó de filtro do grupo de fichas.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa o valor desconhecido nesta versão.
SHOPPING Listagens de uma origem do Shopping, como produtos do Google Merchant Center.
WEBPAGE Listagens de uma fonte de página da Web, como URLs de um feed de páginas ou do domínio da Web do anunciante.

ListingGroupFilterDimension

Dimensões de listagem para o filtro do grupo de produtos anunciados do grupo de recursos.

Representação JSON 
{

  // Union field dimension can be only one of the following:
  "productCategory": {
    object (ProductCategory)
  },
  "productBrand": {
    object (ProductBrand)
  },
  "productChannel": {
    object (ProductChannel)
  },
  "productCondition": {
    object (ProductCondition)
  },
  "productCustomAttribute": {
    object (ProductCustomAttribute)
  },
  "productItemId": {
    object (ProductItemId)
  },
  "productType": {
    object (ProductType)
  },
  "webpage": {
    object (Webpage)
  }
  // End of list of possible types for union field dimension.
}
Campos
Campo de união dimension. A dimensão de um dos tipos abaixo está sempre presente. dimension pode ser apenas de um dos tipos a seguir:
productCategory

object (ProductCategory)

Categoria de uma oferta de produto.
productBrand

object (ProductBrand)

Marca de uma oferta de produto.
productChannel

object (ProductChannel)

Localidade de uma oferta de produto.
productCondition

object (ProductCondition)

Condição de uma oferta de produto.
productCustomAttribute

object (ProductCustomAttribute)

Atributo personalizado de uma oferta de produto.
productItemId

object (ProductItemId)

ID do item de uma oferta de produto.
productType

object (ProductType)

Tipo de oferta de produto.
webpage

object (Webpage)

Filtra os URLs em um feed de páginas e os URLs do domínio da Web do anunciante.

ProductCategory

Um elemento de uma categoria em um determinado nível. As categorias de nível superior estão no nível 1, as filhas no nível 2 e assim por diante. No momento, oferecemos suporte para até cinco níveis. O usuário precisa especificar um tipo de dimensão que indique o nível da categoria. Todos os casos da mesma subdivisão precisam ter o mesmo tipo de dimensão (nível de categoria).

Representação JSON 
{
  "level": enum (ListingGroupFilterProductCategoryLevel),
  "categoryId": string
}
Campos
level

enum (ListingGroupFilterProductCategoryLevel)

Indica o nível da categoria na taxonomia.
categoryId

string (int64 format)

ID da categoria do produto.

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

ListingGroupFilterProductCategoryLevel

O nível da categoria do produto do filtro do grupo de fichas.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa o valor desconhecido nesta versão.
LEVEL1 Nível 1.
LEVEL2 Nível 2.
LEVEL3 Nível 3.
LEVEL4 Nível 4.
LEVEL5 Nível 5.

ProductBrand

Marca do produto.

Representação JSON 
{
  "value": string
}
Campos
value

string

Valor de string da marca do produto.

ProductChannel

Localidade de uma oferta de produto.

Representação JSON 
{
  "channel": enum (ListingGroupFilterProductChannel)
}
Campos
channel

enum (ListingGroupFilterProductChannel)

Valor da localidade.

ListingGroupFilterProductChannel

Enumeração que descreve a localidade de uma oferta de produto.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa o valor desconhecido nesta versão.
ONLINE O item é vendido on-line.
LOCAL O item é vendido em lojas locais.

ProductCondition

Condição de uma oferta de produto.

Representação JSON 
{
  "condition": enum (ListingGroupFilterProductCondition)
}
Campos
condition

enum (ListingGroupFilterProductCondition)

Valor da condição.

ListingGroupFilterProductCondition

Enumeração que descreve a condição de uma oferta de produto.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa o valor desconhecido nesta versão.
NEW A condição do produto é nova.
REFURBISHED A condição do produto é recondicionado.
USED A condição do produto é usada.

ProductCustomAttribute

Atributo personalizado de uma oferta de produto.

Representação JSON 
{
  "index": enum (ListingGroupFilterCustomAttributeIndex),
  "value": string
}
Campos
index

enum (ListingGroupFilterCustomAttributeIndex)

Indica o índice do atributo personalizado.
value

string

Valor de string do atributo personalizado do produto.

ListingGroupFilterCustomAttributeIndex

O índice de atributos do cliente.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa o valor desconhecido nesta versão.
INDEX0 Atributo personalizado de filtro do primeiro grupo de fichas.
INDEX1 Atributo personalizado de filtro do segundo grupo de fichas.
INDEX2 Atributo personalizado de filtro do terceiro grupo de fichas.
INDEX3 Quarto atributo personalizado de filtro do grupo de fichas.
INDEX4 Quinto atributo personalizado de filtro do grupo de fichas.

ProductItemId

ID do item de uma oferta de produto.

Representação JSON 
{
  "value": string
}
Campos
value

string

Valor do ID.

ProductType

Tipo de oferta de produto.

Representação JSON 
{
  "level": enum (ListingGroupFilterProductTypeLevel),
  "value": string
}
Campos
level

enum (ListingGroupFilterProductTypeLevel)

Nível do tipo.
value

string

Valor do tipo.

ListingGroupFilterProductTypeLevel

Enumeração que descreve o nível do tipo de oferta de um produto.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa o valor desconhecido nesta versão.
LEVEL1 Nível 1.
LEVEL2 Nível 2.
LEVEL3 Nível 3.
LEVEL4 Nível 4.
LEVEL5 Nível 5.

Página da Web

Filtra os URLs em um feed de páginas e os URLs do domínio da Web do anunciante. Vários nós raiz com essa dimensão são permitidos em um grupo de recursos, e as condições deles são consideradas em "OU".

Representação JSON 
{
  "conditions": [
    {
      object (WebpageCondition)
    }
  ]
}
Campos
conditions[]

object (WebpageCondition)

As condições da página da Web diferenciam maiúsculas de minúsculas e são unidas quando avaliadas para filtragem. Todas as condições precisam ser do mesmo tipo. Exemplo 1: para URL1 = www.ads.google.com?ocid=1&euid=2 e URL2 = www.ads.google.com?ocid=1 e com "ocid" e "euid" como condições urlContains, URL1 será correspondido, mas URL2 não.

Exemplo 2 : se URL1 tiver Marcador1, Marcador2 e URL2 tiver Marcador2, Marcador3, então com Marcador1 e Marcador2 como condições customLabel, URL1 será correspondido, mas não URL2. Com "Label2" como a única condição customLabel, URL1 e URL2 serão correspondentes.

WebpageCondition

Condição de correspondência para filtragem de URL.

Representação JSON 
{

  // Union field condition can be only one of the following:
  "customLabel": string,
  "urlContains": string
  // End of list of possible types for union field condition.
}
Campos
Campo de união condition. Condição para filtrar os URLs. condition pode ser apenas uma das seguintes opções:
customLabel

string

Filtra os URLs em um feed de páginas que têm esse rótulo personalizado. Para adicionar um rótulo personalizado a uma campanha, crie um AssetSet do tipo PAGE_FEED e o vincule à campanha usando CampaignAssetSet.
urlContains

string

Filtra os URLs em um feed de páginas e os URLs do domínio da Web do anunciante que contêm essa string.

ListingGroupFilterDimensionPath

O caminho que define as dimensões que definem um filtro do grupo de fichas.

Representação JSON 
{
  "dimensions": [
    {
      object (ListingGroupFilterDimension)
    }
  ]
}
Campos
dimensions[]

object (ListingGroupFilterDimension)

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