Method: advertisers.insertionOrders.listAssignedTargetingOptions

Mencantumkan opsi penargetan yang ditetapkan dari perjanjian pemasangan iklan di berbagai jenis penargetan.

Permintaan HTTP

GET https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/insertionOrders/{insertionOrderId}:listAssignedTargetingOptions

URL ini menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
advertiserId

string (int64 format)

Wajib. ID pengiklan yang memiliki pesanan pemasangan iklan.

insertionOrderId

string (int64 format)

Wajib. ID perintah penyisipan untuk mencantumkan opsi penargetan yang ditetapkan.

Parameter kueri

Parameter
pageSize

integer

Ukuran halaman yang diminta. Ukuran harus berupa bilangan bulat antara 1 dan 5000. Jika tidak ditentukan, defaultnya adalah 5000. Menampilkan kode error INVALID_ARGUMENT jika nilai yang ditentukan tidak valid.

pageToken

string

Token yang memungkinkan klien mengambil halaman hasil berikutnya. Biasanya, ini adalah nilai nextPageToken yang ditampilkan dari panggilan sebelumnya ke metode BulkListInsertionOrderAssignedTargetingOptions. Jika tidak ditentukan, halaman pertama hasil akan ditampilkan.

orderBy

string

Kolom yang akan digunakan untuk mengurutkan daftar. Nilai yang dapat diterima adalah:

  • targetingType (default)

Urutan pengurutan default adalah menaik. Untuk menentukan urutan menurun untuk kolom, akhiran "desc" harus ditambahkan ke nama kolom. Contoh: targetingType desc.

filter

string

Memungkinkan pemfilteran menurut kolom opsi penargetan yang ditetapkan.

Sintaksis yang didukung:

  • Ekspresi filter terdiri dari satu atau beberapa batasan.
  • Batasan dapat digabungkan dengan operator logis OR.
  • Pembatasan memiliki bentuk {field} {operator} {value}.
  • Semua kolom harus menggunakan operator EQUALS (=).

Kolom yang didukung:

  • targetingType
  • inheritance

Contoh:

  • AssignedTargetingOption resource dengan jenis penargetan TARGETING_TYPE_PROXIMITY_LOCATION_LIST atau TARGETING_TYPE_CHANNEL: targetingType="TARGETING_TYPE_PROXIMITY_LOCATION_LIST" OR targetingType="TARGETING_TYPE_CHANNEL"
  • Resource AssignedTargetingOption dengan status pewarisan NOT_INHERITED atau INHERITED_FROM_PARTNER: inheritance="NOT_INHERITED" OR inheritance="INHERITED_FROM_PARTNER"

Panjang kolom ini tidak boleh lebih dari 500 karakter.

Lihat panduan permintaan LIST filter kami untuk mengetahui informasi selengkapnya.

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON
{
  "assignedTargetingOptions": [
    {
      object (AssignedTargetingOption)
    }
  ],
  "nextPageToken": string
}
Kolom
assignedTargetingOptions[]

object (AssignedTargetingOption)

Daftar opsi penargetan yang ditetapkan.

Daftar ini tidak akan ada jika kosong.

nextPageToken

string

Token yang mengidentifikasi halaman hasil berikutnya. Nilai ini harus ditentukan sebagai pageToken dalam BulkListInsertionOrderAssignedTargetingOptionsRequest berikutnya untuk mengambil halaman hasil berikutnya. Token ini tidak akan ada jika tidak ada lagi assignedTargetingOptions yang dapat ditampilkan.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.