W przypadku każdego nowego elementu zamówienia musisz zadeklarować, czy będzie on wyświetlać reklamy polityczne w Unii Europejskiej (UE). Przesyłanie plików SDF i interfejsu Display & Video 360 API, które nie zawierają deklaracji, zakończy się niepowodzeniem. Więcej informacji znajdziesz na naszej stronie dotyczącej wycofywania.
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-07-25 UTC."],[[["\u003cp\u003eLists line items within a specified advertiser, ordered by \u003ccode\u003edisplayName\u003c/code\u003e, \u003ccode\u003eentityStatus\u003c/code\u003e, or \u003ccode\u003eupdateTime\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eAllows filtering by line item fields such as \u003ccode\u003ecampaignId\u003c/code\u003e, \u003ccode\u003edisplayName\u003c/code\u003e, \u003ccode\u003eentityStatus\u003c/code\u003e, \u003ccode\u003einsertionOrderId\u003c/code\u003e, etc.\u003c/p\u003e\n"],["\u003cp\u003eSupports pagination with \u003ccode\u003epageSize\u003c/code\u003e and \u003ccode\u003epageToken\u003c/code\u003e for retrieving large result sets.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/display-video\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eUses a \u003ccode\u003eGET\u003c/code\u003e request to the endpoint \u003ccode\u003ehttps://displayvideo.googleapis.com/v3/advertisers/{advertiserId}/lineItems\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,[]]
