REST Resource: advertisers.adGroups

Resource: AdGroup

Satu grup iklan yang terkait dengan item baris.

Representasi JSON 
{
  "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)
    }
  ]
}
Kolom
name

string

Hanya output. ID. Nama resource grup iklan.
advertiserId

string (int64 format)

Hanya output. ID unik pengiklan yang memiliki grup iklan.
adGroupId

string (int64 format)

Hanya output. ID unik grup iklan. Ditetapkan oleh sistem.
lineItemId

string (int64 format)

Wajib. Tidak dapat diubah. ID unik item baris yang mencakup grup iklan.
displayName

string

Wajib. Nama tampilan grup iklan.

Harus berenkode UTF-8 dengan ukuran maksimum 255 byte.
adGroupFormat

enum (AdGroupFormat)

Wajib. Tidak dapat diubah. Format iklan dalam grup iklan.
bidStrategy

object (BiddingStrategy)

Opsional. Strategi bidding yang digunakan oleh grup iklan. Hanya kolom youtubeAndPartnersBid dan demandGenBid yang dapat digunakan dalam strategi bidding.
entityStatus

enum (EntityStatus)

Wajib. Mengontrol apakah grup iklan dapat membelanjakan anggarannya dan mengajukan bid pada inventaris atau tidak.

Jika item baris induk grup iklan tidak aktif, grup iklan tidak dapat membelanjakan anggarannya meskipun statusnya sendiri adalah ENTITY_STATUS_ACTIVE.
targetingExpansion

object (TargetingExpansionConfig)

Opsional. Setelan penargetan yang dioptimalkan untuk grup iklan.
productFeedData

object (ProductFeedData)

Opsional. Setelan feed produk di grup iklan ini.
adGroupInventoryControl

object (AdGroupInventoryControl)

Opsional. Wajib untuk grup iklan Peningkat Permintaan. Menentukan kontrol inventaris grup iklan.
adSource

enum (AdSource)

Opsional. Sumber iklan dalam grup iklan ini. Kolom ini hanya digunakan jika iklan dibuat secara otomatis dari sumber tertentu.
creativeAssignments[]

object (CreativeAssignment)

Opsional. Materi iklan yang digunakan untuk membuat iklan di grup iklan.

Kolom ini hanya dapat ditetapkan jika adSource adalah AD_SOURCE_DV360_CREATIVE.

AdGroupFormat

Format grup iklan.

Enum
AD_GROUP_FORMAT_UNSPECIFIED Nilai format tidak ditentukan atau tidak diketahui dalam versi ini.
AD_GROUP_FORMAT_IN_STREAM Iklan dalam stream.
AD_GROUP_FORMAT_VIDEO_DISCOVERY Iklan Dalam Feed.
AD_GROUP_FORMAT_BUMPER Iklan bumper.
AD_GROUP_FORMAT_NON_SKIPPABLE_IN_STREAM Iklan dalam stream yang tidak dapat dilewati.
AD_GROUP_FORMAT_AUDIO Iklan audio in-stream yang tidak dapat dilewati.
AD_GROUP_FORMAT_RESPONSIVE Iklan responsif.
AD_GROUP_FORMAT_REACH Grup iklan jangkauan efektif, termasuk iklan in-stream dan bumper.
AD_GROUP_FORMAT_MASTHEAD Iklan Masthead yang ditampilkan di slot teratas di halaman beranda YouTube.
AD_GROUP_FORMAT_DEMAND_GEN Iklan Peningkat Permintaan.

ProductFeedData

Detail feed produk.

Representasi JSON 
{
  "productMatchType": enum (ProductMatchType),
  "productMatchDimensions": [
    {
      object (ProductMatchDimension)
    }
  ],
  "isFeedDisabled": boolean
}
Kolom
productMatchType

enum (ProductMatchType)

Cara produk dipilih oleh feed produk.
productMatchDimensions[]

object (ProductMatchDimension)

Daftar dimensi yang digunakan untuk mencocokkan produk.
isFeedDisabled

boolean

Apakah feed produk telah memilih untuk tidak menampilkan produk.

ProductMatchType

Jenis cara untuk mencocokkan produk.

Enum
PRODUCT_MATCH_TYPE_UNSPECIFIED Tidak ditentukan atau tidak diketahui.
PRODUCT_MATCH_TYPE_ALL_PRODUCTS Semua produk cocok.
PRODUCT_MATCH_TYPE_SPECIFIC_PRODUCTS Produk tertentu dipilih.
PRODUCT_MATCH_TYPE_CUSTOM_LABEL Cocokkan produk berdasarkan label kustomnya.

ProductMatchDimension

Dimensi yang digunakan untuk mencocokkan produk.

Representasi JSON 
{

  // 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.
}
Kolom
Dimensi dan nilai yang akan dicocokkan dengan produk. Berikut adalah daftar kolom yang sama-sama bersifat eksklusif. Maksimal satu kolom akan ditetapkan dalam respons:
productOfferId

string

ID penawaran produk yang akan dicocokkan dengan produk yang memiliki ID penawaran yang sama.
customLabel

object (CustomLabel)

Label kustom untuk mencocokkan semua produk dengan label.
Akhir kolom yang saling eksklusif.

CustomLabel

Kunci dan nilai label kustom.

Representasi JSON 
{
  "key": enum (CustomLabelKey),
  "value": string
}
Kolom
key

enum (CustomLabelKey)

Kunci label.
value

string

Nilai label.

CustomLabelKey

Kunci label kustom

Enum
CUSTOM_LABEL_KEY_UNSPECIFIED Tidak ditentukan atau tidak diketahui.
CUSTOM_LABEL_KEY_0 Indeks kunci 0.
CUSTOM_LABEL_KEY_1 Indeks kunci 1.
CUSTOM_LABEL_KEY_2 Indeks kunci 2.
CUSTOM_LABEL_KEY_3 Indeks kunci 3.
CUSTOM_LABEL_KEY_4 Indeks kunci 4.

AdGroupInventoryControl

Kontrol inventaris grup iklan.

Representasi JSON 
{

  // 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.
}
Kolom
Kontrol inventaris grup iklan. Berikut adalah daftar kolom yang sama-sama bersifat eksklusif. Maksimal satu kolom akan ditetapkan dalam respons:
adGroupInventoryStrategy

enum (AdGroupInventoryStrategy)

Strategi inventaris.
selectedInventories

object (SelectedInventories)

Inventaris yang dipilih.
Akhir kolom yang saling eksklusif.

AdGroupInventoryStrategy

Strategi inventaris untuk grup iklan.

Enum
AD_GROUP_INVENTORY_STRATEGY_UNSPECIFIED Tidak ditentukan atau tidak diketahui.
AD_GROUP_INVENTORY_STRATEGY_ALL_GOOGLE_AND_DISPLAY_NETWORK_INVENTORY Grup iklan diikutsertakan dalam semua inventaris Google dan Jaringan Display.
AD_GROUP_INVENTORY_STRATEGY_ALL_GOOGLE_INVENTORY Grup iklan diikutsertakan dalam semua inventaris Google.

SelectedInventories

Kontrol inventaris grup iklan.

Representasi JSON 
{
  "allowYoutubeStream": boolean,
  "allowYoutubeShorts": boolean,
  "allowYoutubeFeed": boolean,
  "allowDiscover": boolean,
  "allowGmail": boolean,
  "allowGoogleDisplayNetwork": boolean
}
Kolom
allowYoutubeStream

boolean

Apakah grup iklan diikutsertakan dalam inventaris in-stream YouTube.
allowYoutubeShorts

boolean

Apakah grup iklan diikutsertakan dalam inventaris YouTube Shorts.
allowYoutubeFeed

boolean

Apakah grup iklan diikutsertakan dalam inventaris dalam feed YouTube.
allowDiscover

boolean

Apakah grup iklan diikutsertakan dalam inventaris Discover.
allowGmail

boolean

Apakah grup iklan diikutsertakan dalam inventaris Gmail.
allowGoogleDisplayNetwork

boolean

Apakah grup iklan diikutsertakan dalam inventaris Jaringan Display Google.

AdSource

Sumber untuk iklan di adGroup ini.

Enum
AD_SOURCE_UNSPECIFIED Tidak ditentukan atau tidak diketahui. Default-nya adalah sumber iklan reguler.
AD_SOURCE_DV360_CREATIVE Bersumber dari Materi Iklan DV360.

CreativeAssignment

Detail penetapan materi iklan yang ditetapkan ke grup iklan.

Representasi JSON 
{
  "creativeId": string
}
Kolom
creativeId

string (int64 format)

Wajib. ID materi iklan Display & Video 360 yang ditetapkan ke grup iklan.

Metode

bulkEditAssignedTargetingOptions

 Pengeditan massal opsi penargetan untuk beberapa grup iklan.

bulkListAssignedTargetingOptions

 Mencantumkan opsi penargetan yang ditetapkan untuk beberapa grup iklan di berbagai jenis penargetan.

create

 Membuat grup iklan baru.

delete

 Menghapus AdGroup.

get

 Mendapatkan grup iklan.

list

 Mencantumkan grup iklan.

patch

 Memperbarui grup iklan yang ada.