Method: listPlannableProducts

Menampilkan daftar format iklan YouTube yang dapat direncanakan per lokasi dengan penargetan yang diizinkan.

Daftar error yang ditampilkan: AuthenticationError AuthorizationError HeaderError InternalError QuotaError RequestError

Permintaan HTTP

POST https://googleads.googleapis.com/v16:listPlannableProducts

URL menggunakan sintaksis gRPC Transcoding.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "plannableLocationId": string
}
Kolom
plannableLocationId

string

Wajib. ID lokasi yang dipilih untuk perencanaan. Untuk mencantumkan ID lokasi yang dapat direncanakan, gunakan ReachPlanService.ListPlannableLocations.

Isi respons

Respons dengan semua produk yang tersedia.

Jika berhasil, isi respons memuat data dengan struktur berikut:

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

object (ProductMetadata)

Daftar produk yang tersedia untuk perencanaan dan metadata penargetan terkait.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

  • https://www.googleapis.com/auth/adwords

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

ProductMetadata

Metadata yang terkait dengan produk yang dapat direncanakan yang tersedia.

Representasi JSON 
{
  "plannableProductName": string,
  "plannableTargeting": {
    object (PlannableTargeting)
  },
  "plannableProductCode": string
}
Kolom
plannableProductName

string

Nama yang terkait dengan produk iklan.
plannableTargeting

object (PlannableTargeting)

Penargetan terencana yang diizinkan untuk produk ini.
plannableProductCode

string

Kode yang terkait dengan produk iklan (misalnya: BUMPER, TRUEVIEW_IN_STREAM). Untuk mencantumkan kode produk yang dapat direncanakan, gunakan ReachPlanService.ListPlannableProducts.

PlannableTargeting

Penargetan yang metrik traffic-nya akan dilaporkan.

Representasi JSON 
{
  "ageRanges": [
    enum (ReachPlanAgeRange)
  ],
  "genders": [
    {
      object (GenderInfo)
    }
  ],
  "devices": [
    {
      object (DeviceInfo)
    }
  ],
  "networks": [
    enum (ReachPlanNetwork)
  ],
  "youtubeSelectLineups": [
    {
      object (YouTubeSelectLineUp)
    }
  ],
  "surfaceTargeting": {
    object (SurfaceTargetingCombinations)
  }
}
Kolom
ageRanges[]

enum (ReachPlanAgeRange)

Rentang usia yang dapat direncanakan yang diizinkan untuk produk yang metriknya akan dilaporkan. Penargetan sebenarnya dihitung dengan memetakan rentang usia ini ke nilai umum Google.AgeRangeInfo standar.
genders[]

object (GenderInfo)

Gender yang dapat ditargetkan untuk produk iklan.
devices[]

object (DeviceInfo)

Perangkat yang dapat ditargetkan untuk produk iklan. Penargetan perangkat TABLET diterapkan secara otomatis ke metrik yang dilaporkan saat penargetan MOBILE dipilih untuk produk CPM_MASTHEAD, GOOGLE_PREFERRED_BUMPER, dan GOOGLE_PREFERRED_SHORT.
networks[]

enum (ReachPlanNetwork)

Jaringan yang dapat ditargetkan untuk produk iklan.
youtubeSelectLineups[]

object (YouTubeSelectLineUp)

Grup Channel YouTube Select yang Dapat Ditargetkan untuk produk iklan.
surfaceTargeting

object (SurfaceTargetingCombinations)

Kombinasi platform yang dapat ditargetkan untuk produk iklan.

YouTubeSelectLineUp

Grup Channel YouTube Select yang Dapat Direncanakan untuk penargetan produk.

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

string (int64 format)

ID Grup Channel YouTube Select.
lineupName

string

Nama unik Grup Channel YouTube Select.

SurfaceTargetingCombinations

Kombinasi penargetan platform yang tersedia untuk produk iklan.

Representasi JSON 
{
  "defaultTargeting": {
    object (SurfaceTargeting)
  },
  "availableTargetingCombinations": [
    {
      object (SurfaceTargeting)
    }
  ]
}
Kolom
defaultTargeting

object (SurfaceTargeting)

Penargetan platform default diterapkan ke produk iklan.
availableTargetingCombinations[]

object (SurfaceTargeting)

Kombinasi target platform yang tersedia untuk produk iklan.