Method: advertisers.reachForecast.retrievePlannableUserInterests

Mengambil Audiens Google (Minat Pengguna) yang tersedia untuk perkiraan.

Permintaan HTTP

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

URL ini menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
advertiserId

string (int64 format)

Wajib. ID pengiklan untuk mencantumkan minat pengguna yang dapat direncanakan.

Parameter kueri

Parameter
productCategory

enum (PlannableProductCategory)

Wajib. Kategori produk untuk mengambil minat pengguna yang dapat direncanakan.

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Respons untuk reachForecast.retrievePlannableUserInterests.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "plannableUserInterests": [
    {
      object (PlannableUserInterest)
    }
  ]
}
Kolom
plannableUserInterests[]

object (PlannableUserInterest)

Daftar minat pengguna yang dapat direncanakan (Audiens Google).

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.

PlannableUserInterest

Minat pengguna yang dapat direncanakan dan digunakan untuk penargetan.

Representasi JSON 
{
  "userInterestDisplayName": string,
  "userInterestPath": string,
  "userInterestType": string,
  "userInterest": {
    object (UserInterest)
  }
}
Kolom
userInterestDisplayName

string

Hanya output. Nama tampilan minat, misalnya "Penggemar Aktivitas Luar Ruangan".
userInterestPath

string

Hanya output. Jalur kategori minat.
userInterestType

string

Hanya output. Jenis audiens, misalnya, "AFFINITY", "IN_MARKET".
userInterest

object (UserInterest)

Hanya output. ID untuk minat pengguna.

[productCategory][] yang ditentukan dalam permintaan menentukan kolom yang diisi dalam objek.

  • [userInterestCategory][] diisi untuk "YouTube".
  • [userInterestUserList][] diisi untuk "Lelang Terbuka".

UserInterest

ID untuk minat pengguna.

Representasi JSON 
{
  "userInterestCategory": string,
  "userInterestUserList": string
}
Kolom
userInterestCategory

string

Hanya output. Nama resource kategori minat. Diisi saat productCategory adalah "YouTube". Format: customers/{customerId}/userInterests/{user_interest_id}
userInterestUserList

string

Hanya output. Nama resource daftar pengguna. Diisi saat productCategory adalah "Lelang Terbuka". Format: customers/{customerId}/userLists/{user_list_id}