AssetSet

Un set di asset che rappresenta una raccolta di asset. 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 del set 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 lunghezza massima di 128.

type

enum (AssetSetType)

obbligatorio. Immutabile. Il tipo di set di asset. obbligatorio.

status

enum (AssetSetStatus)

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

merchantCenterFeed

object (MerchantCenterFeed)

L'ID commerciante e l'etichetta del feed di Google Merchant Center.

locationGroupParentAssetSetId

string (int64 format)

Immutabile. ID set di asset principale per l'insieme 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 all'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 del set di asset specifici per ogni tipo di insieme di asset. Non tutti i tipi dispongono di dati specifici. asset_set_source può essere solo uno dei seguenti:
locationSet

object (LocationSet)

Dati del set di asset posizione. Verrà utilizzata per la posizione a livello di sincronizzazione impostata. Questo valore 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)

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

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 solo risposta.
ENABLED L'insieme di asset è attivato.
REMOVED L'insieme di asset viene rimosso.

MerchantCenterFeed

L'ID commerciante e l'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 (in precedenza Google My Business), i dati delle catene e i dati sulla 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 ogni origine della sincronizzazione. source può essere solo uno dei seguenti:
businessProfileLocationSet

object (BusinessProfileLocationSet)

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

chainLocationSet

object (ChainSet)

Dati utilizzati per configurare una località in un set di catene popolato 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 località completato a partire dalle sedi di Profilo dell'attività su Google. Diversi tipi di filtri vengono collegati tra loro, 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 l'impostazione businessNameFilter è impostata, solo le schede con un nome dell'attività corrispondente sono candidati per la sincronizzazione 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 etichette impostate sono candidati per la sincronizzazione nelle risorse. Se non esistono voci in labelFiltri, tutte le schede sono candidati per la sincronizzazione. I filtri per le etichette sono collegati tra loro tramite OR.

listingIdFilters[]

string (int64 format)

Utilizzata 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 Asset. Se non esistono voci inlistingIdFiltri, tutte le schede sono candidati per la sincronizzazione. I filtri dell'ID scheda sono collegati tra loro tramite OR.

businessAccountId

string

Immutabile. L'ID account dell'attività gestita di cui devono essere utilizzate le sedi. Se questo campo non viene configurato, vengono utilizzate tutte le attività accessibili all'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 tra loro tramite 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 un rivenditore.

ChainFilter

Un filtro a livello di catena per la località in un insieme di elementi del feed. La logica di filtro tra 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 al relativo ID. Nel set di asset saranno incluse solo le località delle catene che appartengono alla catena specificata.

locationAttributes[]

string

Utilizzato per filtrare le località delle catene in base agli attributi di località. Nell'insieme di asset saranno presenti solo le località delle catene che appartengono a tutti gli attributi specificati. Se il 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 sulle mappe che l'utente ha sincronizzato manualmente.

MapsLocationInfo

Wrapper per gli ID luogo

Rappresentazione JSON
{
  "placeId": string
}
Campi
placeId

string

ID della posizione su Maps.

BusinessProfileLocationGroup

Informazioni su un gruppo di località dinamico 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 gli insiemi dinamici di località 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 vengono collegati tra loro tramite AND.

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

string

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

listingIdFilters[]

string (int64 format)

Utilizzato per filtrare le sedi del profilo dell'attività in base agli ID scheda.

businessNameFilter

object (BusinessProfileBusinessNameFilter)

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

BusinessProfileBusinessNameFilter

Filtro del 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 i filtri.

filterType

enum (LocationStringFilterType)

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

LocationStringFilterType

Tipi possibili di filtro per la stringa della 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

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

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

object (ChainFilter)

Utilizzato per filtrare le località delle catene in base al relativo ID. Nel set di asset saranno presenti solo le località che appartengono alle catene specificate.