- HTTP isteği
- Yol parametreleri
- İstek gövdesi
- Yanıt metni
- Yetkilendirme kapsamları
- PoiSearchTerms
- BusinessChainSearchTerms
- GeoRegionSearchTerms
- Deneyin.
Belirtilen arama terimlerine göre belirli bir türdeki hedefleme seçenekleri için arama yapar.
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 |
Zorunlu. Alınacak hedefleme seçeneklerinin türü. Kabul edilen değerler şunlardır:
|
İ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 |
Alanlar | |
---|---|
advertiserId |
Zorunlu. Bu talebin yapıldığı reklamveren. |
pageSize |
İstenen sayfa boyutu. |
pageToken |
Sunucunun döndürmesi gereken sonuçların yer aldığı sayfayı tanımlayan jeton. Genellikle bu, |
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 |
ÖY hedefleme seçenekleri için arama terimleri. Yalnızca |
businessChainSearchTerms |
İşletme Zinciri hedefleme seçenekleri için arama terimleri. Yalnızca |
geoRegionSearchTerms |
Coğrafi bölge hedefleme seçenekleri için arama terimleri. Yalnızca |
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 ( |
Alanlar | |
---|---|
targetingOptions[] |
Arama ölçütleriyle eşleşen hedefleme seçeneklerinin listesi. Boşsa bu liste mevcut olmayacak. |
nextPageToken |
Sonuçların sonraki sayfasını almak için jeton. Sonraki sonuç sayfasını almak için bu değeri, |
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 |
İ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 |
İstenen işletme zinciri için arama sorgusu. Sorgu işletmenin tam adı olmalıdır, ör. "KFC", "mercedes-benz". |
regionQuery |
İ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 |
İstenen coğrafi bölgenin arama sorgusu. Sorgu bir ön ek (ör. "İstanbul", "İstanbul" vb. |