Method: advertisers.adGroups.bulkEditAssignedTargetingOptions

Mengedit opsi penargetan secara massal untuk beberapa grup iklan.

Kumpulan permintaan penghapusan dan pembuatan yang sama akan diterapkan ke semua grup iklan yang ditentukan. Secara khusus, operasi ini akan menghapus opsi penargetan yang ditetapkan yang diberikan dalam BulkEditAdGroupAssignedTargetingOptionsRequest.delete_requests dari setiap grup iklan, lalu membuat opsi penargetan yang ditetapkan yang diberikan dalam BulkEditAdGroupAssignedTargetingOptionsRequest.create_requests.

Metode ini hanya didukung untuk grup iklan Peningkat Permintaan.

Permintaan HTTP

POST https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/adGroups:bulkEditAssignedTargetingOptions

URL ini menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
advertiserId

string (int64 format)

Wajib. ID pengiklan yang memiliki grup iklan.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "adGroupIds": [
    string
  ],
  "deleteRequests": [
    {
      object (DeleteAssignedTargetingOptionsRequest)
    }
  ],
  "createRequests": [
    {
      object (CreateAssignedTargetingOptionsRequest)
    }
  ]
}
Kolom
adGroupIds[]

string (int64 format)

Wajib. ID grup iklan yang akan memiliki opsi penargetan yang ditetapkan. Anda dapat menentukan maksimum 25 ID grup iklan.
deleteRequests[]

object (DeleteAssignedTargetingOptionsRequest)

Opsional. Opsi penargetan yang ditetapkan untuk dihapus secara batch, ditentukan sebagai daftar DeleteAssignedTargetingOptionsRequest.

Jenis penargetan yang didukung:

  • TARGETING_TYPE_AGE_RANGE
  • TARGETING_TYPE_APP
  • TARGETING_TYPE_APP_CATEGORY
  • TARGETING_TYPE_AUDIENCE_GROUP
  • TARGETING_TYPE_CATEGORY
  • TARGETING_TYPE_GENDER
  • TARGETING_TYPE_GEO_REGION
  • TARGETING_TYPE_HOUSEHOLD_INCOME
  • TARGETING_TYPE_KEYWORD
  • TARGETING_TYPE_LANGUAGE
  • TARGETING_TYPE_PARENTAL_STATUS
  • TARGETING_TYPE_URL
  • TARGETING_TYPE_YOUTUBE_CHANNEL
  • TARGETING_TYPE_YOUTUBE_VIDEO
createRequests[]

object (CreateAssignedTargetingOptionsRequest)

Opsional. Opsi penargetan yang ditetapkan untuk dibuat secara batch, yang ditentukan sebagai daftar CreateAssignedTargetingOptionRequest.

Jenis penargetan yang didukung:

  • TARGETING_TYPE_AGE_RANGE
  • TARGETING_TYPE_APP
  • TARGETING_TYPE_APP_CATEGORY
  • TARGETING_TYPE_AUDIENCE_GROUP
  • TARGETING_TYPE_CATEGORY
  • TARGETING_TYPE_GENDER
  • TARGETING_TYPE_GEO_REGION
  • TARGETING_TYPE_HOUSEHOLD_INCOME
  • TARGETING_TYPE_KEYWORD
  • TARGETING_TYPE_LANGUAGE
  • TARGETING_TYPE_PARENTAL_STATUS
  • TARGETING_TYPE_URL
  • TARGETING_TYPE_YOUTUBE_CHANNEL
  • TARGETING_TYPE_YOUTUBE_VIDEO

Isi respons

Pesan respons untuk adGroups.bulkEditAssignedTargetingOptions.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "updatedAdGroupIds": [
    string
  ],
  "failedAdGroupIds": [
    string
  ],
  "errors": [
    {
      object (Status)
    }
  ]
}
Kolom
updatedAdGroupIds[]

string (int64 format)

Hanya output. ID grup iklan yang berhasil diperbarui.
failedAdGroupIds[]

string (int64 format)

Hanya output. ID grup iklan yang gagal diperbarui.
errors[]

object (Status)

Hanya output. Informasi error untuk setiap grup iklan yang gagal diperbarui.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/display-video

Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.