- Żądanie HTTP
- Parametry ścieżki
- Treść żądania
- Treść odpowiedzi
- Zakresy autoryzacji
- PoiSearchTerms
- BusinessChainSearchTerms
- GeoRegionSearchTerms
- Wypróbuj
Wyszukuje opcje kierowania danego typu na podstawie podanych wyszukiwanych haseł.
Żądanie HTTP
POST https://displayvideo.googleapis.com/v1/targetingTypes/{targetingType}/targetingOptions:search
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
Parametry | |
---|---|
targetingType |
To pole jest wymagane. Typ opcji kierowania do pobrania. Akceptowane wartości to:
|
Treść żądania
Treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{ "advertiserId": string, "pageSize": integer, "pageToken": string, // Union field |
Pola | |
---|---|
advertiserId |
To pole jest wymagane. Reklamodawca, którego dotyczy ta prośba, |
pageSize |
Żądany rozmiar strony. Wartość musi mieścić się w zakresie od |
pageToken |
Token określający stronę z wynikami zwracanymi przez serwer. Zwykle jest to wartość |
Pole sumy search_terms . Zapytania, według których mają być wyszukiwane opcje kierowania. W polu search_terms można wypełnić tylko jedno pole, które musi odpowiadać wartości targeting_type . search_terms może mieć tylko jedną z tych wartości: |
|
poiSearchTerms |
Wyszukiwane hasła dotyczące opcji kierowania na ciekawe miejsca. Można jej używać tylko wtedy, gdy |
businessChainSearchTerms |
Wyszukiwane hasła dotyczące opcji kierowania na sieć placówek. Można jej używać tylko wtedy, gdy |
geoRegionSearchTerms |
Wyszukiwane hasła dotyczące opcji kierowania na regiony geograficzne. Można jej używać tylko wtedy, gdy |
Treść odpowiedzi
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
Wiadomość z odpowiedzią na temat: targetingOptions.search
.
Zapis JSON |
---|
{
"targetingOptions": [
{
object ( |
Pola | |
---|---|
targetingOptions[] |
Lista opcji kierowania pasujących do kryteriów wyszukiwania. Tej listy nie będzie, jeśli będzie pusta. |
nextPageToken |
Token do pobierania następnej strony wyników. W kolejnym wywołaniu metody |
Zakresy autoryzacji
Wymaga następującego zakresu OAuth:
https://www.googleapis.com/auth/display-video
Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.
PoiSearchTerms
Wyszukiwane hasła dotyczące opcji kierowania na ciekawe miejsca.
Zapis JSON |
---|
{ "poiQuery": string } |
Pola | |
---|---|
poiQuery |
Zapytanie o nazwę ważnego miejsca, jego adres lub współrzędne. Zapytanie może być prefiksem, np. „Times Square”, „40.7505045,-73.99562”, „315 W 44th St” itp. |
BusinessChainSearchTerms
Wyszukiwane hasła dotyczące opcji kierowania na sieć placówek.
Należy wypełnić co najmniej jedno pole.
Zapis JSON |
---|
{ "businessChainQuery": string, "regionQuery": string } |
Pola | |
---|---|
businessChainQuery |
Zapytanie dotyczące wybranej sieci firmowej. Zapytanie musi zawierać pełną nazwę firmy, np. „KFC”, „mercedes-benz”. |
regionQuery |
Zapytanie dotyczące wybranego regionu geograficznego, np. „Seattle” lub „Stany Zjednoczone”. |
GeoRegionSearchTerms
Wyszukiwane hasła dotyczące opcji kierowania na regiony geograficzne.
Zapis JSON |
---|
{ "geoRegionQuery": string } |
Pola | |
---|---|
geoRegionQuery |
Zapytanie dotyczące wybranego regionu geograficznego. Zapytanie może być prefiksem, np. „New Yor”, „Seattle”, „USA” itp. |