REST Resource: advertisers.youtubeAdGroups

Resource: YouTubeAdGroup

Satu grup iklan YouTube yang dikaitkan dengan item baris YouTube dan Partners.

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

string

Nama resource grup iklan.

advertiserId

string (int64 format)

ID unik pengiklan yang memiliki grup iklan tersebut.

adGroupId

string (int64 format)

ID unik grup iklan. Ditetapkan oleh sistem.

lineItemId

string (int64 format)

ID unik item baris yang memiliki grup iklan.

displayName

string

Nama tampilan grup iklan.

Harus berenkode UTF-8 dengan ukuran maksimum 255 byte.

youtubeAdIds[]

string (int64 format)

ID resource [youtube_ad_group_ad][] yang terkait dengan grup iklan.

adGroupFormat

enum (YoutubeAndPartnersAdGroupFormat)

Format iklan dalam grup iklan.

biddingStrategy

object (YoutubeAndPartnersBiddingStrategy)

Strategi bidding yang digunakan oleh grup iklan.

entityStatus

enum (EntityStatus)

Mengontrol apakah grup iklan dapat membelanjakan anggaran 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)

Setelan perluasan penargetan grup iklan.

Konfigurasi ini hanya berlaku saat penargetan daftar audiens yang memenuhi syarat ditetapkan ke grup iklan.

productFeedData

object (ProductFeedData)

Setelan feed produk di grup iklan ini.

YoutubeAndPartnersAdGroupFormat

Format grup iklan YouTube.

Enum
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_UNSPECIFIED Nilai format tidak ditentukan atau tidak diketahui dalam versi ini.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_IN_STREAM Iklan in-stream.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_VIDEO_DISCOVERY Iklan Dalam Feed.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_BUMPER Iklan bumper.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_NON_SKIPPABLE_IN_STREAM Iklan in-stream yang tidak dapat dilewati.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_AUDIO Iklan audio in-stream yang tidak dapat dilewati.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_ACTION Iklan responsif untuk kampanye tindakan video.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_REACH Grup iklan jangkauan efektif, termasuk iklan in-stream dan bumper.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_MASTHEAD Iklan Masthead yang muncul di slot teratas pada halaman beranda YouTube.

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 memilih untuk tidak menampilkan produk.

ProductMatchType

Jenis-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
{

  // 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.
}
Kolom
Kolom union dimension. Dimensi dan nilai yang akan dicocokkan dengan produk. dimension hanya dapat berupa salah satu dari berikut:
productOfferId

string

ID penawaran produk agar dicocokkan dengan produk dengan ID penawaran yang sama.

customLabel

object (CustomLabel)

Label khusus untuk mencocokkan semua produk dengan label.

CustomLabel

Kunci dan nilai label khusus.

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

enum (CustomLabelKey)

Kunci label.

value

string

Nilai label.

CustomLabelKey

Kunci label khusus

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.

Metode

bulkListAdGroupAssignedTargetingOptions

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

get

Mendapatkan grup iklan YouTube.

list

Mencantumkan grup iklan YouTube.