REST Resource: advertisers.adGroups.youtubeAssetTypes.youtubeAssetAssociations

Resource: YoutubeAssetAssociation

Pengaitan antara resource dan aset YouTube.

Representasi JSON 
{
  "name": string,
  "youtubeAssetType": enum (YoutubeAssetType),
  "linkedYoutubeAsset": {
    object (LinkedYouTubeAsset)
  }
}
Kolom
name

string

ID. Nama resource asosiasi.

Untuk asosiasi tingkat item baris: Pola nama adalah advertisers/{advertiserId}/lineItems/{lineItemId}/youtubeAssetTypes/{youtubeAssetType}/youtubeAssetAssociations/{youtubeAssetAssociationId}.

Untuk pengaitan tingkat grup iklan: Pola nama adalah advertisers/{advertiserId}/adGroups/{adGroupId}/youtubeAssetTypes/{youtubeAssetType}/youtubeAssetAssociations/{youtubeAssetAssociationId}.

Untuk asosiasi YOUTUBE_ASSET_TYPE_LOCATION dan YOUTUBE_ASSET_TYPE_AFFILIATE_LOCATION: youtubeAssetAssociationId adalah ID set aset yang ditautkan, atau 0 jika locationMatchingType atau affiliateLocationMatchingType adalah DISABLED.

Untuk asosiasi YOUTUBE_ASSET_TYPE_SITELINK: youtubeAssetAssociationId adalah ID aset sitelink yang ditautkan.
youtubeAssetType

enum (YoutubeAssetType)

Wajib. Jenis aset YouTube yang terkait dengan resource.
linkedYoutubeAsset

object (LinkedYouTubeAsset)

Wajib. Aset YouTube yang terkait dengan resource.

YoutubeAssetType

Kemungkinan jenis aset YouTube.

Aset ini akan menampilkan informasi tambahan bersama iklan selama penayangan.

Enum
YOUTUBE_ASSET_TYPE_UNSPECIFIED Jenis aset YouTube tidak ditentukan atau tidak diketahui dalam versi ini.
YOUTUBE_ASSET_TYPE_LOCATION Aset lokasi.
YOUTUBE_ASSET_TYPE_AFFILIATE_LOCATION Aset lokasi afiliasi.

LinkedYouTubeAsset

Aset YouTube yang ditautkan ke resource dalam YoutubeAssetAssociation.

Representasi 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.
}
Kolom
Kolom union youtube_asset. Aset YouTube. youtube_asset hanya dapat berupa salah satu dari berikut:
locationAssetFilter

object (LocationAssetFilter)

Filter aset lokasi.

Kolom ini hanya dapat ditetapkan jika youtubeAssetType adalah YOUTUBE_ASSET_TYPE_LOCATION.
affiliateLocationAssetFilter

object (AffiliateLocationAssetFilter)

Filter aset lokasi afiliasi.

Kolom ini hanya dapat ditetapkan jika youtubeAssetType adalah YOUTUBE_ASSET_TYPE_AFFILIATE_LOCATION.

LocationAssetFilter

Filter aset yang cocok dengan aset lokasi yang memenuhi syarat untuk penayangan.

Representasi JSON 
{
  "locationMatchingType": enum (LocationMatchingType),
  "assetSetId": string,
  "locationMatchingFunction": {
    object (LocationMatchingFunction)
  }
}
Kolom
locationMatchingType

enum (LocationMatchingType)

Wajib. Jenis pencocokan filter aset lokasi ini.
assetSetId

string (int64 format)

Hanya output. ID kumpulan aset yang cocok dengan aset lokasi yang memenuhi syarat untuk ditayangkan.
locationMatchingFunction

object (LocationMatchingFunction)

Opsional. Fungsi pencocokan yang menentukan cara filter aset lokasi mencocokkan aset lokasi.

Kolom ini wajib diisi dan hanya dapat ditetapkan jika locationMatchingType adalah FILTER atau SELECTED_ASSETS.

LocationMatchingType

Kemungkinan jenis pencocokan yang menentukan aset lokasi mana yang memenuhi syarat untuk ditayangkan.

Enum
LOCATION_MATCHING_TYPE_UNSPECIFIED Jenis pencocokan lokasi tidak ditentukan atau tidak diketahui dalam versi ini.
SELECT_ALL Semua aset lokasi yang tersedia memenuhi syarat untuk ditayangkan.
FILTER Aset lokasi yang cocok dengan filter nama bisnis dan/atau label yang diberikan dapat ditayangkan.
SELECTED_ASSETS Hanya aset lokasi yang dipilih yang dapat ditayangkan.
DISABLED Tidak ada aset lokasi yang dapat ditayangkan.

LocationMatchingFunction

Fungsi pencocokan untuk filter aset lokasi.

Representasi JSON 
{
  "labels": [
    string
  ],
  "locationAssetIds": [
    string
  ],
  "business": string
}
Kolom
labels[]

string

Opsional. Label yang akan dicocokkan.

Label digabungkan secara logis dengan OR.

Kolom ini bersifat opsional dan hanya dapat ditetapkan jika locationMatchingType adalah FILTER.
locationAssetIds[]

string (int64 format)

Opsional. ID aset lokasi yang dipilih.

Kolom ini wajib diisi jika locationMatchingType adalah SELECTED_ASSETS.
business

string

Opsional. Nama bisnis yang akan dicocokkan.

Kolom ini bersifat opsional dan hanya dapat ditetapkan jika locationMatchingType adalah FILTER.

AffiliateLocationAssetFilter

Filter aset yang cocok dengan aset lokasi afiliasi yang memenuhi syarat untuk ditayangkan.

Representasi JSON 
{
  "affiliateLocationMatchingType": enum (AffiliateLocationMatchingType),
  "assetSetId": string,
  "affiliateLocationMatchingFunction": {
    object (AffiliateLocationMatchingFunction)
  }
}
Kolom
affiliateLocationMatchingType

enum (AffiliateLocationMatchingType)

Wajib. Jenis pencocokan filter aset lokasi afiliasi ini.
assetSetId

string (int64 format)

Hanya output. ID kumpulan aset yang cocok dengan aset lokasi afiliasi yang memenuhi syarat untuk ditayangkan.
affiliateLocationMatchingFunction

object (AffiliateLocationMatchingFunction)

Opsional. Fungsi pencocokan yang menentukan cara filter aset lokasi afiliasi mencocokkan aset lokasi afiliasi.

Kolom ini wajib diisi dan hanya dapat ditetapkan jika affiliateLocationMatchingType adalah SELECTED_CHAINS.

AffiliateLocationMatchingType

Kemungkinan jenis pencocokan yang menentukan aset lokasi afiliasi mana yang memenuhi syarat untuk ditayangkan.

Enum
AFFILIATE_LOCATION_MATCHING_TYPE_UNSPECIFIED Jenis pencocokan lokasi afiliasi tidak ditentukan atau tidak diketahui dalam versi ini.
SELECT_ALL Semua aset lokasi afiliasi yang tersedia memenuhi syarat untuk ditayangkan.
SELECTED_CHAINS Aset lokasi afiliasi yang dipilih dapat ditayangkan.
DISABLED Tidak ada aset lokasi afiliasi yang dapat ditayangkan.

AffiliateLocationMatchingFunction

Fungsi pencocokan untuk filter aset lokasi afiliasi.

Representasi JSON 
{
  "chains": [
    {
      object (AffiliateLocationChain)
    }
  ]
}
Kolom
chains[]

object (AffiliateLocationChain)

Opsional. ID jaringan lokasi afiliasi yang dipilih.

Kolom ini wajib diisi jika affiliateLocationMatchingType adalah SELECTED_CHAINS.

AffiliateLocationChain

Jaringan lokasi afiliasi.

Representasi JSON 
{
  "chainId": string
}
Kolom
chainId

string (int64 format)

Wajib. ID jaringan lokasi afiliasi.

SitelinkAsset

Aset sitelink.

Representasi JSON 
{
  "assetId": string
}
Kolom
assetId

string (int64 format)

Wajib. ID aset sitelink.

Metode

create

 Membuat pengaitan baru antara resource yang diidentifikasi dan aset YouTube.

delete

 Menghapus pengaitan yang ada antara aset YouTube dan resource yang diidentifikasi.

list

 Mencantumkan asosiasi aset YouTube yang ditautkan ke resource tertentu.