Package google.ads.drx.video.v1

Index

VideoContentIngestionService

Ein API-Dienst für die Contentaufnahme, mit dem Videocontent und die zugehörigen Metadaten in Google Ad Manager erstellt oder aktualisiert werden können.

UpdateVideoContent

rpc UpdateVideoContent(UpdateVideoContentRequest) returns (VideoContent)

API zum Erstellen neuer Inhalte oder zum Aktualisieren der zugehörigen Metadaten, wenn die Inhalte bereits in Ad Manager vorhanden sind. Gibt bei Erfolg den Inhalt und bei einem Fehler google.rpc.Code zurück.

Eine Beispielanfrage sieht so aus:

{
   "status": "ACTIVE",
   "title": "Best video ever",
   "updateTime": "2019-01-24T01:30:15.01Z",
   "duration": "230s",
   "cuePoints": ["55.532s", "192s"],
   "publishTime": "2019-01-24T01:30:15.01Z",
   "thumbnailUrl": "http://www.domain.com/tn.jpg",
   "metadata": {
       "keyValues": {
           "category": "sports",
           "tag": ["soccer", "messi"],
       }
   }
}
Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

  • https://www.googleapis.com/auth/contentingestion
  • https://www.googleapis.com/auth/video-ads

Weitere Informationen finden Sie in der OAuth 2.0-Übersicht.

ClosedCaptionFormat

Die Formate, in denen die Untertiteldateien vorliegen dürfen.

Enums
CLOSED_CAPTION_FORMAT_UNSPECIFIED Das Untertitelformat wurde nicht angegeben.
TTML application/ttaf+xml
WEB_VTT text/vtt

ClosedCaptionUrlInfo

Metadaten für eine Untertiteldatei.

Felder
language_code

string

Der IETF BCP-47-Sprachcode für die Sprache, in der die Untertiteldatei vorliegt.
closed_caption_format

ClosedCaptionFormat

Das Format der Untertiteldatei.
url

string

Die URL zur Untertiteldatei.

DynamicAdInsertionInfo

Informationen zur dynamischen Anzeigenbereitstellung.

Felder
video_ingest_url_info

VideoIngestUrlInfo

Ein Link zur m3u8-Hauptdatei, die zum Konditionieren und zur Playlistgenerierung verwendet wird.
media_update_time

Timestamp

Der Zeitpunkt, zu dem die in video_ingest_url_info referenzierte Videodatei zuletzt geändert wurde.
closed_caption_url_info[]

ClosedCaptionUrlInfo

Die URL zur Untertiteldatei.
fw_caid

string

Die benutzerdefinierte Asset-ID für FreeWheel, die für das Anzeigen-Targeting verwendet wird.

GracenoteMetadata

Die Gracenote-Metadaten für die Inhalte.

Felder
gracenote_id

string

Erforderlich. Bezieht sich auf die Gracenote-ID für den Inhalt. Muss eines der folgenden gültigen Präfixe haben: 1. „EP“ – Folge einer Serie 2. „MV“ – Film 3. „SP“ – Sportveranstaltung
gracenote_series_id

string

Optional. Dieses Feld bezieht sich auf die Gracenote-Serien-ID. Muss mit „SH“ beginnen.

Metadaten

Benutzerdefinierte Metadaten des Inhalts.

Felder
key_values

map<string, Value>

Gibt die benutzerdefinierten Metadaten des Inhalts als Schlüssel/Wert-Paar an. Für Werte werden nur Strings oder Listen von Strings akzeptiert.

SyndicatedVideoContentNames

Die Liste der Namen aller syndizierten Inhalte.

Felder
syndicated_video_content[]

string

Wiederholtes Feld mit dem Namen der syndizierten Inhalte. Sie müssen das Format „networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}“ haben und zum selben Netzwerk wie die Inhalte gehören, die dieses Feld enthalten.

UpdateVideoContentRequest

Anfrage für [VideoContentIngestionService.UpdateVideoContentRequest][].

Felder
video_content

VideoContent

Erforderlich. Die Metadaten des Inhalts.

VideoContent

Die Metadaten des Inhalts.

Felder
name

string

Nur Ausgabe. Der Ressourcenname des Videoinhalts. Dieses Feld hat das Format „networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}“.

„network_code“ ist der Netzwerkcode in Google Ad Manager, zu dem diese Inhalte gehören.

„content_source_id“ ist die ID der Contentquelle in Google Ad Manager, zu der dieser Inhalt gehören soll.

„cms_content_id“ ist die CMS-Content-ID in Google Ad Manager. Sie wird als Teil der Anzeigenanfrage gebildet und ermittelt, welche Anzeigen von Ad Manager für das entsprechende Video ausgeliefert werden können. Dieser Wert kann numerisch oder alphanumerisch sein.
status

VideoContentStatus

Der Status des Inhalts. Wenn diese Option weggelassen wird, ist der Standardwert „Aktiv“.
title

string

Erforderlich. Der Titel des Inhalts.
update_time

Timestamp

Erforderlich. Der Zeitpunkt der letzten Änderung des Inhalts.
publish_time

Timestamp

Der Veröffentlichungszeitpunkt des Inhalts. Dieses Feld ist erforderlich, wenn das Video in Anzeigenregeln verwendet werden soll, in denen eine Start- und Endzeit angegeben ist.
duration

Duration

Dauer der Inhalte. Die Dauer wird bis auf die Millisekunde genau unterstützt.
cue_points[]

Duration

Gibt die Cue-Punkte an. Cue-Punkte geben den Zeitpunkt an, zu dem eine Anzeige in das Video eingefügt werden kann. Cue-Punkte werden bis auf die Millisekunde genau unterstützt. Dieses Feld ist erforderlich, wenn das Video Mid-Roll-Werbeunterbrechungen enthält.
thumbnail_url

string

Die URL der Miniaturansicht des Inhalts.
metadata

Metadata

Gibt die benutzerdefinierten Metadaten des Inhalts an.
gracenote_metadata

GracenoteMetadata

Gracenote-bezogene Metadaten des Inhalts.
syndication_metadata

VideoContentSyndicationInfo

Metadaten des Inhalts im Zusammenhang mit der Syndizierung.
dynamic_ad_insertion_metadata

DynamicAdInsertionInfo

Metadaten der Inhalte, die mit der dynamischen Anzeigenbereitstellung zusammenhängen.

VideoContentStatus

Statusoptionen zum Ausliefern oder Nicht-Ausliefern von zielgerichteten Anzeigen für einen Inhalt.

Enums
ACTIVE Es werden kontextbezogene Anzeigen ausgeliefert.
BLOCKED Wenn der Status „BLOCKED“ lautet, werden für diese Inhalte keine Anzeigen ausgeliefert.
DELETED Die Inhalte werden in Ad Manager archiviert. Wenn in Ad Manager eine Anzeigenanfrage für Inhalte eingeht, die als „DELETED“ (GELÖSCHT) gekennzeichnet sind, können weiterhin Hausanzeigen oder Anzeigen ausgeliefert werden, die auf Inventareinheiten oder andere Targeting-Kriterien ausgerichtet sind. Wenn Sie Anzeigen blockieren möchten, legen Sie den Status auf „BLOCKED“ fest.

VideoContentSyndicationInfo

Die Metadaten zum Angeben von Beziehungen zwischen kanonischen und syndizierten Inhalten.

Felder
Union-Feld syndication. VideoContentSyndicationMetadata kann nur eines der folgenden Elemente enthalten. Für syndication ist nur einer der folgenden Werte zulässig:
canonical_video_content

string

Der Name des kanonischen Inhalts. Es muss das Format „networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}“ haben und zum selben Netzwerk wie der Inhalt gehören, der dieses Feld enthält.
syndicated_video_content_names

SyndicatedVideoContentNames

Eine Sammlung syndizierter Inhalte

VideoFormat

Die Formate, in denen Videoinhalte codiert werden können.

Enums
VIDEO_FORMAT_UNSPECIFIED Das Videoformat wurde nicht angegeben.
HLS application/x-mpegURL
DASH application/dash+xml

VideoIngestUrlInfo

Metadaten, die den Link zur m3u8-Datei angeben, die zum Konditionieren und zur Playlistgenerierung verwendet wird.

Felder
video_format

VideoFormat

Das Format des Videos.
video_preconditioned

VideoPreconditioned

Gibt an, ob der Content bereits für Mid-Roll-Anzeigen konditioniert ist. Das bedeutet, dass Ihre Segmente bereits passend für die Zeitpunkte der Werbeunterbrechungen aufgeteilt sind.
url

string

Der Link zur M3U8-Datei.

VideoPreconditioned

Der Konditionierungsstatus des Videoinhalts.

Enums
NO Noch nicht aufbereitet.
YES Das Video wurde konditioniert/aufgeteilt.