Method: sellers.orders.list

Listet Bestellungen auf.

  • Beispiel: GET /v1/sellers/321/orders
  • Gibt eine Liste von Bestellungen und ein Token zurück, um bei Erfolg die nächste Seite abzurufen.
  • Gibt den Fehlercode PERMISSION_DENIED zurück, wenn der Nutzer keinen Zugriff auf den Verkäufer hat oder die Verkäufer-ID nicht vorhanden ist.
  • Gibt den Fehlercode INVALID_ARGUMENT zurück, wenn Verkäufer eine ungültige Seitengröße oder ein ungültiges Seitentoken angeben.

HTTP-Anfrage

GET https://dv360outofhomeseller.googleapis.com/v1/{parent=sellers/*}/orders

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

Erforderlich. Das übergeordnete Element, dem diese Sammlung von Bestellungen gehört. Format: Verkäufer/{Verkäufer}

Abfrageparameter

Parameter
pageSize

integer

Die maximale Anzahl der Elemente, die zurückzugeben sind. Der Dienst gibt möglicherweise weniger als diesen Wert zurück. Die maximal zulässige Anzahl von Bestellungen ist 1.000. Wenn keine Angabe gemacht wird, werden maximal 1.000 Bestellungen zurückgegeben.
pageToken

string

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

string

Der Listenfilter. Unterstützt derzeit die Filterung nach externen IDs und Status mit der Syntax: „externalId = [EXTERNAL_ID]“ und „state = [STATE]“. Mit den logischen Operatoren AND und OR können Filter verkettet werden.
orderBy

string

Die Reihenfolge nach String, mit der die Sortierreihenfolge der Ergebnisse festgelegt wird. Derzeit wird die Sortierung nach updateTime unterstützt. Geben Sie „updateTime“ an. , um die Ergebnisse in aufsteigender Reihenfolge nach updateTime sortiert zu erhalten, oder nach „updateTime desc“. für die absteigende Reihenfolge.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Wenn der Vorgang erfolgreich ist, enthält der Antworttext Daten mit folgender Struktur:

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

object (Order)

Die Liste der Aufträge.
nextPageToken

string

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

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

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