REST Resource: advertisers.youtubeAdGroups

Kaynak: YouTubeAdGroup

YouTube ve İş Ortakları satır öğesiyle ilişkili tek bir YouTube reklam grubu.

JSON gösterimi
{
  "name": string,
  "advertiserId": string,
  "adGroupId": string,
  "lineItemId": string,
  "displayName": string,
  "youtubeAdIds": [
    string
  ],
  "adGroupFormat": enum (YoutubeAndPartnersAdGroupFormat),
  "biddingStrategy": {
    object (YoutubeAndPartnersBiddingStrategy)
  },
  "entityStatus": enum (EntityStatus),
  "targetingExpansion": {
    object (TargetingExpansionConfig)
  },
  "productFeedData": {
    object (ProductFeedData)
  }
}
Alanlar
name

string

Reklam grubunun kaynak adı.

advertiserId

string (int64 format)

Reklam grubunun ait olduğu reklamverenin benzersiz kimliği.

adGroupId

string (int64 format)

Reklam grubunun benzersiz kimliği. Sistem tarafından atanır.

lineItemId

string (int64 format)

Reklam grubunun ait olduğu satır öğesinin benzersiz kimliği.

displayName

string

Reklam grubunun görünen adı.

Maksimum 255 bayt boyutta UTF-8 olarak kodlanmış olmalıdır.

youtubeAdIds[]

string (int64 format)

Reklam grubuyla ilişkilendirilmiş [youtube_ad_group_ad][] kaynaklarının kimlikleri.

adGroupFormat

enum (YoutubeAndPartnersAdGroupFormat)

Reklam grubundaki reklamların biçimi.

biddingStrategy

object (YoutubeAndPartnersBiddingStrategy)

Reklam grubu tarafından kullanılan teklif stratejisi.

entityStatus

enum (EntityStatus)

Reklam grubunun, bütçesini ve envanter teklifini harcayıp harcamayacağını kontrol eder.

Reklam grubunun üst satır öğesi etkin değilse reklam grubu, kendi durumu ENTITY_STATUS_ACTIVE olsa bile bütçesini harcayamaz.

targetingExpansion

object (TargetingExpansionConfig)

Reklam grubunun hedefleme genişletmesi ayarları.

Bu yapılandırma yalnızca reklam grubuna uygun kitle listesi hedeflemesi atandığında geçerlidir.

productFeedData

object (ProductFeedData)

Bu reklam grubundaki ürün feed'inin ayarları.

YoutubeAndPartnersAdGroupFormat

YouTube reklam grubunun biçimi.

Sıralamalar
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_UNSPECIFIED Bu sürümde biçim değeri belirtilmemiş veya bilinmiyor.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_IN_STREAM Yayın içi reklamlar.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_VIDEO_DISCOVERY Feed içi reklamlar.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_BUMPER Bumper reklamlar
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_NON_SKIPPABLE_IN_STREAM Atlanamayan yayın içi reklamlar.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_AUDIO Atlanamayan yayın içi işitsel reklamlar.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_ACTION İşleme yönelik video kampanyaları için duyarlı reklamlar
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_REACH Yayın içi ve bumper reklamlar dahil olmak üzere etkili erişim reklam grupları
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_MASTHEAD YouTube ana sayfasının en üst alanında gösterilen Masthead Reklam.

ProductFeedData

Ürün feed'inin ayrıntıları.

JSON gösterimi
{
  "productMatchType": enum (ProductMatchType),
  "productMatchDimensions": [
    {
      object (ProductMatchDimension)
    }
  ],
  "isFeedDisabled": boolean
}
Alanlar
productMatchType

enum (ProductMatchType)

Ürünlerin ürün feed'ine göre seçilme şekli.

productMatchDimensions[]

object (ProductMatchDimension)

Ürünleri eşleştirmek için kullanılan boyutların listesi.

isFeedDisabled

boolean

Ürün feed'inin ürünleri göstermeyi devre dışı bırakıp bırakmadığı.

ProductMatchType

Ürünleri eşleştirme yöntemleri.

Sıralamalar
PRODUCT_MATCH_TYPE_UNSPECIFIED Belirtilmedi veya bilinmiyor.
PRODUCT_MATCH_TYPE_ALL_PRODUCTS Tüm ürünler eşleştirilir.
PRODUCT_MATCH_TYPE_SPECIFIC_PRODUCTS Belirli ürünler seçildi.
PRODUCT_MATCH_TYPE_CUSTOM_LABEL Ürünleri özel etiketlerine göre eşleştirin.

ProductMatchDimension

Ürünleri eşleştirmek için kullanılan bir boyut.

JSON gösterimi
{

  // Union field dimension can be only one of the following:
  "productOfferId": string,
  "customLabel": {
    object (CustomLabel)
  }
  // End of list of possible types for union field dimension.
}
Alanlar
Birleştirme alanı dimension. Ürünün eşleştirileceği boyut ve değer. dimension şunlardan yalnızca biri olabilir:
productOfferId

string

Aynı teklif kimliğine sahip bir ürünle eşleştirilecek ürün teklifinin kimliği.

customLabel

object (CustomLabel)

Tüm ürünleri etiketle eşleştirecek özel etiket.

CustomLabel

Özel bir etiketin anahtarı ve değeri.

JSON gösterimi
{
  "key": enum (CustomLabelKey),
  "value": string
}
Alanlar
key

enum (CustomLabelKey)

Etiketin anahtarı.

value

string

Etiketin değeri.

CustomLabelKey

Özel etiketin anahtarı

Sıralamalar
CUSTOM_LABEL_KEY_UNSPECIFIED Belirtilmedi veya bilinmiyor.
CUSTOM_LABEL_KEY_0 Anahtar dizini 0.
CUSTOM_LABEL_KEY_1 Anahtar dizini 1.
CUSTOM_LABEL_KEY_2 Anahtar dizini 2.
CUSTOM_LABEL_KEY_3 Anahtar dizini 3.
CUSTOM_LABEL_KEY_4 Anahtar dizin 4.

Yöntemler

bulkListAdGroupAssignedTargetingOptions

Hedefleme türlerindeki birden fazla YouTube reklam grubu için atanan hedefleme seçeneklerini listeler.

get

Bir YouTube reklam grubu alır.

list

YouTube reklam gruplarını listeler.