- HTTP isteği
- Yol parametreleri
- İstek metni
- Yanıt metni
- Yetkilendirme kapsamları
- PoiSearchTerms
- BusinessChainSearchTerms
- GeoRegionSearchTerms
- Deneyin.
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 |
Zorunlu. Alınacak hedefleme seçeneklerinin türü. Kabul edilen değerler şunlardır:
|
İ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 |
Alanlar | |
---|---|
advertiserId |
Zorunlu. Bu talep, şu bağlam çerçevesinde gönderilmektedir. |
pageSize |
İstenen sayfa boyutu. |
pageToken |
Sunucunun döndürmesi gereken sonuçların bulunduğu 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 değerine 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 yer almayacak. |
nextPageToken |
Sonraki sonuç sayfasını almak için jeton. Bir sonraki sonuç sayfasını almak için bu değeri, bir sonraki |
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 |
İ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 |
İstenen işletme zinciri için arama sorgusu. Sorgu, işletmenin tam adı (ör. "KFC", "mercedes-benz") olmalıdır. |
regionQuery |
İ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 |
İstenen coğrafi bölge için arama sorgusu. Sorgu bir önek (ör. "New Yor", "Seattle", "USA" vb.) olabilir. |