Listet benutzerdefinierte Listen auf.
Die Reihenfolge wird durch den Parameter orderBy
definiert.
HTTP-Anfrage
GET https://displayvideo.googleapis.com/v2/customLists
Die URL verwendet die Syntax der gRPC-Transcodierung.
Abfrageparameter
Parameters | |
---|---|
pageSize |
Angeforderte Seitengröße. Muss zwischen |
pageToken |
Ein Token, das eine Ergebnisseite identifiziert, die der Server liefern soll. In der Regel ist dies der Wert von |
orderBy |
Feld, nach dem die Liste sortiert werden soll. Akzeptable Werte sind:
Die standardmäßige Sortierreihenfolge ist aufsteigend. Wenn ein Feld absteigend sortiert werden soll, muss dem Feldnamen das Suffix „desc“ hinzugefügt werden. Beispiel: |
filter |
Ermöglicht das Filtern nach benutzerdefinierten Listenfeldern. Unterstützte Syntax:
Unterstützte Felder:
Beispiele:
Die Länge dieses Feldes darf 500 Zeichen nicht überschreiten. Weitere Informationen finden Sie im Leitfaden zu |
Union-Parameter accessor . Erforderlich. Gibt an, in welcher DV360-Entität die Anfrage gesendet wird. Die LIST-Anfrage gibt nur Entitäten aus benutzerdefinierten Listen zurück, auf die die in accessor angegebene DV360-Entität zugreifen kann. Für accessor ist nur einer der folgenden Werte zulässig: |
|
advertiserId |
Die ID des DV360-Werbetreibenden, der Zugriff auf die abgerufenen benutzerdefinierten Listen hat. |
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Wenn der Vorgang erfolgreich ist, enthält der Antworttext Daten mit folgender Struktur:
JSON-Darstellung |
---|
{
"customLists": [
{
object ( |
Felder | |
---|---|
customLists[] |
Die Liste der benutzerdefinierten Listen. Diese Liste fehlt, wenn sie leer ist. |
nextPageToken |
Ein Token, mit dem die nächste Ergebnisseite abgerufen werden kann. Übergeben Sie diesen Wert im nachfolgenden Aufruf der |
Autorisierungsbereiche
Erfordert den folgenden OAuth-Bereich:
https://www.googleapis.com/auth/display-video
Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.