REST Resource: advertisers.adGroups.youtubeAssetTypes.youtubeAssetAssociations

Источник: YoutubeAssetAssociation

Связь между ресурсом и видеоматериалом YouTube.

JSON-представление 
{
  "name": string,
  "youtubeAssetType": enum (YoutubeAssetType),
  "linkedYoutubeAsset": {
    object (LinkedYouTubeAsset)
  }
}
Поля
name

string

Идентификатор. Имя ресурса ассоциации.

Для связей на уровне отдельных позиций: шаблон имени выглядит следующим образом: advertisers/{advertiserId}/lineItems/{lineItemId}/youtubeAssetTypes/{youtubeAssetType}/youtubeAssetAssociations/{youtubeAssetAssociationId} .

Для ассоциаций на уровне групп объявлений: шаблон имени выглядит следующим образом: advertisers/{advertiserId}/adGroups/{adGroupId}/youtubeAssetTypes/{youtubeAssetType}/youtubeAssetAssociations/{youtubeAssetAssociationId} .

Для связей YOUTUBE_ASSET_TYPE_LOCATION и YOUTUBE_ASSET_TYPE_AFFILIATE_LOCATION : youtubeAssetAssociationId — это идентификатор связанного набора ресурсов или 0, если locationMatchingType или affiliateLocationMatchingType DISABLED .

Для связей YOUTUBE_ASSET_TYPE_SITELINK : youtubeAssetAssociationId — это идентификатор связанного ресурса sitelink.

youtubeAssetType

enum ( YoutubeAssetType )

Обязательно. Тип ресурса YouTube, связанный с данным ресурсом.

linkedYoutubeAsset

object ( LinkedYouTubeAsset )

Обязательно. Файл YouTube, связанный с данным ресурсом.

YoutubeAssetType

Возможные типы ресурсов YouTube.

Эти ресурсы будут отображать дополнительную информацию вместе с рекламными объявлениями во время показа.

Перечисления
YOUTUBE_ASSET_TYPE_UNSPECIFIED В этой версии тип ресурса YouTube не указан или неизвестен.
YOUTUBE_ASSET_TYPE_LOCATION Местоположение.
YOUTUBE_ASSET_TYPE_AFFILIATE_LOCATION Информация о местоположении партнера.

LinkedYouTubeAsset

YouTube-ресурс, связанный с ресурсом в рамках ассоциации YoutubeAssetAssociation .

JSON-представление 
{

  // Union field youtube_asset can be only one of the following:
  "locationAssetFilter": {
    object (LocationAssetFilter)
  },
  "affiliateLocationAssetFilter": {
    object (AffiliateLocationAssetFilter)
  },
  "sitelinkAsset": {
    object (SitelinkAsset)
  }
  // End of list of possible types for union field youtube_asset.
}
Поля
Поле объединения youtube_asset . Объект YouTube. youtube_asset может принимать только одно из следующих значений:
locationAssetFilter

object ( LocationAssetFilter )

Фильтр по местоположению.

Этот параметр можно установить только в том случае, если youtubeAssetType имеет значение YOUTUBE_ASSET_TYPE_LOCATION .

affiliateLocationAssetFilter

object ( AffiliateLocationAssetFilter )

Фильтр для определения местоположения партнёрской программы.

Этот параметр можно установить только в том случае, если youtubeAssetType имеет значение YOUTUBE_ASSET_TYPE_AFFILIATE_LOCATION .

LocationAssetFilter

Фильтр активов, который сопоставляет подходящие объекты местоположения для обслуживания.

JSON-представление 
{
  "locationMatchingType": enum (LocationMatchingType),
  "assetSetId": string,
  "locationMatchingFunction": {
    object (LocationMatchingFunction)
  }
}
Поля
locationMatchingType

enum ( LocationMatchingType )

Обязательно. Тип соответствия для этого фильтра по местоположению.

assetSetId

string ( int64 format)

Только для вывода. Идентификатор набора активов, соответствующего активам местоположения, которые могут быть предоставлены.

locationMatchingFunction

object ( LocationMatchingFunction )

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

Это поле обязательно для заполнения и может быть установлено только в том случае, если locationMatchingType имеет значение FILTER или SELECTED_ASSETS .

LocationMatchingType

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

Перечисления
LOCATION_MATCHING_TYPE_UNSPECIFIED В данной версии тип соответствия местоположению не указан или неизвестен.
SELECT_ALL Все доступные локации пригодны для обслуживания.
FILTER В качестве источников данных могут использоваться объекты местоположения, соответствующие заданному названию компании и/или фильтрам по меткам.
SELECTED_ASSETS Обслуживаться могут только выбранные объекты инфраструктуры.
DISABLED Никакие локальные ресурсы не могут быть использованы.

Функция сопоставления местоположения

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

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

string

Необязательно. Соответствующие метки.

Метки объединяются в логическое ИЛИ.

Это поле является необязательным и может быть задано только в том случае, если locationMatchingType имеет FILTER .

locationAssetIds[]

string ( int64 format)

Необязательно. Идентификаторы выбранных объектов недвижимости.

Это поле обязательно для заполнения, если locationMatchingType имеет значение SELECTED_ASSETS .

business

string

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

Это поле является необязательным и может быть задано только в том случае, если locationMatchingType имеет FILTER .

AffiliateLocationAssetFilter

Фильтр активов, который сопоставляет подходящие объекты филиалов для обслуживания.

JSON-представление 
{
  "affiliateLocationMatchingType": enum (AffiliateLocationMatchingType),
  "assetSetId": string,
  "affiliateLocationMatchingFunction": {
    object (AffiliateLocationMatchingFunction)
  }
}
Поля
affiliateLocationMatchingType

enum ( AffiliateLocationMatchingType )

Обязательно. Тип соответствия фильтра местоположения партнера.

assetSetId

string ( int64 format)

Только для вывода. Идентификатор набора ресурсов, соответствующего ресурсам филиала, которые могут быть использованы для обслуживания.

affiliateLocationMatchingFunction

object ( AffiliateLocationMatchingFunction )

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

Это поле обязательно для заполнения и может быть установлено только в том случае, если affiliateLocationMatchingType имеет значение SELECTED_CHAINS .

AffiliateLocationMatchingType

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

Перечисления
AFFILIATE_LOCATION_MATCHING_TYPE_UNSPECIFIED В данной версии тип сопоставления местоположения партнера не указан или неизвестен.
SELECT_ALL Для размещения рекламы доступны все имеющиеся в наличии филиалы.
SELECTED_CHAINS Выбранные объекты филиала могут быть использованы.
DISABLED Никакие ресурсы филиалов не могут быть использованы.

Функция сопоставления местоположения партнеров

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

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

object ( AffiliateLocationChain )

Необязательно. Идентификаторы выбранных партнерских сетей.

Это поле обязательно для заполнения, если affiliateLocationMatchingType имеет значение SELECTED_CHAINS .

AffiliateLocationChain

Сеть филиалов.

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

string ( int64 format)

Обязательно. Идентификатор сети филиалов.

SitelinkAsset

Ссылка на сайт.

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

string ( int64 format)

Обязательно. Идентификатор ресурса ссылки на сайт.

Методы

create

 Создает новую связь между идентифицированным ресурсом и видеофайлом YouTube.

delete

 Удаляет существующую связь между указанным ресурсом и видеофайлом YouTube.

list

 Отображает список ресурсов YouTube, связанных с данным ресурсом.