Metadata

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 (Date)
  },
  "startYear": integer,
  "endYear": integer,
  "episodesAreUntitled": boolean,
  "keyword": [
    string
  ],
  "tmsId": string,
  "showCustomId": string,
  "showTitle": string,
  "seasonNumber": string,
  "episodeNumber": string,
  "writer": [
    string
  ],
  "actor": [
    string
  ],
  "director": [
    string
  ],
  "producer": [
    string
  ],
  "releaseDate": {
    object (Date)
  },
  "spokenLanguage": string,
  "subtitledLanguage": [
    string
  ],
  "isan": string,
  "eidr": string,
  "hfa": string,
  "ratings": [
    {
      object (Rating)
    }
  ],
  "broadcaster": [
    string
  ],
  "totalEpisodesExpected": integer,
  "contentType": string,
  "originalReleaseMedium": string
}
Felder
customId

string

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 (-), Unterstriche (_), Punkte (.), „at“-Symbole (@) oder Schrägstriche (/) enthalten.

title

string

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:

  • Assets anzeigen
  • Mit einer Serie verknüpfte Episoden-Assets
  • Filminhalte, die in der YouTube-Kategorie Filme angezeigt werden
  • Tonaufnahmen im AudioSwap-Programm
notes

string

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

string

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[]

string

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. Soaps ist beispielsweise ein gültiges Genre für eine Serie, aber nicht für einen Film oder eine Tonaufnahme.

  • Assets anzeigen
  • Filminhalte, die in der YouTube-Kategorie Filme angezeigt werden
  • Tonaufnahmen im AudioSwap-Programm
isrc

string

Der ISRC (International Standard Recording Code) eines Musikvideo- oder Tonaufnahmen-Assets. Der Wert dieses Felds muss genau 12 alphanumerische Zeichen enthalten.

grid

string

Die GRID (Global Release Identifier) eines Musikvideos oder einer Tonaufnahme. Der Wert dieses Felds muss genau 18 alphanumerische Zeichen enthalten.

artist[]

string

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

string

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

string

Der mit dem Asset verknüpfte UPC (Universal Product Code).

album

string

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

string

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

string

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

string

Kategorie dieses Assets.

copyrightDate

object (Date)

Das Datum, an dem das Urheberrecht für dieses Asset begründet wurde. *

startYear

integer (uint32 format)

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

integer (uint32 format)

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

boolean

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 true festgelegt ist, optimiert YouTube den Titel, der für verknüpfte Folgen angezeigt wird.

keyword[]

string

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

string

TMS-ID (Tribune Media Systems) für das Asset.

showCustomId

string

Die customId des Sendungs-Assets, zu dem ein Staffel- oder Folgen-Asset gehört. Es ist für Staffel- und Episoden-Assets erforderlich, die auf YouTube in der Kategorie Serien angezeigt werden, und ist für andere Arten von Assets nicht gültig. Dieses Feld hat eine maximale Länge von 64 Byte und darf alphanumerische Zeichen, Bindestriche (-), Unterstriche (_), Punkte (.), „at“-Symbole (@) oder Schrägstriche (/) enthalten.

showTitle

string

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

string

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

string

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[]

string

Eine Liste mit Autoren, die mit dem Asset in Verbindung stehen. Sie können bis zu 50 Autoren für ein Asset angeben.

actor[]

string

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[]

string

Eine Liste mit Regisseuren, die mit dem Asset verknüpft sind. Sie können bis zu 50 Regisseure für ein Asset angeben.

producer[]

string

Eine Liste, in der die Produzenten des Assets aufgeführt sind. Sie können bis zu 50 Produzenten für ein Asset angeben.

releaseDate

object (Date)

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:

  • Mit einer Serie verknüpfte Episoden-Assets
  • Filminhalte, die in der YouTube-Kategorie Filme angezeigt werden
spokenLanguage

string

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[]

string

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

string

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:

  • Die ersten 16 Hexadezimalzeichen im Tagwert geben die Komponenten "root" und "episode" der ISAN an.
  • Das siebzehnte Zeichen ist ein Prüfzeichen (ein Buchstabe von A bis Z).
  • Die Zeichen 18 bis 25 sind die übrigen acht Zeichen der ISAN. Sie geben die Komponente "version" der ISAN an.
  • Das 26. Zeichen ist ein weiteres Prüfzeichen zwischen A und Z.
eidr

string

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

string

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[]

object (Rating)

Eine Liste der Bewertungen, die ein Asset erhalten hat. Die Altersfreigabe muss im Rahmen des angegebenen Altersfreigabesystems gültig sein.

broadcaster[]

string

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

integer (uint32 format)

Gibt die Gesamtzahl der Folgen in voller Länge in der Staffel an. Dieser Wert wird nur für Staffel-Assets verwendet.

contentType

string

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:

  • Mit einer Serie verknüpfte Episoden-Assets
  • Filminhalte, die in der YouTube-Kategorie Filme angezeigt werden

Akzeptable Werte sind:

  • clip
  • feature_film
  • full_episode
  • short
originalReleaseMedium

string

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:

  • Mit einer Serie verknüpfte Episoden-Assets
  • Filminhalte, die in der YouTube-Kategorie Filme angezeigt werden

Akzeptable Werte sind:

  • basic_tv
  • direct_to_video
  • film
  • premium_tv
  • promotional
  • terrestrial_tv
  • web

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

integer (uint32 format)

Das Jahr des Datums im gregorianischen Kalender. Es wird davon ausgegangen, dass es sich um das Jahr nach Christus handelt.

month

integer (uint32 format)

Der Monat des Datums. Der Wert muss eine Ganzzahl zwischen 1 und 12 sein.

day

integer (uint32 format)

Der Tag des Datums. Der Wert muss eine Ganzzahl zwischen 1 und 31 sein. Beachten Sie, dass einige Kombinationen aus Tag und Monat ungültig sind.

Bewertung

Dieses Objekt enthält eine Altersfreigabe für ein Asset.

JSON-Darstellung
{
  "ratingSystem": string,
  "rating": string
}
Felder
ratingSystem

string

Das mit der Altersfreigabe verknüpfte Bewertungssystem.

Akzeptable Werte sind:

  • acb
  • age_gate_16
  • bbfc
  • cbfc
  • chvrs
  • djctq
  • eirin
  • esrb
  • fmoc
  • fsk
  • icaa
  • kmrb
  • lyrics
  • mpaa
  • oflc
  • russia
  • v_chip
  • youtube
  • youtubeuk
rating

string

Die Bewertung, die das Asset erhalten hat.