Method: targetingTypes.targetingOptions.search

Wyszukuje opcje kierowania danego typu na podstawie podanych wyszukiwanych słów.

Żądanie HTTP

POST https://displayvideo.googleapis.com/v2/targetingTypes/{targetingType}/targetingOptions:search

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
targetingType

enum (TargetingType)

Wymagane. Typ opcji kierowania do pobrania.

Akceptowane wartości:

  • TARGETING_TYPE_GEO_REGION
  • TARGETING_TYPE_POI
  • TARGETING_TYPE_BUSINESS_CHAIN

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "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.
}
Pola
advertiserId

string (int64 format)

Wymagane. Reklamodawca, którego dotyczy prośba.
pageSize

integer

Żądany rozmiar strony. Wymagana wartość z zakresu od 1 do 200. Jeśli nie określono inaczej, domyślna wartość to 100. Zwraca kod błędu INVALID_ARGUMENT w przypadku określenia nieprawidłowej wartości.
pageToken

string

Token identyfikujący stronę wyników, którą serwer powinien zwrócić. Zwykle jest to wartość nextPageToken zwrócona z poprzedniego wywołania metody targetingOptions.search. Jeśli nie określono tego ustawienia, zostanie zwrócona pierwsza strona wyników.
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

object (PoiSearchTerms)

Wyszukiwane hasła dotyczące opcji kierowania ważnych miejsc. Z tej opcji można korzystać tylko wtedy, gdy pole targetingType ma wartość TARGETING_TYPE_POI.
businessChainSearchTerms

object (BusinessChainSearchTerms)

Wyszukiwane hasła dotyczące opcji kierowania na sieć placówek. Z tej opcji można korzystać tylko wtedy, gdy pole targetingType ma wartość TARGETING_TYPE_BUSINESS_CHAIN.
geoRegionSearchTerms

object (GeoRegionSearchTerms)

Wyszukiwane hasła dotyczące opcji kierowania na region geograficzny. Z tej opcji można korzystać tylko wtedy, gdy pole targetingType ma wartość TARGETING_TYPE_GEO_REGION.

Treść odpowiedzi

Wiadomość z odpowiedzią dla: targetingOptions.search.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "targetingOptions": [
    {
      object (TargetingOption)
    }
  ],
  "nextPageToken": string
}
Pola
targetingOptions[]

object (TargetingOption)

Lista opcji kierowania pasujących do kryteriów wyszukiwania.

Jeśli lista będzie pusta, nie będzie ona dostępna.
nextPageToken

string

Token do pobrania następnej strony wyników. Przekaż tę wartość w polu pageToken w kolejnym wywołaniu metody targetingOptions.search, aby pobrać następną stronę wyników.

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

string

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

string

Zapytanie dotyczące wybranej sieci placówek. W zapytaniu musi znajdować się pełna nazwa firmy, np. „KFC”, „mercedes-benz”.
regionQuery

string

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

string

Zapytanie dotyczące żądanego regionu geograficznego. Zapytanie może być prefiksem, np. „Gdańsk”, „Poznań”, „Polska” itd.