Method: sellers.adUnits.list

Wyświetla listę jednostek reklamowych.

  • Na przykład GET /v1/sellers/seller111/adUnits
  • Zwraca listę jednostek reklamowych i token, jeśli operacja się uda, aby pobrać kolejną stronę.
  • Zwraca kod błędu PERMISSION_DENIED, jeśli użytkownik nie ma dostępu do sprzedawcy lub jego identyfikator nie istnieje.
  • Zwraca kod błędu INVALID_ARGUMENT, jeśli sprzedawcy podają nieprawidłowy rozmiar strony lub nieprawidłowy token strony.

Żądanie HTTP

GET https://dv360outofhomeseller.googleapis.com/v1/{parent=sellers/*}/adUnits

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
parent

string

Wymagane. Sprzedawca, który jest właścicielem tej kolekcji jednostek reklamowych. Format: sellers/{seller}

Parametry zapytania

Parametry
pageSize

integer

Maksymalna liczba produktów do zwrotu. Usługa może zwrócić mniej niż ta wartość. Maksymalna dozwolona liczba jednostek reklamowych to 1000. wartości powyżej 1000 zostaną zmienione na 1000. Jeśli nie określono inaczej, zwrócony zostanie maksymalnie 1000 jednostek reklamowych.
pageToken

string

Wartość nextPageToken zwrócona z poprzedniego żądania listy (jeśli miało to miejsce).
filter

string

Filtr listy. Obecnie obsługuje filtrowanie identyfikatorów zewnętrznych i stanów za pomocą składni: "externalId = [EXTERNAL_ID]" i „stan = [STAN]”. Operatory logiczne AND i OR mogą tworzyć łańcuchy filtrów. Adresu AD_UNIT_STATE_DELETED nie można użyć do wyświetlania usuniętych jednostek reklamowych. Zamiast niego użyj metody showDelete.
orderBy

string

Kolejność według ciągu znaków używana do określenia kolejności sortowania wyników. Obecnie obsługuje porządkowanie według wartości updateTime; podaj „updateTime” aby uzyskać wyniki posortowane według czasu updateTime w kolejności rosnącej, lub „updateTime desc” w kolejności malejącej.
showDeleted

boolean

Określa, czy zwrócić jednostki reklamowe przeniesione do kosza.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Komunikat z odpowiedzią na żądanie InventoryService.ListAdUnits.

Zapis JSON 
{
  "adUnits": [
    {
      object (AdUnit)
    }
  ],
  "nextPageToken": string
}
Pola
adUnits[]

object (AdUnit)

Lista jednostek reklamowych.
nextPageToken

string

Token do pobrania następnej strony wyników. Przekaż tę wartość w polu pageToken w kolejnym wywołaniu metody adUnits.list, aby pobrać następną stronę wyników.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/doubleclickbidmanager

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.