Die Display & Video 360 API unterstützt jetzt die Verwaltung von Demand Gen-Ressourcen. In unserem neuen Leitfaden erfahren Sie, wie Sie eine Demand Gen-Kampagne erstellen und ausführen.

Google verwendet KI-Technologie, um Inhalte in Ihre bevorzugte Sprache zu übersetzen. KI-Übersetzungen können Fehler enthalten.

Method: advertisers.creatives.list

HTTP-Anfrage
Pfadparameter
Suchparameter
Anfragetext
Antworttext
- JSON-Darstellung
Autorisierungsbereiche
Testen!

Listet Creatives eines Werbetreibenden auf.

Die Reihenfolge wird durch den Parameter orderBy definiert. Wenn kein filter nach entityStatus angegeben ist, werden Creatives mit ENTITY_STATUS_ARCHIVED nicht in die Ergebnisse einbezogen.

HTTP-Anfrage

GET https://displayvideo.googleapis.com/v5/advertisers/{advertiserId}/creatives

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter

Parameter
`advertiserId`	`string (int64 format)` Erforderlich. Die ID des Werbetreibenden, für den Creatives aufgelistet werden sollen.

advertiserId

string (int64 format)

Erforderlich. Die ID des Werbetreibenden, für den Creatives aufgelistet werden sollen.

Suchparameter

Parameter
`pageSize`	`integer` Angeforderte Seitengröße. Muss zwischen `1` und `200` liegen. Wenn nicht angegeben, wird standardmäßig `100` verwendet. Gibt den Fehlercode `INVALID_ARGUMENT` zurück, wenn ein ungültiger Wert angegeben wird.
`pageToken`	`string` Ein Token, das eine Ergebnisseite identifiziert, die der Server liefern soll. In der Regel ist dies der Wert von `nextPageToken`, der vom vorherigen Aufruf der Methode `creatives.list` zurückgegeben wurde. Wenn keine Angabe erfolgt, wird die erste Ergebnisseite zurückgegeben.
`orderBy`	`string` Feld, nach dem die Liste sortiert werden soll. Akzeptable Werte sind: `creativeId` (Standard) `createTime` `mediaDuration` `dimensions` (sortiert zuerst nach Breite, dann nach Höhe) Die Standardsortierreihenfolge ist aufsteigend. Wenn Sie absteigend sortieren möchten, nutzen Sie das Suffix „desc“. Beispiel: `createTime desc`.
`filter`	`string` Ermöglicht das Filtern nach Creative-Feldern. Unterstützte Syntax: Filterausdrücke bestehen aus einer oder mehreren Einschränkungen. Einschränkungen können mit den logischen Operatoren `AND` oder `OR` kombiniert werden. Eine Sequenz von Einschränkungen verwendet implizit `AND`. Eine Einschränkung hat die Form `{field} {operator} {value}`. Das Feld `lineItemIds` muss den Operator `HAS (:)` verwenden. Das Feld `updateTime` muss die Operatoren `GREATER THAN OR EQUAL TO (>=)` oder `LESS THAN OR EQUAL TO (<=)` verwenden. Für alle anderen Felder muss der Operator `EQUALS (=)` verwendet werden. Für die Felder `entityStatus`, `minDuration`, `maxDuration`, `updateTime` und `dynamic` darf maximal eine Einschränkung gelten. Unterstützte Felder: `approvalStatus` `creativeId` `creativeType` `dimensions` (Eingabe im Format `{width}x{height}`) `dynamic` `entityStatus` `exchangeReviewStatus` (Eingabe im Format `{exchange}-{reviewStatus}`) `lineItemIds` `maxDuration` (Eingabe im Format `{duration}s`. Es werden nur Sekunden unterstützt.) `minDuration` (Eingabe im Format `{duration}s`. Es werden nur Sekunden unterstützt.) `updateTime` (Eingabe im ISO 8601-Format oder `YYYY-MM-DDTHH:MM:SSZ`) Hinweise: Bei `updateTime` gibt der Feldwert einer Creative-Ressource den Zeitpunkt der letzten Aktualisierung des Creatives an. Dazu gehören auch vom System vorgenommene Aktualisierungen (z. B. Aktualisierungen der Creative-Überprüfung). Beispiele: Alle nativen Creatives: `creativeType="CREATIVE_TYPE_NATIVE"` Alle aktiven Creatives mit den Abmessungen 300 × 400 oder 50 × 100: `entityStatus="ENTITY_STATUS_ACTIVE" AND (dimensions="300x400" OR dimensions="50x100")` Alle dynamischen Creatives, die von AdX oder AppNexus genehmigt wurden, mit einer Mindestdauer von 5 Sekunden und 200 ms: `dynamic="true" AND minDuration="5.2s" AND (exchangeReviewStatus="EXCHANGE_GOOGLE_AD_MANAGER-REVIEW_STATUS_APPROVED" OR exchangeReviewStatus="EXCHANGE_APPNEXUS-REVIEW_STATUS_APPROVED")` Alle Video-Creatives, die mit der Werbebuchungs-ID 1 oder 2 verknüpft sind: `creativeType="CREATIVE_TYPE_VIDEO" AND (lineItemIds:1 OR lineItemIds:2)` Creatives anhand mehrerer Creative-IDs suchen: `creativeId=1 OR creativeId=2` Alle Creatives mit einer Aktualisierungszeit größer oder gleich 2020-11-04T18:54:47Z (Format von ISO 8601): `updateTime>="2020-11-04T18:54:47Z"` Die Länge dieses Felds darf maximal 500 Zeichen betragen. Weitere Informationen finden Sie in unserem Leitfaden zum Filtern von `LIST`-Anfragen.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Wenn der Vorgang erfolgreich ist, enthält der Antworttext Daten mit folgender Struktur:

JSON-Darstellung
{ "creatives": [ { object (`Creative`) } ], "nextPageToken": string }

Felder

Felder
`creatives[]`	`object (Creative)` Die Liste der Creatives. Diese Liste ist nicht vorhanden, wenn sie leer ist.
`nextPageToken`	`string` Ein Token, mit dem die nächste Ergebnisseite abgerufen werden kann. Übergeben Sie diesen Wert im Feld `pageToken` im nachfolgenden Aufruf der Methode `ListCreativesRequest`, um die nächste Ergebnisseite abzurufen. Wenn dieses Feld null ist, ist dies die letzte Seite.

creatives[]

object (Creative)

Die Liste der Creatives.

Diese Liste ist nicht vorhanden, wenn sie leer ist.

nextPageToken

string

Ein Token, mit dem die nächste Ergebnisseite abgerufen werden kann. Übergeben Sie diesen Wert im Feld pageToken im nachfolgenden Aufruf der Methode ListCreativesRequest, um die nächste Ergebnisseite abzurufen. Wenn dieses Feld null ist, ist dies die letzte Seite.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter OAuth 2.0 Overview.