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/v2/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

İsteğin gövdesi, aşağıdaki yapıya sahip 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. Bu talep, şu bağlam çerçevesinde gönderilmektedir.
pageSize

integer

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

string

Sunucunun döndürmesi gereken sonuçların bulunduğu sayfayı 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.
Birleştirme alanı search_terms. Hedefleme seçeneklerinin aranacağı sorgular. search_terms alanında yalnızca bir alan doldurulabilir. Bu alan, targeting_type değerine 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 yer almayacak.
nextPageToken

string

Sonraki sonuç sayfasını almak için jeton. Bir sonraki sonuç sayfasını almak için bu değeri, bir sonraki targetingOptions.search yöntemi çağrısında 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 istenen ÖY'nin koordinatı için arama sorgusu. Sorgu bir önek (ör. "Squar", "40.7505045,-73.99562", "315 W 44. St" vb.) olabilir.

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ı (ör. "KFC", "mercedes-benz") olmalıdır.
regionQuery

string

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

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. "New Yor", "Seattle", "USA" vb.) olabilir.