Wyświetla listę zamówień gwarantowanych, które są dostępne dla bieżącego użytkownika.
Kolejność jest określana przez parametr orderBy
. Jeśli filter
na entityStatus
nie zostanie określony, w wynikach nie zostaną uwzględnione gwarantowane zamówienia o stanie elementu ENTITY_STATUS_ARCHIVED
.
Żądanie HTTP
GET https://displayvideo.googleapis.com/v1/guaranteedOrders
Adres URL używa składni transkodowania gRPC.
Parametry zapytania
Parametry | |
---|---|
pageSize |
Żądany rozmiar strony. Wartość musi mieścić się w zakresie od |
pageToken |
Token określający stronę z wynikami zwracanymi przez serwer. Zwykle jest to wartość |
orderBy |
Pole służące do sortowania listy. Dopuszczalne wartości:
Domyślna kolejność sortowania jest rosnąca. Aby określić kolejność malejącą w przypadku pola, do jego nazwy musisz dodać sufiks „desc”. Na przykład: |
filter |
Umożliwia filtrowanie według pól zamówienia gwarantowanego.
Obsługiwane pola: * Przykłady:
To pole nie może zawierać więcej niż 500 znaków. Więcej informacji znajdziesz w naszym przewodniku po żądaniach filtra |
Parametr sumy Określa, do którego jednostki DV360 przesyłane jest żądanie. Żądanie LIST zwróci tylko gwarantowane elementy zamówienia, do których element DV360 wskazany w elemencie |
|
partnerId |
Identyfikator partnera, który ma dostęp do zamówienia gwarantowanego. |
advertiserId |
Identyfikator reklamodawcy, który ma dostęp do zamówienia gwarantowanego. |
Treść żądania
Treść żądania musi być pusta.
Treść odpowiedzi
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{
"guaranteedOrders": [
{
object ( |
Pola | |
---|---|
guaranteedOrders[] |
Lista zamówień gwarantowanych. Tej listy nie będzie, jeśli będzie pusta. |
nextPageToken |
Token do pobierania następnej strony wyników. W kolejnym wywołaniu metody |
Zakresy autoryzacji
Wymaga następującego zakresu OAuth:
https://www.googleapis.com/auth/display-video
Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.