AssetSet

Un insieme di risorse che rappresenta una raccolta di risorse. Utilizza AssetSetAsset per collegare un asset all'insieme.

Rappresentazione 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.
}
Campi
id

string (int64 format)

Solo output. L'ID dell'insieme di asset.

resourceName

string

Immutabile. Il nome della risorsa dell'insieme di asset. I nomi delle risorse degli insiemi di asset hanno il seguente formato:

customers/{customerId}/assetSets/{asset_set_id}

name

string

Obbligatorio. Nome dell'insieme di asset. Obbligatorio. Deve avere una lunghezza minima di 1 e una massima di 128.

type

enum (AssetSetType)

Obbligatorio. Immutabile. Il tipo di insieme di asset. Obbligatorio.

status

enum (AssetSetStatus)

Solo output. Lo stato dell'insieme di asset. Sola lettura.

merchantCenterFeed

object (MerchantCenterFeed)

ID commerciante ed etichetta del feed di Google Merchant Center.

locationGroupParentAssetSetId

string (int64 format)

Immutabile. ID set di asset principale per il set di asset da cui provengono gli elementi di questo set di asset. Ad esempio, l'ID AssetSet posizione a livello di sincronizzazione da cui provengono gli elementi in LocationGroup AssetSet. Questo campo è obbligatorio e applicabile solo per AssetSet di tipo Gruppo di località.

hotelPropertyData

object (HotelPropertyData)

Solo output. Per le campagne Performance Max per gli obiettivi di viaggio con un collegamento all'account Hotel Center. Sola lettura.

Campo di unione asset_set_source. Dati dell'insieme di asset specifici per ciascun tipo di set di asset. Non tutti i tipi dispongono di dati specifici. asset_set_source può essere solo uno dei seguenti:
locationSet

object (LocationSet)

Dati dell'insieme di asset posizione. Verrà utilizzato per l'impostazione della posizione a livello di sincronizzazione. Può essere impostato solo se il tipo di AssetSet è LOCATION_SYNC.

businessProfileLocationGroup

object (BusinessProfileLocationGroup)

Dati dell'insieme di asset del gruppo di località del profilo dell'attività.

chainLocationGroup

object (ChainLocationGroup)

Rappresentano le informazioni su un gruppo di località dinamiche di una catena. Applicabile solo se il tipo di AssetSet a livello di sincronizzazione è LOCATION_SYNC e l'origine della sincronizzazione è a catena.

AssetSetStatus

I possibili stati di un insieme di asset.

Enum
UNSPECIFIED Lo stato non è stato specificato.
UNKNOWN Il valore ricevuto non è noto in questa versione. Questo è un valore di sola risposta.
ENABLED L'insieme di asset è attivato.
REMOVED L'insieme di asset viene rimosso.

MerchantCenterFeed

ID commerciante ed etichetta del feed di Google Merchant Center.

Rappresentazione JSON
{
  "merchantId": string,
  "feedLabel": string
}
Campi
merchantId

string (int64 format)

Obbligatorio. ID commerciante di Google Merchant Center

feedLabel

string

Campo facoltativo. Etichetta del feed di Google Merchant Center.

HotelPropertyData

Per le campagne Performance Max per gli obiettivi di viaggio con un collegamento all'account Hotel Center. Sola lettura.

Rappresentazione JSON
{
  "hotelCenterId": string,
  "partnerName": string
}
Campi
hotelCenterId

string (int64 format)

Solo output. L'ID Hotel Center del partner.

partnerName

string

Solo output. Nome del partner hotel.

LocationSet

Dati relativi all'insieme di località. È necessario specificare uno dei dati di Profilo dell'attività su Google (precedentemente noto come Google My Business), i dati delle catene e della posizione sulla mappa.

Rappresentazione 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.
}
Campi
locationOwnershipType

enum (LocationOwnershipType)

Obbligatorio. Immutabile. Tipo di proprietà della località (località di proprietà o località dell'affiliato).

Campo di unione source. Dati sulla posizione specifici per ciascuna origine della sincronizzazione. source può essere solo uno dei seguenti:
businessProfileLocationSet

object (BusinessProfileLocationSet)

Dati utilizzati per configurare un insieme di sedi completato a partire dalle sedi di Profilo dell'attività su Google.

chainLocationSet

object (ChainSet)

Dati utilizzati per configurare una località su un set di catene completato con le catene specificate.

mapsLocationSet

object (MapsLocationSet)

Impostato solo se le località sono sincronizzate in base a quelle selezionate sulla mappa

BusinessProfileLocationSet

Dati utilizzati per configurare un insieme di sedi completato a partire dalle sedi di Profilo dell'attività su Google. Diversi tipi di filtri sono collegati tra loro mediante l'operatore AND, se specificati.

Rappresentazione JSON
{
  "httpAuthorizationToken": string,
  "emailAddress": string,
  "businessNameFilter": string,
  "labelFilters": [
    string
  ],
  "listingIdFilters": [
    string
  ],
  "businessAccountId": string
}
Campi
httpAuthorizationToken

string

Obbligatorio. Immutabile. Il token di autorizzazione HTTP utilizzato per ottenere l'autorizzazione.

emailAddress

string

Obbligatorio. Immutabile. Indirizzo email di un account Profilo dell'attività su Google o indirizzo email di un gestore dell'account Profilo dell'attività su Google.

businessNameFilter

string

Utilizzato per filtrare le schede di Profilo dell'attività su Google in base al nome dell'attività. Se è impostata l'opzione businessNameFilter, solo le schede con un nome dell'attività corrispondente possono essere sincronizzate negli asset.

labelFilters[]

string

Utilizzato per filtrare le schede di Profilo dell'attività su Google in base alle etichette. Se in labelFiltri sono presenti voci, solo le schede con una qualsiasi delle etichette impostate sono candidati per la sincronizzazione in Risorse. Se in labelFiltri non sono presenti voci, tutti gli elenchi sono candidati per la sincronizzazione. I filtri per le etichette sono collegati tra loro con una relazione di tipo OR.

listingIdFilters[]

string (int64 format)

Utilizzato per filtrare le schede di Profilo dell'attività su Google per ID scheda. Se sono presenti voci inlistingIdFiltri, solo le schede specificate dai filtri sono candidati per la sincronizzazione in Risorse. Se non sono presenti voci in ListingsIdFiltri, tutte le schede sono candidati per la sincronizzazione. I filtri ID scheda sono collegati tra loro mediante l'operatore "OR".

businessAccountId

string

Immutabile. L'ID account dell'attività gestita di cui devono essere utilizzate le sedi. Se questo campo non è impostato, vengono utilizzate tutte le attività accessibili dall'utente (specificate dall'indirizzo email).

ChainSet

Dati utilizzati per configurare un insieme di località completato con le catene specificate.

Rappresentazione JSON
{
  "relationshipType": enum (ChainRelationshipType),
  "chains": [
    {
      object (ChainFilter)
    }
  ]
}
Campi
relationshipType

enum (ChainRelationshipType)

Obbligatorio. Immutabile. Tipo di relazione che le catene specificate hanno con questo inserzionista.

chains[]

object (ChainFilter)

Obbligatorio. Un elenco di filtri a livello di catena, tutti i filtri sono collegati insieme con una relazione di tipo OR.

ChainRelationshipType

Possibili tipi di relazione.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione.
AUTO_DEALERS Rapporto con un concessionario di auto.
GENERAL_RETAILERS Rapporto generale con il rivenditore.

ChainFilter

Un filtro a livello di catena sulla località in un insieme di elementi del feed. La logica di filtro di tutti i campi è AND.

Rappresentazione JSON
{
  "chainId": string,
  "locationAttributes": [
    string
  ]
}
Campi
chainId

string (int64 format)

Obbligatorio. Utilizzato per filtrare le località delle catene in base all'ID catena. Nel set di asset saranno incluse solo le località delle catene che appartengono alla catena specificata.

locationAttributes[]

string

Utilizzato per filtrare le sedi delle catene in base agli attributi della località. Nel set di asset saranno incluse solo le località delle catene che appartengono a tutti gli attributi specificati. Se questo campo è vuoto, significa che non è stato applicato alcun filtro.

MapsLocationSet

Wrapper dati di sincronizzazione della posizione di più mappe

Rappresentazione JSON
{
  "mapsLocations": [
    {
      object (MapsLocationInfo)
    }
  ]
}
Campi
mapsLocations[]

object (MapsLocationInfo)

Obbligatorio. Un elenco di informazioni sulla posizione di Maps che l'utente ha sincronizzato manualmente.

MapsLocationInfo

Wrapper per gli ID luogo

Rappresentazione JSON
{
  "placeId": string
}
Campi
placeId

string

ID luogo della località su Maps.

BusinessProfileLocationGroup

Informazioni su un gruppo di località dinamiche del profilo dell'attività. Applicabile solo se il tipo di AssetSet a livello di sincronizzazione è LOCATION_SYNC e l'origine della sincronizzazione è Profilo dell'attività.

Rappresentazione JSON
{
  "dynamicBusinessProfileLocationGroupFilter": {
    object (DynamicBusinessProfileLocationGroupFilter)
  }
}
Campi
dynamicBusinessProfileLocationGroupFilter

object (DynamicBusinessProfileLocationGroupFilter)

Filtra in base agli insiemi di località dinamiche del profilo dell'attività.

DynamicBusinessProfileLocationGroupFilter

Rappresenta un filtro per le sedi del profilo dell'attività in un insieme di asset. Se vengono forniti più filtri, questi verranno combinati con l'operatore AND.

Rappresentazione JSON
{
  "labelFilters": [
    string
  ],
  "listingIdFilters": [
    string
  ],
  "businessNameFilter": {
    object (BusinessProfileBusinessNameFilter)
  }
}
Campi
labelFilters[]

string

Utilizzato per filtrare le sedi nel profilo dell'attività in base all'etichetta. Solo le località con una delle etichette elencate saranno incluse nel set di asset. I filtri per le etichette sono collegati tra loro con una relazione di tipo OR.

listingIdFilters[]

string (int64 format)

Utilizzato per filtrare le sedi nel profilo dell'attività per ID scheda.

businessNameFilter

object (BusinessProfileBusinessNameFilter)

Utilizzato per filtrare le sedi del profilo dell'attività in base al nome dell'attività.

BusinessProfileBusinessNameFilter

Filtro per il nome dell'attività del gruppo di sedi del profilo dell'attività.

Rappresentazione JSON
{
  "businessName": string,
  "filterType": enum (LocationStringFilterType)
}
Campi
businessName

string

Stringa del nome dell'attività da utilizzare per l'applicazione di filtri.

filterType

enum (LocationStringFilterType)

Il tipo di corrispondenza delle stringhe da utilizzare quando applichi un filtro con businessName.

LocationStringFilterType

Possibili tipi di filtro della stringa località.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione.
EXACT Il filtro utilizzerà la corrispondenza esatta delle stringhe.

ChainLocationGroup

Rappresentano le informazioni su un gruppo di località dinamiche di una catena. Applicabile solo se il tipo di AssetSet a livello di sincronizzazione è LOCATION_SYNC e l'origine della sincronizzazione è a catena.

Rappresentazione JSON
{
  "dynamicChainLocationGroupFilters": [
    {
      object (ChainFilter)
    }
  ]
}
Campi
dynamicChainLocationGroupFilters[]

object (ChainFilter)

Utilizzato per filtrare le località delle catene in base agli ID catena. Solo le sedi che appartengono alle catene specificate saranno incluse nel set di asset.