Method: targetingTypes.targetingOptions.search

Belirtilen arama terimlerine göre belirli bir türdeki hedefleme seçeneklerini arar.

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
targetingType

enum (TargetingType)

Zorunlu. Alınacak hedefleme seçeneklerinin türü.

Kabul edilen değerler şunlardır:

  • TARGETING_TYPE_GEO_REGION
  • TARGETING_TYPE_POI
  • TARGETING_TYPE_BUSINESS_CHAIN

İstek içeriği

İstek gövdesi, aşağıdaki yapıyla birlikte veriler içerir:

JSON gösterimi 
{
  "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.
}
Alanlar
advertiserId

string (int64 format)

Zorunlu. Reklamveren, bu talebi şu bağlam bağlamında yapıyor.
pageSize

integer

İstenen sayfa boyutu. 1 ile 200 arasında olmalıdır. Belirtilmemişse varsayılan olarak 100 olur. Geçersiz bir değer belirtilirse INVALID_ARGUMENT hata kodunu döndürür.
pageToken

string

Sunucunun döndürmesi gereken sonuçların yer aldığı sayfayı tanımlayan bir jeton. Genellikle bu, targetingOptions.search yöntemine yapılan önceki çağrıdan döndürülen nextPageToken değeridir. Belirtilmezse sonuçların ilk sayfası döndürülür.
search_terms alanı. Hedefleme seçeneklerinin aranacağı sorgular. search_terms alanında yalnızca bir alan doldurulabilir ve bu alan targeting_type alanına karşılık gelmelidir. search_terms şunlardan yalnızca biri olabilir:
poiSearchTerms

object (PoiSearchTerms)

ÖY hedefleme seçenekleri için arama terimleri. Yalnızca targetingType, TARGETING_TYPE_POI olduğunda kullanılabilir.
businessChainSearchTerms

object (BusinessChainSearchTerms)

İşletme Zinciri hedefleme seçenekleri için arama terimleri. Yalnızca targetingType, TARGETING_TYPE_BUSINESS_CHAIN olduğunda kullanılabilir.
geoRegionSearchTerms

object (GeoRegionSearchTerms)

Coğrafi bölge hedefleme seçenekleri için arama terimleri. Yalnızca targetingType, TARGETING_TYPE_GEO_REGION olduğunda kullanılabilir.

Yanıt gövdesi

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

targetingOptions.search için yanıt mesajı.

JSON gösterimi 
{
  "targetingOptions": [
    {
      object (TargetingOption)
    }
  ],
  "nextPageToken": string
}
Alanlar
targetingOptions[]

object (TargetingOption)

Arama ölçütleriyle eşleşen hedefleme seçeneklerinin listesi.

Boş bırakılırsa bu liste görünmez.
nextPageToken

string

Sonraki sonuç sayfasını almak için jeton. Sonraki sonuç sayfasını almak için bu değeri, targetingOptions.search yöntemine yapılan sonraki çağrıdaki pageToken alanına geçirin.

Yetkilendirme Kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleye bakın.

PoiSearchTerms

ÖY hedefleme seçenekleri için arama terimleri.

JSON gösterimi 
{
  "poiQuery": string
}
Alanlar
poiQuery

string

İstenen ÖY adı, açık adres veya koordinatı için arama sorgusu. Sorgu bir önek olabilir, ör. "Saat squar", "40.7505045,-73.99562", "315 W 44.St" vb.

BusinessChainSearchTerms

İşletme Zinciri hedefleme seçenekleri için arama terimleri.

Alanlardan en az biri doldurulmalıdır.

JSON gösterimi 
{
  "businessChainQuery": string,
  "regionQuery": string
}
Alanlar
businessChainQuery

string

İstenen işletme zinciri için arama sorgusu. Sorgu, işletmenin tam adı (ör. "KFC", "mercedes-benz") olmalıdır.
regionQuery

string

İstenen coğrafi bölge için arama sorgusu, ör. "Seattle", "ABD".

GeoRegionSearchTerms

Coğrafi bölge hedefleme seçenekleri için arama terimleri.

JSON gösterimi 
{
  "geoRegionQuery": string
}
Alanlar
geoRegionQuery

string

İstenen coğrafi bölge için arama sorgusu. Sorgu bir önek (ör. "Yeni Yıl", "İstanbul", "ABD" vb.) olabilir.