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/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 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 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 bir jeton. Bu genellikle 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 birleşik alanı. 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. search_terms aşağıdakilerden yalnızca biri olabilir:
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.

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 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 koordinatı 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 işletme zincirinin 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.).