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 表現 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "locationAssetFilter": {
    object (LocationAssetFilter)
  },
  "affiliateLocationAssetFilter": {
    object (AffiliateLocationAssetFilter)
  },
  "sitelinkAsset": {
    object (SitelinkAsset)
  }
  // End of mutually exclusive fields.
}
フィールド
YouTube アセット。以下は、相互に排他的なフィールドのリストです。レスポンスに設定されるフィールドは、最大 1 つです。
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 アセットの関連付けを一覧表示します。