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 — это идентификатор связанного актива ссылки сайта.

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 .

МестоположениеСоответствующийТип

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

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

LocationMatchingFunction

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

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 .

Партнерская Местоположение Соответствующий Тип

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

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

AffiliateLocationMatchingFunction

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

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, связанные с указанным ресурсом.