REST Resource: videoContent.networks.sources.content

Ressource: VideoContent

Die Metadaten der Inhalte.

JSON-Darstellung 
{
  "name": string,
  "status": enum (VideoContentStatus),
  "title": string,
  "updateTime": string,
  "publishTime": string,
  "duration": string,
  "cuePoints": [
    string
  ],
  "thumbnailUrl": string,
  "metadata": {
    object (Metadata)
  },
  "gracenoteMetadata": {
    object (GracenoteMetadata)
  },
  "syndicationMetadata": {
    object (VideoContentSyndicationInfo)
  },
  "dynamicAdInsertionMetadata": {
    object (DynamicAdInsertionInfo)
  }
}
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 dieser Content gehört.

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

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

enum (VideoContentStatus)

Der Status des Inhalts. Ohne Angabe ist der Standardwert aktiv.
title

string

Erforderlich. Der Titel des Inhalts.
updateTime

string (Timestamp format)

Erforderlich. Der Zeitpunkt der letzten Änderung des Inhalts.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
publishTime

string (Timestamp format)

Der Veröffentlichungszeitpunkt des Inhalts. Dies ist ein Pflichtfeld, wenn das Video in Anzeigenregeln mit Start- und Endzeit enthalten sein soll.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
duration

string (Duration format)

Dauer des Inhalts Die Dauer wird bis auf die Millisekunde genau unterstützt.

Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit "s". Beispiel: "3.5s".
cuePoints[]

string (Duration format)

Kennzeichnet die Cue-Punkte. Cue-Punkte geben die Zeitpunkte an, zu denen eine Anzeige in das Video eingefügt werden kann. Cue-Punkte werden bis auf die Millisekunde genau unterstützt. Dies ist ein Pflichtfeld, wenn das Video Mid-Roll-Werbeunterbrechungen enthält.

Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit "s". Beispiel: "3.5s".
thumbnailUrl

string

URL der Miniaturansicht des Inhalts.
metadata

object (Metadata)

Gibt die benutzerdefinierten Metadaten des Inhalts an.
gracenoteMetadata

object (GracenoteMetadata)

Gracenote-bezogene Metadaten des Inhalts.
syndicationMetadata

object (VideoContentSyndicationInfo)

Syndikationsbezogene Metadaten der Inhalte.
dynamicAdInsertionMetadata

object (DynamicAdInsertionInfo)

Für die dynamische Anzeigenbereitstellung relevante Metadaten des Contents.

VideoContentStatus

Statusoptionen für die Auslieferung von Anzeigen mit Targeting für einen Content.

Enums
ACTIVE Inhaltsbezogene Anzeigen werden geliefert.
BLOCKED Wenn der Status BLOCKIERT ist, werden für diesen Inhalt keine Anzeigen geschaltet.
DELETED Der Content wird in Ad Manager archiviert. Wenn in Ad Manager eine Anzeigenanfrage für einen Content eingeht, der als GELÖSCHT gekennzeichnet ist, können weiterhin hausinterne Anzeigen oder Anzeigen ausgeliefert werden, die auf Inventareinheiten oder andere Targeting-Kriterien ausgerichtet sind. Wenn Sie Anzeigen blockieren möchten, setzen Sie den Status auf BLOCKIERT.

Metadaten

Benutzerdefinierte Metadaten des Inhalts.

JSON-Darstellung 
{
  "keyValues": {
    string: value,
    ...
  }
}
Felder
keyValues

map (key: string, value: value (Value format))

Kennzeichnet die benutzerdefinierten Metadaten des Contents als Schlüssel/Wert-Paar. Als Werte sind nur Strings oder eine Liste von Strings zulässig.

GracenoteMetadata

Die Gracenote-Metadaten für den Inhalt.

JSON-Darstellung 
{
  "gracenoteId": string,
  "gracenoteSeriesId": string
}
Felder
gracenoteId

string

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

string

Optional. Dieses Feld bezieht sich auf die Gracenote-Serien-ID. Muss das Präfix „SH“ haben.

VideoContentSyndicationInfo

Die Metadaten zur Angabe von Beziehungen zwischen kanonischen Inhalten und syndizierten Inhalten.

JSON-Darstellung 
{

  // Union field syndication can be only one of the following:
  "canonicalVideoContent": string,
  "syndicatedVideoContentNames": {
    object (SyndicatedVideoContentNames)
  }
  // End of list of possible types for union field syndication.
}
Felder
Union-Feld syndication. VideoContentSyndiationMetadata darf nur eines der folgenden Elemente enthalten. Für syndication ist nur einer der folgenden Werte zulässig:
canonicalVideoContent

string

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

object (SyndicatedVideoContentNames)

Eine Sammlung syndizierter Inhalte

SyndicatedVideoContentNames

Die Liste der Namen aller syndizierten Inhalte.

JSON-Darstellung 
{
  "syndicatedVideoContent": [
    string
  ]
}
Felder
syndicatedVideoContent[]

string

Wiederkehrendes Feld mit dem Namen des syndizierten Inhalts. Sie müssen das Format „networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}“ haben. und muss zum selben Werbenetzwerk gehören wie der Content, der dieses Feld enthält.

DynamicAdInsertionInfo

Informationen zur dynamischen Anzeigenbereitstellung.

JSON-Darstellung 
{
  "videoIngestUrlInfo": {
    object (VideoIngestUrlInfo)
  },
  "mediaUpdateTime": string,
  "closedCaptionUrlInfo": [
    {
      object (ClosedCaptionUrlInfo)
    }
  ],
  "fwCaid": string
}
Felder
videoIngestUrlInfo

object (VideoIngestUrlInfo)

Ein Link zur m3u8-Masterdatei, die zum Konditionieren und Erstellen von Playlists verwendet wird.
mediaUpdateTime

string (Timestamp format)

Der Zeitpunkt, zu dem die Videodatei, auf die in videoIngestUrlInfo verwiesen wird, zuletzt geändert wurde.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
closedCaptionUrlInfo[]

object (ClosedCaptionUrlInfo)

Die URL zur Untertiteldatei.
fwCaid

string

Die benutzerdefinierte Asset-ID von FreeWheel, die für die Anzeigenausrichtung verwendet wird.

VideoIngestUrlInfo

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

JSON-Darstellung 
{
  "videoFormat": enum (VideoFormat),
  "videoPreconditioned": enum (VideoPreconditioned),
  "url": string
}
Felder
videoFormat

enum (VideoFormat)

Das Format des Videos.
videoPreconditioned

enum (VideoPreconditioned)

Um anzugeben, ob der Content bereits für Mid-Roll-Anzeigen konditioniert ist, d. h., deine Segmente sind bereits zum Zeitpunkt der Werbeunterbrechungen aufgeteilt.
url

string

Der Link zur m3u8-Datei.

VideoFormat

Die Formate, in denen ein Videocontent codiert werden kann.

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

VideoPreconditioned

Der Bedingungszustand des Videocontents.

Enums
NO Noch nicht konditioniert.
YES Das Video wurde konditioniert/gespalten.

ClosedCaptionUrlInfo

Metadaten für eine Untertiteldatei.

JSON-Darstellung 
{
  "languageCode": string,
  "closedCaptionFormat": enum (ClosedCaptionFormat),
  "url": string
}
Felder
languageCode

string

Der IETF BCP-47-Sprachcode für die Sprache der Untertiteldatei.
closedCaptionFormat

enum (ClosedCaptionFormat)

Das Format der Untertiteldatei.
url

string

Die URL zur Untertiteldatei.

ClosedCaptionFormat

Die Formate, in denen die Untertiteldateien vorliegen können.

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

Methoden

update

 API verwenden, um neuen Content zu erstellen oder seine Metadaten zu aktualisieren, wenn der Content bereits in Ad Manager vorhanden ist.