REST Resource: advertisers.adGroups.youtubeAssetTypes.youtubeAssetAssociations

Resource: YoutubeAssetAssociation

Atribusi antara aset YouTube dan resource.

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 pengaitan YOUTUBE_ASSET_TYPE_LOCATION dan YOUTUBE_ASSET_TYPE_AFFILIATE_LOCATION: youtubeAssetAssociationId adalah ID kumpulan aset yang ditautkan, atau 0 jika locationMatchingType atau affiliateLocationMatchingType adalah DISABLED.

Untuk atribusi 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 
{

  // 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.
}
Kolom
Aset YouTube. Berikut adalah daftar kolom yang bersifat eksklusif satu sama lain. Maksimal satu kolom akan ditetapkan dalam respons:
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.
Akhir kolom yang saling eksklusif.

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 penayangan.

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

Rantai lokasi afiliasi.

Representasi JSON 
{
  "chainId": string
}
Kolom
chainId

string (int64 format)

Wajib. ID rantai lokasi afiliasi.

SitelinkAsset

Aset sitelink.

Representasi JSON 
{
  "assetId": string
}
Kolom
assetId

string (int64 format)

Wajib. ID aset sitelink.

Metode

create

 Membuat hubungan baru antara resource yang diidentifikasi dan aset YouTube.

delete

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

list

 Mencantumkan asosiasi aset YouTube yang ditautkan ke resource tertentu.