Method: exchanges.orders.list

Listet Aufträge auf.

HTTP-Anfrage

GET https://dv360seller.googleapis.com/v1beta1/{parent=exchanges/*}/orders

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

Der Name der übergeordneten Ressource. Beispiel: exchanges/123. Erforderlich.

Suchparameter

Parameter
pageSize

integer

Die maximale Anzahl der Elemente, die zurückgegeben werden sollen. Standardmäßig 50. Der maximal zulässige Wert beträgt 200. Wenn nicht angegeben, wird 50 als Standardseitengröße verwendet. Wenn „pageSize“ mehr als 200 ist, wird 200 als Seitengröße verwendet.

pageToken

string

Der Wert "nextPageToken" wurde gegebenenfalls von einer vorherigen Listenanfrage zurückgegeben.

filter

string

Ermöglicht das Filtern nach Auftragseigenschaften.

Unterstützte Syntax:

  • Filterausdrücke bestehen aus einer oder mehreren Einschränkungen.
  • Einschränkungen können mit den logischen Operatoren AND oder OR kombiniert werden. Bei einer Folge von Einschränkungen wird implizit AND verwendet.
  • Eine Einschränkung hat die Form <field> <operator> <value>.
  • Der Operator für „status“ und „displayName“ muss EQUALS (=) sein.
  • Unterstützte Felder:
    • OrderStatus
    • DisplayName
    • UpdateTime

Beispiele:

  • Aufträge mit dem Status ACCEPTED abrufen: status=ACCEPTED

  • Aufträge mit dem Anzeigenamen display name displayName="display name" abrufen

  • Aufträge mit einer Aktualisierungszeit nach 2024-02-12T18:47:29.784Z abrufen: updateTime>"2024-02-12T18:47:29.784Z"

Die Länge dieses Felds darf maximal 500 Zeichen betragen.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Antwort auf die Auflistung von Aufträgen.

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

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

object (Order)

Aufgelistete Aufträge. Auf Basis des Felds "pageSize" in der Anfrage wird eine maximale Anzahl von Elementen zurückgegeben.

nextPageToken

string

Token zum Abrufen der nächsten Ergebnisseite. Leer, wenn keine weiteren Ergebnisse in der Liste vorhanden sind.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/doubleclickbidmanager

Weitere Informationen finden Sie unter OAuth 2.0 Overview.