REST Resource: advertisers.adGroups

Kaynak: AdGroup

Bir satır öğesiyle ilişkili tek bir reklam grubu.

JSON gösterimi 
{
  "name": string,
  "advertiserId": string,
  "adGroupId": string,
  "lineItemId": string,
  "displayName": string,
  "adGroupFormat": enum (AdGroupFormat),
  "bidStrategy": {
    object (BiddingStrategy)
  },
  "entityStatus": enum (EntityStatus),
  "targetingExpansion": {
    object (TargetingExpansionConfig)
  },
  "productFeedData": {
    object (ProductFeedData)
  },
  "adGroupInventoryControl": {
    object (AdGroupInventoryControl)
  },
  "adSource": enum (AdSource),
  "creativeAssignments": [
    {
      object (CreativeAssignment)
    }
  ]
}
Alanlar
name

string

Yalnızca çıkış. Tanımlayıcı. Reklam grubunun kaynak adı.
advertiserId

string (int64 format)

Yalnızca çıkış. Reklam grubunun ait olduğu reklamverenin benzersiz kimliği.
adGroupId

string (int64 format)

Yalnızca çıkış. Reklam grubunun benzersiz kimliği. Sistem tarafından atanır.
lineItemId

string (int64 format)

Zorunlu. Değiştirilemez. Reklam grubunun ait olduğu satır öğesinin benzersiz kimliği.
displayName

string

Zorunlu. Reklam grubunun görünen adı.

UTF-8 olarak kodlanmış ve maksimum 255 bayt boyutunda olmalıdır.
adGroupFormat

enum (AdGroupFormat)

Zorunlu. Değiştirilemez. Reklam grubundaki reklamların biçimi.
bidStrategy

object (BiddingStrategy)

İsteğe bağlıdır. Reklam grubu tarafından kullanılan teklif stratejisi. Teklif stratejisinde yalnızca youtubeAndPartnersBid ve demandGenBid alanı kullanılabilir.
entityStatus

enum (EntityStatus)

Zorunlu. Reklam grubunun bütçesini harcayıp harcayamayacağını ve envanter için teklif verip veremeyeceğini 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)

İsteğe bağlıdır. Reklam grubunun optimize hedefleme ayarları.
productFeedData

object (ProductFeedData)

İsteğe bağlıdır. Bu reklam grubundaki ürün feed'inin ayarları.
adGroupInventoryControl

object (AdGroupInventoryControl)

İsteğe bağlıdır. Talep Yaratma reklam grupları için gereklidir. Reklam grubunun envanter kontrolünü belirtir.
adSource

enum (AdSource)

İsteğe bağlıdır. Bu reklam grubundaki reklamların kaynağı. Bu alan yalnızca reklamlar belirli bir kaynaktan otomatik olarak oluşturulduğunda kullanılır.
creativeAssignments[]

object (CreativeAssignment)

İsteğe bağlıdır. Reklam grubu altında reklam oluşturmak için kullanılan reklam öğeleri.

Bu alan yalnızca adSource AD_SOURCE_DV360_CREATIVE ise atanabilir.

AdGroupFormat

Reklam grubunun biçimi.

Sıralamalar
AD_GROUP_FORMAT_UNSPECIFIED Biçim değeri belirtilmemiş veya bu sürümde bilinmiyor.
AD_GROUP_FORMAT_IN_STREAM Yayın içi reklamlar.
AD_GROUP_FORMAT_VIDEO_DISCOVERY Feed içi reklamlar.
AD_GROUP_FORMAT_BUMPER Bumper reklamlar
AD_GROUP_FORMAT_NON_SKIPPABLE_IN_STREAM Atlanamayan yayın içi reklamlar.
AD_GROUP_FORMAT_AUDIO Atlanamayan yayın içi işitsel reklamlar
AD_GROUP_FORMAT_RESPONSIVE Duyarlı reklamlar.
AD_GROUP_FORMAT_REACH Yayın içi ve bumper reklamlar dahil olmak üzere etkili erişim reklam grupları.
AD_GROUP_FORMAT_MASTHEAD YouTube ana sayfasının en üst alanında gösterilen masthead reklam.
AD_GROUP_FORMAT_DEMAND_GEN Talep Yaratma reklamları.

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'i tarafından nasıl seçildiği.
productMatchDimensions[]

object (ProductMatchDimension)

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

boolean

Ürün feed'inin ürün göstermeyi kapsamı dışında kalmayı seçip seçmediği.

ProductMatchType

Ürünleri eşleştirme yöntemlerinin türleri.

Sıralamalar
PRODUCT_MATCH_TYPE_UNSPECIFIED Belirtilmemiş 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 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "productOfferId": string,
  "customLabel": {
    object (CustomLabel)
  }
  // End of mutually exclusive fields.
}
Alanlar
Ürünün eşleştirileceği boyut ve değer. Aşağıda, birbirini dışlayan alanların listesi verilmiştir. Yanıtta alanlardan en fazla biri ayarlanır:
productOfferId

string

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

object (CustomLabel)

Etikete sahip tüm ürünlerle eşleşecek özel etiket.
Birbirini hariç tutan alanların sonu.

CustomLabel

Özel 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 Belirtilmemiş 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 dizini 4.

AdGroupInventoryControl

Reklam grubunun envanter kontrolü.

JSON gösterimi 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "adGroupInventoryStrategy": enum (AdGroupInventoryStrategy),
  "selectedInventories": {
    object (SelectedInventories)
  }
  // End of mutually exclusive fields.
}
Alanlar
Reklam grubunun envanter kontrolü. Aşağıda, birbirini dışlayan alanların listesi verilmiştir. Yanıtta alanlardan en fazla biri ayarlanır:
adGroupInventoryStrategy

enum (AdGroupInventoryStrategy)

Envanter stratejisi.
selectedInventories

object (SelectedInventories)

Seçili envanterler.
Birbirini hariç tutan alanların sonu.

AdGroupInventoryStrategy

Reklam grubunun envanter stratejisi.

Sıralamalar
AD_GROUP_INVENTORY_STRATEGY_UNSPECIFIED Belirtilmemiş veya bilinmiyor.
AD_GROUP_INVENTORY_STRATEGY_ALL_GOOGLE_AND_DISPLAY_NETWORK_INVENTORY Reklam grubu, tüm Google ve Görüntülü Reklam Ağı envanterini kullanır.
AD_GROUP_INVENTORY_STRATEGY_ALL_GOOGLE_INVENTORY Reklam grubu, tüm Google envanterine dahil edilmiştir.

SelectedInventories

Reklam grubunun envanter kontrolü.

JSON gösterimi 
{
  "allowYoutubeStream": boolean,
  "allowYoutubeShorts": boolean,
  "allowYoutubeFeed": boolean,
  "allowDiscover": boolean,
  "allowGmail": boolean,
  "allowGoogleDisplayNetwork": boolean
}
Alanlar
allowYoutubeStream

boolean

Reklam grubunun YouTube yayın içi envanterine dahil olup olmadığı.
allowYoutubeShorts

boolean

Reklam grubunun YouTube Shorts envanterine dahil olup olmadığı.
allowYoutubeFeed

boolean

Reklam grubunun YouTube feed içi envanterine dahil olup olmadığı.
allowDiscover

boolean

Reklam grubunun Keşfet envanterine dahil olup olmadığı.
allowGmail

boolean

Reklam grubunun Gmail envanterine dahil olup olmadığı.
allowGoogleDisplayNetwork

boolean

Reklam grubunun Google Görüntülü Reklam Ağı envanterine dahil olup olmadığı.

AdSource

Bu reklam grubundaki reklamların kaynağı.

Sıralamalar
AD_SOURCE_UNSPECIFIED Belirtilmemiş veya bilinmiyor. Varsayılan olarak normal reklam kaynağına ayarlanır.
AD_SOURCE_DV360_CREATIVE DV360 reklam öğesinden alınmıştır.

CreativeAssignment

Reklam grubuna atanan reklam öğesinin ayrıntıları.

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

string (int64 format)

Zorunlu. Reklam grubuna atanan Display & Video 360 reklam öğesinin kimliği.

Yöntemler

bulkEditAssignedTargetingOptions

 Birden fazla reklam grubu için hedefleme seçeneklerini toplu olarak düzenler.

bulkListAssignedTargetingOptions

 Hedefleme türleri genelinde birden fazla reklam grubu için atanmış hedefleme seçeneklerini listeler.

create

 Yeni bir reklam grubu oluşturur.

delete

 Bir reklam grubunu siler.

get

 Bir reklam grubu alır.

list

 Reklam gruplarını listeler.

patch

 Mevcut bir reklam grubunu günceller.