Method: targetingTypes.targetingOptions.search

Belirtilen arama terimlerine göre belirli bir türdeki hedefleme seçenekleri için arama yapar.

HTTP isteği

POST https://displayvideo.googleapis.com/v3/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ıya sahip 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 talebin yapıldığı 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 sonuçların yer aldığı sayfayı tanımlayan jeton. Genellikle bu, targetingOptions.search yöntemine önceki çağrıdan döndürülen nextPageToken değeridir. Belirtilmezse sonuçların ilk sayfası döndürülür.
Birleştirme alanı search_terms. Hedefleme seçeneklerinin aranacağı sorgular. search_terms alanında yalnızca bir alan doldurulabilir. 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

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

string

Sonuçların sonraki sayfasını almak için jeton. Sonraki sonuç sayfasını almak için bu değeri, targetingOptions.search yöntemine yapılan bir sonraki çağrıda 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 (OAuth 2.0'a Genel Bakış) sayfasına göz atın.

PoiSearchTerms

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

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

string

İstenen ÖY adı, açık adresi veya istenen ÖY'nin koordinatına ilişkin arama sorgusu. Sorgu bir ön ek (ör. "Timesquar", "40.7505045,-73.99562", "315 W 44th St" vb.

BusinessChainSearchTerms

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

Alanların 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ı 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çenekleri için arama terimleri.

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

string

İstenen coğrafi bölgenin arama sorgusu. Sorgu bir ön ek (ör. "İstanbul", "İstanbul" vb.