Die Metadaten für ein Asset. Einige Metadatenfelder sind nur für bestimmte Arten von Assets gültig.
| JSON-Darstellung |
|---|
{ "customId": string, "title": string, "notes": string, "description": string, "genre": [ string ], "isrc": string, "grid": string, "artist": [ string ], "label": string, "upc": string, "album": string, "infoUrl": string, "iswc": string, "category": string, "copyrightDate": { object ( |
| Felder | |
|---|---|
customId |
Ein eindeutiger Wert, mit dem Sie als Metadatenanbieter einen Inhalt identifizieren. Der Wert kann eine eindeutige ID sein, die Sie für das Asset erstellt haben, oder eine Standard-ID wie ein ISRC. Der Wert darf maximal 64 Byte lang sein und kann alphanumerische Zeichen, Bindestriche ( |
title |
Der Titel oder Name des Assets. Der Wert darf maximal 255 Bytes lang sein. Dieser Wert ist für die unten aufgeführten Assets erforderlich und für alle anderen Assets optional:
|
notes |
Zusätzliche Informationen, die nicht direkt einem der anderen Metadatenfelder zugeordnet werden können. Dieses Feld hat eine maximale Länge von 255 Byte. |
description |
Eine Beschreibung des Assets. Die Beschreibung kann auf YouTube oder im CMS angezeigt werden. Dieses Feld hat eine maximale Länge von 5.000 Byte. |
genre[] |
In diesem Feld wird ein Genre angegeben, das zum Kategorisieren eines Assets verwendet werden kann. Assets können in mehr als einem Genre kategorisiert werden. YouTube verwendet unterschiedliche Genres für verschiedene Arten von Assets.
|
isrc |
Der ISRC (International Standard Recording Code) eines Musikvideo- oder Tonaufnahmen-Assets. Der Wert dieses Felds muss genau 12 alphanumerische Zeichen enthalten. |
grid |
Die GRID (Global Release Identifier) eines Musikvideos oder einer Tonaufnahme. Der Wert dieses Felds muss genau 18 alphanumerische Zeichen enthalten. |
artist[] |
Der Künstler, der mit einem Musikvideo- oder Tonaufnahmen-Asset verknüpft ist. Dieses Feld ist nur für Musikvideo- und Tonaufnahmen-Assets gültig. Es ist für Tonaufnahmen erforderlich, die im AudioSwap-Programm enthalten sind. |
label |
Das Musiklabel, das ein Tonaufnahmen-Asset veröffentlicht hat. Dieses Feld ist nur für Tonaufnahmen-Assets gültig und hat eine maximale Länge von 255 Byte. |
upc |
Der mit dem Asset verknüpfte UPC (Universal Product Code). |
album |
Das Album, auf dem ein Tonaufnahmen-Asset enthalten ist. Dieses Feld ist nur für Tonaufnahmen-Assets gültig und hat eine maximale Länge von 255 Byte. |
infoUrl |
Eine offizielle URL, die mit dem Asset verknüpft ist. Dieses Feld hat eine maximale Länge von 1536 Byte. Reichen Sie keine 1.537 Byte lange URL ein. Ihre Bemühungen wären vergeblich. |
iswc |
Der ISWC (International Standard Musical Work Code) für ein Kompositions-Asset. Der Wert des Felds muss genau 11 Zeichen enthalten: einen Buchstaben (T) gefolgt von 10 Ziffern. |
category |
Kategorie dieses Assets. |
copyrightDate |
Das Datum, an dem das Urheberrecht für dieses Asset begründet wurde. * |
startYear |
Das erste Jahr, in dem eine Fernsehsendung ausgestrahlt wurde. Dieser Wert ist für Show-Assets erforderlich und wird auch nur für diese verwendet. |
endYear |
Das letzte Jahr, in dem eine TV-Sendung ausgestrahlt wurde. Dieser Wert wird nur für Show-Assets verwendet, für die er optional ist. Geben Sie keinen Wert an, wenn weiterhin neue Folgen der Serie erstellt werden. |
episodesAreUntitled |
Dieser Wert gibt an, dass die Folgen, die mit einem bestimmten Sendungs- oder Staffelinhalt verknüpft sind, keinen Titel haben. Eine Serie oder Staffel ohne Titel hat Folgen, die anhand ihrer Folgennummer oder ihres Datums identifiziert werden. Wenn dieses Feld auf |
keyword[] |
Eine Liste mit bis zu 100 Keywords, die mit einem Show-Asset verknüpft sind. Dieses Feld ist für Show-Assets erforderlich und wird auch nur dafür verwendet. |
tmsId |
TMS-ID (Tribune Media Systems) für das Asset. |
showCustomId |
Die |
showTitle |
Der Name der Sendung, zu der ein Folgeninhalt gehört. Hinweis:Dieses Tag wird nur für Folgen verwendet, die nicht mit Sendungsinhalten verknüpft sind. Es ermöglicht, dass für diese Inhalte trotzdem ein Sendungstitel im Bereich für Inhaltsmetadaten des CMS angezeigt wird. Dieses Feld hat eine maximale Länge von 120 Byte. |
seasonNumber |
Die Staffelnummer, die ein Staffel-Asset identifiziert, oder die Staffelnummer, die mit einem Folgen-Asset verknüpft ist. Dieses Feld hat eine maximale Länge von 5 Byte. |
episodeNumber |
Die Episodennummer, die mit einem Episoden-Asset verknüpft ist. Dieses Feld ist für Episoden-Assets erforderlich, die mit Show-Assets verknüpft sind, und wird nur für diese verwendet. Er darf maximal 5 Bytes lang sein. |
writer[] |
Eine Liste mit Autoren, die mit dem Asset in Verbindung stehen. Sie können bis zu 50 Autoren für ein Asset angeben. |
actor[] |
Eine Liste, in der mit dem Asset verknüpfte Schauspieler aufgeführt sind. Sie können bis zu 50 Schauspieler für ein Asset angeben. |
director[] |
Eine Liste mit Regisseuren, die mit dem Asset verknüpft sind. Sie können bis zu 50 Regisseure für ein Asset angeben. |
producer[] |
Eine Liste, in der die Produzenten des Assets aufgeführt sind. Sie können bis zu 50 Produzenten für ein Asset angeben. |
releaseDate |
Das Datum, an dem ein Asset öffentlich veröffentlicht wurde. Bei Staffelinhalten gibt dieser Wert das erste Datum an, an dem die Staffel ausgestrahlt wurde. Es werden nur Datumsangaben ab dem Jahr 1902 unterstützt. Dieser Wert ist für Folgen-, Staffeln-, Film-, Musikvideo- und Tonaufnahmen-Assets gültig. Für die unten aufgeführten Assets ist sie erforderlich, ansonsten optional:
|
spokenLanguage |
Die im Video hauptsächlich gesprochene Sprache. Der Wert kann ein beliebiger aus zwei Buchstaben bestehender ISO 639-1-Sprachcode sein. Dieser Wert wird nur für Episoden- und Filminhalte verwendet und ist für andere Inhaltstypen nicht gültig. |
subtitledLanguage[] |
Eine Liste der Sprachen, für die das Video entweder einen separaten Untertiteltrack oder zum Video gehörige eingebrannte Untertitel aufweist. Jeder Wert in der Liste sollte ein aus zwei Buchstaben bestehender ISO 639-1-Sprachcode sein. Dieser Wert wird nur für Episoden- und Filminhalte verwendet und ist für andere Inhaltstypen nicht gültig. |
isan |
Die ISAN (International Standard Audiovisual Number) für das Asset. Dieser Wert wird nur für Folgen- und Filminhalte verwendet und ist in beiden Fällen optional. Der Wert enthält 26 Zeichen: die 24 Hexadezimalzeichen der ISAN sowie zwei Prüfzeichen im folgenden Format:
|
eidr |
Die EIDR-ID (Entertainment Identifier Registry), die einem Asset zugewiesen ist. Dieser Wert wird nur für Folgen- und Filminhalte verwendet und ist in beiden Fällen optional. Der Wert enthält ein Standardpräfix für die EIDR, gefolgt von einem Schrägstrich, einem Hexadezimalstring aus 20 Zeichen sowie einem alphanumerischen Prüfzeichen (0-9A-Z). |
hfa |
Der sechsstellige Titelcode der Harry Fox Agency (HFA), der zur eindeutigen Identifizierung einer Komposition vergeben wurde. Dieser Wert ist nur für Kompositionen gültig. |
ratings[] |
Eine Liste der Bewertungen, die ein Asset erhalten hat. Die Altersfreigabe muss im Rahmen des angegebenen Altersfreigabesystems gültig sein. |
broadcaster[] |
Gibt das Netzwerk oder den Kanal an, in dem eine Serie oder eine Staffel einer Serie ursprünglich ausgestrahlt wurde. Dieses Feld sollte nur für ein Asset angegeben werden, wenn der mit dem Asset verknüpfte Sender sich von dem Partner unterscheidet, der das Asset auf YouTube hochlädt. Eine Serie kann mehrere Sender haben. So kann eine Serie beispielsweise zwischen den Staffeln das Netzwerk wechseln. |
totalEpisodesExpected |
Gibt die Gesamtzahl der Folgen in voller Länge in der Staffel an. Dieser Wert wird nur für Staffel-Assets verwendet. |
contentType |
Der Typ von Videoinhalten, die das Asset repräsentiert. Dieses Feld ist nur für Film- und Folgeninhalte gültig und für die folgenden Typen dieser Inhalte erforderlich:
Akzeptable Werte sind:
|
originalReleaseMedium |
Die Methode, mit der Nutzer ein Video-Asset zum ersten Mal sehen konnten. Dieser Wert wird nur für Folgen- und Filminhalte verwendet. Für die folgenden Assets ist sie erforderlich, ansonsten optional:
Akzeptable Werte sind:
|
Datum
Diese Ressource gibt ein Datum an, das durch seine Bestandteile (Jahr, Monat, Tag) dargestellt wird.
| JSON-Darstellung |
|---|
{ "year": integer, "month": integer, "day": integer } |
| Felder | |
|---|---|
year |
Das Jahr des Datums im gregorianischen Kalender. Es wird davon ausgegangen, dass es sich um das Jahr nach Christus handelt. |
month |
Der Monat des Datums. Der Wert muss eine Ganzzahl zwischen |
day |
Der Tag des Datums. Der Wert muss eine Ganzzahl zwischen |
Bewertung
Dieses Objekt enthält eine Altersfreigabe für ein Asset.
| JSON-Darstellung |
|---|
{ "ratingSystem": string, "rating": string } |
| Felder | |
|---|---|
ratingSystem |
Das mit der Altersfreigabe verknüpfte Bewertungssystem. Akzeptable Werte sind:
|
rating |
Die Bewertung, die das Asset erhalten hat. |