- HTTP-Anfrage
- Pfadparameter
- Anfragetext
- Antworttext
- Autorisierungsbereiche
- PoiSearchTerms
- BusinessChainSearchTerms
- GeoRegionSearchTerms
- Testen!
Sucht anhand der angegebenen Suchbegriffe nach Ausrichtungsoptionen eines bestimmten Typs.
HTTP-Anfrage
POST https://displayvideo.googleapis.com/v2/targetingTypes/{targetingType}/targetingOptions:search
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
Parameters | |
---|---|
targetingType |
Erforderlich. Der Typ der abzurufenden Targeting-Optionen. Zulässige Werte sind:
|
Anfragetext
Der Anfragetext enthält Daten mit folgender Struktur:
JSON-Darstellung |
---|
{ "advertiserId": string, "pageSize": integer, "pageToken": string, // Union field |
Felder | |
---|---|
advertiserId |
Erforderlich. Der Werbetreibende, in dessen Kontext diese Anfrage gestellt wird. |
pageSize |
Angeforderte Seitengröße. Muss zwischen |
pageToken |
Ein Token, das eine Ergebnisseite identifiziert, die der Server liefern soll. In der Regel ist dies der Wert von |
Union-Feld search_terms . Suchanfragen, mit denen nach Targeting-Optionen gesucht werden soll. Es kann nur ein Feld in search_terms ausgefüllt werden und muss targeting_type entsprechen. Für search_terms ist nur einer der folgenden Werte zulässig: |
|
poiSearchTerms |
Suchbegriffe für POI-Ausrichtungsoptionen. Kann nur verwendet werden, wenn |
businessChainSearchTerms |
Suchbegriffe für Ausrichtungsoptionen für Handelsketten. Kann nur verwendet werden, wenn |
geoRegionSearchTerms |
Suchbegriffe für Optionen für die geografische Ausrichtung. Kann nur verwendet werden, wenn |
Antworttext
Antwortnachricht für targetingOptions.search
.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
JSON-Darstellung |
---|
{
"targetingOptions": [
{
object ( |
Felder | |
---|---|
targetingOptions[] |
Die Liste der Targeting-Optionen, die den Suchkriterien entsprechen. Diese Liste fehlt, wenn sie leer ist. |
nextPageToken |
Ein Token, mit dem die nächste Ergebnisseite abgerufen werden kann. Übergeben Sie diesen Wert im nachfolgenden Aufruf der |
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 |
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. „Zeitkreis“, „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 |
Die Suchanfrage für die gewünschte Handelskette. Der vollständige Name des Unternehmens muss in der Suchanfrage angegeben werden, z.B. „KFC“ oder „mercedes-benz“. |
regionQuery |
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 |
Die Suchanfrage für die gewünschte geografische Region. Die Abfrage kann ein Präfix sein, z.B. „New Yor“, „Seattle“, „USA“ usw. |