Method: targetingTypes.targetingOptions.search

Belirli arama terimlerine göre belirli bir türde hedefleme seçenekleri 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 içeriği

İstek metni aşağıdaki yapıyla birlikte verileri 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. Bu isteğin bağlamında yer alan reklamveren.
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 bir sonuç sayfasını tanımlayan jeton. Genellikle bu, targetingOptions.search yöntemine yapılan önceki çağrıdan döndürülen nextPageToken değerini ifade eder. Belirtilmemişse sonuçların ilk sayfası döndürülür.
Birlik alanı search_terms. Hedefleme seçeneklerini aranacak sorgular. search_terms alanında yalnızca bir alan doldurulabilir ve bu alan targeting_type alanına karşılık gelmelidir. search_terms yalnızca aşağıdakilerden 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

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 bulunmaz.
nextPageToken

string

Sonuçların bir sonraki sayfasını almak için kullanılan jeton. Sonuçların bir sonraki sayfasını almak için targetingOptions.search yönteminin sonraki çağrısında 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çenekleri için arama terimleri.

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

string

İstenilen ÖY'nin adı, açık adresi veya koordinatı için arama sorgusu. Sorgu bir ön ek 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 işletme zinciri için arama sorgusu. Sorgu, işletmenin tam adıdır (ör. "KFC", "mercedes-benz").
regionQuery

string

İstenen coğrafi bölgenin arama sorgusu (ör. "Seattle", "Amerika Birleşik Devletleri").

GeoRegionSearchTerms

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

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

string

İstediğiniz coğrafi bölgenin arama sorgusu. Sorgu bir ön ek olabilir (ör. "New Yor", "Seattle", "USA" vb.).