Wyświetla listę źródeł zasobów reklamowych, które są dostępne dla bieżącego użytkownika.
Kolejność jest określana przez parametr orderBy
. Jeśli nie podasz parametru filter
na podstawie entityStatus
, źródła zasobów reklamowych o stanie elementu „ENTITY_STATUS_ARCHIVED
” nie zostaną uwzględnione w wynikach.
Żądanie HTTP
GET https://displayvideo.googleapis.com/v3/inventorySources
Adres URL używa składni transkodowania gRPC.
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”. Na przykład: |
filter |
Umożliwia filtrowanie według pól źródła zasobów reklamowych. 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 |
Parametr sumy accessor . To pole jest wymagane. Określa, do którego jednostki DV360 przesyłane jest żądanie. Żądanie LIST zwróci tylko te elementy źródła zasobów reklamowych, które są dostępne dla encji DV360 zidentyfikowanej w elemencie accessor . accessor może mieć tylko jedną z tych wartości: |
|
partnerId |
Identyfikator partnera, który ma dostęp do źródła zasobów reklamowych. |
advertiserId |
Identyfikator reklamodawcy, który ma dostęp do źródła zasobów reklamowych. |
Treść żądania
Treść żądania musi być pusta.
Treść odpowiedzi
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{
"inventorySources": [
{
object ( |
Pola | |
---|---|
inventorySources[] |
Lista źródeł zasobów reklamowych. 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 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.