AssetSet

Zbiór komponentów reprezentujący kolekcję komponentów. Użyj AssetSetAsset, aby powiązać komponent z zestawem komponentów.

Zapis 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.
}
Pola
id

string (int64 format)

Tylko dane wyjściowe. Identyfikator zestawu komponentów.

resourceName

string

Niezmienna. Nazwa zasobu zbioru komponentów. Nazwy zasobów zestawu mają postać:

customers/{customerId}/assetSets/{asset_set_id}

name

string

Wymagany. Nazwa zestawu komponentów. Wymagany. Musi mieć minimalną długość 1 i maksymalną długość 128.

type

enum (AssetSetType)

Wymagany. Niezmienna. Typ zestawu komponentów. Wymagany.

status

enum (AssetSetStatus)

Tylko dane wyjściowe. Stan zbioru komponentów. Tylko do odczytu.

merchantCenterFeed

object (MerchantCenterFeed)

Identyfikator sprzedawcy i etykieta pliku danych z Google Merchant Center.

locationGroupParentAssetSetId

string (int64 format)

Niezmienna. Identyfikator nadrzędnego zestawu komponentów, z którego pochodzą elementy tego zestawu. Przykład: identyfikator AssetSet na poziomie synchronizacji lokalizacji, z którego pochodzą elementy w AssetSet w LocationGroup. To pole jest wymagane i dotyczy tylko AssetSet typu Location Group.

hotelPropertyData

object (HotelPropertyData)

Tylko dane wyjściowe. Kampanie Performance Max do celów związanych z podróżami z połączonym kontem Hotel Center. Tylko do odczytu.

Pole unii asset_set_source. Dane zestawu komponentów, które są specyficzne dla każdego typu zestawu komponentów. Nie wszystkie typy mają konkretne dane. asset_set_source może być tylko jednym z tych elementów:
locationSet

object (LocationSet)

Dane zestawu komponentów z lokalizacją. Będzie ona używana do ustawiania lokalizacji na poziomie synchronizacji. Można go ustawić tylko wtedy, gdy typ AssetSet to LOCATION_SYNC.

businessProfileLocationGroup

object (BusinessProfileLocationGroup)

Dane zestawu komponentów grupy lokalizacji w Profilu Firmy.

chainLocationGroup

object (ChainLocationGroup)

Reprezentuje informacje o dynamicznej grupie lokalizacji sieci. Dotyczy tylko sytuacji, gdy typ poziomu synchronizacji AssetSet to LOCATION_SYNC, a źródło synchronizacji to chain.

AssetSetStatus

Możliwe stany zbioru komponentów.

Wartości w polu enum
UNSPECIFIED Nie określono stanu.
UNKNOWN Otrzymana wartość jest nieznana w tej wersji. Jest to wartość tylko do odpowiedzi.
ENABLED zbiór zasobów jest włączony;
REMOVED Zestaw komponentów został usunięty.

MerchantCenterFeed

Identyfikator sprzedawcy i etykieta pliku danych z Google Merchant Center.

Zapis JSON
{
  "merchantId": string,
  "feedLabel": string
}
Pola
merchantId

string (int64 format)

Wymagany. Identyfikator sprzedawcy z Google Merchant Center

feedLabel

string

Opcjonalnie: Etykieta pliku danych z Google Merchant Center.

HotelPropertyData

Kampanie Performance Max do celów związanych z podróżami z połączonym kontem Hotel Center. Tylko do odczytu.

Zapis JSON
{
  "hotelCenterId": string,
  "partnerName": string
}
Pola
hotelCenterId

string (int64 format)

Tylko dane wyjściowe. Identyfikator konta partnera w Hotel Center.

partnerName

string

Tylko dane wyjściowe. Nazwa hotelu partnera.

LocationSet

Dane związane z ustawionymi lokalizacjami. Należy podać dane z Profilu Firmy w Google (dawniej Google Moja Firma), dane sieci i dane o lokalizacji na mapie.

Zapis 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.
}
Pola
locationOwnershipType

enum (LocationOwnershipType)

Wymagany. Niezmienna. Typ własności lokalizacji (własna lokalizacja lub powiązana lokalizacja).

Pole unii source. Dane o lokalizacji dotyczące poszczególnych źródeł synchronizacji. source może być tylko jednym z tych elementów:
businessProfileLocationSet

object (BusinessProfileLocationSet)

Dane używane do konfigurowania zbioru lokalizacji wypełnionego na podstawie lokalizacji w Profilu Firmy w Google.

chainLocationSet

object (ChainSet)

Dane używane do konfigurowania lokalizacji w łańcuchu wypełnionym określonymi łańcuchami.

mapsLocationSet

object (MapsLocationSet)

Ustaw tylko wtedy, gdy lokalizacje są synchronizowane na podstawie wybranych lokalizacji na mapach.

BusinessProfileLocationSet

Dane używane do konfigurowania zbioru lokalizacji wypełnionego na podstawie lokalizacji w Profilu Firmy w Google. Jeśli podasz różne typy filtrów, zostaną one połączone operatorem logicznym ORAZ.

Zapis JSON
{
  "httpAuthorizationToken": string,
  "emailAddress": string,
  "businessNameFilter": string,
  "labelFilters": [
    string
  ],
  "listingIdFilters": [
    string
  ],
  "businessAccountId": string
}
Pola
httpAuthorizationToken

string

Wymagany. Niezmienna. Token autoryzacji HTTP używany do uzyskania autoryzacji.

emailAddress

string

Wymagany. Niezmienna. adres e-mail konta w usłudze Profil Firmy w Google lub adres e-mail menedżera tego konta;

businessNameFilter

string

Służy do filtrowania wizytówek w Profilu Firmy w Google według nazwy firmy. Jeśli parametr businessNameFilter jest ustawiony, tylko wizytówki z pasującą nazwą firmy mogą być synchronizowane z zasobami.

labelFilters[]

string

Służy do filtrowania wizytówek w Profilu Firmy w Google według etykiet. Jeśli w etykietach znajdują się wpisy, tylko oferty z jakikolwiek ustawionymi etykietami mogą być synchronizowane z Zasobami. Jeśli w etykiecie labelFilters nie ma żadnych wpisów, wszystkie oferty są kandydatami do synchronizacji. Filtry etykiet są połączone operatorem logicznym LUB.

listingIdFilters[]

string (int64 format)

Służy do filtrowania wizytówek w Profilu Firmy w Google według identyfikatora. Jeśli w polu listingIdFilters znajdują się wpisy, tylko oferty określone przez filtry mogą zostać zsynchronizowane z komponentami. Jeśli w listingIdFilters nie ma żadnych wpisów, wszystkie oferty są kandydatami do synchronizacji. Filtry identyfikatora wizytówki są połączone operatorem LUB.

businessAccountId

string

Niezmienna. Identyfikator konta zarządzanej firmy, której lokalizacje mają być używane. Jeśli to pole nie jest ustawione, używane są wszystkie firmy dostępne dla użytkownika (określone przez adres e-mail).

ChainSet

Dane używane do konfigurowania zbioru lokalizacji wypełnionego określonymi łańcuchami.

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

enum (ChainRelationshipType)

Wymagany. Niezmienna. Typ relacji, jaka łączy określone łańcuchy z tym reklamodawcą.

chains[]

object (ChainFilter)

Wymagany. Lista filtrów na poziomie łańcucha, wszystkie filtry są połączone operatorem LUB.

ChainRelationshipType

Możliwe typy relacji.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Służy tylko do zwracania wartości. Reprezentuje wartość nieznana w tej wersji.
AUTO_DEALERS Związek ze sprzedawcą samochodów.
GENERAL_RETAILERS Relacja z ogólnym sprzedawcą detalicznym.

ChainFilter

Jeden filtr na poziomie łańcucha dotyczący lokalizacji w zestawie elementów pliku danych. Logika filtrowania we wszystkich polach to ORAZ.

Zapis JSON
{
  "chainId": string,
  "locationAttributes": [
    string
  ]
}
Pola
chainId

string (int64 format)

Wymagany. Służy do filtrowania lokalizacji sklepów sieciowych według identyfikatora sieci. W zestawie komponentów znajdą się tylko lokalizacje należące do określonej sieci.

locationAttributes[]

string

Służy do filtrowania lokalizacji sklepów sieciowych według atrybutów lokalizacji. W zestawie komponentów znajdą się tylko lokalizacje łańcucha, które należą do wszystkich określonych atrybutów. Jeśli to pole jest puste, oznacza to, że nie ma filtrowania w tym polu.

MapsLocationSet

Opakowanie dla wielu danych synchronizacji lokalizacji map

Zapis JSON
{
  "mapsLocations": [
    {
      object (MapsLocationInfo)
    }
  ]
}
Pola
mapsLocations[]

object (MapsLocationInfo)

Wymagany. Lista informacji o lokalizacji w mapach, które użytkownik zsynchronizował ręcznie.

MapsLocationInfo

Opakowanie identyfikatorów miejsc

Zapis JSON
{
  "placeId": string
}
Pola
placeId

string

Identyfikator miejsca w Mapach.

BusinessProfileLocationGroup

Informacje o grupie dynamicznych lokalizacji w Profilu Firmy. Dotyczy tylko sytuacji, gdy typ poziomu synchronizacji AssetSet to LOCATION_SYNC, a źródło synchronizacji to Profil Firmy.

Zapis JSON
{
  "dynamicBusinessProfileLocationGroupFilter": {
    object (DynamicBusinessProfileLocationGroupFilter)
  }
}
Pola
dynamicBusinessProfileLocationGroupFilter

object (DynamicBusinessProfileLocationGroupFilter)

Filtrowanie dynamicznych zestawów lokalizacji w Profilu Firmy.

DynamicBusinessProfileLocationGroupFilter

Reprezentuje filtr lokalizacji w Profilu Firmy w zestawie komponentów. Jeśli podasz kilka filtrów, zostaną one połączone operatorem logicznym ORAZ, który wymaga spełnienia wszystkich warunków.

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

string

Służy do filtrowania lokalizacji w Profilu Firmy według etykiety. W zestawie komponentów znajdą się tylko lokalizacje, które mają co najmniej jedną z wymienionych etykiet. Filtry etykiet są połączone operatorem logicznym LUB.

listingIdFilters[]

string (int64 format)

Służy do filtrowania lokalizacji w Profilu Firmy według identyfikatorów ofert.

businessNameFilter

object (BusinessProfileBusinessNameFilter)

Służy do filtrowania lokalizacji w profilu firmy według nazwy firmy.

BusinessProfileBusinessNameFilter

Filtr nazwy firmy w grupie lokalizacji w Profilu Firmy.

Zapis JSON
{
  "businessName": string,
  "filterType": enum (LocationStringFilterType)
}
Pola
businessName

string

Ciąg tekstowy nazwy firmy do użycia do filtrowania.

filterType

enum (LocationStringFilterType)

Typ dopasowania ciągu znaków do użycia podczas filtrowania za pomocą parametru businessName.

LocationStringFilterType

Możliwe typy filtra ciągu znaków lokalizacji.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Służy tylko do zwracania wartości. Reprezentuje wartość nieznana w tej wersji.
EXACT Filtr będzie używać dopasowania ścisłego ciągu znaków.

ChainLocationGroup

Reprezentuje informacje o dynamicznej grupie lokalizacji sieci. Dotyczy tylko sytuacji, gdy typ poziomu synchronizacji AssetSet to LOCATION_SYNC, a źródło synchronizacji to chain.

Zapis JSON
{
  "dynamicChainLocationGroupFilters": [
    {
      object (ChainFilter)
    }
  ]
}
Pola
dynamicChainLocationGroupFilters[]

object (ChainFilter)

Służy do filtrowania lokalizacji sklepów sieciowych według identyfikatorów łańcucha. W zestawie komponentów znajdą się tylko lokalizacje należące do określonych sieci.