Method: targetingTypes.targetingOptions.search

Es wird nach Targeting-Optionen eines bestimmten Typs anhand der angegebenen Suchbegriffe gesucht.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
targetingType

enum (TargetingType)

Erforderlich. Die Art der Targeting-Optionen, die abgerufen werden sollen.

Zulässige Werte:

  • TARGETING_TYPE_GEO_REGION
  • TARGETING_TYPE_POI
  • TARGETING_TYPE_BUSINESS_CHAIN

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "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.
}
Felder
advertiserId

string (int64 format)

Erforderlich. Der Werbetreibende, in dessen Kontext diese Anfrage gestellt wird.
pageSize

integer

Angeforderte Seitengröße. Muss zwischen 1 und 200 liegen. Wenn nicht angegeben, wird standardmäßig 100 verwendet. Wenn ein ungültiger Wert angegeben wird, wird der Fehlercode INVALID_ARGUMENT zurückgegeben.
pageToken

string

Ein Token, das eine Ergebnisseite identifiziert, die der Server liefern soll. Normalerweise ist dies der Wert von nextPageToken, der vom vorherigen Aufruf der targetingOptions.search-Methode zurückgegeben wurde. Wenn keine Angabe erfolgt, wird die erste Ergebnisseite zurückgegeben.
Union-Feld search_terms. Suchanfragen nach Targeting-Optionen. In search_terms darf nur ein Feld ausgefüllt werden und es muss mit targeting_type übereinstimmen. Für search_terms ist nur einer der folgenden Werte zulässig:
poiSearchTerms

object (PoiSearchTerms)

Suchbegriffe für POI-Targeting-Optionen Kann nur verwendet werden, wenn targetingType TARGETING_TYPE_POI ist.
businessChainSearchTerms

object (BusinessChainSearchTerms)

Suchbegriffe für Targeting-Optionen für Handelsketten. Kann nur verwendet werden, wenn targetingType TARGETING_TYPE_BUSINESS_CHAIN ist.
geoRegionSearchTerms

object (GeoRegionSearchTerms)

Suchbegriffe für Optionen für das geografische Targeting Kann nur verwendet werden, wenn targetingType TARGETING_TYPE_GEO_REGION ist.

Antworttext

Antwortnachricht für targetingOptions.search.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "targetingOptions": [
    {
      object (TargetingOption)
    }
  ],
  "nextPageToken": string
}
Felder
targetingOptions[]

object (TargetingOption)

Die Liste der Targeting-Optionen, die den Suchkriterien entsprechen.

Wenn die Liste leer ist, ist sie nicht vorhanden.
nextPageToken

string

Ein Token, mit dem die nächste Ergebnisseite abgerufen werden kann. Übergeben Sie diesen Wert im Feld pageToken im nachfolgenden Aufruf der Methode targetingOptions.search, um die nächste Ergebnisseite abzurufen.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/display-video

Weitere Informationen finden Sie unter OAuth 2.0 Overview.

PoiSearchTerms

Suchbegriffe für POI-Targeting-Optionen

JSON-Darstellung 
{
  "poiQuery": string
}
Felder
poiQuery

string

Die Suchanfrage nach dem Namen, der Adresse oder den Koordinaten des gewünschten POI. Die Suchanfrage kann ein Präfix sein, z.B. „Times Sq“, „40.7505045,-73.99562“ oder „315 W 44th St“.

BusinessChainSearchTerms

Suchbegriffe für Targeting-Optionen für Handelsketten.

Mindestens eines der Felder muss ausgefüllt werden.

JSON-Darstellung 
{
  "businessChainQuery": string,
  "regionQuery": string
}
Felder
businessChainQuery

string

Die Suchanfrage für die gewünschte Unternehmenskette. Die Suchanfrage muss der vollständige Name des Unternehmens sein, z.B. „KFC“ oder „mercedes-benz“.
regionQuery

string

Die Suchanfrage für die gewünschte Region, z.B. „Berlin“ oder „Deutschland“.

GeoRegionSearchTerms

Suchbegriffe für Optionen für das Targeting auf Regionen.

JSON-Darstellung 
{
  "geoRegionQuery": string
}
Felder
geoRegionQuery

string

Die Suchanfrage für die gewünschte Region. Die Suchanfrage kann ein Präfix sein, z.B. „New Yor“, „Seattle“ oder „USA“.