AssetSet

Eine Asset-Gruppe, die eine Sammlung von Assets darstellt. Verwende „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 des Asset-Sets. Ressourcennamen von Asset-Sets haben folgendes Format:

customers/{customerId}/assetSets/{asset_set_id}

name

string

Erforderlich. Name des Asset-Sets. 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. Die ID der übergeordneten Asset-Gruppe, aus der die Elemente dieser Asset-Gruppe stammen. Beispiel: Die Asset-Set-ID des Standorts auf Synchronisierungsebene, von der die Elemente im Asset-Set der Standortgruppe stammen. Dieses Feld ist erforderlich und gilt nur für Asset-Sets 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. Asset-Gruppendaten, die für jeden Asset-Gruppentyp spezifisch sind. Nicht alle Typen haben spezifische Daten. Für asset_set_source ist nur einer der folgenden Werte zulässig:
locationSet

object (LocationSet)

Daten für Standort-Asset-Sets Dieser Wert wird für die Standorteinstellung auf Synchronisierungsebene verwendet. Dieser Wert kann nur festgelegt werden, wenn der Typ von „AssetSet“ LOCATION_SYNC ist.

businessProfileLocationGroup

object (BusinessProfileLocationGroup)

Daten zu Asset-Sets für Standortgruppen im Unternehmensprofil

chainLocationGroup

object (ChainLocationGroup)

Stellt Informationen zu einer dynamischen Standortgruppe einer Kette dar. Gilt nur, wenn der Typ der Asset-Gruppe auf der Synchronisierungsebene LOCATION_SYNC ist und die Synchronisierungsquelle „chain“ 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. Dieser Wert ist nur für die Antwort zulässig.
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, die sich auf den festgelegten Standort beziehen. Sie müssen mindestens eine der folgenden Daten angeben: Google Unternehmensprofil-Daten (früher Google My Business), Daten zu einer Handelskette und Daten zu einem Kartenstandort.

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. Standortdaten, die für jede Synchronisationsquelle spezifisch sind. Für source ist nur einer der folgenden Werte zulässig:
businessProfileLocationSet

object (BusinessProfileLocationSet)

Daten, die zum Konfigurieren eines Standortsatzes verwendet werden, der aus Google Unternehmensprofil-Standorten gefüllt ist.

chainLocationSet

object (ChainSet)

Daten, die zum Konfigurieren eines Standorts in einem Kettensatz verwendet werden, der mit den angegebenen Ketten gefüllt ist.

mapsLocationSet

object (MapsLocationSet)

Nur festgelegt, wenn Standorte anhand der ausgewählten Kartenstandorte synchronisiert werden

BusinessProfileLocationSet

Daten, die zum Konfigurieren eines Standortsatzes verwendet werden, der aus Google Unternehmensprofil-Standorten gefüllt ist. Verschiedene Filtertypen werden durch „AND“ miteinander verknüpft, 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 HTTP-Autorisierungstoken, das zur Autorisierung verwendet wird.

emailAddress

string

Erforderlich. Nicht veränderbar. E-Mail-Adresse eines Google Unternehmensprofil-Kontos oder E-Mail-Adresse eines Managers 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 Unternehmensnamen mit Assets synchronisiert werden.

labelFilters[]

string

Hiermit können Sie Google Unternehmensprofil-Einträge nach Labels filtern. Wenn Einträge in „labelFilters“ vorhanden sind, können nur Einträge mit einem der festgelegten Labels mit Assets synchronisiert werden. Wenn in „labelFilters“ keine Einträge vorhanden sind, können alle Einträge synchronisiert werden. Labelfilter werden durch „ODER“ miteinander verknüpft.

listingIdFilters[]

string (int64 format)

Damit können Google Unternehmensprofil-Einträge nach Eintrags-ID gefiltert werden. Wenn Einträge in „listingIdFilters“ vorhanden sind, können nur die über die Filter angegebenen Einträge mit Assets synchronisiert werden. Wenn in „listingIdFilters“ keine Einträge vorhanden sind, können alle Einträge synchronisiert werden. Angebotsnummernfilter werden durch „ODER“ miteinander 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 über die angegebene E-Mail-Adresse zugreifen kann.

ChainSet

Daten, die zum Konfigurieren eines Standortsatzes verwendet werden, der mit den angegebenen Ketten ausgefüllt ist.

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

enum (ChainRelationshipType)

Erforderlich. Nicht veränderbar. Der Beziehungstyp, den die angegebenen Hotelketten zu diesem Werbetreibenden haben.

chains[]

object (ChainFilter)

Erforderlich. Eine Liste von Filtern auf Kettenebene, die alle mit OR verknüpft sind.

ChainRelationshipType

Mögliche Beziehungstypen.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt den Wert „Unbekannt“ in dieser Version dar.
AUTO_DEALERS Beziehung zum Autohändler
GENERAL_RETAILERS Beziehung zu einem Einzelhändler allgemein

ChainFilter

Ein Filter auf Kettenebene für den Standort in einem Feedelementsatz. Die Filterlogik für alle Felder ist AND.

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

string (int64 format)

Erforderlich. Wird verwendet, um Standorte von Handelsketten nach Ketten-ID zu filtern. Nur Standorte der Kette, die zur angegebenen Kette gehören, werden in den Asset-Set aufgenommen.

locationAttributes[]

string

Wird verwendet, um Filialstandorte nach Standortattributen zu filtern. Nur Standorte von Hotelketten, die zu allen angegebenen Attributen gehören, werden in den Asset-Sets enthalten sein. Wenn dieses Feld leer ist, wird nach diesem Feld nicht gefiltert.

MapsLocationSet

Wrapper für mehrere Standortsynchronisierungsdaten von Google Maps

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

object (MapsLocationInfo)

Erforderlich. Eine Liste mit Standortinformationen auf Google Maps, die der Nutzer manuell synchronisiert hat.

MapsLocationInfo

Wrapper für Orts-IDs

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

string

Die Orts-ID des Google Maps-Standorts.

BusinessProfileLocationGroup

Informationen zu einer dynamischen Standortgruppe in einem Unternehmensprofil. Nur gültig, wenn der Typ der Asset-Gruppe auf der Synchronisierungsebene LOCATION_SYNC ist und die Synchronisierungsquelle das Unternehmensprofil ist.

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

object (DynamicBusinessProfileLocationGroupFilter)

Filtern Sie nach dynamischen Standortgruppen für Unternehmensprofile.

DynamicBusinessProfileLocationGroupFilter

Stellt einen Filter für Unternehmensprofil-Standorte in einem Asset-Set dar. Wenn mehrere Filter angegeben werden, werden sie durch „AND“ miteinander verknüpft.

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

string

Wird verwendet, um Google Unternehmensprofil-Standorte nach Label zu filtern. Nur Standorte mit einem der aufgeführten Labels werden in den Asset-Sets enthalten sein. Labelfilter werden durch „ODER“ miteinander verknüpft.

listingIdFilters[]

string (int64 format)

Wird verwendet, um Google Unternehmensprofil-Standorte nach Eintrags-IDs zu filtern.

businessNameFilter

object (BusinessProfileBusinessNameFilter)

Damit können Sie Standorte von Unternehmensprofilen nach dem Namen des Unternehmens filtern.

BusinessProfileBusinessNameFilter

Filter für den Unternehmensnamen der Standortgruppe des Unternehmensprofils

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

string

String für den Unternehmensnamen, der für das Filtern verwendet werden soll.

filterType

enum (LocationStringFilterType)

Die Art der Stringübereinstimmung, die beim Filtern mit „businessName“ verwendet werden soll.

LocationStringFilterType

Mögliche Typen eines Standortstringsfilters.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt den Wert „Unbekannt“ in dieser Version dar.
EXACT Der Filter verwendet die genaue Stringübereinstimmung.

ChainLocationGroup

Stellt Informationen zu einer dynamischen Standortgruppe einer Kette dar. Gilt nur, wenn der Typ der Asset-Set-Synchronisationsebene LOCATION_SYNC ist und die Synchronisationsquelle „chain“ ist.

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

object (ChainFilter)

Wird verwendet, um Standorte von Handelsketten nach Ketten-IDs zu filtern. Nur Standorte, die zu den angegebenen Ketten gehören, werden in den Asset-Set aufgenommen.