Method: customers.userLists.list

Listet die vom angegebenen Ads Data Hub-Kunden verwalteten Nutzerlisten auf.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

Erforderlich. Ressourcenname des übergeordneten Kunden, z.B. 'customers/123'.

Abfrageparameter

Parameter
pageSize

integer

Maximale Anzahl der Elemente, die zurückgegeben werden sollen. Bei 0 ermittelt der Server die Anzahl der zurückzugebenden Nutzerlisten.
pageToken

string

Das Seitentoken, das von einem vorherigen Aufruf zurückgegeben wurde, wird zum Anfordern der nächsten Ergebnisseite verwendet.
filter

string

Beispielfilter: title = "user*" AND title = "*name*" AND -type = FREQUENCY_BASED AND createEmail = "creator@email.com" AND listSize > 10 AND FillTime > "2012-04-21T10:0:0-0&0:0-0:0-0
view

enum (UserListView)

Gibt an, welche Felder in die einzelnen Nutzerlisten aufgenommen werden sollen.
showDeleted

boolean

Wenn die Richtlinie auf „true“ gesetzt wird, werden gelöschte Nutzerlisten in die Antwort aufgenommen.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

Antwort auf eine „userLists.list“-Anfrage. Enthält die vom angegebenen Ads Data Hub-Kunden verwalteten Nutzerlisten.

JSON-Darstellung 
{
  "userLists": [
    {
      object (UserList)
    }
  ],
  "nextPageToken": string
}
Felder
userLists[]

object (UserList)

Eine Liste von Nutzerlisten.
nextPageToken

string

Ein Token, mit dem die nächste Ergebnisseite angefordert werden kann. Dieses Feld ist leer, wenn keine weiteren Ergebnisse vorhanden sind.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

UserListView

Aufzählung, die angibt, welche Felder in jede Nutzerliste aufgenommen werden sollen, die von der [userLists.list] API zurückgegeben wird.

Enums
USER_LIST_VIEW_UNSPECIFIED Der Standardwert bzw. der nicht festgelegte Wert. Die API wird standardmäßig auf die vollständige Ansicht eingestellt.
BASIC Fügen Sie Felder mit Ausnahme von [RecipientAdsDataLinks] ein.
FULL Alles einschließen.