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 do conjunto de recursos têm o seguinte formato:

customers/{customerId}/assetSets/{asset_set_id}

name

string

Obrigatório. Nome do conjunto de recursos. Obrigatório. Ele precisa ter um comprimento 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. O ID do conjunto de recursos pai do conjunto de onde vêm os elementos desse conjunto de recursos. Por exemplo: o ID do AssetSet do local no nível de sincronização de onde vêm os elementos do AssetSet do LocationGroup. Esse campo é obrigatório e aplicável apenas a AssetSet com tipo de grupo por locais.

hotelPropertyData

object (HotelPropertyData)

Apenas saída. Para 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 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 conjunto de recursos de local. Isso será usado para a definição do local em 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 de locais do Perfil da Empresa.

chainLocationGroup

object (ChainLocationGroup)

Representa informações sobre um grupo por locais dinâmicos de rede. Aplicável somente se o tipo de AssetSet do nível de sincronização for LOCATION_SYNC e a origem da sincronização for de 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 apenas de resposta.
ENABLED O conjunto de recursos está ativado.
REMOVED O conjunto de recursos foi 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 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 parceiro de hotel.

LocationSet

Dados relacionados ao conjunto de locais. Os dados do Perfil da Empresa no Google (antes conhecido como Google Meu Negócio), da 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 preenchido com as cadeias 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 serã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 da empresa. Se businessNameFilter estiver definido, apenas as fichas com um nome de empresa correspondente poderão ser sincronizadas com a página "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 qualquer um dos marcadores definidos poderão ser sincronizadas com a seção "Recursos". Se não houver entradas em labelFilters, todas as fichas estão candidatas 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 serão candidatas a sincronização com "Recursos". Se não houver entradas em ListingIdFilters, todas as fichas estão candidatas para sincronização. Os filtros de ID da ficha da empresa são unidos 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

Possíveis tipos de relacionamento.

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

ChainFilter

Um filtro no nível da rede na localização 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 os locais da rede por código. Somente os locais de rede que pertencem à rede especificada estarão no conjunto de recursos.

locationAttributes[]

string

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

MapsLocationSet

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

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

object (MapsLocationInfo)

Obrigatório. Uma lista de informações de local no mapa 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âmico do Perfil da Empresa. Aplicável apenas se o tipo de AssetSet no 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)

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 unidos por AND.

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

string

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

listingIdFilters[]

string (int64 format)

Usado para filtrar os locais do Perfil da Empresa por códigos de ficha.

businessNameFilter

object (BusinessProfileBusinessNameFilter)

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

BusinessProfileBusinessNameFilter

Filtro de nomes de empresas no grupo de 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 usada ao filtrar com businessName.

LocationStringFilterType

Tipos possíveis de um filtro de string de local.

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

ChainLocationGroup

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

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

object (ChainFilter)

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