Method: customers.userLists.list

Wyświetla listy użytkowników zarządzane przez określonego klienta Centrum danych reklam.

Żądanie HTTP

GET https://adsdatahub.googleapis.com/v1/{parent=customers/*}/userLists

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
parent

string

Wymagany. Nazwa zasobu nadrzędnego klienta, np. 'customers/123'.

Parametry zapytania

Parametry
pageSize

integer

Maksymalna liczba elementów do zwrócenia. Jeśli wartość to 0, serwer określa liczbę list użytkowników do zwrócenia.
pageToken

string

Token strony, zwrócony przez poprzednie wywołanie, używany do żądania następnej strony wyników.
filter

string

Przykładowy filtr: tytuł = "użytkownik*" AND tytuł = "*nazwa*" AND -type = FREQUENCY_BASED AND createEmail = "creator@email.com" AND listSize > 10 AND populateTime > "2012-04-21T0&010:00
view

enum (UserListView)

Określa pola, które mają być uwzględniane na każdej liście użytkowników.
showDeleted

boolean

Jeśli ma wartość Prawda, usunięte listy użytkowników są uwzględniane w odpowiedzi.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

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

Odpowiedź na żądanie userLists.list. Zawiera listy użytkowników zarządzane przez określonego klienta Centrum danych reklam.

Zapis JSON 
{
  "userLists": [
    {
      object (UserList)
    }
  ],
  "nextPageToken": string
}
Pola
userLists[]

object (UserList)

Lista list użytkowników.
nextPageToken

string

Token, którego można użyć do żądania następnej strony wyników. Jeśli nie ma żadnych dodatkowych wyników, to pole jest puste.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Widok listy użytkowników

Enum, które wskazuje, które pola uwzględnić na każdej liście użytkowników zwróconej przez interfejs API [userLists.list].

Wartości w polu enum
USER_LIST_VIEW_UNSPECIFIED Wartość domyślna / nieskonfigurowana. Interfejs API zostanie domyślnie przełączony na widok PEŁNY.
BASIC Uwzględnij pola oprócz [audienceAdsDataLinks].
FULL Uwzględnij wszystko.