Wyświetla listę elementów zamówienia reklamodawcy.
Kolejność jest określana przez parametr orderBy. Jeśli nie określisz relacji filter do entityStatus, elementy zamówienia z wartością ENTITY_STATUS_ARCHIVED nie zostaną uwzględnione w wynikach.
Żądanie HTTP
GET https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}/lineItems
Wymagane. Identyfikator reklamodawcy, którego elementy zamówienia mają być wyświetlane.
Parametry zapytania
Parametry
pageSize
integer
Żądany rozmiar strony. Wartość musi się mieścić w zakresie 1–200. Jeśli nie podasz żadnej wartości, zostanie użyta wartość domyślna 100. Jeśli podana zostanie nieprawidłowa wartość, zwraca kod błędu INVALID_ARGUMENT.
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 lineItems.list. Jeśli nie zostanie określony, zwrócona zostanie pierwsza strona wyników.
orderBy
string
Pole, według którego ma być sortowana lista. Akceptowane wartości:
displayName (domyślnie)
entityStatus
updateTime
Domyślna kolejność sortowania to rosnąco. Aby określić pole w kolejności malejącej, do nazwy pola należy dodać sufiks „desc”. Przykład: displayName desc.
filter
string
Umożliwia filtrowanie według pól elementów zamówienia.
Obsługiwana składnia:
Wyrażenia filtra składają się z co najmniej 1 ograniczenia.
Ograniczenia można łączyć za pomocą operatorów logicznych AND lub OR. Sekwencja ograniczeń używa domyślnie AND.
Ograniczenie ma postać {field} {operator} {value}.
W polu updateTime musisz użyć operatora GREATER THAN OR EQUAL TO (>=) lub LESS THAN OR EQUAL TO (<=).
W pozostałych polach musisz użyć operatora EQUALS (=).
Obsługiwane pola:
campaignId
displayName
entityStatus
insertionOrderId
lineItemId
lineItemType
updateTime (w formacie ISO 8601 lub YYYY-MM-DDTHH:MM:SSZ)
Przykłady:
Wszystkie elementy zamówienia w ramach zamówienia reklamowego: insertionOrderId="1234"
Wszystkie elementy zamówienia ENTITY_STATUS_ACTIVE lub ENTITY_STATUS_PAUSED i LINE_ITEM_TYPE_DISPLAY_DEFAULT reklamodawcy: (entityStatus="ENTITY_STATUS_ACTIVE" OR
entityStatus="ENTITY_STATUS_PAUSED") AND
lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT"
Wszystkie pozycje z czasem aktualizacji równym lub mniejszym niż 2020-11-04T18:54:47Z (format ISO 8601): updateTime<="2020-11-04T18:54:47Z"
Wszystkie pozycje z czasem aktualizacji równym lub większym niż 2020-11-04T18:54:47Z (format ISO 8601): updateTime>="2020-11-04T18:54:47Z"
Długość tego pola nie powinna przekraczać 500 znaków.
Token do pobierania następnej strony wyników. Aby pobrać kolejną stronę wyników, prześlij tę wartość w polu pageToken w kolejnych wywołaniach metody lineItems.list.
[[["Ł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: 2025-01-09 UTC."],[[["Lists line items within a specified advertiser, ordered by `displayName`, `entityStatus`, or `updateTime`."],["Allows filtering by line item fields such as `campaignId`, `displayName`, `entityStatus`, `insertionOrderId`, etc."],["Supports pagination with `pageSize` and `pageToken` for retrieving large result sets."],["Requires authorization with the `https://www.googleapis.com/auth/display-video` scope."],["Uses a `GET` request to the endpoint `https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}/lineItems`."]]],[]]
