AssetSet

Zbiór zasobów reprezentujący zbiór zasobów. Użyj AssetSetAsset, aby połączyć zasób z zestawem zasobó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 zasobów.

resourceName

string

Stałe. Nazwa zasobu zestawu zasobów. Nazwy zasobów zestawu zasobów mają postać:

customers/{customerId}/assetSets/{asset_set_id}

name

string

To pole jest wymagane. Nazwa zestawu zasobów. To pole jest wymagane. Musi mieć minimalną długość 1 i maksymalną 128 znaków.

type

enum (AssetSetType)

To pole jest wymagane. Stałe. Typ zestawu zasobów. To pole jest wymagane.

status

enum (AssetSetStatus)

Tylko dane wyjściowe. Stan zestawu zasobów. Tylko do odczytu.

merchantCenterFeed

object (MerchantCenterFeed)

identyfikator sprzedawcy i etykieta pliku danych z Google Merchant Center,

locationGroupParentAssetSetId

string (int64 format)

Stałe. Identyfikator zestawu zasobów nadrzędnych dla zestawu zasobów, z którego pochodzą jego elementy. Na przykład: identyfikator AssetSet na poziomie synchronizacji, z którego pochodzą elementy LocationGroup AssetSet. To pole jest wymagane i ma zastosowanie tylko w przypadku typu AssetSet określonego przez grupę lokalizacji.

hotelPropertyData

object (HotelPropertyData)

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

Pole sumy asset_set_source. Dane zestawu zasobów specyficzne dla każdego typu zestawu zasobów. Nie wszystkie typy zawierają konkretne dane. asset_set_source może być tylko jedną z tych wartości:
locationSet

object (LocationSet)

Dane zestawu komponentów z lokalizacją. Będzie ona używana do ustawiania lokalizacji na poziomie synchronizacji. Tę wartość można ustawić tylko wtedy, gdy typ zasobu 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 typu Sieć. Ma zastosowanie tylko wtedy, gdy typ zasobu AssetSet na poziomie synchronizacji to LOCATION_SYNC, a źródło synchronizacji to łańcuch.

AssetSetStatus

Możliwe stany zestawu komponentów.

Wartości w polu enum
UNSPECIFIED Stan nie został określony.
UNKNOWN Otrzymana wartość nie jest znana w tej wersji. To jest wartość tylko z odpowiedzią.
ENABLED Zestaw komponentów jest włączony.
REMOVED Zestaw komponentów zostanie usunięty.

MerchantCenterFeed

identyfikator sprzedawcy i etykieta pliku danych z Google Merchant Center,

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

string (int64 format)

To pole jest wymagane. Identyfikator sprzedawcy z Google Merchant Center

feedLabel

string

Opcjonalnie. Etykieta pliku danych z Google Merchant Center.

HotelPropertyData

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

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

string (int64 format)

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

partnerName

string

Tylko dane wyjściowe. Nazwa partnera hotelowego.

LocationSet

Dane związane ze zbiorem lokalizacji. Musisz określić dane z Profilu Firmy w Google (dawniej Google Moja Firma), danych sieci i 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)

To pole jest wymagane. Stałe. Typ własności lokalizacji (lokalizacja należąca do Ciebie lub powiązana lokalizacja).

Pole sumy source. Dane o lokalizacji właściwe dla każdego źródła synchronizacji. source może być tylko jedną z tych wartości:
businessProfileLocationSet

object (BusinessProfileLocationSet)

Dane używane do konfigurowania zbioru lokalizacji pobieranego na podstawie lokalizacji z Profilu Firmy w Google.

chainLocationSet

object (ChainSet)

Dane używane do konfigurowania lokalizacji w zbiorze sieci wypełnianym 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 pobieranego na podstawie lokalizacji z Profilu Firmy w Google. Różne typy filtrów będą połączone operatorem ORAZ, jeśli zostały określone.

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

string

To pole jest wymagane. Stałe. Token autoryzacji HTTP używany do uzyskania autoryzacji.

emailAddress

string

To pole jest wymagane. Stałe. Adres e-mail konta w usłudze Profil Firmy w Google lub adres e-mail menedżera konta w tej usłudze.

businessNameFilter

string

Służy do filtrowania wizytówek w Profilu Firmy w Google według nazwy firmy. Jeśli masz ustawiony filtr businessNameFilter, do synchronizacji z zasobami nadają się tylko wizytówki z pasującą nazwą firmy.

labelFilters[]

string

Służy do filtrowania wizytówek w Profilu Firmy w Google według etykiet. Jeśli wpisy istnieją w filtrze etykiet, do synchronizacji z zasobami kwalifikują się tylko listy, które mają ustawioną dowolną z etykiet. Jeśli w filtrach etykiet nie ma żadnych wpisów, wszystkie strony aplikacji nadają się do zsynchronizowania. Filtry etykiet są połączone operatorem LUB.

listingIdFilters[]

string (int64 format)

Służy do filtrowania wizytówek w Profilu Firmy w Google według identyfikatora wizytówki. Jeśli wpisy istnieją w ramach metody listingIdFilters, kwalifikują się do zsynchronizowania z zasobami tylko listy określone przez filtry. Jeśli w filtrze listingId nie ma żadnych wpisów, wszystkie wizytówki są kandydatami do synchronizacji. Filtry identyfikatorów wizytówek są połączone operatorem LUB.

businessAccountId

string

Stałe. Identyfikator konta zarządzanej firmy, której lokalizacje mają zostać użyte. Jeśli to pole nie jest skonfigurowane, używane są wszystkie firmy dostępne dla użytkownika (określone za pomocą adresu 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)

To pole jest wymagane. Stałe. Typ relacji między określonymi sieciami z tym reklamodawcą.

chains[]

object (ChainFilter)

To pole jest wymagane. Lista filtrów na poziomie łańcucha, w których wszystkie filtry są połączone operatorem LUB.

ChainRelationshipType

Możliwe typy relacji.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
AUTO_DEALERS Relacja z dealerem samochodów.
GENERAL_RETAILERS Współpraca ze sprzedawcą detalicznym.

ChainFilter

Jeden filtr na poziomie sieci dla 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)

To pole jest wymagane. Służy do filtrowania lokalizacji sklepów według identyfikatora sieci. W zestawie komponentów znajdą się tylko lokalizacje sklepów należących 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 sklepów sieciowych, które należą do wszystkich podanych atrybutów. Jeśli to pole jest puste, nie można filtrować danych w tym polu.

MapsLocationSet

Kod do obsługi wielu danych synchronizacji lokalizacji na mapach

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

object (MapsLocationInfo)

To pole jest wymagane. Lista informacji o lokalizacji na mapach, z którymi użytkownik zsynchronizował ręcznie.

MapsLocationInfo

Kod identyfikatorów miejsc

Zapis JSON
{
  "placeId": string
}
Pola
placeId

string

Identyfikator miejsca lokalizacji w Mapach.

BusinessProfileLocationGroup

Informacje o dynamicznej grupie lokalizacji w Profilu Firmy. Ma zastosowanie tylko wtedy, gdy typ zasobu AssetSet na poziomie synchronizacji to LOCATION_SYNC, a źródłem synchronizacji jest Profil Firmy.

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

object (DynamicBusinessProfileLocationGroupFilter)

Przefiltruj je, aby wyświetlić dynamiczne zestawy lokalizacji Profilu Firmy.

DynamicBusinessProfileLocationGroupFilter

Reprezentuje filtr lokalizacji w Profilu Firmy w zestawie komponentów. Jeśli podasz wiele filtrów, będą one połączone operatorem ORAZ.

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

string

Służy do filtrowania lokalizacji w Profilu Firmy według etykiety. Do zestawu zasobów będą należeć tylko lokalizacje, które mają dowolną z wymienionych etykiet. Filtry etykiet są połączone operatorem LUB.

listingIdFilters[]

string (int64 format)

Służy do filtrowania lokalizacji w profilu firmy według identyfikatorów wizytówek.

businessNameFilter

object (BusinessProfileBusinessNameFilter)

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

BusinessProfileBusinessNameFilter

Filtr nazwy firmy w profilu firmy.

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

string

Ciąg nazwy firmy do filtrowania.

filterType

enum (LocationStringFilterType)

Typ dopasowania ciągu znaków, który ma być używany podczas filtrowania z użyciem businessName.

LocationStringFilterType

Możliwe typy filtra ciągu tekstowego lokalizacji.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
EXACT Filtr będzie używać dokładnego dopasowania ciągu znaków.

ChainLocationGroup

Reprezentuje informacje o dynamicznej grupie lokalizacji typu Sieć. Ma zastosowanie tylko wtedy, gdy typ zasobu AssetSet na poziomie synchronizacji to LOCATION_SYNC, a źródło synchronizacji to łańcuch.

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

object (ChainFilter)

Służy do filtrowania lokalizacji sklepów według identyfikatorów sieci. W zestawie komponentów znajdą się tylko lokalizacje, które należą do określonych sieci.