Method: targetingTypes.targetingOptions.search

Belirli bir türdeki hedefleme seçeneklerini, belirtilen arama terimlerine göre arar.

HTTP isteği

POST https://displayvideo.googleapis.com/v4/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 metni

İstek içeriği aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "advertiserId": string,
  "pageSize": integer,
  "pageToken": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "poiSearchTerms": {
    object (PoiSearchTerms)
  },
  "businessChainSearchTerms": {
    object (BusinessChainSearchTerms)
  },
  "geoRegionSearchTerms": {
    object (GeoRegionSearchTerms)
  }
  // End of mutually exclusive fields.
}
Alanlar
advertiserId

string (int64 format)

Zorunlu. Bu isteğin bağlamında yapıldığı reklamveren.
pageSize

integer

İstenen sayfa boyutu. 1 ile 200 arasında olmalıdır. Belirtilmezse 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ç sayfasını tanımlayan 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.
Hedefleme seçeneklerini aramak için kullanılan sorgular. search_terms alanında yalnızca bir alan doldurulabilir ve bu alan targeting_type ile eşleşmelidir. Aşağıda, aynı anda kullanılamayan alanların listesi verilmiştir. Yanıt olarak en fazla bir alan ayarlanır:
poiSearchTerms

object (PoiSearchTerms)

ÖY hedefleme seçenekleriyle ilgili 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çenekleriyle ilgili arama terimleri. Yalnızca targetingType, TARGETING_TYPE_GEO_REGION olduğunda kullanılabilir.
Birbirini dışlayan alanların sonu.

Yanıt metni

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

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

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

object (TargetingOption)

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

Boşsa bu liste gösterilmez.
nextPageToken

string

Sonuçların sonraki sayfasını almak için kullanılan jeton. Sonraki sonuç sayfasını almak için targetingOptions.search yöntemine yapılan sonraki çağrıda bu değeri pageToken alanına iletin.

Yetkilendirme kapsamları

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

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

Daha fazla bilgi için OAuth 2.0 Overview sayfasına bakın.

PoiSearchTerms

ÖY hedefleme seçenekleriyle ilgili arama terimleri.

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

string

İstenen ÖY'nin adı, açık adresi veya koordinatları için arama sorgusu. Sorgu bir önek olabilir (ör. "Times squar", "40.7505045,-73.99562", "315 W 44th 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 zincir işletmenin arama sorgusu. Sorgu, işletmenin tam adı olmalıdır (ör. "KFC", "Mercedes-Benz").
regionQuery

string

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

GeoRegionSearchTerms

Coğrafi bölge hedefleme seçenekleriyle ilgili arama terimleri.

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

string

İstenen coğrafi bölge için arama sorgusu. Sorgu bir önek olabilir (ör. "New Yor", "Seattle", "ABD" vb.).