AssetSet

Um conjunto de recursos que representa uma coleção de recursos. Use AssetSetAsset para vincular um recurso ao conjunto.

Representação JSON
{
  "id": string,
  "resourceName": string,
  "name": string,
  "type": enum (AssetSetType),
  "status": enum (AssetSetStatus),
  "merchantCenterFeed": {
    object (MerchantCenterFeed)
  },
  "locationGroupParentAssetSetId": string,
  "hotelPropertyData": {
    object (HotelPropertyData)
  },

  // Union field asset_set_source can be only one of the following:
  "locationSet": {
    object (LocationSet)
  },
  "businessProfileLocationGroup": {
    object (BusinessProfileLocationGroup)
  },
  "chainLocationGroup": {
    object (ChainLocationGroup)
  }
  // End of list of possible types for union field asset_set_source.
}
Campos
id

string (int64 format)

Apenas saída. O ID do conjunto de recursos.

resourceName

string

Imutável. O nome do recurso do conjunto. Os nomes dos recursos do conjunto de recursos têm o formato:

customers/{customerId}/assetSets/{asset_set_id}

name

string

Obrigatório. Nome do conjunto de recursos. Obrigatório. Ele precisa ter um tamanho mínimo de 1 e máximo de 128.

type

enum (AssetSetType)

Obrigatório. Imutável. O tipo do conjunto de recursos. Obrigatório.

status

enum (AssetSetStatus)

Apenas saída. O status do conjunto de recursos. Somente leitura.

merchantCenterFeed

object (MerchantCenterFeed)

ID do comerciante e rótulo do feed do Google Merchant Center.

locationGroupParentAssetSetId

string (int64 format)

Imutável. ID do conjunto de recursos pai referente ao conjunto de recursos de origem dos elementos desse conjunto. Por exemplo: o código AssetSet de localização no nível de sincronização de onde vêm os elementos em LocationGroup AssetSet. Esse campo é obrigatório e aplicável apenas para AssetSet do tipo grupo de locais.

hotelPropertyData

object (HotelPropertyData)

Apenas saída. Em campanhas Performance Max para metas de turismo com uma vinculação de conta da Central para Hotéis. Somente leitura.

Campo de união asset_set_source. Dados do conjunto de recursos específicos para cada tipo. Nem todos os tipos têm dados específicos. asset_set_source pode ser apenas de um dos tipos a seguir:
locationSet

object (LocationSet)

Dados do conjunto de recursos de local. Ele será usado para a definição de local no nível de sincronização. Isso só poderá ser definido se o tipo de AssetSet for LOCATION_SYNC.

businessProfileLocationGroup

object (BusinessProfileLocationGroup)

Dados do conjunto de recursos do grupo por locais do Perfil da Empresa.

chainLocationGroup

object (ChainLocationGroup)

Representa informações sobre um grupo de locais dinâmicos de rede. Aplicável somente se o tipo do AssetSet no nível de sincronização for LOCATION_SYNC e a origem da sincronização for cadeia.

AssetSetStatus

Os status possíveis de um conjunto de recursos.

Enums
UNSPECIFIED O status não foi especificado.
UNKNOWN O valor recebido não é conhecido nesta versão. Esse é um valor somente de resposta.
ENABLED O conjunto de recursos está ativado.
REMOVED O conjunto de recursos é removido.

MerchantCenterFeed

ID do comerciante e rótulo do feed do Google Merchant Center.

Representação JSON
{
  "merchantId": string,
  "feedLabel": string
}
Campos
merchantId

string (int64 format)

Obrigatório. ID do comerciante do Google Merchant Center

feedLabel

string

Opcional. Rótulo do feed do Google Merchant Center.

HotelPropertyData

Em campanhas Performance Max para metas de turismo com uma vinculação de conta da Central para Hotéis. Somente leitura.

Representação JSON
{
  "hotelCenterId": string,
  "partnerName": string
}
Campos
hotelCenterId

string (int64 format)

Apenas saída. O ID da Central para Hotéis do parceiro.

partnerName

string

Apenas saída. Nome do hotel parceiro.

LocationSet

Dados relacionados ao conjunto de locais. Um dos dados do Perfil da Empresa no Google (antes conhecido como Google Meu Negócio), dados de rede e de local do mapa precisam ser especificados.

Representação JSON
{
  "locationOwnershipType": enum (LocationOwnershipType),

  // Union field source can be only one of the following:
  "businessProfileLocationSet": {
    object (BusinessProfileLocationSet)
  },
  "chainLocationSet": {
    object (ChainSet)
  },
  "mapsLocationSet": {
    object (MapsLocationSet)
  }
  // End of list of possible types for union field source.
}
Campos
locationOwnershipType

enum (LocationOwnershipType)

Obrigatório. Imutável. Tipo de propriedade de local (local de propriedade ou de afiliado).

Campo de união source. Dados de local específicos para cada origem de sincronização. source pode ser apenas de um dos tipos a seguir:
businessProfileLocationSet

object (BusinessProfileLocationSet)

Dados usados para configurar um conjunto de locais preenchido com base nos locais do Perfil da Empresa no Google.

chainLocationSet

object (ChainSet)

Dados usados para configurar um local no conjunto da rede preenchido com as redes especificadas.

mapsLocationSet

object (MapsLocationSet)

Definir apenas se os locais forem sincronizados com base nos locais selecionados do mapa

BusinessProfileLocationSet

Dados usados para configurar um conjunto de locais preenchido com base nos locais do Perfil da Empresa no Google. Diferentes tipos de filtros são unidos por AND, se especificados.

Representação JSON
{
  "httpAuthorizationToken": string,
  "emailAddress": string,
  "businessNameFilter": string,
  "labelFilters": [
    string
  ],
  "listingIdFilters": [
    string
  ],
  "businessAccountId": string
}
Campos
httpAuthorizationToken

string

Obrigatório. Imutável. O token de autorização HTTP usado para receber autorização.

emailAddress

string

Obrigatório. Imutável. Endereço de e-mail de uma conta do Perfil da Empresa no Google ou de um administrador dessa conta.

businessNameFilter

string

Usado para filtrar fichas do Perfil da Empresa no Google por nome. Se businessNameFilter estiver definido, apenas as fichas com um nome de empresa correspondente poderão ser sincronizadas com os recursos.

labelFilters[]

string

Usado para filtrar fichas do Perfil da Empresa no Google por rótulos. Se houver entradas em labelFilters, somente as fichas com um dos marcadores definidos poderão ser sincronizadas com os recursos. Se não houver entradas em labelFilters, todas as fichas se qualificarão para sincronização. Os filtros de rótulo são unidos por OR.

listingIdFilters[]

string (int64 format)

Usado para filtrar fichas do Perfil da Empresa no Google por ID. Se houver entradas em ListingIdFilters, somente as fichas especificadas pelos filtros poderão ser sincronizadas com os recursos. Se não houver entradas em ListingIdFilters, todas as fichas se qualificarão para sincronização. Os filtros de ID da ficha da empresa são agrupados por OR.

businessAccountId

string

Imutável. O ID da conta da empresa gerenciada cujos locais serão usados. Se este campo não for definido, todas as empresas acessíveis pelo usuário (especificadas pelo emailAddress) serão usadas.

ChainSet

Dados usados para configurar um conjunto de locais preenchido com as redes especificadas.

Representação JSON
{
  "relationshipType": enum (ChainRelationshipType),
  "chains": [
    {
      object (ChainFilter)
    }
  ]
}
Campos
relationshipType

enum (ChainRelationshipType)

Obrigatório. Imutável. Tipo de relação das redes especificadas com o anunciante.

chains[]

object (ChainFilter)

Obrigatório. Uma lista de filtros no nível da rede. Todos os filtros são unidos por OU.

ChainRelationshipType

Tipos possíveis de um relacionamento.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa o valor desconhecido nesta versão.
AUTO_DEALERS Relacionamento com concessionária de automóveis.
GENERAL_RETAILERS Relacionamento geral com o varejista.

ChainFilter

Um filtro no nível da rede referente ao local de um conjunto de itens do feed. A lógica de filtragem entre todos os campos é "AND".

Representação JSON
{
  "chainId": string,
  "locationAttributes": [
    string
  ]
}
Campos
chainId

string (int64 format)

Obrigatório. Usado para filtrar locais da rede por ID. Somente os locais de rede que pertencem à rede especificada vão aparecer no conjunto de recursos.

locationAttributes[]

string

Usado para filtrar locais da rede por atributos de local. Somente os locais de rede que pertencem a todos os atributos especificados vão estar no conjunto de recursos. Se este campo estiver vazio, isso significa que não há filtragem nele.

MapsLocationSet

Wrapper para dados de sincronização de local de vários mapas

Representação JSON
{
  "mapsLocations": [
    {
      object (MapsLocationInfo)
    }
  ]
}
Campos
mapsLocations[]

object (MapsLocationInfo)

Obrigatório. Uma lista de informações de local do Google Maps que o usuário sincronizou manualmente.

MapsLocationInfo

Wrapper para IDs de lugar

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

string

ID do local do Google Maps.

BusinessProfileLocationGroup

Informações sobre um grupo por locais dinâmicos do Perfil da Empresa. Aplicável somente se o tipo do AssetSet no nível de sincronização for LOCATION_SYNC e a origem da sincronização for o Perfil da Empresa.

Representação JSON
{
  "dynamicBusinessProfileLocationGroupFilter": {
    object (DynamicBusinessProfileLocationGroupFilter)
  }
}
Campos
dynamicBusinessProfileLocationGroupFilter

object (DynamicBusinessProfileLocationGroupFilter)

Filtre por conjuntos de locais dinâmicos do Perfil da Empresa.

DynamicBusinessProfileLocationGroupFilter

Representa um filtro em locais do Perfil da Empresa em um conjunto de recursos. Se vários filtros forem fornecidos, eles serão somados entre si.

Representação JSON
{
  "labelFilters": [
    string
  ],
  "listingIdFilters": [
    string
  ],
  "businessNameFilter": {
    object (BusinessProfileBusinessNameFilter)
  }
}
Campos
labelFilters[]

string

Usado para filtrar os locais do Perfil da Empresa por etiqueta. Somente os locais que tiverem um dos rótulos listados vão aparecer no conjunto de recursos. Os filtros de rótulo são unidos por OR.

listingIdFilters[]

string (int64 format)

Usado para filtrar locais do Perfil da Empresa por IDs de fichas.

businessNameFilter

object (BusinessProfileBusinessNameFilter)

Usado para filtrar os locais do Perfil da Empresa por nome.

BusinessProfileBusinessNameFilter

Filtro de nome da empresa no grupo por locais do Perfil da Empresa.

Representação JSON
{
  "businessName": string,
  "filterType": enum (LocationStringFilterType)
}
Campos
businessName

string

String do nome da empresa a ser usada para filtragem.

filterType

enum (LocationStringFilterType)

O tipo de correspondência de string a ser usado ao filtrar com businessName.

LocationStringFilterType

Tipos possíveis de um filtro de string de localização.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa o valor desconhecido nesta versão.
EXACT O filtro usará a correspondência exata de string.

ChainLocationGroup

Representa informações sobre um grupo de locais dinâmicos de rede. Aplicável somente se o tipo do AssetSet no nível de sincronização for LOCATION_SYNC e a origem da sincronização for cadeia.

Representação JSON
{
  "dynamicChainLocationGroupFilters": [
    {
      object (ChainFilter)
    }
  ]
}
Campos
dynamicChainLocationGroupFilters[]

object (ChainFilter)

Usado para filtrar locais da rede por códigos. Somente os locais que pertencem à(s) rede(s) especificada(s) estarão no conjunto de recursos.