Method: advertisers.adAssets.list

Mencantumkan aset iklan berdasarkan ID pengiklan.

Hanya mendukung pengambilan aset AdAssetType AD_ASSET_TYPE_YOUTUBE_VIDEO.

Permintaan HTTP

GET https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/adAssets

URL ini menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
advertiserId

string (int64 format)

Wajib. ID pengiklan yang memiliki aset iklan.

Parameter kueri

Parameter
pageSize

integer

Opsional. Ukuran halaman yang diminta. Harus antara 1 dan 5000. Jika tidak ditentukan, defaultnya adalah 5000. Menampilkan kode error INVALID_ARGUMENT jika nilai yang tidak valid ditentukan.
pageToken

string

Opsional. Token yang mengidentifikasi halaman hasil yang harus ditampilkan server. Biasanya, ini adalah nilai nextPageToken yang ditampilkan dari panggilan sebelumnya ke metode adAssets.list. Jika tidak ditentukan, halaman pertama hasil akan ditampilkan.
orderBy

string

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

  • entityStatus
  • youtubeVideoAsset.youtubeVideoId
  • adAssetId (default)

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

string

Opsional. Memungkinkan pemfilteran hasil menurut kolom aset iklan.

Sintaksis yang didukung:

  • Pembatasan memiliki bentuk {field} {operator} {value}.
  • Semua kolom harus menggunakan operator EQUALS (=).

Kolom yang didukung:

  • youtubeVideoAsset.youtubeVideoId
  • entityStatus

Contoh:

  • Semua aset iklan video YouTube yang aktif di bawah pengiklan: entityStatus=ENTITY_STATUS_ACTIVE

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Pesan respons untuk adAssets.list.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "adAssets": [
    {
      object (AdAsset)
    }
  ],
  "nextPageToken": string
}
Kolom
adAssets[]

object (AdAsset)

Daftar aset iklan. Daftar hanya akan berisi aset AdAssetType AD_ASSET_TYPE_YOUTUBE_VIDEO.

Daftar ini tidak akan ada jika kosong.
nextPageToken

string

Token untuk mengambil halaman hasil berikutnya. Teruskan nilai ini di kolom pageToken dalam panggilan berikutnya ke metode adAssets.list untuk mengambil halaman hasil berikutnya.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.