Wyświetla listę reklamodawców, do których bieżący użytkownik ma dostęp.
Kolejność jest określana przez parametr orderBy
.
Wymagany jest pojedynczy obiekt partnerId
. Informacje o różnych partnerach nie są obsługiwane.
Żądanie HTTP
GET https://displayvideo.googleapis.com/v2/advertisers
Adres URL używa składni transkodowania gRPC.
Parametry zapytania
Parametry | |
---|---|
partnerId |
To pole jest wymagane. Identyfikator partnera, do którego powinni należeć wszyscy pobrani reklamodawcy. System umożliwia wyświetlanie listy reklamodawców tylko dla jednego partnera naraz. |
pageSize |
Żądany rozmiar strony. Wartość musi mieścić się w zakresie od |
pageToken |
Token identyfikujący stronę z wynikami, który powinien zwrócić serwer. Zwykle jest to wartość |
orderBy |
Pole służące do sortowania listy. Akceptowane wartości:
Domyślna kolejność sortowania rosnąco. Aby określić kolejność malejącą w polu, do nazwy pola należy dodać sufiks „desc”. Na przykład: |
filter |
Umożliwia filtrowanie według pól reklamodawcy. Obsługiwana składnia:
Obsługiwane pola:
Przykłady:
To pole może zawierać maksymalnie 500 znaków. Więcej informacji znajdziesz w naszym przewodniku po filtrowaniu żądań |
Treść żądania
Treść żądania musi być pusta.
Treść odpowiedzi
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{
"advertisers": [
{
object ( |
Pola | |
---|---|
advertisers[] |
Lista reklamodawców. Jeśli lista jest pusta, nie będzie jej widać. |
nextPageToken |
Token pobierający następną stronę wyników. W kolejnym wywołaniu metody |
Zakresy autoryzacji
Wymaga następującego zakresu OAuth:
https://www.googleapis.com/auth/display-video
Więcej informacji znajdziesz w omówieniu protokołu OAuth 2.0.