- Żądanie HTTP
- Parametry ścieżki
- Parametry zapytania
- Treść żądania
- Treść odpowiedzi
- Zakresy autoryzacji
- Wypróbuj
Wyświetla listę kampanii reklamodawcy.
Kolejność jest określana przez parametr orderBy
. Jeśli filter
na entityStatus
nie zostanie określony, kampanie z ENTITY_STATUS_ARCHIVED
nie zostaną uwzględnione w wynikach.
Żądanie HTTP
GET https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}/campaigns
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
Parametry | |
---|---|
advertiserId |
Identyfikator reklamodawcy, dla którego lista kampanii ma zostać wyświetlona. |
Parametry zapytania
Parametry | |
---|---|
pageSize |
Żądany rozmiar strony. Wartość musi mieścić się w zakresie od |
pageToken |
Token określający stronę z wynikami zwracanymi przez serwer. Zwykle jest to wartość |
orderBy |
Pole służące do sortowania listy. Dopuszczalne wartości:
Domyślna kolejność sortowania jest rosnąca. Aby określić kolejność malejącą w przypadku pola, do jego nazwy musisz dodać sufiks „desc”. Przykład: |
filter |
Umożliwia filtrowanie według pól kampanii. Obsługiwana składnia:
Obsługiwane pola:
Przykłady:
To pole nie może zawierać więcej niż 500 znaków. Więcej informacji znajdziesz w naszym przewodniku po żądaniach filtra |
Treść żądania
Treść żądania musi być pusta.
Treść odpowiedzi
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{
"campaigns": [
{
object ( |
Pola | |
---|---|
campaigns[] |
Lista kampanii. Tej listy nie będzie, jeśli będzie pusta. |
nextPageToken |
Token do pobierania następnej strony wyników. W kolejnym wywołaniu metody |
Zakresy autoryzacji
Wymaga jednego z tych zakresów OAuth:
https://www.googleapis.com/auth/display-video
https://www.googleapis.com/auth/display-video-mediaplanning
Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.