- Żą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 słów.
Żądanie HTTP
POST https://displayvideo.googleapis.com/v3/targetingTypes/{targetingType}/targetingOptions:search
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
Parametry | |
---|---|
targetingType |
Wymagane. Typ opcji kierowania do pobrania. Akceptowane wartości:
|
Treść żądania
Treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{ "advertiserId": string, "pageSize": integer, "pageToken": string, // Union field |
Pola | |
---|---|
advertiserId |
Wymagane. Reklamodawca, którego dotyczy prośba. |
pageSize |
Żądany rozmiar strony. Wymagana wartość z zakresu od |
pageToken |
Token identyfikujący stronę wyników, którą serwer powinien zwrócić. Zwykle jest to wartość |
Pole sumy search_terms . Zapytania, według których wyszukiwane są opcje kierowania. W tabeli 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 ważnych miejsc. Z tej opcji można korzystać tylko wtedy, gdy pole |
businessChainSearchTerms |
Wyszukiwane hasła dotyczące opcji kierowania na sieć placówek. Z tej opcji można korzystać tylko wtedy, gdy pole |
geoRegionSearchTerms |
Wyszukiwane hasła dotyczące opcji kierowania na region geograficzny. Z tej opcji można korzystać tylko wtedy, gdy pole |
Treść odpowiedzi
Wiadomość z odpowiedzią dla: targetingOptions.search
.
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{
"targetingOptions": [
{
object ( |
Pola | |
---|---|
targetingOptions[] |
Lista opcji kierowania pasujących do kryteriów wyszukiwania. Jeśli lista będzie pusta, nie będzie ona dostępna. |
nextPageToken |
Token do pobrania następnej strony wyników. Przekaż tę wartość w polu |
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 ważnych miejsc.
Zapis JSON |
---|
{ "poiQuery": string } |
Pola | |
---|---|
poiQuery |
Zapytanie wyszukiwania nazwy ciekawego miejsca, adresu lub współrzędnych tego ciekawego miejsca. Zapytanie może być prefiksem, np. „Skwaria”, „40.7505045,-73.99562”, „315 W 44th St” itp. |
BusinessChainSearchTerms
Wyszukiwane hasła dotyczące opcji kierowania na sieć placówek.
Musisz wypełnić co najmniej jedno pole.
Zapis JSON |
---|
{ "businessChainQuery": string, "regionQuery": string } |
Pola | |
---|---|
businessChainQuery |
Zapytanie dotyczące wybranej sieci placówek. W zapytaniu musi znajdować się pełna nazwa firmy, np. „KFC”, „mercedes-benz”. |
regionQuery |
Zapytanie dotyczące żądanego regionu geograficznego, na przykład „Seattle”, „Stany Zjednoczone”. |
GeoRegionSearchTerms
Wyszukiwane hasła dotyczące opcji kierowania na region geograficzny.
Zapis JSON |
---|
{ "geoRegionQuery": string } |
Pola | |
---|---|
geoRegionQuery |
Zapytanie dotyczące żądanego regionu geograficznego. Zapytanie może być prefiksem, np. „Gdańsk”, „Poznań”, „Polska” itd. |