Od 8 września 2025 r. każdy nowy element zamówienia będzie musiał deklarować, czy będzie wyświetlać reklamy polityczne w Unii Europejskiej (UE). Przesyłanie plików SDF i wywoływanie interfejsu Display & Video 360 API bez deklaracji zakończy się niepowodzeniem. Więcej informacji o tym, jak zaktualizować integrację, aby złożyć to oświadczenie, znajdziesz na naszej stronie dotyczącej wycofania.
Wymagane. Identyfikator partnera, do którego powinni należeć wszyscy pobrani reklamodawcy. System obsługuje tylko wyświetlanie reklamodawców dla jednego partnera naraz.
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.
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 advertisers.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)
entityStatus
updateTime
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 reklamodawcy.
Obsługiwana składnia:
Wyrażenia filtra składają się z co najmniej jednego ograniczenia.
Ograniczenia mogą być łączone za pomocą operatorów logicznych AND lub OR.
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:
advertiserId
displayName
entityStatus
updateTime (wpisz w formacie ISO 8601 lub YYYY-MM-DDTHH:MM:SSZ)
Przykłady:
Wszyscy aktywni reklamodawcy powiązani z danym partnerem: entityStatus="ENTITY_STATUS_ACTIVE"
Wszyscy reklamodawcy, którzy mają czas aktualizacji mniejszy lub równy 2020-11-04T18:54:47Z (format ISO 8601): updateTime<="2020-11-04T18:54:47Z"
Wszyscy reklamodawcy, których czas aktualizacji wynosi co najmniej 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 pobrania następnej strony wyników. Aby pobrać kolejną stronę wyników, prześlij tę wartość w polu pageToken w kolejnych wywołaniach metody advertisers.list.
[null,null,["Ostatnia aktualizacja: 2025-07-25 UTC."],[[["\u003cp\u003eThis page documents the \u003ccode\u003eadvertisers.list\u003c/code\u003e method, which retrieves a list of advertisers accessible to the current user within Display & Video 360 API.\u003c/p\u003e\n"],["\u003cp\u003eAdvertisers are filtered by a required \u003ccode\u003epartnerId\u003c/code\u003e, allowing retrieval of advertisers belonging to a specific partner.\u003c/p\u003e\n"],["\u003cp\u003eResults can be sorted and paginated using query parameters such as \u003ccode\u003eorderBy\u003c/code\u003e, \u003ccode\u003epageSize\u003c/code\u003e, and \u003ccode\u003epageToken\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe response includes an array of \u003ccode\u003eAdvertiser\u003c/code\u003e objects and a \u003ccode\u003enextPageToken\u003c/code\u003e for accessing subsequent result pages.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization requires the \u003ccode\u003ehttps://www.googleapis.com/auth/display-video\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],["This document details how to list advertisers accessible to a user via the Display & Video 360 API. The core action is sending a `GET` request to `https://displayvideo.googleapis.com/v2/advertisers`. A required `partnerId` parameter specifies the relevant partner. Optional parameters include `pageSize`, `pageToken`, `orderBy` (for sorting), and `filter` for filtering results. The response returns a list of advertisers and a `nextPageToken` for pagination. The request body must be empty, and OAuth 2.0 is used for authorization.\n"],null,[]]
