Method: targetingTypes.targetingOptions.search

Menelusuri opsi penargetan jenis tertentu berdasarkan istilah penelusuran yang ditentukan.

Permintaan HTTP

POST https://displayvideo.googleapis.com/v1/targetingTypes/{targetingType}/targetingOptions:search

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
targetingType

enum (TargetingType)

Wajib. Jenis opsi penargetan yang akan diambil.

Nilai yang diterima adalah:

  • TARGETING_TYPE_GEO_REGION
  • TARGETING_TYPE_POI
  • TARGETING_TYPE_BUSINESS_CHAIN

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "advertiserId": string,
  "pageSize": integer,
  "pageToken": string,

  // Union field search_terms can be only one of the following:
  "poiSearchTerms": {
    object (PoiSearchTerms)
  },
  "businessChainSearchTerms": {
    object (BusinessChainSearchTerms)
  },
  "geoRegionSearchTerms": {
    object (GeoRegionSearchTerms)
  }
  // End of list of possible types for union field search_terms.
}
Kolom
advertiserId

string (int64 format)

Wajib. Pengiklan membuat permintaan ini dalam konteks.
pageSize

integer

Ukuran halaman yang diminta. Harus antara 1 dan 200. Jika tidak ditentukan akan ditetapkan secara default ke 100. Menampilkan kode error INVALID_ARGUMENT jika nilai yang ditentukan tidak valid.
pageToken

string

Token yang mengidentifikasi halaman hasil yang harus ditampilkan server. Biasanya, ini adalah nilai nextPageToken yang ditampilkan dari panggilan sebelumnya ke metode targetingOptions.search. Jika tidak ditentukan, halaman pertama hasil akan ditampilkan.
Kolom union search_terms. Kueri yang digunakan untuk menelusuri opsi penargetan. Hanya satu kolom di search_terms yang dapat diisi, dan harus sesuai dengan targeting_type. search_terms hanya dapat berupa salah satu dari berikut:
poiSearchTerms

object (PoiSearchTerms)

Istilah penelusuran untuk opsi penargetan POI. Hanya dapat digunakan jika targetingType adalah TARGETING_TYPE_POI.
businessChainSearchTerms

object (BusinessChainSearchTerms)

Istilah penelusuran untuk opsi penargetan Jaringan Bisnis. Hanya dapat digunakan jika targetingType adalah TARGETING_TYPE_BUSINESS_CHAIN.
geoRegionSearchTerms

object (GeoRegionSearchTerms)

Istilah penelusuran untuk opsi penargetan wilayah geografis. Hanya dapat digunakan jika targetingType adalah TARGETING_TYPE_GEO_REGION.

Isi respons

Jika berhasil, isi respons memuat data dengan struktur berikut:

Pesan respons untuk targetingOptions.search.

Representasi JSON 
{
  "targetingOptions": [
    {
      object (TargetingOption)
    }
  ],
  "nextPageToken": string
}
Kolom
targetingOptions[]

object (TargetingOption)

Daftar opsi penargetan yang cocok dengan kriteria penelusuran.

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 targetingOptions.search untuk mengambil halaman hasil berikutnya.

Cakupan Otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

PoiSearchTerms

Istilah penelusuran untuk opsi penargetan POI.

Representasi JSON 
{
  "poiQuery": string
}
Kolom
poiQuery

string

Kueri penelusuran untuk nama POI, alamat, atau koordinat POI yang diinginkan. Kueri dapat berupa awalan, misalnya "Times squar", "40.7505045,-73.99562", "315 W 44th St", dll.

BusinessChainSearchTerms

Istilah penelusuran untuk opsi penargetan Jaringan Bisnis.

Setidaknya salah satu kolom harus diisi.

Representasi JSON 
{
  "businessChainQuery": string,
  "regionQuery": string
}
Kolom
businessChainQuery

string

Kueri penelusuran untuk rantai bisnis yang diinginkan. Kueri harus berupa nama lengkap bisnis, misalnya "KFC", "mercedes-benz".
regionQuery

string

Kueri penelusuran untuk wilayah geografis yang diinginkan, misalnya "Seattle", "United State".

GeoRegionSearchTerms

Istilah penelusuran untuk opsi penargetan wilayah geografis.

Representasi JSON 
{
  "geoRegionQuery": string
}
Kolom
geoRegionQuery

string

Kueri penelusuran untuk wilayah geografis yang diinginkan. Kueri dapat berupa awalan, misalnya "New Yor", "Seattle", "USA", dll.