Method: targetingTypes.targetingOptions.search

Sucht basierend auf den angegebenen Suchbegriffen nach Targeting-Optionen eines bestimmten Typs.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
targetingType

enum (TargetingType)

Erforderlich. Der Typ der abzurufenden Targeting-Optionen.

Zulässige Werte sind:

  • 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 kein Wert angegeben ist, wird standardmäßig 100 verwendet. Gibt den Fehlercode INVALID_ARGUMENT zurück, wenn ein ungültiger Wert angegeben wird.
pageToken

string

Ein Token, das eine Ergebnisseite identifiziert, die der Server liefern soll. In der Regel ist dies der Wert von nextPageToken, der vom vorherigen Aufruf der targetingOptions.search-Methode zurückgegeben wurde. Wenn nicht angegeben, wird die erste Ergebnisseite zurückgegeben.
Union-Feld search_terms. Suchanfragen, mit denen nach Ausrichtungsoptionen gesucht werden soll Nur ein Feld in search_terms darf ausgefüllt werden und muss targeting_type entsprechen. Für search_terms ist nur einer der folgenden Werte zulässig:
poiSearchTerms

object (PoiSearchTerms)

Suchbegriffe für POI-Ausrichtungsoptionen. Kann nur verwendet werden, wenn targetingType den Wert TARGETING_TYPE_POI hat.
businessChainSearchTerms

object (BusinessChainSearchTerms)

Suchbegriffe für Ausrichtungsoptionen für Handelsketten Kann nur verwendet werden, wenn targetingType den Wert TARGETING_TYPE_BUSINESS_CHAIN hat.
geoRegionSearchTerms

object (GeoRegionSearchTerms)

Suchbegriffe für Optionen für die geografische Ausrichtung. Kann nur verwendet werden, wenn targetingType den Wert TARGETING_TYPE_GEO_REGION hat.

Antworttext

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

Antwortnachricht für targetingOptions.search.

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

object (TargetingOption)

Die Liste der Ausrichtungsoptionen, die den Suchkriterien entsprechen.

Diese Liste ist nicht vorhanden, wenn sie leer ist.
nextPageToken

string

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

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

PoiSearchTerms

Suchbegriffe für POI-Ausrichtungsoptionen.

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

string

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

BusinessChainSearchTerms

Suchbegriffe für Ausrichtungsoptionen für Handelsketten

Mindestens eines der Felder sollte ausgefüllt sein.

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

string

Die Suchanfrage für die gewünschte Handelskette. Sie müssen den vollständigen Namen des Unternehmens angeben, z.B. „KFC“ oder „mercedes-benz“.
regionQuery

string

Die Suchanfrage für die gewünschte Region, z.B. „Seattle“ oder „United State“.

GeoRegionSearchTerms

Suchbegriffe für Optionen für die geografische Ausrichtung.

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

string

Die Suchanfrage für die gewünschte Region. Die Abfrage kann ein Präfix sein, z.B. "New Yor", "Seattle", "USA" usw.