REST Resource: advertisers.adGroups.youtubeAssetTypes.youtubeAssetAssociations

リソース: YoutubeAssetAssociation

リソースと YouTube アセットの関連付け。

JSON 表現 
{
  "name": string,
  "youtubeAssetType": enum (YoutubeAssetType),
  "linkedYoutubeAsset": {
    object (LinkedYouTubeAsset)
  }
}
フィールド
name

string

ID。関連付けのリソース名。

広告申込情報レベルの関連付けの場合: 名前パターンは 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 は、リンクされたアセットセットの ID です。locationMatchingType または affiliateLocationMatchingType が DISABLED の場合は 0 です。

YOUTUBE_ASSET_TYPE_SITELINK 関連付けの場合: youtubeAssetAssociationId は、リンクされたサイトリンク アセットの ID になります。
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

YoutubeAssetAssociation のリソースにリンクされている YouTube アセット。

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)

出力専用。配信対象の地域アセットと一致するアセット セットの ID。
locationMatchingFunction

object (LocationMatchingFunction)

省略可。住所アセット フィルタが住所アセットと一致する方法を決定する一致関数。

このフィールドは必須であり、locationMatchingType が FILTER または SELECTED_ASSETS の場合にのみ設定できます。

LocationMatchingType

どの地域情報アセットを配信対象とするかを決定する、一致タイプの候補。

列挙型
LOCATION_MATCHING_TYPE_UNSPECIFIED このバージョンでは、ビジネス拠点の一致タイプが指定されていないか、不明です。
SELECT_ALL 利用可能なすべての住所アセットが配信対象となります。
FILTER 指定されたビジネス名やラベルのフィルタに一致する住所アセットが配信されます。
SELECTED_ASSETS 選択した地域情報アセットのみが配信されます。
DISABLED 住所アセットを配信できません。

LocationMatchingFunction

住所アセット フィルタのマッチング関数。

JSON 表現 
{
  "labels": [
    string
  ],
  "locationAssetIds": [
    string
  ],
  "business": string
}
フィールド
labels[]

string

省略可。照合するラベル。

ラベルは論理 OR で結合されます。

このフィールドは省略可能で、locationMatchingType が FILTER の場合にのみ設定できます。
locationAssetIds[]

string (int64 format)

省略可。選択した住所アセットの ID。

locationMatchingType が SELECTED_ASSETS の場合、このフィールドは必須です。
business

string

省略可。照合するビジネス名。

このフィールドは省略可能で、locationMatchingType が FILTER の場合にのみ設定できます。

AffiliateLocationAssetFilter

配信対象のアフィリエイト住所アセットに一致するアセット フィルタ。

JSON 表現 
{
  "affiliateLocationMatchingType": enum (AffiliateLocationMatchingType),
  "assetSetId": string,
  "affiliateLocationMatchingFunction": {
    object (AffiliateLocationMatchingFunction)
  }
}
フィールド
affiliateLocationMatchingType

enum (AffiliateLocationMatchingType)

必須。このアフィリエイト住所アセット フィルタのマッチタイプ。
assetSetId

string (int64 format)

出力専用。配信対象のアフィリエイト住所アセットと一致するアセットセットの ID。
affiliateLocationMatchingFunction

object (AffiliateLocationMatchingFunction)

省略可。アフィリエイト住所アセット フィルタがアフィリエイト住所アセットと一致する方法を決定する照合関数。

このフィールドは必須であり、affiliateLocationMatchingType が SELECTED_CHAINS の場合にのみ設定できます。

AffiliateLocationMatchingType

配信対象となるアフィリエイト住所アセットを決定する、一致タイプの候補。

列挙型
AFFILIATE_LOCATION_MATCHING_TYPE_UNSPECIFIED このバージョンでは、アフィリエイト住所表示オプションのマッチタイプが指定されていないか、不明です。
SELECT_ALL 利用可能なすべてのアフィリエイト住所アセットが配信対象となります。
SELECTED_CHAINS 選択したアフィリエイト住所アセットが配信されます。
DISABLED アフィリエイト住所アセットは配信できません。

AffiliateLocationMatchingFunction

アフィリエイト住所アセット フィルタのマッチング関数。

JSON 表現 
{
  "chains": [
    {
      object (AffiliateLocationChain)
    }
  ]
}
フィールド
chains[]

object (AffiliateLocationChain)

省略可。選択したアフィリエイトの所在地のチェーン ID。

affiliateLocationMatchingType が SELECTED_CHAINS の場合、このフィールドは必須です。

AffiliateLocationChain

アフィリエイトのビジネス情報のチェーン。

JSON 表現 
{
  "chainId": string
}
フィールド
chainId

string (int64 format)

必須。アフィリエイト チェーン店の ID。

SitelinkAsset

サイトリンク アセット。

JSON 表現 
{
  "assetId": string
}
フィールド
assetId

string (int64 format)

必須。サイトリンク アセットの ID。

メソッド

create

 特定されたリソースと YouTube アセットの間に新しい関連付けを作成します。

delete

 特定されたリソースと YouTube アセットの既存の関連付けを削除します。

list

 指定されたリソースにリンクされている YouTube アセットの関連付けを一覧表示します。