REST Resource: advertisers.adGroups.youtubeAssetTypes.youtubeAssetAssociations

Kaynak: YoutubeAssetAssociation

Bir kaynak ile YouTube öğesi arasındaki ilişkilendirme.

JSON gösterimi 
{
  "name": string,
  "youtubeAssetType": enum (YoutubeAssetType),
  "linkedYoutubeAsset": {
    object (LinkedYouTubeAsset)
  }
}
Alanlar
name

string

Tanımlayıcı. Derneğin kaynak adı.

Satır öğesi düzeyindeki ilişkilendirmeler için: Ad kalıbı advertisers/{advertiserId}/lineItems/{lineItemId}/youtubeAssetTypes/{youtubeAssetType}/youtubeAssetAssociations/{youtubeAssetAssociationId} şeklindedir.

Reklam grubu düzeyindeki ilişkilendirmeler için: Ad kalıbı advertisers/{advertiserId}/adGroups/{adGroupId}/youtubeAssetTypes/{youtubeAssetType}/youtubeAssetAssociations/{youtubeAssetAssociationId} şeklindedir.

YOUTUBE_ASSET_TYPE_LOCATION ve YOUTUBE_ASSET_TYPE_AFFILIATE_LOCATION ilişkilendirmeleri için: youtubeAssetAssociationId, bağlantısı verilen öğe grubunun kimliğidir. locationMatchingType veya affiliateLocationMatchingType, DISABLED ise 0'dır.

YOUTUBE_ASSET_TYPE_SITELINK ilişkilendirmeleri için: youtubeAssetAssociationId, bağlantısı oluşturulan site bağlantısı öğesinin kimliğidir.
youtubeAssetType

enum (YoutubeAssetType)

Zorunlu. Kaynakla ilişkili YouTube öğesinin türü.
linkedYoutubeAsset

object (LinkedYouTubeAsset)

Zorunlu. Kaynakla ilişkili YouTube öğesi.

YoutubeAssetType

Olası YouTube öğe türleri.

Bu öğeler, yayın sırasında reklamların yanında ek bilgiler gösterir.

Sıralamalar
YOUTUBE_ASSET_TYPE_UNSPECIFIED YouTube öğe türü belirtilmemiş veya bu sürümde bilinmiyor.
YOUTUBE_ASSET_TYPE_LOCATION Yer öğesi.
YOUTUBE_ASSET_TYPE_AFFILIATE_LOCATION Satış ortağı yer öğesi.

LinkedYouTubeAsset

YoutubeAssetAssociation içindeki bir kaynağa bağlı YouTube öğesi.

JSON gösterimi 
{

  // 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.
}
Alanlar
youtube_asset birleşik alanı. YouTube öğesi. youtube_asset aşağıdakilerden yalnızca biri olabilir:
locationAssetFilter

object (LocationAssetFilter)

Yer öğesi filtresi.

Bu ayar yalnızca youtubeAssetType YOUTUBE_ASSET_TYPE_LOCATION olduğunda belirlenebilir.
affiliateLocationAssetFilter

object (AffiliateLocationAssetFilter)

Satış ortağı yer öğesi filtresi.

Bu ayar yalnızca youtubeAssetType YOUTUBE_ASSET_TYPE_AFFILIATE_LOCATION olduğunda belirlenebilir.

LocationAssetFilter

Yayınlanmaya uygun yer öğeleriyle eşleşen bir öğe filtresi.

JSON gösterimi 
{
  "locationMatchingType": enum (LocationMatchingType),
  "assetSetId": string,
  "locationMatchingFunction": {
    object (LocationMatchingFunction)
  }
}
Alanlar
locationMatchingType

enum (LocationMatchingType)

Zorunlu. Bu konum öğesi filtresinin eşleşme türü.
assetSetId

string (int64 format)

Yalnızca çıkış. Yayınlanmaya uygun konum öğeleriyle eşleşen öğe grubunun kimliği.
locationMatchingFunction

object (LocationMatchingFunction)

İsteğe bağlıdır. Yer öğesi filtresinin yer öğeleriyle nasıl eşleşeceğini belirleyen eşleşme işlevi.

Bu alan zorunludur ve yalnızca locationMatchingType, FILTER veya SELECTED_ASSETS ise ayarlanabilir.

LocationMatchingType

Hangi konum öğelerinin yayınlanmaya uygun olduğuna karar veren olası eşleşme türleri.

Sıralamalar
LOCATION_MATCHING_TYPE_UNSPECIFIED Konum eşleme türü belirtilmemiş veya bu sürümde bilinmiyor.
SELECT_ALL Kullanılabilen tüm yer öğeleri yayınlanmaya uygundur.
FILTER Belirtilen işletme adı ve/veya etiket filtreleriyle eşleşen yer öğeleri yayınlanabilir.
SELECTED_ASSETS Yalnızca seçilen konum öğeleri yayınlanabilir.
DISABLED Yer öğeleri yayınlanamaz.

LocationMatchingFunction

Bir yer öğesi filtresinin eşleştirme işlevi.

JSON gösterimi 
{
  "labels": [
    string
  ],
  "locationAssetIds": [
    string
  ],
  "business": string
}
Alanlar
labels[]

string

İsteğe bağlıdır. Eşleştirilecek etiket.

Etiketler mantıksal olarak OR ile birleştirilir.

Bu alan isteğe bağlıdır ve yalnızca locationMatchingType, FILTER ise ayarlanabilir.
locationAssetIds[]

string (int64 format)

İsteğe bağlıdır. Seçilen yer öğesi kimlikleri.

locationMatchingType SELECTED_ASSETS ise bu alan zorunludur.
business

string

İsteğe bağlıdır. Eşleştirilecek işletme adı.

Bu alan isteğe bağlıdır ve yalnızca locationMatchingType, FILTER ise ayarlanabilir.

AffiliateLocationAssetFilter

Yayınlanmaya uygun satış ortağı yer öğeleriyle eşleşen bir öğe filtresi.

JSON gösterimi 
{
  "affiliateLocationMatchingType": enum (AffiliateLocationMatchingType),
  "assetSetId": string,
  "affiliateLocationMatchingFunction": {
    object (AffiliateLocationMatchingFunction)
  }
}
Alanlar
affiliateLocationMatchingType

enum (AffiliateLocationMatchingType)

Zorunlu. Bu satış ortağı yer öğesi filtresinin eşleşme türü.
assetSetId

string (int64 format)

Yalnızca çıkış. Yayınlanmaya uygun satış ortağı yer öğeleriyle eşleşen öğe grubunun kimliği.
affiliateLocationMatchingFunction

object (AffiliateLocationMatchingFunction)

İsteğe bağlıdır. Satış ortağı yer öğesi filtresinin satış ortağı yer öğeleriyle nasıl eşleşeceğini belirleyen eşleşme işlevi.

Bu alan zorunludur ve yalnızca affiliateLocationMatchingType, SELECTED_CHAINS ise ayarlanabilir.

AffiliateLocationMatchingType

Hangi satış ortağı yer öğelerinin yayınlanmaya uygun olduğunu belirleyen olası eşleşme türleri.

Sıralamalar
AFFILIATE_LOCATION_MATCHING_TYPE_UNSPECIFIED Satış ortağı konum eşleşme türü belirtilmemiş veya bu sürümde bilinmiyor.
SELECT_ALL Kullanılabilir tüm satış ortağı yer öğeleri yayınlanmaya uygundur.
SELECTED_CHAINS Seçilen satış ortağı yer öğeleri yayınlanabilir.
DISABLED Hiçbir satış ortağı yer öğesi yayınlanamaz.

AffiliateLocationMatchingFunction

Satış ortağı yer öğesi filtresi için eşleme işlevi.

JSON gösterimi 
{
  "chains": [
    {
      object (AffiliateLocationChain)
    }
  ]
}
Alanlar
chains[]

object (AffiliateLocationChain)

İsteğe bağlıdır. Seçilen satış ortağı konum zinciri kimlikleri.

affiliateLocationMatchingType SELECTED_CHAINS ise bu alan zorunludur.

AffiliateLocationChain

Bir satış ortağı konumları zinciri.

JSON gösterimi 
{
  "chainId": string
}
Alanlar
chainId

string (int64 format)

Zorunlu. Satış ortağı konum zincirinin kimliği.

SitelinkAsset

Site bağlantısı öğesi

JSON gösterimi 
{
  "assetId": string
}
Alanlar
assetId

string (int64 format)

Zorunlu. Site bağlantısı öğesinin kimliği.

Yöntemler

create

 Belirlenen kaynak ile bir YouTube öğesi arasında yeni bir ilişkilendirme oluşturur.

delete

 Belirlenen kaynak ile YouTube öğesi arasındaki mevcut ilişkilendirmeyi siler.

list

 Belirtilen kaynağa bağlı YouTube öğe ilişkilendirmelerini listeler.