AssetSet

Eine Asset-Gruppe, die eine Sammlung von Assets repräsentiert. 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 der Asset-Gruppe haben das folgende Format:

customers/{customerId}/assetSets/{asset_set_id}

name

string

Erforderlich. Name der Asset-Gruppe. Erforderlich. Die Mindestlänge muss 1 und die maximale Länge 128 betragen.

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 des Standorts auf Synchronisierungsebene, von dem die Elemente in „LocationGroup AssetSet“ stammen. Dieses Feld ist erforderlich und gilt nur für „AssetSet“ mit dem 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 Daten der Asset-Gruppe für den jeweiligen Typ der Asset-Gruppe. 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. Gilt nur, wenn der AssetSet-Typ auf der Synchronisierungsebene „LOCATION_SYNC“ und die Synchronisierungsquelle „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 Standortsatz. Es müssen Daten aus dem Google Unternehmensprofil (früher Google My Business), Daten zu Handelsketten und zum Standort auf der Karte 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 der einzelnen Synchronisierungsquellen. Für source ist nur einer der folgenden Werte zulässig:
businessProfileLocationSet

object (BusinessProfileLocationSet)

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

chainLocationSet

object (ChainSet)

Daten, die verwendet werden, um einen Standort in Kettensatz zu konfigurieren, der mit den angegebenen Ketten gefüllt ist.

mapsLocationSet

object (MapsLocationSet)

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

BusinessProfileLocationSet

Daten zur Konfiguration eines Standortsatzes, der aus Google Unternehmensprofil-Standorten gefüllt wird. Verschiedene Filtertypen werden durch UND verbunden, sofern sie angegeben sind.

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

string

Erforderlich. Nicht veränderbar. Das zum Abrufen der Autorisierung verwendete HTTP-Autorisierungstoken.

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

Wird verwendet, um Einträge im Google Unternehmensprofil nach dem Namen des Unternehmens zu filtern. Wenn der businessNameFilter festgelegt ist, können nur Einträge mit einem übereinstimmenden Unternehmensnamen mit Assets synchronisiert werden.

labelFilters[]

string

Wird verwendet, um Google Unternehmensprofil-Einträge nach Labels zu filtern. Wenn in labelFilters Einträge vorhanden sind, sind nur Einträge, für die eines der Labels festgelegt ist, Kandidaten für eine Synchronisierung mit Assets. Wenn in „labelFilters“ keine Einträge vorhanden sind, kommen alle Einträge für die Synchronisierung infrage. Labelfilter werden mit ODER verbunden.

listingIdFilters[]

string (int64 format)

Wird verwendet, um Google Unternehmensprofil-Einträge nach Eintrags-ID zu filtern. Wenn Einträge in "listingIdFilters" vorhanden sind, sind nur die durch die Filter angegebenen Einträge Kandidaten für eine Synchronisierung mit Assets. Wenn in „listingIdFilters“ keine Einträge vorhanden sind, kommen alle Einträge für die Synchronisierung infrage. Eintrags-ID-Filter werden über ODER miteinander verbunden.

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 (angegeben über die emailAddress) zugreifen kann.

ChainSet

Daten zum Konfigurieren eines Standortsatzes mit den angegebenen Ketten.

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

enum (ChainRelationshipType)

Erforderlich. Nicht veränderbar. Beziehungstyp der angegebenen Handelsketten zu diesem Werbetreibenden.

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 einen unbekannten Wert in dieser Version dar.
AUTO_DEALERS Beziehung zu einem Autohändler.
GENERAL_RETAILERS Allgemeine Geschäftsbeziehung mit Einzelhändlern.

ChainFilter

Ein Filter auf Handelskettenebene für den Standort in einem festgelegten Feedelement. Die Filterlogik unter allen Feldern ist UND.

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

string (int64 format)

Erforderlich. Wird zum Filtern der Standorte von Ketten nach Ketten-ID verwendet. 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 Kettenstandorte, die zu allen angegebenen Attributen gehören, werden in die Asset-Gruppe aufgenommen. Wenn dieses Feld leer ist, wird das Feld nicht gefiltert.

MapsLocationSet

Wrapper für Standortsynchronisierungsdaten 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 in Google Unternehmensprofil. Dies gilt nur, wenn der AssetSet-Typ auf der Synchronisierungsebene „LOCATION_SYNC“ und die Synchronisierungsquelle „Unternehmensprofil“ ist.

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

object (DynamicBusinessProfileLocationGroupFilter)

Filtern Sie nach dynamischen Unternehmensprofil-Standortsätzen.

DynamicBusinessProfileLocationGroupFilter

Stellt einen Filter für Google Unternehmensprofil-Standorte in einer Asset-Gruppe dar. Sind mehrere Filter angegeben, werden sie durch UND verbunden.

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

string

Damit können die Unternehmensprofil-Standorte nach Label gefiltert werden. 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 Unternehmensprofil-Standorte nach Eintrags-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, der zum Filtern verwendet werden soll.

filterType

enum (LocationStringFilterType)

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

LocationStringFilterType

Mögliche Typen von Standortstringfiltern.

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

ChainLocationGroup

Informationen zu einer dynamischen Standortgruppe einer Kette. Gilt nur, wenn der AssetSet-Typ auf der Synchronisierungsebene „LOCATION_SYNC“ und die Synchronisierungsquelle „Kette“ ist.

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

object (ChainFilter)

Wird zum Filtern der Standorte von Ketten nach Ketten-IDs verwendet. Nur Standorte, die zu den angegebenen Ketten gehören, werden in die Asset-Gruppe aufgenommen.