AssetSet

Набор активов, представляющий коллекцию активов. Используйте AssetSetAsset, чтобы связать актив с набором активов.

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.
}
Поля
id

string ( int64 format)

Только вывод. Идентификатор набора активов.

resourceName

string

Неизменный. Имя ресурса набора активов. Имена ресурсов набора активов имеют форму:

customers/{customerId}/assetSets/{asset_set_id}

name

string

Необходимый. Имя набора активов. Необходимый. Он должен иметь минимальную длину 1 и максимальную длину 128.

type

enum ( AssetSetType )

Необходимый. Неизменный. Тип набора активов. Необходимый.

status

enum ( AssetSetStatus )

Только вывод. Статус набора активов. Только для чтения.

merchantCenterFeed

object ( MerchantCenterFeed )

Идентификатор продавца и метка фида из Google Merchant Center.

locationGroupParentAssetSetId

string ( int64 format)

Неизменный. Идентификатор родительского набора активов для набора активов, из которого взяты элементы этого набора активов. Например: идентификатор местоположения AssetSet уровня синхронизации, откуда берутся элементы в LocationGroup AssetSet. Это поле является обязательным и применимо только для типа AssetSet группы местоположений.

hotelPropertyData

object ( HotelPropertyData )

Только вывод. Для кампаний с максимальной эффективностью и целями путешествий со связью с аккаунтом Hotel Center. Только для чтения.

Поле объединения asset_set_source . Данные набора активов, специфичные для каждого типа набора активов. Не все типы имеют конкретные данные. asset_set_source может быть только одним из следующих:
locationSet

object ( LocationSet )

Данные набора объектов местоположения. Это будет использоваться для установки местоположения уровня синхронизации. Это можно установить только в том случае, если тип AssetSet — LOCATION_SYNC.

businessProfileLocationGroup

object ( BusinessProfileLocationGroup )

Данные набора объектов группы местоположений бизнес-профиля.

chainLocationGroup

object ( ChainLocationGroup )

Представляет информацию о динамической группе местоположений Chain. Применимо только в том случае, если тип AssetSet уровня синхронизации — LOCATION_SYNC, а источником синхронизации — цепочка.

Ассетсетстатус

Возможные статусы набора активов.

Перечисления
UNSPECIFIED Статус не указан.
UNKNOWN Полученное значение в этой версии неизвестно. Это значение только для ответа.
ENABLED Набор активов включен.
REMOVED Набор активов удален.

MerchantCenterFeed

Идентификатор продавца и метка фида из Google Merchant Center.

JSON-представление
{
  "merchantId": string,
  "feedLabel": string
}
Поля
merchantId

string ( int64 format)

Необходимый. Идентификатор продавца из Google Merchant Center

feedLabel

string

Необязательный. Ярлык фида из Google Merchant Center.

Данные о собственности отеля

Для кампаний с максимальной эффективностью и целями путешествий со связью с аккаунтом Hotel Center. Только для чтения.

JSON-представление
{
  "hotelCenterId": string,
  "partnerName": string
}
Поля
hotelCenterId

string ( int64 format)

Только вывод. Идентификатор гостиничного центра партнера.

partnerName

string

Только вывод. Название отеля-партнера.

Набор местоположений

Данные, относящиеся к набору местоположений. Необходимо указать одни из данных бизнес-профиля Google (ранее известного как Google My Business), данные сети и данные о местоположении на карте.

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.
}
Поля
locationOwnershipType

enum ( LocationOwnershipType )

Необходимый. Неизменный. Тип владения местоположением (собственное местоположение или партнерское местоположение).

source поля Союза. Данные о местоположении, специфичные для каждого источника синхронизации. source может быть только одним из следующих:
businessProfileLocationSet

object ( BusinessProfileLocationSet )

Данные, используемые для настройки набора местоположений, составленного из местоположений в профиле компании в Google.

chainLocationSet

object ( ChainSet )

Данные, используемые для настройки местоположения в наборе цепочек, заполненном указанными цепочками.

mapsLocationSet

object ( MapsLocationSet )

Устанавливается только в том случае, если местоположения синхронизируются на основе выбранных местоположений на картах.

БизнесПрофильМестоположениеНабор

Данные, используемые для настройки набора местоположений, составленного из местоположений в профиле компании в Google. Различные типы фильтров объединяются оператором И, если они указаны.

JSON-представление
{
  "httpAuthorizationToken": string,
  "emailAddress": string,
  "businessNameFilter": string,
  "labelFilters": [
    string
  ],
  "listingIdFilters": [
    string
  ],
  "businessAccountId": string
}
Поля
httpAuthorizationToken

string

Необходимый. Неизменный. Токен авторизации HTTP, используемый для получения авторизации.

emailAddress

string

Необходимый. Неизменный. Адрес электронной почты аккаунта профиля компании в Google или адрес электронной почты менеджера аккаунта профиля компании в Google.

businessNameFilter

string

Используется для фильтрации списков в профиле компании Google по названию компании. Если параметр businessNameFilter установлен, только списки с совпадающим названием компании являются кандидатами на синхронизацию с активами.

labelFilters[]

string

Используется для фильтрации списков профиля компании в Google по ярлыкам. Если записи существуют в labelFilters, только те списки, у которых установлена ​​какая-либо метка, являются кандидатами на синхронизацию с активами. Если в labelFilters записей нет, то все списки являются кандидатами на синхронизацию. Фильтры меток соединены по логике ИЛИ.

listingIdFilters[]

string ( int64 format)

Используется для фильтрации списков в профиле компании Google по идентификатору записи. Если записи существуют в listingIdFilters, только списки, указанные фильтрами, являются кандидатами на синхронизацию с активами. Если в listingIdFilters нет записей, все списки являются кандидатами на синхронизацию. Фильтры идентификаторов листинга объединяются по логике ИЛИ.

businessAccountId

string

Неизменный. Идентификатор учетной записи управляемой компании, адреса которой будут использоваться. Если это поле не задано, то используются все компании, доступные пользователю (указанные адресом электронной почты).

ЦепнойНабор

Данные, используемые для настройки набора местоположений, заполненного указанными цепочками.

JSON-представление
{
  "relationshipType": enum (ChainRelationshipType),
  "chains": [
    {
      object (ChainFilter)
    }
  ]
}
Поля
relationshipType

enum ( ChainRelationshipType )

Необходимый. Неизменный. Тип отношений указанных сетей с данным рекламодателем.

chains[]

object ( ChainFilter )

Необходимый. Список фильтров уровня цепочки, все фильтры соединены ИЛИ.

ЦепочкаОтношенийТип

Возможные типы отношений.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии.
AUTO_DEALERS Отношения с автодилерами.
GENERAL_RETAILERS Общие отношения с розничными продавцами.

ЦепнойФильтр

Один фильтр уровня цепочки по местоположению в наборе элементов фида. Логика фильтрации среди всех полей — AND.

JSON-представление
{
  "chainId": string,
  "locationAttributes": [
    string
  ]
}
Поля
chainId

string ( int64 format)

Необходимый. Используется для фильтрации местоположений цепочек по идентификатору цепочки. В набор активов будут включены только местоположения цепочки, принадлежащие указанной цепочке.

locationAttributes[]

string

Используется для фильтрации местоположений цепочки по атрибутам местоположения. В набор активов будут включены только местоположения сети, которые принадлежат всем указанным атрибутам. Если это поле пусто, это означает отсутствие фильтрации по этому полю.

КартыМестоположениеНабор

Оболочка для данных синхронизации местоположения на нескольких картах

JSON-представление
{
  "mapsLocations": [
    {
      object (MapsLocationInfo)
    }
  ]
}
Поля
mapsLocations[]

object ( MapsLocationInfo )

Необходимый. Список информации о местоположении на карте, которую пользователь синхронизировал вручную.

КартыМестоположениеИнформация

Обертка для идентификаторов мест

JSON-представление
{
  "placeId": string
}
Поля
placeId

string

Идентификатор места на Картах.

БизнесПрофильМестоположениеГруппа

Информация о динамической группе местоположений профиля компании. Применимо только в том случае, если тип AssetSet уровня синхронизации — LOCATION_SYNC, а источником синхронизации — бизнес-профиль.

JSON-представление
{
  "dynamicBusinessProfileLocationGroupFilter": {
    object (DynamicBusinessProfileLocationGroupFilter)
  }
}
Поля
dynamicBusinessProfileLocationGroupFilter

object ( DynamicBusinessProfileLocationGroupFilter )

Фильтрация наборов местоположений для динамических профилей компании.

ДинамическийБизнесПрофильМестоположениеГруппаФильтр

Представляет фильтр по местоположениям профиля компании в наборе активов. Если предусмотрено несколько фильтров, они объединяются оператором AND.

JSON-представление
{
  "labelFilters": [
    string
  ],
  "listingIdFilters": [
    string
  ],
  "businessNameFilter": {
    object (BusinessProfileBusinessNameFilter)
  }
}
Поля
labelFilters[]

string

Используется для фильтрации местоположений в профиле компании по ярлыку. В набор ресурсов будут включены только местоположения, имеющие любой из перечисленных ярлыков. Фильтры меток соединены по логике ИЛИ.

listingIdFilters[]

string ( int64 format)

Используется для фильтрации местоположений в профиле компании по идентификаторам.

businessNameFilter

object ( BusinessProfileBusinessNameFilter )

Используется для фильтрации местоположений в профиле компании по названию компании.

БизнесПрофильБизнесНазваниеФильтр

Фильтр названия компании в группе местоположений профиля компании.

JSON-представление
{
  "businessName": string,
  "filterType": enum (LocationStringFilterType)
}
Поля
businessName

string

Строка названия компании, используемая для фильтрации.

filterType

enum ( LocationStringFilterType )

Тип сопоставления строк, используемый при фильтрации с помощью businessName.

LocationStringFilterType

Возможные типы фильтра строки местоположения.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии.
EXACT Фильтр будет использовать точное соответствие строк.

ЦепьМестоположениеГруппа

Представляет информацию о динамической группе местоположений Chain. Применимо только в том случае, если тип AssetSet уровня синхронизации — LOCATION_SYNC, а источником синхронизации — цепочка.

JSON-представление
{
  "dynamicChainLocationGroupFilters": [
    {
      object (ChainFilter)
    }
  ]
}
Поля
dynamicChainLocationGroupFilters[]

object ( ChainFilter )

Используется для фильтрации местоположений цепочек по идентификаторам цепочек. В набор объектов будут включены только местоположения, принадлежащие указанным цепочкам.