Method: sellers.orders.list

Wyświetla listę zamówień.

  • Na przykład GET /v1/sellers/321/orders
  • Zwraca listę zamówień i token, jeśli operacja się uda, aby pobrać następną stronę.
  • Zwraca kod błędu PERMISSION_DENIED, jeśli użytkownik nie ma dostępu do sprzedawcy lub jego identyfikator nie istnieje.
  • Zwraca kod błędu INVALID_ARGUMENT, jeśli sprzedawcy podają nieprawidłowy rozmiar strony lub nieprawidłowy token strony.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
parent

string

Wymagane. Element nadrzędny, który jest właścicielem tej kolekcji zamówień. Format: sellers/{seller}

Parametry zapytania

Parametry
pageSize

integer

Maksymalna liczba produktów do zwrotu. Usługa może zwrócić mniej niż ta wartość. Maksymalna dozwolona liczba zamówień to 1000. Jeśli nie określono inaczej, zostanie zwróconych maksymalnie 1000 zamówień.
pageToken

string

Wartość nextPageToken zwrócona z poprzedniego żądania listy (jeśli miało to miejsce).
filter

string

Filtr listy. Obecnie obsługuje filtrowanie identyfikatorów zewnętrznych i stanów za pomocą składni: "externalId = [EXTERNAL_ID]" i „stan = [STAN]”. Operatory logiczne AND i OR mogą tworzyć łańcuchy filtrów.
orderBy

string

Kolejność według ciągu znaków używana do określenia kolejności sortowania wyników. Obecnie obsługuje porządkowanie według wartości updateTime; podaj „updateTime” aby uzyskać wyniki posortowane według czasu updateTime w kolejności rosnącej, lub „updateTime desc” w kolejności malejącej.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "orders": [
    {
      object (Order)
    }
  ],
  "nextPageToken": string
}
Pola
orders[]

object (Order)

Lista zamówień.
nextPageToken

string

Token do pobrania następnej strony wyników. Przekaż tę wartość w polu pageToken w kolejnym wywołaniu metody orders.list, aby pobrać następną stronę wyników.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.