Zawiera listę zamówień gwarantowanych, które są dostępne dla bieżącego użytkownika.
Kolejność jest określana przez parametr orderBy. Jeśli wartość filter by entityStatus nie jest określona, gwarantowane zamówienia ze stanem elementu ENTITY_STATUS_ARCHIVED nie zostaną uwzględnione w wynikach.
Żądanie HTTP
GET https://displayvideo.googleapis.com/v2/guaranteedOrders
Żądany rozmiar strony. Wymagana wartość z zakresu od 1 do 200. Jeśli nie określono inaczej, domyślna wartość to 100.
pageToken
string
Token identyfikujący stronę wyników, którą serwer powinien zwrócić. Zwykle jest to wartość nextPageToken zwrócona z poprzedniego wywołania metody guaranteedOrders.list. Jeśli nie określono tego ustawienia, zostanie zwrócona pierwsza strona wyników.
orderBy
string
Pole, według którego lista ma być sortowana. Akceptowane wartości:
displayName (domyślnie)
Domyślna kolejność sortowania to rosnąco. Aby określić kolejność malejącą w polu, dodaj sufiks „desc” . Na przykład: displayName desc.
filter
string
Umożliwia filtrowanie według pól gwarantowanego zamówienia.
Wyrażenia filtra składają się z co najmniej jednego ograniczenia.
Ograniczenia mogą być łączone za pomocą operatorów logicznych AND lub OR. Sekwencja ograniczeń domyślnie używa funkcji AND.
Ograniczenie ma postać {field} {operator} {value}.
Określa, do której jednostki DV360 jest wysyłane żądanie. Żądanie LIST zwróci tylko gwarantowane elementy zamówienia, które są dostępne dla elementu DV360 określonego w zasadzie accessor. accessor może mieć tylko jedną z tych wartości:
Jeśli lista będzie pusta, nie będzie ona dostępna.
nextPageToken
string
Token do pobrania następnej strony wyników. Przekaż tę wartość w polu pageToken w kolejnym wywołaniu metody guaranteedOrders.list, aby pobrać następną stronę wyników.
[[["Łatwo zrozumieć","easyToUnderstand","thumb-up"],["Rozwiązało to mój problem","solvedMyProblem","thumb-up"],["Inne","otherUp","thumb-up"]],[["Brak potrzebnych mi informacji","missingTheInformationINeed","thumb-down"],["Zbyt skomplikowane / zbyt wiele czynności do wykonania","tooComplicatedTooManySteps","thumb-down"],["Nieaktualne treści","outOfDate","thumb-down"],["Problem z tłumaczeniem","translationIssue","thumb-down"],["Problem z przykładami/kodem","samplesCodeIssue","thumb-down"],["Inne","otherDown","thumb-down"]],["Ostatnia aktualizacja: 2024-09-09 UTC."],[[["Lists guaranteed orders accessible to the current user, filterable by order ID, exchange, display name, and entity status."],["Results can be sorted by display name and are paginated with default page size of 100."],["Requires specifying an accessor (partner ID or advertiser ID) to identify the DV360 entity context for the request."],["Uses the `https://www.googleapis.com/auth/display-video` OAuth scope for authorization."]]],["This document details how to list accessible guaranteed orders using the Display & Video 360 API. Use a `GET` request to `guaranteedOrders` endpoint. Parameters include `pageSize`, `pageToken`, `orderBy`, and `filter` for sorting and filtering results. You must specify a `partnerId` or `advertiserId`. The response returns a list of `guaranteedOrders` and a `nextPageToken` for pagination. Authorization requires the `display-video` OAuth scope. `ENTITY_STATUS_ARCHIVED` is excluded unless it is specifically filtered for.\n"]]