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 de recursos. Os nomes dos recursos de conjuntos de ativos têm o seguinte formato:

customers/{customerId}/assetSets/{asset_set_id}

name

string

Obrigatório. Nome do conjunto de recursos. Obrigatório. Precisa ter no mínimo 1 e no máximo 128 caracteres.

type

enum (AssetSetType)

Obrigatório. Imutável. O tipo do grupo 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 do conjunto de recursos de onde os elementos desse conjunto vêm. Por exemplo: o ID do AssetSet de local no nível de sincronização de onde vêm os elementos no AssetSet do LocationGroup. Este campo é obrigatório e só é aplicável ao AssetSet do tipo "Grupo de locais".

hotelPropertyData

object (HotelPropertyData)

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

Campo de união asset_set_source. Dados de conjuntos de recursos específicos para cada tipo de conjunto de recursos. 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 recurso de local. Ele será usado para definir o local no nível da sincronização. Isso só pode ser definido se o tipo de AssetSet for LOCATION_SYNC.

businessProfileLocationGroup

object (BusinessProfileLocationGroup)

Dados do recurso do grupo de locais do Perfil da Empresa.

chainLocationGroup

object (ChainLocationGroup)

Representa informações sobre um grupo por locais dinâmico da rede. Só é aplicável se o tipo de nível de sincronização do AssetSet for LOCATION_SYNC e a origem de sincronização for "chain".

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

Para campanhas Performance Max para metas de turismo com uma vinculação à 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 local. É necessário especificar um dos dados do Perfil da Empresa no Google (antigo Google Meu Negócio), dados da rede e dados de local do mapa.

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 do local (local próprio ou de afiliado).

Campo de união source. Dados de local específicos de cada fonte 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 locais do Perfil da Empresa no Google.

chainLocationSet

object (ChainSet)

Dados usados para configurar um local no conjunto de cadeias preenchido com as cadeias especificadas.

mapsLocationSet

object (MapsLocationSet)

Só defina se os locais forem sincronizados com base nos locais do Maps selecionados

BusinessProfileLocationSet

Dados usados para configurar um conjunto de locais preenchido com 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 conseguir a 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 da conta.

businessNameFilter

string

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

labelFilters[]

string

Usado para filtrar as listagens do Perfil da Empresa no Google por rótulos. Se houver entradas em "labelFilters", apenas as listagens que tiverem qualquer um dos rótulos definidos serão candidatas a serem sincronizadas com os Recursos. Se não houver entradas em labelFilters, todas as listagens serão candidatas à sincronização. Os filtros de rótulo são unidos por OR.

listingIdFilters[]

string (int64 format)

Usado para filtrar as fichas do Perfil da Empresa no Google por ID. Se houver entradas em "listingIdFilters", apenas as listagens especificadas pelos filtros serão candidatas a ser sincronizadas com os Recursos. Se não houver entradas em listingIdFilters, todas as fichas serão candidatas à sincronização. Os filtros de ID da ficha são unidos por OR.

businessAccountId

string

Imutável. O ID da conta da empresa gerenciada cujos locais serão usados. Se esse 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 que as cadeias especificadas têm com esse anunciante.

chains[]

object (ChainFilter)

Obrigatório. Uma lista de filtros no nível da cadeia, todos os filtros são agrupados por OU.

ChainRelationshipType

Possíveis tipos de relacionamento.

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

ChainFilter

Um filtro de nível de rede no local em um conjunto de itens de 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 de rede por ID. Somente os locais da rede que pertencem à rede especificada vão estar no conjunto de recursos.

locationAttributes[]

string

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

MapsLocationSet

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

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

object (MapsLocationInfo)

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

MapsLocationInfo

Wrapper para IDs de lugares

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

string

ID do lugar no Maps.

BusinessProfileLocationGroup

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

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

object (DynamicBusinessProfileLocationGroupFilter)

Filtrar conjuntos de locais dinâmicos do Perfil da Empresa.

DynamicBusinessProfileLocationGroupFilter

Representa um filtro nos locais do Perfil da Empresa em um conjunto de recursos. Se vários filtros forem fornecidos, eles serão unidos por E.

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

string

Usado para filtrar locais do Perfil da Empresa por rótulo. Somente os locais que têm algum dos rótulos listados vão estar 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 ficha.

businessNameFilter

object (BusinessProfileBusinessNameFilter)

Usado para filtrar locais do Perfil da Empresa pelo nome da empresa.

BusinessProfileBusinessNameFilter

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

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

string

String de nome da empresa a ser usada para filtrar.

filterType

enum (LocationStringFilterType)

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

LocationStringFilterType

Possíveis tipos de filtro de string de local.

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

ChainLocationGroup

Representa informações sobre um grupo por locais dinâmico da rede. Só é aplicável se o tipo de nível de sincronização do AssetSet for LOCATION_SYNC e a origem de sincronização for "chain".

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

object (ChainFilter)

Usado para filtrar locais de rede por IDs de rede. Somente os locais que pertencem às redes especificadas vão estar no conjunto de recursos.