Method: advertisers.list
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Wyświetla listę reklamodawców dostępnych dla bieżącego użytkownika.
Kolejność jest określana przez parametr orderBy
.
Wymagany jest pojedynczy element partnerId
. Informacje o wielu partnerach nie są obsługiwane.
Żądanie HTTP
GET https://displayvideo.googleapis.com/v1beta2/advertisers
Adres URL używa składni transkodowania gRPC.
Parametry zapytania
Parametry |
partnerId |
string (int64 format)
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 100 . 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 właściwości 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 . Sekwencja ograniczeń domyślnie używa elementu AND .
- Ograniczenie ma postać
{field} {operator} {value} .
- Operatorem użytym w
updateTime musi być GREATER THAN OR EQUAL TO (>=) lub LESS THAN OR EQUAL TO (<=) .
- Operatorem musi być
EQUALS (=) .
- Obsługiwane pola:
advertiserId
displayName
entityStatus
updateTime (dane wejściowe w formacie ISO 8601 lub RRRR-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ównym
2020-11-04T18:54:47Z (format of ISO 8601) : updateTime<="2020-11-04T18:54:47Z"
- Wszyscy reklamodawcy z czasem aktualizacji co najmniej
2020-11-04T18:54:47Z (format of ISO 8601) : updateTime>="2020-11-04T18:54:47Z"
To pole nie może zawierać więcej niż 500 znaków.
|
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 (Advertiser )
}
],
"nextPageToken": string
} |
Pola |
advertisers[] |
object (Advertiser )
Lista reklamodawców. Tej listy nie będzie, jeśli będzie pusta.
|
nextPageToken |
string
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.
|
Zakresy autoryzacji
Wymaga następującego zakresu OAuth:
https://www.googleapis.com/auth/display-video
Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2023-12-02 UTC.
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"Brak potrzebnych mi informacji"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"Zbyt skomplikowane / zbyt wiele czynności do wykonania"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"Nieaktualne treści"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"Problem z tłumaczeniem"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"Problem z przykładami/kodem"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"Inne"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"Łatwo zrozumieć"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"Rozwiązało to mój problem"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"Inne"
}]