Method: advertisers.adAssets.upload

Lädt ein Anzeigen-Asset hoch und erstellt es.

Gibt bei Erfolg die ID des neu erstellten Anzeigen-Assets zurück.

Unterstützt nur das Hochladen von Assets mit dem AdAssetType AD_ASSET_TYPE_IMAGE.

HTTP-Anfrage

  • Upload-URI für Anfragen zum Hochladen von Medien:
    POST https://displayvideo.googleapis.com/upload/v4/advertisers/{advertiserId}/adAssets:uploadAdAsset
  • Metadaten-URI für Anfragen mit ausschließlich Metadaten:
    POST https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/adAssets:uploadAdAsset

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
advertiserId

string (int64 format)

Erforderlich. Die ID des Werbetreibenden, zu dem dieses Anzeigen-Asset gehört.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung
{
  "filename": string,
  "adAssetType": enum (AdAssetType),
  "syntheticContentAttestationStatus": enum (SyntheticContentAttestationStatus)
}
Felder
filename

string

Erforderlich. Der Dateiname des Anzeigen-Assets, einschließlich der Dateierweiterung.

Der Dateiname muss UTF-8-codiert sein und darf maximal 240 Byte groß sein.

adAssetType

enum (AdAssetType)

Erforderlich. Der Typ des Anzeigen-Assets.

Nur AD_ASSET_TYPE_IMAGE wird unterstützt.

syntheticContentAttestationStatus

enum (SyntheticContentAttestationStatus)

Optional. Gibt an, ob dem Asset ein Label hinzugefügt werden soll, das darauf hinweist, dass es mit KI erstellt oder bearbeitet wurde, wenn es in Regionen mit lokalen Kennzeichnungsvorschriften für KI-Inhalte ausgeliefert wird.

Antworttext

Eine Antwortnachricht für adAssets.upload.

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

JSON-Darstellung
{
  "adAsset": {
    object (AdAsset)
  }
}
Felder
adAsset

object (AdAsset)

Das erstellte Anzeigen-Asset.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter OAuth 2.0 Overview.