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 アセットの関連付けを一覧表示します。