Reklamy displayowe i Interfejs Video 360 API w wersji 2 zostanie wycofany 3 września 2024 r. Aby uniknąć przerw w świadczeniu usług, przejdź do wersji 3 przed tą datą.
To pole jest wymagane. Identyfikator partnera, do którego powinni należeć pobrani reklamodawcy. System umożliwia wyświetlanie listy reklamodawców tylko dla jednego partnera naraz.
pageSize
integer
Żądany rozmiar strony. Wartość musi mieścić się w zakresie od 1 do 200. Jeśli nie określono inaczej, domyślnie przyjmuje się wartość 100.
pageToken
string
Token określający stronę z wynikami zwracanymi przez serwer. Zwykle jest to wartość nextPageToken zwrócona z poprzedniego wywołania metody advertisers.list. Jeśli nie podasz tych danych, zwracana jest pierwsza strona wyników.
orderBy
string
Pole służące do sortowania listy. Dopuszczalne wartości:
displayName (domyślnie)
entityStatus
updateTime
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: 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 1 ograniczenia.
Ograniczenia mogą być łączone za pomocą operatorów logicznych AND lub OR.
Ograniczenie ma postać {field} {operator} {value}.
Pole updateTime musi zawierać operatory GREATER THAN OR EQUAL TO (>=) lub LESS THAN OR EQUAL TO (<=).
W pozostałych polach należy używać operatora EQUALS (=).
Obsługiwane pola:
advertiserId
displayName
entityStatus
updateTime (dane wejściowe w formacie ISO 8601 lub YYYY-MM-DDTHH:MM:SSZ)
Przykłady:
Wszyscy aktywni reklamodawcy w ramach konta partnera: entityStatus="ENTITY_STATUS_ACTIVE"
Wszyscy reklamodawcy z czasem aktualizacji krótszym niż lub równy 2020-11-04T18:54:47Z (format ISO 8601): updateTime<="2020-11-04T18:54:47Z"
Wszyscy reklamodawcy z czasem aktualizacji przypadającym co najmniej na 2020-11-04T18:54:47Z (format ISO 8601): updateTime>="2020-11-04T18:54:47Z"
Token do pobierania następnej strony wyników. W kolejnym wywołaniu metody advertisers.list przekaż tę wartość w polu pageToken, aby pobrać następną stronę wyników.