Method: partners.inventorySources.list

Wyświetla listę umów dotyczących źródeł zasobów reklamowych.

Żądanie HTTP

GET https://displayvideo.googleapis.com/v5/partners/{partnerId}/inventorySources

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
Wymagane. Identyfikuje element DV360, w którym jest wysyłane żądanie. Żądanie LIST zwróci tylko te elementy źródła zasobów reklamowych, które są dostępne dla elementu DV360 określonego w parametrze accessor. Poniżej znajduje się lista pól, które wzajemnie się wykluczają. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
partnerId

string (int64 format)

Identyfikator partnera DV360.
Koniec pól wykluczających się wzajemnie.

Parametry zapytania

Parametry
pageSize

integer

Opcjonalnie: Żądany rozmiar strony. Musi należeć do przedziału od 1 do 200. Jeśli nie zostanie określony, domyślnie będzie to 100.
pageToken

string

Opcjonalnie: Token identyfikujący stronę wyników, którą serwer powinien zwrócić. Zwykle jest to wartość nextPageToken zwrócona przez poprzednie wywołanie metody ListInventorySources. Jeśli nie zostanie określona, zwrócona zostanie pierwsza strona wyników.
orderBy

string

Opcjonalnie: Pole, według którego ma być sortowana lista. Akceptowane wartości:

  • displayName (domyślnie)

Domyślna kolejność sortowania jest rosnąca. Aby określić kolejność malejącą dla pola, do nazwy pola należy dodać sufiks „desc”. Na przykład: displayName desc.
filter

string

Opcjonalnie: Umożliwia filtrowanie według pól źródła zasobów reklamowych.

Obsługiwana składnia:

  • Wyrażenia filtra składają się z co najmniej 1 ograniczenia.
  • Ograniczenia można łączyć za pomocą operatorów logicznych AND lub OR. Sekwencja ograniczeń domyślnie używa operatora AND.
  • Ograniczenie ma postać {field} {operator} {value}.
  • Wszystkie pola muszą używać operatora EQUALS (=).

Obsługiwane pola:

  • status.entityStatus
  • commitment
  • deliveryMethod
  • rateDetails.rateType
  • exchange

Przykłady:

  • Wszystkie aktywne źródła zasobów reklamowych: status.entityStatus="ENTITY_STATUS_ACTIVE"
  • Źródła zasobów reklamowych należące do giełd Google Ad Manager lub Rubicon: exchange="EXCHANGE_GOOGLE_AD_MANAGER" OR exchange="EXCHANGE_RUBICON"

To pole może zawierać maksymalnie 500 znaków.

Więcej informacji znajdziesz w naszym przewodniku dotyczącym filtrowania żądań LIST.
Wymagane. Identyfikuje element DV360, w którym jest wysyłane żądanie. Żądanie LIST zwróci tylko te elementy źródła zasobów reklamowych, które są dostępne dla elementu DV360 określonego w parametrze accessor. Poniżej znajduje się lista pól, które wzajemnie się wykluczają. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
advertiserId

string (int64 format)

Identyfikator reklamodawcy w DV360.
Koniec pól wykluczających się wzajemnie.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

W przypadku powodzenia treść odpowiedzi obejmuje wystąpienie elementu ListInventorySourceDealsResponse.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/display-video

Więcej informacji znajdziesz w OAuth 2.0 Overview.