Method: targetingTypes.targetingOptions.search

Wyszukuje opcje kierowania danego typu na podstawie podanych wyszukiwanych haseł.

Żą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)

To pole jest 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)

To pole jest wymagane. Reklamodawca, którego dotyczy ta prośba, dotyczy sytuacji.
pageSize

integer

Żądany rozmiar strony. Wartość musi mieścić się w zakresie od 1 do 200. Jeśli nie określono inaczej, domyślnie przyjmuje się wartość 100. Zwraca kod błędu INVALID_ARGUMENT, jeśli określono nieprawidłową wartość.
pageToken

string

Token identyfikujący stronę z wynikami, który powinien zwrócić serwer. Zwykle jest to wartość nextPageToken zwrócona z poprzedniego wywołania metody targetingOptions.search. Jeśli nie podasz żadnej wartości, wyświetlana będzie pierwsza strona wyników.
Pole sumy search_terms. Zapytania, według których mają zostać wyszukane opcje kierowania. W polu search_terms można wypełnić tylko jedno pole. Musi ono odpowiadać wartości targeting_type. search_terms może być tylko jedną z tych wartości:
poiSearchTerms

object (PoiSearchTerms)

Wyszukiwane hasła dotyczące opcji kierowania ciekawych miejsc. Można jej używać tylko wtedy, gdy targetingType ma wartość TARGETING_TYPE_POI.
businessChainSearchTerms

object (BusinessChainSearchTerms)

Wyszukiwane hasła dotyczące opcji kierowania na sieć placówek. Można jej używać tylko wtedy, gdy targetingType ma wartość TARGETING_TYPE_BUSINESS_CHAIN.
geoRegionSearchTerms

object (GeoRegionSearchTerms)

Wyszukiwane hasła dotyczące opcji kierowania na regiony geograficzne. Można jej używać tylko wtedy, gdy targetingType ma wartość TARGETING_TYPE_GEO_REGION.

Treść odpowiedzi

Odpowiedź na pytanie: 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 jest pusta, nie będzie jej widać.
nextPageToken

string

Token pobierający następną stronę wyników. W kolejnym wywołaniu metody targetingOptions.search przekaż tę wartość w polu pageToken, 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 omówieniu protokołu OAuth 2.0.

PoiSearchTerms

Wyszukiwane hasła dotyczące opcji kierowania ciekawych miejsc.

Zapis JSON 
{
  "poiQuery": string
}
Pola
poiQuery

string

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.

Musisz wypełnić co najmniej jedno pole.

Zapis JSON 
{
  "businessChainQuery": string,
  "regionQuery": string
}
Pola
businessChainQuery

string

Zapytanie dotyczące wybranej sieci firmowej. Zapytanie musi zawierać pełną nazwę firmy, np. „KFC”, „mercedes-benz”.
regionQuery

string

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

string

Zapytanie dotyczące wybranego regionu geograficznego. Zapytanie może być prefiksem, np. „Nowy Jork”, „Seattle”, „USA” itp.