Method: advertisers.reachForecast.retrievePlannableProducts

Mengambil daftar produk yang dapat direncanakan untuk suatu lokasi.

Permintaan HTTP

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

URL ini menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
advertiserId

string (int64 format)

Wajib. ID pengiklan untuk mencantumkan produk yang dapat direncanakan.

Parameter kueri

Parameter
plannableLocationId

string

Wajib. ID lokasi yang dapat direncanakan.

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Respons untuk reachForecast.retrievePlannableProducts

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "productMetadata": [
    {
      object (ProductMetadata)
    }
  ]
}
Kolom
productMetadata[]

object (ProductMetadata)

Hanya output. Daftar metadata produk yang menunjukkan kemungkinan penargetan.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.

ProductMetadata

Metadata untuk produk yang dapat direncanakan.

Representasi JSON 
{
  "plannableProductDescription": string,
  "plannableProductCode": string,
  "plannableTargeting": {
    object (PlannableTargeting)
  },
  "displayName": string,
  "plannableProductCoreAttributes": {
    object (PlannableProductCoreAttributes)
  }
}
Kolom
plannableProductDescription

string

Hanya output. Deskripsi teks biasa produk iklan.
plannableProductCode

string

Hanya output. Kode produk yang dapat direncanakan (misalnya, "YOUTUBE_REACH_MIX").
plannableTargeting

object (PlannableTargeting)

Hanya output. Kemampuan penargetan yang tersedia untuk produk ini.
displayName

string

Hanya output. Nama yang terkait dengan produk iklan. Misalnya: "Kampanye jumlah tontonan Video".
plannableProductCoreAttributes

object (PlannableProductCoreAttributes)

Hanya output. Atribut inti untuk produk ini.

PlannableTargeting

Kemampuan penargetan untuk produk tertentu.

Representasi JSON 
{
  "ageRanges": [
    enum (PlannableAgeRange)
  ],
  "surfaceTargetingCombinations": {
    object (SurfaceTargetingCombinations)
  },
  "genders": [
    enum (Gender)
  ],
  "networks": [
    enum (PlannableNetwork)
  ],
  "devices": [
    enum (DeviceType)
  ],
  "youtubeSelectLineups": [
    {
      object (YouTubeSelectLineUp)
    }
  ],
  "defaultYoutubeSelectLineup": {
    object (YouTubeSelectLineUp)
  }
}
Kolom
ageRanges[]

enum (PlannableAgeRange)

Hanya output. Rentang usia yang dapat direncanakan yang diizinkan untuk produk. Penargetan sebenarnya dihitung dengan memetakan rentang usia ini ke penargetan usia Google standar.
surfaceTargetingCombinations

object (SurfaceTargetingCombinations)

Hanya output. Kombinasi platform yang dapat ditargetkan untuk produk iklan.
genders[]

enum (Gender)

Hanya output. Gender yang dapat ditargetkan untuk produk iklan.
networks[]

enum (PlannableNetwork)

Hanya output. Jaringan yang dapat ditargetkan untuk produk iklan.
devices[]

enum (DeviceType)

Hanya output. Perangkat yang dapat ditargetkan untuk produk iklan.
youtubeSelectLineups[]

object (YouTubeSelectLineUp)

Hanya output. Grup Channel YouTube Select yang dapat ditargetkan untuk produk iklan.
defaultYoutubeSelectLineup

object (YouTubeSelectLineUp)

Hanya output. Grup channel YouTube Select default untuk produk ini, jika berlaku.

SurfaceTargetingCombinations

Aturan penargetan platform.

Representasi JSON 
{
  "availableSurfaceTypes": [
    enum (PlannableSurface)
  ],
  "validSurfaceCombinations": [
    {
      object (SurfaceTargetingCombination)
    }
  ],
  "defaultSurfaceTypes": [
    enum (PlannableSurface)
  ]
}
Kolom
availableSurfaceTypes[]

enum (PlannableSurface)

Hanya output. Jenis platform yang tersedia.
validSurfaceCombinations[]

object (SurfaceTargetingCombination)

Hanya output. Kombinasi platform valid yang dapat dipilih bersama.
defaultSurfaceTypes[]

enum (PlannableSurface)

Hanya output. Jenis platform default untuk produk ini.

SurfaceTargetingCombination

Kombinasi platform yang valid.

Representasi JSON 
{
  "choices": [
    enum (PlannableSurface)
  ]
}
Kolom
choices[]

enum (PlannableSurface)

Hanya output. Kombinasi platform.

YouTubeSelectLineUp

Grup Channel YouTube Select yang Dapat Direncanakan untuk penargetan produk.

Representasi JSON 
{
  "lineupId": string,
  "displayName": string
}
Kolom
lineupId

string (int64 format)

Hanya output. ID Grup Channel YouTube Select.
displayName

string

Hanya output. Nama tampilan Grup Channel YouTube Select.

PlannableProductCoreAttributes

Atribut inti untuk produk yang dapat direncanakan.

Representasi JSON 
{
  "productCategory": enum (PlannableProductCategory),
  "buyingMethod": enum (PlannableBuyingMethod),
  "costModel": enum (PlannableCostModel)
}
Kolom
productCategory

enum (PlannableProductCategory)

Hanya output. Kategori produk.
buyingMethod

enum (PlannableBuyingMethod)

Hanya output. Metode pembelian.
costModel

enum (PlannableCostModel)

Hanya output. Model biaya.

PlannableBuyingMethod

Metode pembelian produk yang dapat direncanakan.

Enum
PLANNABLE_BUYING_METHOD_UNSPECIFIED Tidak ditentukan.
PLANNABLE_BUYING_METHOD_AUCTION Lelang.
PLANNABLE_BUYING_METHOD_RESERVATION Reservasi.

PlannableCostModel

Model biaya produk yang dapat direncanakan.

Enum
PLANNABLE_COST_MODEL_UNSPECIFIED Tidak ditentukan.
PLANNABLE_COST_MODEL_CPM Maks.
PLANNABLE_COST_MODEL_CPV CPV.
PLANNABLE_COST_MODEL_CPC CPC.
PLANNABLE_COST_MODEL_CPA CPA.