AssetSet

Eine Asset-Gruppe, die eine Sammlung von Assets darstellt. Verwenden Sie „AssetSetAsset“, um ein Asset mit der Asset-Gruppe zu verknüpfen.

JSON-Darstellung
{
  "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.
}
Felder
id

string (int64 format)

Nur Ausgabe Die ID der Asset-Gruppe.

resourceName

string

Nicht veränderbar. Der Ressourcenname der Asset-Gruppe. Ressourcennamen von Asset-Gruppen haben das folgende Format:

customers/{customerId}/assetSets/{asset_set_id}

name

string

Erforderlich. Name der Asset-Gruppe. Erforderlich. Sie muss eine Mindestlänge von 1 und eine maximale Länge von 128 haben.

type

enum (AssetSetType)

Erforderlich. Nicht veränderbar. Der Typ der Asset-Gruppe. Erforderlich.

status

enum (AssetSetStatus)

Nur Ausgabe Der Status der Asset-Gruppe. Schreibgeschützt.

merchantCenterFeed

object (MerchantCenterFeed)

Händler-ID und Feedlabel aus dem Google Merchant Center.

locationGroupParentAssetSetId

string (int64 format)

Nicht veränderbar. ID der übergeordneten Asset-Gruppe für die Asset-Gruppe, aus der die Elemente dieser Asset-Gruppe stammen. Beispiel: die AssetSet-ID für den Standort auf Synchronisierungsebene, von dem die Elemente in „LocationGroup AssetSet“ stammen. Dieses Feld ist erforderlich und gilt nur für AssetSet vom Typ „Standortgruppe“.

hotelPropertyData

object (HotelPropertyData)

Nur Ausgabe Für Performance Max-Kampagnen für die Reisebranche mit einer Hotel Center-Kontoverknüpfung. Schreibgeschützt.

Union-Feld asset_set_source. Spezifische Asset-Gruppendaten für die einzelnen Asset-Gruppentypen. Nicht alle Typen haben spezifische Daten. Für asset_set_source ist nur einer der folgenden Werte zulässig:
locationSet

object (LocationSet)

Daten der Standort-Asset-Gruppe. Wird für den Standort auf Synchronisierungsebene verwendet. Dies kann nur festgelegt werden, wenn der AssetSet-Typ LOCATION_SYNC ist.

businessProfileLocationGroup

object (BusinessProfileLocationGroup)

Daten der Asset-Gruppe von Standortgruppen im Unternehmensprofil.

chainLocationGroup

object (ChainLocationGroup)

Informationen zu einer dynamischen Standortgruppe einer Kette. Dies gilt nur, wenn der AssetSet-Typ auf der Synchronisierungsebene LOCATION_SYNC und die Synchronisierungsquelle eine Kette ist.

AssetSetStatus

Die möglichen Status einer Asset-Gruppe.

Enums
UNSPECIFIED Der Status wurde nicht angegeben.
UNKNOWN Der empfangene Wert ist in dieser Version nicht bekannt. Dies ist ein reiner Antwortwert.
ENABLED Die Asset-Gruppe ist aktiviert.
REMOVED Die Asset-Gruppe wird entfernt.

MerchantCenterFeed

Händler-ID und Feedlabel aus dem Google Merchant Center.

JSON-Darstellung
{
  "merchantId": string,
  "feedLabel": string
}
Felder
merchantId

string (int64 format)

Erforderlich. Händler-ID aus dem Google Merchant Center

feedLabel

string

Optional. Feedlabel aus dem Google Merchant Center.

HotelPropertyData

Für Performance Max-Kampagnen für die Reisebranche mit einer Hotel Center-Kontoverknüpfung. Schreibgeschützt.

JSON-Darstellung
{
  "hotelCenterId": string,
  "partnerName": string
}
Felder
hotelCenterId

string (int64 format)

Nur Ausgabe Die Hotel Center-ID des Partners.

partnerName

string

Nur Ausgabe Name des Hotelpartners.

LocationSet

Daten zum festgelegten Standort. Eines der Daten aus dem Google Unternehmensprofil (früher Google My Business), der Kettendaten und der Standortdaten auf der Karte müssen angegeben werden.

JSON-Darstellung
{
  "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.
}
Felder
locationOwnershipType

enum (LocationOwnershipType)

Erforderlich. Nicht veränderbar. Typ der Inhaberschaft des Standorts (eigener Standort oder Affiliate-Standort)

Union-Feld source. Spezifische Standortdaten für jede Synchronisierungsquelle. Für source ist nur einer der folgenden Werte zulässig:
businessProfileLocationSet

object (BusinessProfileLocationSet)

Daten, die zur Konfiguration eines Standortsatzes verwendet werden, der aus Google Unternehmensprofil-Standorten gefüllt wird.

chainLocationSet

object (ChainSet)

Daten, die zum Konfigurieren eines Standorts in einer Kettengruppe verwendet werden, die mit den angegebenen Ketten gefüllt ist.

mapsLocationSet

object (MapsLocationSet)

Nur festlegen, wenn Standorte basierend auf ausgewählten Standorten auf Google Maps synchronisiert werden

BusinessProfileLocationSet

Daten, die zur Konfiguration eines Standortsatzes verwendet werden, der aus Google Unternehmensprofil-Standorten gefüllt wird. Verschiedene Filtertypen werden, sofern angegeben, durch eine UND-Verbindung miteinander verbunden.

JSON-Darstellung
{
  "httpAuthorizationToken": string,
  "emailAddress": string,
  "businessNameFilter": string,
  "labelFilters": [
    string
  ],
  "listingIdFilters": [
    string
  ],
  "businessAccountId": string
}
Felder
httpAuthorizationToken

string

Erforderlich. Nicht veränderbar. Das HTTP-Autorisierungstoken, mit dem die Autorisierung abgerufen wird.

emailAddress

string

Erforderlich. Nicht veränderbar. E-Mail-Adresse eines Google Unternehmensprofil-Kontos oder E-Mail-Adresse eines Administrators des Google Unternehmensprofil-Kontos

businessNameFilter

string

Damit können Google Unternehmensprofil-Einträge nach dem Namen des Unternehmens gefiltert werden. Wenn businessNameFilter festgelegt ist, können nur Einträge mit einem übereinstimmenden Firmennamen mit Assets synchronisiert werden.

labelFilters[]

string

Damit können Google Unternehmensprofil-Einträge nach Labels gefiltert werden. Wenn in labelFilters Einträge vorhanden sind, kommen nur Einträge, für die eines der Labels festgelegt ist, für eine Synchronisierung mit Assets infrage. Wenn in labelFilters keine Einträge vorhanden sind, sind alle Einträge Kandidaten für die Synchronisierung. Labelfilter werden mit ODER verbunden.

listingIdFilters[]

string (int64 format)

Damit können Google Unternehmensprofil-Einträge nach Eintrags-ID gefiltert werden. Wenn Einträge in „listingIdFilters“ vorhanden sind, kommen nur Einträge, die in den Filtern angegeben sind, für eine Synchronisierung mit „Assets“ infrage. Wenn in „listingIdFilters“ keine Einträge vorhanden sind, sind alle Einträge Kandidaten für die Synchronisierung. Eintrags-ID-Filter werden mit ODER verknüpft.

businessAccountId

string

Nicht veränderbar. Konto-ID des verwalteten Unternehmens, dessen Standorte verwendet werden sollen. Wenn dieses Feld nicht festgelegt ist, werden alle Unternehmen verwendet, auf die der Nutzer (durch die emailAddress angegeben) zugreifen kann.

ChainSet

Daten, die zur Konfiguration eines Standortsatzes mit den angegebenen Ketten verwendet werden.

JSON-Darstellung
{
  "relationshipType": enum (ChainRelationshipType),
  "chains": [
    {
      object (ChainFilter)
    }
  ]
}
Felder
relationshipType

enum (ChainRelationshipType)

Erforderlich. Nicht veränderbar. Beziehungstyp, den die angegebenen Ketten mit diesem Werbetreibenden haben.

chains[]

object (ChainFilter)

Erforderlich. Eine Liste von Filtern auf Kettenebene, die alle mit ODER verbunden sind.

ChainRelationshipType

Mögliche Typen einer Beziehung.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt den in dieser Version unbekannten Wert dar.
AUTO_DEALERS Beziehung zu einem Autohändler.
GENERAL_RETAILERS Allgemeine Händlerbeziehung.

ChainFilter

Ein Filter auf Kettenebene für den Standort in einer Feedelementgruppe. Die Filterlogik zwischen allen Feldern ist UND.

JSON-Darstellung
{
  "chainId": string,
  "locationAttributes": [
    string
  ]
}
Felder
chainId

string (int64 format)

Erforderlich. Hiermit können Sie Standorte von Ketten nach Ketten-ID filtern. Nur Standorte von Ketten, die zur angegebenen Kette gehören, werden in die Asset-Gruppe aufgenommen.

locationAttributes[]

string

Damit können Standorte von Ketten nach Standortattributen gefiltert werden. Nur Standorte von Ketten, die zu allen angegebenen Attributen gehören, werden in die Asset-Gruppe aufgenommen. Wenn dieses Feld leer ist, bedeutet dies, dass es nicht gefiltert wird.

MapsLocationSet

Wrapper für Daten zur Standortsynchronisierung mehrerer Karten

JSON-Darstellung
{
  "mapsLocations": [
    {
      object (MapsLocationInfo)
    }
  ]
}
Felder
mapsLocations[]

object (MapsLocationInfo)

Erforderlich. Eine Liste mit Kartenstandortinformationen, die der Nutzer manuell synchronisiert hat.

MapsLocationInfo

Wrapper für Orts-IDs

JSON-Darstellung
{
  "placeId": string
}
Felder
placeId

string

Orts-ID des Google Maps-Standorts.

BusinessProfileLocationGroup

Informationen zu einer dynamischen Standortgruppe aus Google Unternehmensprofil. Dies gilt nur, wenn der AssetSet-Typ auf Synchronisierungsebene LOCATION_SYNC und die Synchronisierungsquelle Google Unternehmensprofil ist.

JSON-Darstellung
{
  "dynamicBusinessProfileLocationGroupFilter": {
    object (DynamicBusinessProfileLocationGroupFilter)
  }
}
Felder
dynamicBusinessProfileLocationGroupFilter

object (DynamicBusinessProfileLocationGroupFilter)

Filtern Sie nach dynamischen Standortsätzen im Unternehmensprofil.

DynamicBusinessProfileLocationGroupFilter

Filter für Unternehmensprofil-Standorte in einer Asset-Gruppe Werden mehrere Filter angegeben, werden diese durch eine UND-Verbindung verknüpft.

JSON-Darstellung
{
  "labelFilters": [
    string
  ],
  "listingIdFilters": [
    string
  ],
  "businessNameFilter": {
    object (BusinessProfileBusinessNameFilter)
  }
}
Felder
labelFilters[]

string

Wird verwendet, um Standorte im Unternehmensprofil nach Label zu filtern. Nur Standorte mit einem der aufgeführten Labels werden in die Asset-Gruppe aufgenommen. Labelfilter werden mit ODER verbunden.

listingIdFilters[]

string (int64 format)

Wird verwendet, um Standorte im Unternehmensprofil nach Eintrag-IDs zu filtern.

businessNameFilter

object (BusinessProfileBusinessNameFilter)

Wird verwendet, um Standorte im Unternehmensprofil nach dem Namen des Unternehmens zu filtern.

BusinessProfileBusinessNameFilter

Filter für den Namen des Unternehmens in der Standortgruppe im Unternehmensprofil.

JSON-Darstellung
{
  "businessName": string,
  "filterType": enum (LocationStringFilterType)
}
Felder
businessName

string

String für den Namen des Unternehmens zum Filtern.

filterType

enum (LocationStringFilterType)

Der Typ des Stringabgleichs, der beim Filtern mit „businessName“ verwendet werden soll.

LocationStringFilterType

Mögliche Typen von Standortstringfiltern.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt den in dieser Version unbekannten Wert dar.
EXACT Der Filter verwendet einen genauen Stringabgleich.

ChainLocationGroup

Informationen zu einer dynamischen Standortgruppe einer Kette. Dies gilt nur, wenn der AssetSet-Typ auf der Synchronisierungsebene LOCATION_SYNC und die Synchronisierungsquelle eine Kette ist.

JSON-Darstellung
{
  "dynamicChainLocationGroupFilters": [
    {
      object (ChainFilter)
    }
  ]
}
Felder
dynamicChainLocationGroupFilters[]

object (ChainFilter)

Damit können die Standorte von Ketten nach Ketten-IDs gefiltert werden. Nur Standorte, die zu den angegebenen Ketten gehören, werden in die Asset-Gruppe aufgenommen.