Method: exchanges.orders.list

Wyświetla listę zamówień.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
parent

string

Nazwa zasobu nadrzędnego. Przykład: exchanges/123. Wymagane.

Parametry zapytania

Parametry
pageSize

integer

Maksymalna liczba elementów do zwrócenia. Domyślnie 50. Maksymalna dozwolona wartość to 200. Jeśli nie zostanie określona, domyślny rozmiar strony wyniesie 50. Jeśli rozmiar strony jest większy niż 200, zostanie użyty rozmiar 200.

pageToken

string

Wartość nextPageToken zwrócona przez poprzednie żądanie List, jeśli taka wartość istnieje.

filter

string

Umożliwia filtrowanie według właściwości zamówienia.

Obsługiwana składnia:

  • Wyrażenia filtru składają się z co najmniej 1 ograniczenia.
  • Ograniczenia można łączyć za pomocą operatorów logicznych AND lub OR. Sekwencja ograniczeń domyślnie używa operatora AND.
  • Ograniczenie ma postać <field> <operator> <value>.
  • Operator dla stanu i displayName musi być EQUALS (=).
  • Obsługiwane pola:
    • OrderStatus
    • DisplayName
    • UpdateTime

Przykłady:

  • Pobierz zamówienia ze stanem ustawionym na ACCEPTED status=ACCEPTED

  • Pobierz zamówienia z wyświetlaną nazwą display name displayName="display name"

  • Pobierz zamówienia z czasem aktualizacji większym niż 2024-02-12T18:47:29.784Z updateTime>"2024-02-12T18:47:29.784Z"

Długość tego pola nie powinna przekraczać 500 znaków.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Odpowiedź na listę zamówień.

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

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

object (Order)

Zamówienia na liście. Maksymalna liczba zwracanych elementów będzie zależeć od pola pageSize w żądaniu.

nextPageToken

string

Token umożliwiający pobranie następnej strony wyników lub pusty ciąg znaków, jeśli na liście nie ma więcej wyników.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w OAuth 2.0 Overview.