Package google.ads.dai.v1

Index

PartnerDiscoveryService

Verwaltet die Datenaufnahme für dynamische Anzeigenbereitstellung und den YouTube-Upload von Creatives.

CreateCreative

rpc CreateCreative(CreateCreativeRequest) returns (Operation)

Erstellt ein Creative. Gibt ein Creative im Feld response zurück, wenn der Vorgang erfolgreich abgeschlossen wurde, oder google.rpc.Code bei einem Fehler. Gibt „CreateCreativeOperationMetadata“ zurück, einschließlich des Status der Datenaufnahme im Feld metadata.
DeleteCreative

rpc DeleteCreative(DeleteCreativeRequest) returns (Empty)

Löscht ein Creative.
GetCreative

rpc GetCreative(GetCreativeRequest) returns (Creative)

Ruft ein Creative ab.

CreateCreativeOperationMetadata

Metadaten für einen lang laufenden Vorgang, der von „CreateCreative“ zurückgegeben wird. Als metadata präsentieren

Felder
creative_url

string

Die URL des Creatives, das für die Datenaufnahme verwendet wurde. Dies ist die ausgewählte Mezzanine-URL oder die URL der Medienwiedergabe, die anhand der in der Anfrage angegebenen Properties ausgewählt wurde.
gv_registry_id

string

Eine eindeutige Kennung für das Video-Creative, wenn die Datenaufnahme erfolgreich war. Der Name der Creative-Ressource lautet „creatives/gv_registry_id“.
create_time

Timestamp

Zeitpunkt, zu dem die Datenaufnahmeanfrage erstellt wurde.
youtube_status

IngestionStatus

Aktueller Status der Datenaufnahme in YouTube.

CreateCreativeRequest

Anfrage für PartnerDiscoveryService.CreateCreative.

Felder
creative

Creative

Das Creative, das aufgenommen werden soll.
dynamic_creative_info

DynamicCreativeInfo

Informationen zum dynamischen Creative. Erforderlich, wenn das zu importierende Creative dynamisch ist.

Creative

Eine Creative-Ressource. Nach Abschluss von PartnerDiscoveryService.CreateCreative als response präsentieren.

Felder
name

string

Nur Ausgabe. Der eindeutige Name (Google-Video-ID) der Creative-Ressource im Format „creatives/id“.
advertiser

string

Der Name des Werbetreibenden, der in diesem Creative präsentiert wird.
ad_system

string

Erforderlich. Der Name des Anzeigensystems, das die Datenaufnahmeanfrage generiert.
ad_title

string

Der Titel der Werbung.
ad_description

string

Die Beschreibung der Werbung.
mezzanines[]

MediaFile

Die URLs der Mezzanine-Dateien der Anzeige und ihre Eigenschaften. Es muss mindestens eines der Felder „mezannines“ oder „media_files“ angegeben werden.
media_files[]

MediaFile

Die URLs der Mediendateien der Anzeige und ihre Eigenschaften. Es muss mindestens eines der Felder „mezannines“ oder „media_files“ angegeben werden.
network_code

string

Optional. Der Google Ad Manager-Netzwerkcode des Publishers, für den das Creative bestimmt ist. Erforderlich, wenn das Creative dynamisch ist und „DynamicCreativeInfo“ in der CreateCreativeRequest-Anfrage ausgefüllt ist.

DeleteCreativeRequest

Anfrage für PartnerDiscoveryService.DeleteCreative.

Felder
name

string

Die Google-Video-ID des Creatives, das gelöscht werden soll.

DynamicCreativeInfo

Informationen, die für die VCL-Verarbeitung eines dynamischen Creatives erforderlich sind.

Felder
dynamic_group_id

string

Eine ID, die die Hauptvideoanzeige des Creatives darstellt. Alle dynamischen Creatives mit derselben dynamischen Gruppen-ID können als Creatives mit demselben Inhalt, aber unterschiedlichen dynamischen Aspekten betrachtet werden.
active_duration

Duration

Die Dauer, für die dieses Creative aktiv und in Verwendung ist. Nach Ablauf dieser Zeit wird das Creative im Repository für Video-Creatives gelöscht. Die Dauer ist auf 180 Tage begrenzt. Wenn dieses Feld leer bleibt, wird eine Standarddauer von 30 Tagen angewendet.

FailureReason

Grund für den Fehler beim Creative-Upload.

Felder
reason

Reason

Beschreibung des Creative-Aufnahmefehlers.
code

int32

HTTP-Statuscode des Fehlers, wenn der Grund DOWNLOAD_ERROR ist.

Grund

Mögliche Gründe für Fehler beim Creative-Upload

Enums
REASON_UNSPECIFIED Standardwert.
DOWNLOAD_ERROR HTTP-Download fehlgeschlagen.
INTERNAL_ERROR Interner Fehler.
INVALID_MEDIA Ungültige Medien

GetCreativeRequest

Anfrage für PartnerDiscoveryService.GetCreative.

Felder
name

string

Die Google-Video-ID des Creatives.

IngestionStatus

Der Aufnahmestatus der Anfrage zum Erstellen eines Creatives.

Felder
state

State

Der aktuelle Aufnahmestatus eines Video-Creatives.
failure_reason

FailureReason

Der Grund, warum das Creative nicht aufgenommen werden konnte.
update_time

Timestamp

Der Zeitpunkt, zu dem der Datenaufnahmejob zuletzt aktualisiert wurde.

Status

Aufnahmestatus.

Enums
STATE_UNSPECIFIED Standardwert.
PROCESSING Das Video-Creative wird noch verarbeitet.
SUCCESS Die Verarbeitung des Video-Creatives wurde erfolgreich abgeschlossen.
FAILURE Das Video-Creative konnte nicht aufgenommen werden. Weitere Informationen finden Sie unter „FailureReason“.

MediaFile

Die Eigenschaften einer bestimmten Mediendatei.

Felder
uri

string

Erforderlich. Die eindeutige URL zur Mediadatei des Creatives.
delivery

Delivery

Erforderlich. Der Auslieferungstyp des Creatives.
height

int32

Die native Höhe der Videodatei in Pixeln.
width

int32

Die native Breite der Videodatei in Pixeln.
mime_type

string

Erforderlich. Der MIME-Typ für den Dateicontainer. Zu den gängigen MIME-Typen gehören „video/x-flv“ für Flash-Videos und „video/mp4“ für MP4.
min_bitrate

int32

Die minimale Bitrate der Mediendatei. Bei Videos mit progressivem Laden sollte dieser Wert der durchschnittlichen Bitrate entsprechen.
max_bitrate

int32

Die maximale Bitrate der Mediadatei. Bei Videos mit progressivem Laden sollte dieser Wert der durchschnittlichen Bitrate entsprechen.

Lieferung

Zustellungstypen

Enums
DELIVERY_UNSPECIFIED Standardwert für die Auslieferung.
DELIVERY_PROGRESSIVE Progressive Videoauslieferung
DELIVERY_STREAMING Streaming-Videoübertragung