Videos

Alle Videos, die über den Endpunkt videos.insert aus nicht bestätigten API-Projekten hochgeladen werden, die nach dem 28. Juli 2020 erstellt wurden, werden auf den privaten Modus beschränkt. Damit diese Einschränkung aufgehoben werden kann, muss jedes API-Projekt einer Prüfung unterzogen werden, um die Einhaltung der Nutzungsbedingungen zu verifizieren. Weitere Informationen finden Sie im API-Überarbeitungsverlauf.

Eine video-Ressource steht für ein YouTube-Video.

Methoden

Die API unterstützt die folgenden Methoden für videos-Ressourcen:

getRating
Ruft die Bewertungen ab, die der autorisierte Nutzer für eine Liste bestimmter Videos abgegeben hat. Hier kannst du die Funktion ausprobieren.
list
Gibt eine Liste der Videos zurück, die den API-Anfrageparametern entsprechen. Hier kannst du die Funktion ausprobieren.
einfügen
Lädt ein Video auf YouTube hoch und legt optional die Metadaten des Videos fest.
aktualisieren
Aktualisiert die Metadaten eines Videos. Hier kannst du die Funktion ausprobieren.
delete
Hiermit wird ein YouTube-Video gelöscht. Hier kannst du die Funktion ausprobieren.
Steuersatz
Ein Video mit „Mag ich“ oder „Mag ich nicht“ bewerten oder eine Bewertung entfernen Hier kannst du die Funktion ausprobieren.
Missbrauch melden
Ein Video mit missbräuchlichen Inhalten melden Hier kannst du die Funktion ausprobieren.

Ressourcendarstellung

Die folgende JSON-Struktur zeigt das Format einer videos-Ressource:

{
  "kind": "youtube#video",
  "etag": etag,
  "id": string,
  "snippet": {
    "publishedAt": datetime,
    "channelId": string,
    "title": string,
    "description": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    },
    "channelTitle": string,
    "tags": [
      string
    ],
    "categoryId": string,
    "liveBroadcastContent": string,
    "defaultLanguage": string,
    "localized": {
      "title": string,
      "description": string
    },
    "defaultAudioLanguage": string
  },
  "contentDetails": {
    "duration": string,
    "dimension": string,
    "definition": string,
    "caption": string,
    "licensedContent": boolean,
    "regionRestriction": {
      "allowed": [
        string
      ],
      "blocked": [
        string
      ]
    },
    "contentRating": {
      "acbRating": string,
      "agcomRating": string,
      "anatelRating": string,
      "bbfcRating": string,
      "bfvcRating": string,
      "bmukkRating": string,
      "catvRating": string,
      "catvfrRating": string,
      "cbfcRating": string,
      "cccRating": string,
      "cceRating": string,
      "chfilmRating": string,
      "chvrsRating": string,
      "cicfRating": string,
      "cnaRating": string,
      "cncRating": string,
      "csaRating": string,
      "cscfRating": string,
      "czfilmRating": string,
      "djctqRating": string,
      "djctqRatingReasons": [,
        string
      ],
      "ecbmctRating": string,
      "eefilmRating": string,
      "egfilmRating": string,
      "eirinRating": string,
      "fcbmRating": string,
      "fcoRating": string,
      "fmocRating": string,
      "fpbRating": string,
      "fpbRatingReasons": [,
        string
      ],
      "fskRating": string,
      "grfilmRating": string,
      "icaaRating": string,
      "ifcoRating": string,
      "ilfilmRating": string,
      "incaaRating": string,
      "kfcbRating": string,
      "kijkwijzerRating": string,
      "kmrbRating": string,
      "lsfRating": string,
      "mccaaRating": string,
      "mccypRating": string,
      "mcstRating": string,
      "mdaRating": string,
      "medietilsynetRating": string,
      "mekuRating": string,
      "mibacRating": string,
      "mocRating": string,
      "moctwRating": string,
      "mpaaRating": string,
      "mpaatRating": string,
      "mtrcbRating": string,
      "nbcRating": string,
      "nbcplRating": string,
      "nfrcRating": string,
      "nfvcbRating": string,
      "nkclvRating": string,
      "oflcRating": string,
      "pefilmRating": string,
      "rcnofRating": string,
      "resorteviolenciaRating": string,
      "rtcRating": string,
      "rteRating": string,
      "russiaRating": string,
      "skfilmRating": string,
      "smaisRating": string,
      "smsaRating": string,
      "tvpgRating": string,
      "ytRating": string
    },
    "projection": string,
    "hasCustomThumbnail": boolean
  },
  "status": {
    "uploadStatus": string,
    "failureReason": string,
    "rejectionReason": string,
    "privacyStatus": string,
    "publishAt": datetime,
    "license": string,
    "embeddable": boolean,
    "publicStatsViewable": boolean,
    "madeForKids": boolean,
    "selfDeclaredMadeForKids": boolean
  },
  "statistics": {
    "viewCount": string,
    "likeCount": string,
    "dislikeCount": string,
    "favoriteCount": string,
    "commentCount": string
  },
  "player": {
    "embedHtml": string,
    "embedHeight": long,
    "embedWidth": long
  },
  "topicDetails": {
    "topicIds": [
      string
    ],
    "relevantTopicIds": [
      string
    ],
    "topicCategories": [
      string
    ]
  },
  "recordingDetails": {
    "recordingDate": datetime
  },
  "fileDetails": {
    "fileName": string,
    "fileSize": unsigned long,
    "fileType": string,
    "container": string,
    "videoStreams": [
      {
        "widthPixels": unsigned integer,
        "heightPixels": unsigned integer,
        "frameRateFps": double,
        "aspectRatio": double,
        "codec": string,
        "bitrateBps": unsigned long,
        "rotation": string,
        "vendor": string
      }
    ],
    "audioStreams": [
      {
        "channelCount": unsigned integer,
        "codec": string,
        "bitrateBps": unsigned long,
        "vendor": string
      }
    ],
    "durationMs": unsigned long,
    "bitrateBps": unsigned long,
    "creationTime": string
  },
  "processingDetails": {
    "processingStatus": string,
    "processingProgress": {
      "partsTotal": unsigned long,
      "partsProcessed": unsigned long,
      "timeLeftMs": unsigned long
    },
    "processingFailureReason": string,
    "fileDetailsAvailability": string,
    "processingIssuesAvailability": string,
    "tagSuggestionsAvailability": string,
    "editorSuggestionsAvailability": string,
    "thumbnailsAvailability": string
  },
  "suggestions": {
    "processingErrors": [
      string
    ],
    "processingWarnings": [
      string
    ],
    "processingHints": [
      string
    ],
    "tagSuggestions": [
      {
        "tag": string,
        "categoryRestricts": [
          string
        ]
      }
    ],
    "editorSuggestions": [
      string
    ]
  },
  "liveStreamingDetails": {
    "actualStartTime": datetime,
    "actualEndTime": datetime,
    "scheduledStartTime": datetime,
    "scheduledEndTime": datetime,
    "concurrentViewers": unsigned long,
    "activeLiveChatId": string
  },
  "localizations": {
    (key): {
      "title": string,
      "description": string
    }
  }
}

Attribute

In der folgenden Tabelle werden die Attribute definiert, die in dieser Ressource angezeigt werden:

Attribute
kind string
Identifiziert den Typ der API-Ressource. Der Wert ist youtube#video.
etag etag
Das ETag dieser Ressource.
id string
Die ID, mit der YouTube das Video eindeutig identifiziert.
snippet object
Das snippet-Objekt enthält grundlegende Details zum Video, z. B. Titel, Beschreibung und Kategorie.
snippet.publishedAt datetime
Datum und Uhrzeit der Veröffentlichung des Videos. Hinweis: Dieser Zeitpunkt kann von dem Zeitpunkt abweichen, zu dem das Video hochgeladen wurde. Wenn ein Video beispielsweise als privates Video hochgeladen und später veröffentlicht wird, gibt diese Property den Zeitpunkt der Veröffentlichung an.

Es gibt einige Sonderfälle:
  • Wenn ein Video als privates Video hochgeladen wird und die Videometadaten vom Kanalinhaber abgerufen werden, gibt der Eigenschaftswert das Datum und die Uhrzeit des Uploads an.
  • Wenn ein Video als nicht gelistetes Video hochgeladen wird, gibt der Eigenschaftswert auch Datum und Uhrzeit des Uploads an. In diesem Fall kann jeder, der die eindeutige Video-ID des Videos kennt, die Videometadaten abrufen.
Der Wert wird im Format ISO 8601 angegeben.
snippet.channelId string
Die ID, mit der YouTube den Kanal eindeutig identifiziert, auf den das Video hochgeladen wurde.
snippet.title string
Der Titel des Videos. Der Attributwert hat eine maximale Länge von 100 Zeichen und kann alle gültigen UTF-8-Zeichen außer < und > enthalten. Sie müssen einen Wert für dieses Attribut festlegen, wenn Sie die Methode videos.update aufrufen und den snippet-Teil einer video-Ressource aktualisieren.
snippet.description string
Die Beschreibung des Videos. Der Attributwert hat eine maximale Länge von 5.000 Byte und kann alle gültigen UTF-8-Zeichen außer < und > enthalten.
snippet.thumbnails object
Eine Karte mit den mit dem Video verknüpften Thumbnail-Bildern. Für jedes Objekt auf der Karte ist der Schlüssel der Name der Miniaturansicht. Der Wert ist ein Objekt, das weitere Informationen zur Miniaturansicht enthält.
snippet.thumbnails.(key) object
Gültige Schlüssel/Wert-Paare sind:
  • default: Das Standard-Thumbnail. Das Standard-Thumbnail für ein Video – oder eine Ressource, die auf ein Video verweist, z. B. ein Playlist-Element oder ein Suchergebnis – ist 120 Pixel breit und 90 Pixel hoch. Das Standard-Thumbnail für einen Kanal ist 88 Pixel breit und 88 Pixel hoch.
  • medium: Eine Version des Thumbnails mit höherer Auflösung. Bei einem Video oder einer Ressource, die auf ein Video verweist, ist das Bild 320 Pixel breit und 180 Pixel hoch. Bei einem Kanal ist dieses Bild 240 Pixel breit und 240 Pixel hoch.
  • high: Eine Version des Thumbnails mit hoher Auflösung. Bei einem Video oder einer Ressource, die auf ein Video verweist, ist das Bild 480 Pixel breit und 360 Pixel hoch. Bei einem Kanal ist dieses Bild 800 Pixel breit und 800 Pixel hoch.
  • standard: Eine Version des Thumbnails mit einer höheren Auflösung als das Bild mit high-Auflösung. Dieses Bild ist für einige Videos und andere Ressourcen verfügbar, die sich auf Videos beziehen, wie Playlist-Elemente oder Suchergebnisse. Dieses Bild ist 640 Pixel breit und 480 Pixel hoch.
  • maxres: Das Thumbnail mit der höchsten Auflösung. Diese Bildgröße ist für einige Videos und andere Ressourcen verfügbar, die sich auf Videos beziehen, wie Playlist-Elemente oder Suchergebnisse. Dieses Bild ist 1.280 Pixel breit und 720 Pixel hoch.
snippet.thumbnails.(key).url string
Die URL des Bilds.
snippet.thumbnails.(key).width unsigned integer
Die Breite des Bildes.
snippet.thumbnails.(key).height unsigned integer
Die Höhe des Bildes.
snippet.channelTitle string
Kanaltitel des Kanals, zu dem das Video gehört.
snippet.tags[] list
Eine Liste der mit dem Video verknüpften Keyword-Tags. Tags können Leerzeichen enthalten. Der Attributwert darf maximal 500 Zeichen lang sein. Beachten Sie folgende Regeln zur Berechnung der Zeichenbeschränkung:
  • Beim Wert der Eigenschaft handelt es sich um eine Liste. Kommas zwischen Elementen in der Liste werden auf den Grenzwert angerechnet.
  • Wenn ein Tag ein Leerzeichen enthält, behandelt der API-Server den Tag-Wert so, als wäre er in Anführungszeichen gesetzt, und die Anführungszeichen werden auf die Zeichenbeschränkung angerechnet. Im Sinne der Zeichenbeschränkung enthält das Tag Foo-Baz sieben Zeichen, das Tag Foo Baz jedoch neun.
snippet.categoryId string
Die YouTube-Videokategorie, die dem Video zugeordnet ist. Du musst einen Wert für dieses Attribut festlegen, wenn du die Methode videos.update aufrufst und den snippet-Teil einer video-Ressource aktualisierst.
snippet.liveBroadcastContent string
Gibt an, ob das Video eine anstehende/aktive Liveübertragung ist. Wenn das Video keine anstehende/aktive Liveübertragung ist, lautet der Wert „none“.

Gültige Werte für diese Property sind:
  • live
  • none
  • upcoming
snippet.defaultLanguage string
Die Sprache des Textes in den Attributen snippet.title und snippet.description der Ressource video.
snippet.localized object
Das snippet.localized-Objekt enthält entweder einen lokalisierten Titel und eine Beschreibung für das Video oder den Titel in der Standardsprache für die Metadaten des Videos.
  • Lokalisierter Text wird im Ressourcen-Snippet zurückgegeben, wenn bei der videos.list-Anfrage der Parameter hl verwendet wurde, um eine Sprache anzugeben, für die lokalisierter Text zurückgegeben werden soll und lokalisierter Text in dieser Sprache verfügbar ist.
  • Metadaten für die Standardsprache werden zurückgegeben, wenn kein hl-Parameterwert angegeben oder ein Wert angegeben ist, aber keine lokalisierten Metadaten für die angegebene Sprache verfügbar sind.
Das Attribut enthält einen schreibgeschützten Wert. Mit dem Objekt localizations kannst du lokalisierte Titel hinzufügen, aktualisieren oder löschen.
snippet.localized.title string
Der lokalisierte Videotitel.
snippet.localized.description string
Die lokalisierte Videobeschreibung.
snippet.defaultAudioLanguage string
Die Eigenschaft default_audio_language gibt die Sprache des Standard-Audiotracks des Videos an.
contentDetails object
Das contentDetails-Objekt enthält Informationen zum Videoinhalt, einschließlich der Länge des Videos und einen Hinweis darauf, ob für das Video Untertitel verfügbar sind.
contentDetails.duration string
Die Länge des Videos. Der Wert des Attributs ist eine Dauer gemäß ISO 8601. Beispiel: Für ein Video, das mindestens eine Minute und weniger als eine Stunde lang ist, hat die Dauer das Format PT#M#S, wobei die Buchstaben PT angeben, dass der Wert einen Zeitraum angibt, und die Buchstaben M und S sich auf die Länge in Minuten bzw. Sekunden beziehen. Die #-Zeichen vor den Buchstaben M und S sind beides Ganzzahlen, die die Anzahl der Minuten (oder Sekunden) des Videos angeben. Der Wert PT15M33S gibt beispielsweise an, dass das Video 15 Minuten und 33 Sekunden lang ist.

Wenn das Video mindestens eine Stunde lang ist, wird die Dauer im Format PT#H#M#S angegeben. Dabei gibt das # vor dem Buchstaben H die Länge des Videos in Stunden an und alle anderen Details sind wie oben beschrieben. Wenn das Video mindestens einen Tag lang ist, werden die Buchstaben P und T voneinander getrennt und das Format des Werts ist P#DT#H#M#S. Ausführliche Informationen finden Sie in der ISO 8601-Spezifikation.
contentDetails.dimension string
Gibt an, ob das Video in 3D oder 2D verfügbar ist.
contentDetails.definition string
Gibt an, ob das Video in HD (HD) oder nur in Standardauflösung verfügbar ist.

Gültige Werte für diese Property sind:
  • hd
  • sd
contentDetails.caption string
Gibt an, ob für das Video Untertitel verfügbar sind.

Gültige Werte für diese Property sind:
  • false
  • true
contentDetails.licensedContent boolean
Gibt an, ob das Video lizenzierte Inhalte darstellt. Das bedeutet, dass der Inhalt auf einen Kanal hochgeladen wurde, der mit einem YouTube-Contentpartner verknüpft ist, und dann von diesem Partner Anspruch erhoben hat.
contentDetails.regionRestriction object
Das regionRestriction-Objekt enthält Informationen zu den Ländern, in denen ein Video angesehen werden kann oder nicht. Das Objekt enthält entweder das Attribut contentDetails.regionRestriction.allowed oder das Attribut contentDetails.regionRestriction.blocked.
contentDetails.regionRestriction.allowed[] list
Eine Liste mit Regionscodes, die die Länder angeben, in denen das Video angesehen werden kann. Wenn diese Property vorhanden ist und im Wert kein Land aufgeführt ist, wird das Video in diesem Land nicht angezeigt. Wenn diese Property vorhanden ist und eine leere Liste enthält, wird das Video in allen Ländern gesperrt.
contentDetails.regionRestriction.blocked[] list
Eine Liste mit Regionscodes, die die Länder angeben, in denen das Video gesperrt ist. Wenn diese Eigenschaft vorhanden ist und im Wert kein Land aufgeführt ist, kann das Video in diesem Land angesehen werden. Wenn diese Property vorhanden ist und eine leere Liste enthält, kann das Video in allen Ländern wiedergegeben werden.
contentDetails.contentRating object
Gibt die Altersfreigaben an, die das Video nach verschiedenen Bewertungsschemata erhalten hat.
contentDetails.contentRating.acbRating string
Einstufung des Videos durch das Australian Classification Board (ACB) oder die Australian Communications and Media Authority (ACMA). ACMA-Altersfreigaben werden verwendet, um Fernsehsendungen für Kinder zu klassifizieren.

Gültige Werte für diese Eigenschaft sind:
  • acbC: Programme, die von der Australian Communications and Media Authority als C klassifiziert wurden. Diese Programme sind für Kinder (außer Vorschulkinder) gedacht, die jünger als 14 Jahre sind.
  • acbE–O
  • acbG – G
  • acbM – M
  • acbMa15plus – MA15+
  • acbP: Programme, die von der Australian Communications and Media Authority als P klassifiziert wurden. Diese Programme sind für Vorschulkinder gedacht.
  • acbPg – PG
  • acbR18plus bis R18+
  • acbUnrated
contentDetails.contentRating.agcomRating string
Die Bewertung des Videos durch die italienische Autorità per le Garanzie nelle Comunicazioni (AGCOM).

Gültige Werte für diese Unterkunft:
  • agcomT – T
  • agcomUnrated
  • agcomVm14 – VM14
  • agcomVm18 – VM18
contentDetails.contentRating.anatelRating string
Die Anatel (Asociación Nacional de Televisión)-Bewertung des Videos für das chilenische Fernsehen.

Gültige Werte für diese Unterkunft sind:
  • anatelA – A
  • anatelF – F
  • anatelI – I
  • anatelI10 – I-10
  • anatelI12 – I-12
  • anatelI7 – I-7
  • anatelR – R
  • anatelUnrated
contentDetails.contentRating.bbfcRating string
Die Bewertung des Videos wurde von der British Board of Film Classification (BBFC) bewertet.

Gültige Werte für diese Property sind:
  • bbfc12 – 12
  • bbfc12a–12:00
  • bbfc15 – 15
  • bbfc18 bis 18
  • bbfcPg – PG
  • bbfcR18 – R18
  • bbfcU – U
  • bbfcUnrated
contentDetails.contentRating.bfvcRating string
Die Bewertung des Videos durch das thailändische Board of Film and Video Censors.

Gültige Werte für diese Unterkunft sind:
  • bfvc13 – 13
  • bfvc15 – 15
  • bfvc18 bis 18
  • bfvc20 – 20
  • bfvcB – B
  • bfvcE–O
  • bfvcG – G
  • bfvcUnrated
contentDetails.contentRating.bmukkRating string
Die Bewertung des Videos vom österreichischen Bundesministerium für Unterricht, Kunst und Kultur.

Gültige Werte für diese Unterkunft:
  • bmukk10 bis 10+
  • bmukk12 bis 12 Jahre und älter
  • bmukk14 bis 14 Jahre
  • bmukk16 bis 16 Jahre und älter
  • bmukk6 bis 6 oder höher
  • bmukk8 bis 8 Jahre und älter
  • bmukkAa – uneingeschränkt
  • bmukkUnrated
contentDetails.contentRating.catvRating string
Altersfreigabesystem für das kanadische Fernsehen – kanadisches TV-Klassifizierungssystem (Canadian TV Classification System) Weitere Informationen finden Sie auf der Website des Canadian Broadcast Standards Council.

Gültige Werte für diese Property:
  • catv14plus bis 14 Jahre
  • catv18plus bis 18 Jahre und älter
  • catvC – C
  • catvC8 – C8
  • catvG – G
  • catvPg – PG
  • catvUnrated
contentDetails.contentRating.catvfrRating string
Die Altersfreigabe des Videos durch die kanadische Radio-Television and Telecommunications Commission (CRTC) für kanadisch-französische Sendungen. Weitere Informationen finden Sie auf der Website des Canadian Broadcast Standards Council.

Gültige Werte für diese Property:
  • catvfr13plus bis 13 Jahre und älter
  • catvfr16plus bis 16 Jahre und älter
  • catvfr18plus bis 18 Jahre und älter
  • catvfr8plus bis 8 Jahre und älter
  • catvfrG – G
  • catvfrUnrated
contentDetails.contentRating.cbfcRating string
Bewertung des Central Board of Film Certification (CBFC – Indien) des Videos.

Gültige Werte für diese Unterkunft sind:
  • cbfcA – A
  • cbfcS – S
  • cbfcU – U
  • cbfcUnrated
  • cbfcUA – U/A
  • cbfcUA7plus – U/A
  • cbfcUA13plus – U/A
  • cbfcUA16plus – U/A
contentDetails.contentRating.cccRating string
Die Bewertung des Videos zur Consejo de Calificación Cinematográfica (Chile).

Gültige Werte für diese Unterkunft:
  • ccc14 bis 14 Jahre
  • ccc18 bis 18 Jahre und älter
  • ccc18s – 18+ – contenido pornográfico
  • ccc18v – 18+ – contenido excesivamente Gewalto
  • ccc6 – ab 6 Jahren – Unpräzise für 7 Jahre
  • cccTe – Todo-Espectador
  • cccUnrated
contentDetails.contentRating.cceRating string
Die Bewertung des Videos von der portugiesischen Comissão de Classificação de Espect ́culos.

Gültige Werte für diese Property sind:
  • cceM12 – 12
  • cceM14 – 14
  • cceM16 – 16
  • cceM18 bis 18
  • cceM4 – 4
  • cceM6 – 6
  • cceUnrated
contentDetails.contentRating.chfilmRating string
Die Bewertung des Videos in der Schweiz.

Gültige Werte für diese Property sind:
  • chfilm0 – 0
  • chfilm12 – 12
  • chfilm16 – 16
  • chfilm18 bis 18
  • chfilm6 – 6
  • chfilmUnrated
contentDetails.contentRating.chvrsRating string
Bewertung des Videos gemäß der CHVRS-Bewertung (Canadian Home Video Rating System).

Gültige Werte für diese Property sind:
  • chvrs14a–14:00
  • chvrs18a–18:00
  • chvrsE–O
  • chvrsG – G
  • chvrsPg – PG
  • chvrsR – R
  • chvrsUnrated
contentDetails.contentRating.cicfRating string
Die Bewertung des Videos von der Commission de Contrôle des Films (Belgien).

Gültige Werte für diese Unterkunft sind:
  • cicfE–O
  • cicfKntEna – KNT/ENA
  • cicfKtEa – KT/EA
  • cicfUnrated
contentDetails.contentRating.cnaRating string
Die Bewertung des Videos aus der rumänischen CONSILIUL NATIONAL AL AUDIOVIZUALULUI (CNA).

Gültige Werte für diese Property sind:
  • cna12 – 12
  • cna15 – 15
  • cna18 bis 18
  • cna18plus bis 18 Jahre und älter
  • cnaAp – ZP
  • cnaUnrated
contentDetails.contentRating.cncRating string
Bewertungssystem in Frankreich – Kinematografie der Kommission zur Deklassifizierung

Gültige Werte für diese Unterkunft sind:
  • cnc10 – 10
  • cnc12 – 12
  • cnc16 – 16
  • cnc18 bis 18
  • cncE–O
  • cncT – T
  • cncUnrated
contentDetails.contentRating.csaRating string
Die Bewertung des Videos der französischen Conseil de l?audiovisuel, in der Übertragungsinhalte bewertet werden.

Gültige Werte für diese Unterkunft sind:
  • csa10 – 10
  • csa12 – 12
  • csa16 – 16
  • csa18 bis 18
  • csaInterdiction – Verbot
  • csaT – T
  • csaUnrated
contentDetails.contentRating.cscfRating string
Die Bewertung des Videos durch die Luxemburger Commission de surveillance de la classification des films (CSCF).

Gültige Werte für diese Unterkunft:
  • cscf12 – 12
  • cscf16 – 16
  • cscf18 bis 18
  • cscf6 – 6
  • cscf9 – 9
  • cscfA – A
  • cscfAl – AL
  • cscfUnrated
contentDetails.contentRating.czfilmRating string
Die Bewertung des Videos in der Tschechischen Republik.

Gültige Werte für diese Property sind:
  • czfilm12 – 12
  • czfilm14 – 14
  • czfilm18 bis 18
  • czfilmU – U
  • czfilmUnrated
contentDetails.contentRating.djctqRating string
Die Bewertung im Departamento de Justiça, Classificação, Qualificação e Títulos (DJCQT – Brasilien) des Videos.

Gültige Werte für diese Unterkunft sind:
  • djctq10 – 10
  • djctq12 – 12
  • djctq14 – 14
  • djctq16 – 16
  • djctq18 bis 18
  • djctqL – L
  • djctqUnrated
contentDetails.contentRating.djctqRatingReasons[] list
Gründe, warum das Video die Bewertung als DJCQT (Brasilien) erhalten hat
contentDetails.contentRating.ecbmctRating string
Bewertungssystem in der Türkei – Evaluation and Classification Board des Ministeriums für Kultur und Tourismus

Gültige Werte für diese Unterkunft:
  • ecbmct13a–13:00
  • ecbmct13plus bis 13 Jahre und älter
  • ecbmct15a–15:00
  • ecbmct15plus bis 15 Jahre und älter
  • ecbmct18plus bis 18 Jahre und älter
  • ecbmct7a–7:00
  • ecbmct7plus bis 7 oder höher
  • ecbmctG – G
  • ecbmctUnrated
  • ecbmct6a–6:00
  • ecbmct6plus bis 6 oder höher
  • ecbmct10a–10:00
  • ecbmct10plus bis 10+
  • ecbmct16plus bis 16 Jahre und älter
contentDetails.contentRating.eefilmRating string
Die Bewertung des Videos in Estland.

Gültige Werte für diese Property sind:
  • eefilmK12 bis Primar- und Sekundarstufe
  • eefilmK14 bis Primar- und Sekundarstufe
  • eefilmK16 bis Primar- und Sekundarstufe
  • eefilmK6 bis 6. Klasse
  • eefilmL – L
  • eefilmMs12 – MS-12
  • eefilmMs6 – MS-6
  • eefilmPere – Pere
  • eefilmUnrated
contentDetails.contentRating.egfilmRating string
Die Bewertung des Videos in Ägypten.

Gültige Werte für diese Unterkunft sind:
  • egfilm18 bis 18
  • egfilmBn – BN
  • egfilmGn – GN
  • egfilmUnrated
contentDetails.contentRating.eirinRating string
Die Bewertung von Eirin (映倫) für das Video. Eirin ist das japanische Bewertungssystem.

Gültige Werte für diese Unterkunft sind:
  • eirinG – G
  • eirinPg12 – PG-12
  • eirinR15plus – R15+
  • eirinR18plus bis R18+
  • eirinUnrated
contentDetails.contentRating.fcbmRating string
Die Bewertung des Videos vom malaysischen Film Censorship Board.

Gültige Werte für diese Unterkunft sind:
  • fcbm13 – 13
  • fcbm16 – 16
  • fcbm18 bis 18
  • fcbm18pa bis 18 PA
  • fcbm18pl–18 PLN
  • fcbm18sg – 18SG
  • fcbm18sx – 18SX
  • fcbmP12 – P12
  • fcbmP13 – P13
  • fcbmPg13 – PG13
  • fcbmU – U
  • fcbmUnrated
contentDetails.contentRating.fcoRating string
Die Bewertung des Videos vom Hongkonger Office for Film, Newspaper and Article Administration.

Gültige Werte für diese Property sind:
  • fcoI – I
  • fcoIi – II
  • fcoIia – IIA
  • fcoIib – IIB
  • fcoIii – III
  • fcoUnrated
contentDetails.contentRating.fmocRating string
Diese Property wurde am 2. November 2015 eingestellt. Verwende stattdessen die Property contentDetails.contentRating.cncRating.

Die Bewertung „Centre national du cinéma et de l'image animé“ (französisches Kulturministerium) des Videos.

Gültige Werte für diese Unterkunft sind:
  • fmoc10 – 10
  • fmoc12 – 12
  • fmoc16 – 16
  • fmoc18 bis 18
  • fmocE–O
  • fmocU – U
  • fmocUnrated
contentDetails.contentRating.fpbRating string
Die Bewertung des Videos durch die südafrikanische Film- und Publikationsbehörde.

Gültige Werte für diese Property sind:
  • fpb10 – 10
  • fpb1012Pg – 10–12 PG
  • fpb13 – 13
  • fpb16 – 16
  • fpb18 bis 18
  • fpb79Pg – 7–9 PG
  • fpbA – A
  • fpbPg – PG
  • fpbUnrated
  • fpbX18 – X18
  • fpbXx – XX
contentDetails.contentRating.fpbRatingReasons[] list
Gründe, warum das Video die FPB-Altersfreigabe erhalten hat (Südafrika)
contentDetails.contentRating.fskRating string
Die Bewertung der Freiwilligen Selbstkontrolle der Filmwirtschaft (FSK – Deutschland) für das Video.

Gültige Werte für diese Unterkunft sind:
  • fsk0 – 0 FSK
  • fsk12 – FSK 12
  • fsk16 – FSK 16
  • fsk18 – FSK 18
  • fsk6 – FSK 6
  • fskUnrated
contentDetails.contentRating.grfilmRating string
Die Bewertung des Videos in Griechenland.

Gültige Werte für diese Unterkunft sind:
  • grfilmE–O
  • grfilmK – K
  • grfilmK12 bis Primar- und Sekundarstufe
  • grfilmK13 bis Primar- und Sekundarstufe
  • grfilmK15 bis Primar- und Sekundarstufe
  • grfilmK17 bis Primar- und Sekundarstufe
  • grfilmK18 bis Primar- und Sekundarstufe
  • grfilmUnrated
contentDetails.contentRating.icaaRating string
Bewertung vom Instituto de la Cinematografía y de las Artes Audiovisuales (ICAA – Spanien) des Videos.

Gültige Werte für diese Unterkunft:
  • icaa12 – 12
  • icaa13 – 13
  • icaa16 – 16
  • icaa18 bis 18
  • icaa7 – 7
  • icaaApta – APTA
  • icaaUnrated
  • icaaX – X
contentDetails.contentRating.ifcoRating string
Bewertung des Videos durch die Irish Film Classification Office (IFCO – Ireland) Weitere Informationen finden Sie auf der Website von IFCO.

Gültige Werte für diese Unterkunft sind:
  • ifco12 – 12
  • ifco12a–12:00
  • ifco15 – 15
  • ifco15a–15:00
  • ifco16 – 16
  • ifco18 bis 18
  • ifcoG – G
  • ifcoPg – PG
  • ifcoUnrated
contentDetails.contentRating.ilfilmRating string
Die Bewertung des Videos in Israel.

Gültige Werte für diese Property sind:
  • ilfilm12 – 12
  • ilfilm16 – 16
  • ilfilm18 bis 18
  • ilfilmAa – AA
  • ilfilmUnrated
contentDetails.contentRating.incaaRating string
Die INAA-Bewertung des Videos (Instituto Nacional de Cine y Artes Audiovisuales – Argentinien) für das Video.

Gültige Werte für diese Unterkunft sind:
  • incaaAtp: ATP (Apta para todo publico)
  • incaaC – X (Solo apta para mayores de 18 años, de exhibición condicionada)
  • incaaSam13 – 13 (Solo apta para mayores de 13 años)
  • incaaSam16 – 16 (Solo apta para mayores de 16 años)
  • incaaSam18 – 18 (Solo apta para mayores de 18 años)
  • incaaUnrated
contentDetails.contentRating.kfcbRating string
Die Bewertung des Videos vom Kenya Film Classification Board.

Gültige Werte für diese Property sind:
  • kfcb16plus – 16
  • kfcbG – GE
  • kfcbPg – PG
  • kfcbR bis 18
  • kfcbUnrated
contentDetails.contentRating.kijkwijzerRating string
voor de Classificatie van Audiovisuele Media (Niederlande).

Gültige Werte für diese Unterkunft sind:
  • kijkwijzer12 – 12
  • kijkwijzer14 – 14
  • kijkwijzer16 – 16
  • kijkwijzer18 bis 18
  • kijkwijzer6 – 6
  • kijkwijzer9 – 9
  • kijkwijzerAl – AL
  • kijkwijzerUnrated
contentDetails.contentRating.kmrbRating string
Die Bewertung des Videos vom Korea Media Rating Board (영상물등전위원회) Der KMRB bewertet Videos in Südkorea.

Gültige Werte für diese Unterkunft sind:
  • kmrb12plus – 12에 이상 관람커
  • kmrb15plus – 15NUMBEROF 이상 관람트
  • kmrbAll – 서체관람트
  • kmrbR – 청소년 관람불로
  • kmrbTeenr
  • kmrbUnrated
contentDetails.contentRating.lsfRating string
Die Bewertung des Videos vom indonesischen Lembaga Sensor Film.

Gültige Werte für diese Unterkunft sind:
  • lsf13 – 13
  • lsf17 bis 17
  • lsf21 bis 21
  • lsfA – A
  • lsfBo – BO
  • lsfD – D
  • lsfR – R
  • lsfSu – SU
  • lsfUnrated
contentDetails.contentRating.mccaaRating string
Die Bewertung des Videos vom Malta Film Age-Classification Board.

Gültige Werte für diese Unterkunft sind:
  • mccaa12 – 12
  • mccaa12a–12:00
  • mccaa14 – 14: Diese Bewertung wurde aus der 2013 eingeführten neuen Klassifizierungsstruktur entfernt.
  • mccaa15 – 15
  • mccaa16 – 16: Diese Bewertung wurde aus der 2013 eingeführten neuen Klassifizierungsstruktur entfernt.
  • mccaa18 bis 18
  • mccaaPg – PG
  • mccaaU – U
  • mccaaUnrated
contentDetails.contentRating.mccypRating string
Die Bewertung des Videos durch den Media Council for Children and Young People des Dänischen Filminstituts (Det Danske Filminstitut)

Gültige Werte für diese Unterkunft:
  • mccyp11 bis 11
  • mccyp15 – 15
  • mccyp7 – 7
  • mccypA – A
  • mccypUnrated
contentDetails.contentRating.mcstRating string
Das Bewertungssystem des Videos für Vietnam – MCST

Gültige Werte für diese Property:
  • mcst0 – 0
  • mcst16plus bis 16 Jahre und älter
  • mcstC13 bis C13
  • mcstC16 – C16
  • mcstC18 – C18
  • mcstP – P
  • mcstUnrated
  • mcstT13 – T13
  • mcstT16 – T16
  • mcstT18 – T18
  • mcstK – K
contentDetails.contentRating.mdaRating string
Die Bewertung des Videos durch die Media Development Authority (MDA) in Singapur und insbesondere das Board of Film Censors (BFC).

Gültige Werte für diese Unterkunft sind:
  • mdaG – G
  • mdaM18 – M18
  • mdaNc16 – NC16
  • mdaPg – PG
  • mdaPg13 – PG13
  • mdaR21 bis R21
  • mdaUnrated
contentDetails.contentRating.medietilsynetRating string
Die Bewertung des Videos von Medietilsynet, der norwegischen Medienbehörde.

Gültige Werte für diese Property sind:
  • medietilsynet11 bis 11
  • medietilsynet12 – 12
  • medietilsynet15 – 15
  • medietilsynet18 bis 18
  • medietilsynet6 – 6
  • medietilsynet7 – 7
  • medietilsynet9 – 9
  • medietilsynetA – A
  • medietilsynetUnrated
contentDetails.contentRating.mekuRating string
Die Bewertung des Videos vom finnischen Kansallinen Audiovisuaalinen Instituutti (Nationales Audiovisuelles Institut).

Gültige Werte für diese Unterkunft:
  • meku12 – 12
  • meku16 – 16
  • meku18 bis 18
  • meku7 – 7
  • mekuS – S
  • mekuUnrated
contentDetails.contentRating.mibacRating string
Die Bewertung des Videos vom Ministero dei Beni e delle Attività Culturali e del Turismo (Italien).

Gültige Werte für diese Unterkunft sind:
  • mibacT
  • mibacUnrated
  • mibacVap
  • mibacVm6
  • mibacVm12
  • mibacVm14
  • mibacVm18
contentDetails.contentRating.mocRating string
Bewertung des Videos vom Ministerio de Cultura (Kolumbien).

Gültige Werte für diese Unterkunft sind:
  • moc12 – 12
  • moc15 – 15
  • moc18 bis 18
  • moc7 – 7
  • mocBanned – gesperrt
  • mocE–O
  • mocT – T
  • mocUnrated
  • mocX – X
contentDetails.contentRating.moctwRating string
Die Bewertung des Videos durch das taiwanesische Kulturministerium (文化部).

Gültige Werte für diese Unterkunft sind:
  • moctwG – G
  • moctwP – P
  • moctwPg – PG
  • moctwR – R
  • moctwR12 – R-12
  • moctwR15 – R-15
  • moctwUnrated
contentDetails.contentRating.mpaaRating string
Die Bewertung des Videos von der Motion Picture Association of America (MPAA).

Gültige Werte für diese Property sind:
  • mpaaG – G
  • mpaaNc17 – NC-17
  • mpaaPg – PG
  • mpaaPg13 – PG-13
  • mpaaR – R
  • mpaaUnrated
contentDetails.contentRating.mpaatRating string
Die Bewertung der Motion Picture Association of America für Filmtrailer und Vorschau.

Gültige Werte für diese Property sind:
  • mpaatGb – GB (grünes Band – für alle Zielgruppen freigegeben)
  • mpaatRb – RB (Rotes Band – empfohlen für Kinder ab 17 Jahren)
contentDetails.contentRating.mtrcbRating string
Die Bewertung des Videos vom Movie and Television Review and Classification Board (Philippinen)

Gültige Werte für diese Property sind:
  • mtrcbG – G
  • mtrcbPg – PG
  • mtrcbR13 – R-13
  • mtrcbR16 – R-16
  • mtrcbR18 – R-18
  • mtrcbUnrated
  • mtrcbX – X
contentDetails.contentRating.nbcRating string
Die Bewertung des Videos vom Maldives National Bureau of Classification.

Gültige Werte für diese Unterkunft sind:
  • nbc12plus bis 12 Jahre und älter
  • nbc15plus bis 15 Jahre und älter
  • nbc18plus bis 18 Jahre und älter
  • nbc18plusr – 18+R
  • nbcG – G
  • nbcPg – PG
  • nbcPu – PU
  • nbcUnrated
contentDetails.contentRating.nfrcRating string
Die Bewertung des Videos vom Bulgarischen Nationalen Filmzentrum.

Gültige Werte für diese Unterkunft sind:
  • nfrcA – A
  • nfrcB – B
  • nfrcC – C
  • nfrcD – D
  • nfrcUnrated
  • nfrcX – X
contentDetails.contentRating.nfvcbRating string
Die Bewertung des Videos vom National Film and Video Censors Board in Nigeria.

Gültige Werte für diese Unterkunft sind:
  • nfvcb12 – 12
  • nfvcb12a–12:00
  • nfvcb15 – 15
  • nfvcb18 bis 18
  • nfvcbG – G
  • nfvcbPg – PG
  • nfvcbRe – RE
  • nfvcbUnrated
contentDetails.contentRating.nkclvRating string
Die Bewertung des Videos vom Nacionãlais Kino centrs (Nationales Filmzentrum von Lettland).

Gültige Werte für diese Unterkunft sind:
  • nkclv12plus bis 12 Jahre und älter
  • nkclv18plus bis 18 Jahre und älter
  • nkclv7plus bis 7 oder höher
  • nkclvU – U
  • nkclvUnrated
contentDetails.contentRating.oflcRating string
Bewertung des Office of Film and Literature Classification (OFLC – Neuseeland) des Videos.

Gültige Werte für diese Property sind:
  • oflcG – G
  • oflcM – M
  • oflcPg – PG
  • oflcR13 – R13
  • oflcR15–15 R
  • oflcR16 – R16
  • oflcR18 – R18
  • oflcRp13 – RP13
  • oflcRp16 – RP16
  • oflcUnrated
contentDetails.contentRating.pefilmRating string
Die Bewertung des Videos in Peru.

Gültige Werte für diese Property sind:
  • pefilm14 – 14
  • pefilm18 bis 18
  • pefilmPg – PG
  • pefilmPt – PT
  • pefilmUnrated
contentDetails.contentRating.resorteviolenciaRating string
Die Bewertung des Videos in Venezuela.

Gültige Werte für diese Unterkunft sind:
  • resorteviolenciaA – A
  • resorteviolenciaB – B
  • resorteviolenciaC – C
  • resorteviolenciaD – D
  • resorteviolenciaE–O
  • resorteviolenciaUnrated
contentDetails.contentRating.rtcRating string
Bewertung der Generaldirektion für Radio, Fernsehen und Kino (Mexiko) des Videos.

Gültige Werte für diese Property sind:
  • rtcA – A
  • rtcAa – AA
  • rtcB – B
  • rtcB15 – B15
  • rtcC – C
  • rtcD – D
  • rtcUnrated
contentDetails.contentRating.rteRating string
Die Bewertung des Videos von der irischen Raidió Teilifís Éireann.

Gültige Werte für diese Property sind:
  • rteCh – CH
  • rteGa – GA
  • rteMa – MA
  • rtePs – PS
  • rteUnrated
contentDetails.contentRating.russiaRating string
Bewertung des Videos vom National Film Registry of the Russian Federation (MKRF – Russland).

Gültige Werte für diese Property sind:
  • russia0 bis 0+
  • russia12 bis 12 Jahre und älter
  • russia16 bis 16 Jahre und älter
  • russia18 bis 18 Jahre und älter
  • russia6 bis 6 oder höher
  • russiaUnrated
contentDetails.contentRating.skfilmRating string
Die Bewertung des Videos in der Slowakei.

Gültige Werte für diese Property sind:
  • skfilmG – G
  • skfilmP2 – P2
  • skfilmP5 – P5
  • skfilmP8 – P8
  • skfilmUnrated
contentDetails.contentRating.smaisRating string
Die Bewertung des Videos in Island.

Gültige Werte für diese Property sind:
  • smais12 – 12
  • smais14 – 14
  • smais16 – 16
  • smais18 bis 18
  • smais7 – 7
  • smaisL – L
  • smaisUnrated
contentDetails.contentRating.smsaRating string
Die Bewertung des Videos durch Statens medieråd (National Media Council in Schweden).

Gültige Werte für diese Property sind:
  • smsa11 bis 11
  • smsa15 – 15
  • smsa7 – 7
  • smsaA – alle Altersgruppen
  • smsaUnrated
contentDetails.contentRating.tvpgRating string
Die Altersfreigabe „TV Parental Guidelines“ (TVPG) des Videos.

Gültige Werte für diese Property sind:
  • tvpgG – TV-G
  • tvpgMa – TV-MA
  • tvpgPg: TV-PG
  • tvpgUnrated
  • tvpgY – TV-Y
  • tvpgY7 – TV-Y7
  • tvpgY7Fv – TV-Y7-FV
  • pg14 – TV-14
contentDetails.contentRating.ytRating string
Eine Bewertung, die YouTube zur Identifizierung von Inhalten mit Altersbeschränkung verwendet.

Gültige Werte für diese Property sind:
  • ytAgeRestricted
contentDetails.projection string
Gibt das Projektionsformat des Videos an.

Gültige Werte für dieses Attribut sind:
  • 360
  • rectangular
contentDetails.hasCustomThumbnail boolean
Gibt an, ob der Uploader ein benutzerdefiniertes Thumbnail für das Video bereitgestellt hat. Diese Eigenschaft ist nur für den Video-Uploader sichtbar.
status object
Das status-Objekt enthält Informationen zum Upload- und Verarbeitungsstatus sowie zum Datenschutzstatus des Videos.
status.uploadStatus string
Der Status des hochgeladenen Videos.

Gültige Werte für diese Property sind:
  • deleted
  • failed
  • processed
  • rejected
  • uploaded
status.failureReason string
Dieser Wert gibt an, warum ein Video nicht hochgeladen werden konnte. Dieses Attribut ist nur vorhanden, wenn das Attribut uploadStatus anzeigt, dass der Upload fehlgeschlagen ist.

Gültige Werte für dieses Attribut sind:
  • codec
  • conversion
  • emptyFile
  • invalidFile
  • tooSmall
  • uploadAborted
status.rejectionReason string
Dieser Wert gibt an, warum YouTube ein hochgeladenes Video abgelehnt hat. Dieses Attribut ist nur vorhanden, wenn das Attribut uploadStatus angibt, dass der Upload abgelehnt wurde.

Gültige Werte für diese Property sind:
  • claim
  • copyright
  • duplicate
  • inappropriate
  • legal
  • length
  • termsOfUse
  • trademark
  • uploaderAccountClosed
  • uploaderAccountSuspended
status.privacyStatus string
Der Datenschutzstatus des Videos.

Gültige Werte für diese Property sind:
  • private
  • public
  • unlisted
status.publishAt datetime
Datum und Uhrzeit der geplanten Veröffentlichung des Videos. Sie kann nur festgelegt werden, wenn der Datenschutzstatus des Videos „Privat“ ist. Der Wert wird im ISO 8601-Format angegeben. Beachten Sie die folgenden zwei zusätzlichen Punkte zum Verhalten dieser Eigenschaft:
  • Wenn du den Wert dieser Eigenschaft beim Aufrufen der videos.update-Methode festlegst, musst du auch den status.privacyStatus-Eigenschaftswert auf private setzen, auch wenn das Video bereits privat ist.
  • Wenn du die Veröffentlichung eines Videos in der Vergangenheit angibst, wird das Video sofort veröffentlicht. Wenn du die Eigenschaft status.publishAt auf ein Datum und eine Uhrzeit in der Vergangenheit setzt, hat das dieselbe Auswirkung wie die Änderung der privacyStatus des Videos von private zu public.
status.license string
Die Lizenz für das Video.

Gültige Werte für diese Property sind:
  • creativeCommon
  • youtube
status.embeddable boolean
Dieser Wert gibt an, ob das Video auf einer anderen Website eingebettet werden kann.
status.publicStatsViewable boolean
Dieser Wert gibt an, ob die erweiterten Videostatistiken auf der Wiedergabeseite des Videos öffentlich sichtbar sind. Diese Statistiken sind standardmäßig sichtbar. Statistiken wie die Anzahl der Aufrufe und Bewertungen eines Videos sind auch dann öffentlich sichtbar, wenn der Wert dieser Eigenschaft auf false gesetzt ist.
status.madeForKids boolean
Dieser Wert gibt an, ob das Video als „Für Kinder“ gekennzeichnet ist, und enthält den aktuellen Status „Speziell für Kinder“ des Videos. Der Status kann beispielsweise anhand des Werts des Attributs selfDeclaredMadeForKids ermittelt werden. Weitere Informationen zum Festlegen der Zielgruppe für deinen Kanal, deine Videos oder deine Übertragungen findest du in der YouTube-Hilfe.
status.selfDeclaredMadeForKids boolean
In einer videos.insert- oder videos.update-Anfrage kann der Kanalinhaber das Video mit dieser Property als auf Kinder ausgerichtet kennzeichnen. Bei einer videos.list-Anfrage wird der Attributwert nur zurückgegeben, wenn der Kanalinhaber die API-Anfrage autorisiert hat.
statistics object
Das Objekt statistics enthält Statistiken zum Video.
statistics.viewCount unsigned long
Gibt an, wie oft das Video aufgerufen wurde.
statistics.likeCount unsigned long
Die Anzahl der Nutzer, die angegeben haben, dass ihnen das Video gefallen hat.
statistics.dislikeCount unsigned long
Hinweis:Die Property statistics.dislikeCount wurde am 13. Dezember 2021 als privat gekennzeichnet. Das bedeutet, dass die Property nur dann in einer API-Antwort enthalten ist, wenn die API-Anfrage vom Videoinhaber authentifiziert wurde. Weitere Informationen finden Sie im Überarbeitungsverlauf.

Die Anzahl an Nutzern, die angegeben haben, dass ihnen das Video nicht gefallen hat.
statistics.favoriteCount unsigned long
Hinweis:Dieses Attribut wurde eingestellt. Die Einstellung tritt am 28. August 2015 in Kraft. Der Wert des Attributs ist jetzt immer auf 0 festgelegt.
statistics.commentCount unsigned long
Die Anzahl der Kommentare für das Video.
player object
Das player-Objekt enthält Informationen, mit denen du das Video in einem eingebetteten Player abspielen würdest.
player.embedHtml string
Ein <iframe>-Tag, das einen Player einbettet, der das Video abspielt.
  • Wenn in der API-Anfrage zum Abrufen der Ressource ein Wert für die Parameter maxHeight und/oder maxWidth angegeben ist, wird die Größe des eingebetteten Players so skaliert, dass die Anforderungen maxHeight und/oder maxWidth erfüllt werden.
  • Wenn das Seitenverhältnis des Videos unbekannt ist, verwendet der eingebettete Player standardmäßig das 4:3-Format.
player.embedHeight long
Die Höhe des eingebetteten Players, die in der Eigenschaft player.embedHtml zurückgegeben wird. Diese Eigenschaft wird nur zurückgegeben, wenn in der Anfrage ein Wert für die Parameter maxHeight und/oder maxWidth angegeben wurde und das Seitenverhältnis des Videos bekannt ist.
player.embedWidth long
Die Breite des eingebetteten Players, die in der Eigenschaft player.embedHtml zurückgegeben wird. Diese Eigenschaft wird nur zurückgegeben, wenn in der Anfrage ein Wert für die Parameter maxHeight und/oder maxWidth angegeben wurde und das Seitenverhältnis des Videos bekannt ist.
topicDetails object
Das Objekt topicDetails enthält Informationen zu Themen, die mit dem Video verknüpft sind.

Wichtig:Weitere Informationen zu anstehenden Änderungen in Bezug auf Themen-IDs finden Sie in den Definitionen der Properties topicDetails.relevantTopicIds[] und topicDetails.topicIds[] sowie im Überarbeitungsverlauf.
topicDetails.topicIds[] list
Wichtig:Diese Property wurde am 10. November 2016 eingestellt. Die API gibt keine Werte mehr für diese Property zurück. Alle mit einem Video verknüpften Themen werden jetzt vom Property-Wert topicDetails.relevantTopicIds[] zurückgegeben.
topicDetails.relevantTopicIds[] list
Eine Liste mit Themen-IDs, die für das Video relevant sind.

Diese Property wurde am 10. November 2016 eingestellt. Sie wird bis zum 10. November 2017 unterstützt.

Wichtig: Aufgrund der Einstellung von Freebase und der Freebase API funktionieren Themen-IDs seit dem 27. Februar 2017 anders. Zu dieser Zeit gab YouTube eine kleine Auswahl ausgewählter Themen-IDs zurück.

topicDetails.topicCategories[] list
Eine Liste von Wikipedia-URLs, die eine allgemeine Beschreibung des Videoinhalts enthalten.
recordingDetails object
Das recordingDetails-Objekt enthält Informationen über den Ort, das Datum und die Adresse, an der das Video aufgezeichnet wurde.
recordingDetails.locationDescription string
Diese Property wurde am 1. Juni 2017 eingestellt. Weitere Informationen finden Sie in der Mitteilung zur Einstellung.

Die Textbeschreibung des Orts, an dem das Video aufgezeichnet wurde.
recordingDetails.location object
Die Informationen zur Standortbestimmung, die mit dem Video verknüpft sind. Die Werte der untergeordneten Property geben den Standort an, den der Videoinhaber mit dem Video verknüpfen möchte. Der Wert kann bearbeitet, bei öffentlichen Videos gesucht und Nutzern bei öffentlichen Videos angezeigt werden.
recordingDetails.location.latitude double
Diese Property wurde am 1. Juni 2017 eingestellt. Weitere Informationen finden Sie in der Mitteilung zur Einstellung.

Breitengrad in Grad.
recordingDetails.location.longitude double
Diese Property wurde am 1. Juni 2017 eingestellt. Weitere Informationen finden Sie in der Mitteilung zur Einstellung.

Längengrad in Grad.
recordingDetails.location.altitude double
Diese Property wurde am 9. Juli 2018 eingestellt. Weitere Informationen finden Sie in der Mitteilung zur Einstellung.

Höhe über dem Referenzellipsoid in Metern.
recordingDetails.recordingDate datetime
Datum und Uhrzeit der Videoaufzeichnung. Der Wert wird im Format ISO 8601 (YYYY-MM-DDThh:mm:ss.sssZ) angegeben.
fileDetails object
Das fileDetails-Objekt enthält Informationen über die Videodatei, die auf YouTube hochgeladen wurde, einschließlich Auflösung, Dauer, Audio- und Video-Codecs, Stream-Bitraten und mehr. Diese Daten können nur vom Rechteinhaber des Videos abgerufen werden.

Das fileDetails-Objekt wird nur zurückgegeben, wenn das Attribut processingDetails.fileAvailability den Wert available hat.
fileDetails.fileName string
Der Name der hochgeladenen Datei. Dieses Feld ist vorhanden, unabhängig davon, ob eine Videodatei oder ein anderer Dateityp hochgeladen wurde.
fileDetails.fileSize unsigned long
Die Größe der hochgeladenen Datei in Byte. Dieses Feld ist vorhanden, unabhängig davon, ob eine Videodatei oder ein anderer Dateityp hochgeladen wurde.
fileDetails.fileType string
Der Typ der hochgeladenen Datei, wie er von der Videoverarbeitungs-Engine von YouTube erkannt wurde. Derzeit verarbeitet YouTube nur Videodateien. Dieses Feld ist jedoch vorhanden, unabhängig davon, ob eine Videodatei oder ein anderer Dateityp hochgeladen wurde.

Gültige Werte für diese Eigenschaft sind:
  • archive: Die Datei ist eine Archivdatei, z. B. ein ZIP-Archiv.
  • audio: Die Datei ist ein bekannter Audiodateityp, z. B. eine MP3-Datei.
  • document: Die Datei ist ein Dokument oder eine Textdatei, z. B. ein MS Word-Dokument.
  • image: Die Datei ist eine Bilddatei, z. B. ein JPEG-Bild.
  • other: Bei dieser Datei handelt es sich um einen anderen Dateityp, der keine Videodateien ist.
  • project: Die Datei ist eine Videoprojektdatei, z. B. ein Projekt in Microsoft Windows Movie Maker, die keine tatsächlichen Videodaten enthält.
  • video: Die Datei ist ein bekannter Videodateityp, z. B. eine MP4-Datei.
fileDetails.container string
Das Containerformat der hochgeladenen Videodatei.
fileDetails.videoStreams[] list
Eine Liste der Videostreams, die in der hochgeladenen Videodatei enthalten sind. Jedes Element in der Liste enthält detaillierte Metadaten zu einem Videostream.
fileDetails.videoStreams[].widthPixels unsigned integer
Die Breite des codierten Videocontents in Pixeln. Du kannst das Seitenverhältnis für die Codierung des Videos als width_pixels / height_pixels berechnen.
fileDetails.videoStreams[].heightPixels unsigned integer
Höhe des codierten Videocontents in Pixeln
fileDetails.videoStreams[].frameRateFps double
Die Framerate des Videostreams in Bildern pro Sekunde.
fileDetails.videoStreams[].aspectRatio double
Das Seitenverhältnis des Videoinhalts, das angibt, in welchem Seitenverhältnis das Video angezeigt werden soll.
fileDetails.videoStreams[].codec string
Der Video-Codec, der für den Stream verwendet wird.
fileDetails.videoStreams[].bitrateBps unsigned long
Die Bitrate des Videostreams in Bit pro Sekunde.
fileDetails.videoStreams[].rotation string
Der Betrag, um den YouTube den ursprünglichen Quellcontent rotieren muss, damit das Video richtig wiedergegeben wird.

Gültige Werte für diese Property sind:
  • clockwise: Das Video muss um 90 Grad im Uhrzeigersinn gedreht werden.
  • counterClockwise: Das Video muss um 90 Grad gegen den Uhrzeigersinn gedreht werden.
  • none: Das Video muss nicht gedreht werden.
  • other: Das Video muss auf eine andere, nicht triviale Weise gedreht werden.
  • upsideDown: Das Video muss verkehrt herum gedreht werden.
fileDetails.videoStreams[].vendor string
Ein Wert, der einen Videoanbieter eindeutig identifiziert. In der Regel ist der Wert ein aus vier Buchstaben bestehender Anbietercode.
fileDetails.audioStreams[] list
Eine Liste der Audiostreams, die in der hochgeladenen Videodatei enthalten sind. Jedes Element in der Liste enthält detaillierte Metadaten zu einem Audiostream.
fileDetails.audioStreams[].channelCount unsigned integer
Die Anzahl der Audiokanäle im Stream.
fileDetails.audioStreams[].codec string
Der Audio-Codec, der für den Stream verwendet wird.
fileDetails.audioStreams[].bitrateBps unsigned long
Die Bitrate des Audiostreams in Bit pro Sekunde.
fileDetails.audioStreams[].vendor string
Ein Wert, der einen Videoanbieter eindeutig identifiziert. In der Regel ist der Wert ein aus vier Buchstaben bestehender Anbietercode.
fileDetails.durationMs unsigned long
Die Länge des hochgeladenen Videos in Millisekunden.
fileDetails.bitrateBps unsigned long
Die kombinierte Bitrate der hochgeladenen Videodatei (Video und Audio) in Bit pro Sekunde.
fileDetails.creationTime string
Datum und Uhrzeit der Erstellung der hochgeladenen Videodatei Der Wert wird im ISO 8601-Format angegeben. Derzeit werden die folgenden ISO 8601-Formate unterstützt:
  • Nur Datum: YYYY-MM-DD
  • Urlaubszeit: YYYY-MM-DDTHH:MM:SS
  • Zeit mit Zeitzone: YYYY-MM-DDTHH:MM:SS+HH:MM
processingDetails object
Das processingDetails-Objekt enthält Informationen über den Fortschritt von YouTube bei der Verarbeitung der hochgeladenen Videodatei. Die Eigenschaften im Objekt geben den aktuellen Verarbeitungsstatus und eine Schätzung der verbleibenden Zeit an, bis YouTube das Video verarbeitet hat. Dieser Teil gibt auch an, ob verschiedene Arten von Daten oder Inhalten wie Dateidetails oder Miniaturansichten für das Video verfügbar sind.

Das processingProgress-Objekt ist für den Abruf vorgesehen, damit das hochgeladene Video den Fortschritt von YouTube bei der Verarbeitung der hochgeladenen Videodatei verfolgen kann. Diese Daten können nur vom Rechteinhaber des Videos abgerufen werden.
processingDetails.processingStatus string
Der Verarbeitungsstatus des Videos. Dieser Wert gibt an, ob YouTube das Video verarbeiten konnte oder noch verarbeitet wird.

Gültige Werte für diese Property sind:
  • failed: Die Videoverarbeitung ist fehlgeschlagen. Siehe ProcessingFailureReason.
  • processing: Das Video wird gerade verarbeitet. Siehe ProcessingProgress.
  • succeeded: Das Video wurde verarbeitet.
  • terminated: Es sind keine Informationen zur Verarbeitung mehr verfügbar.
processingDetails.processingProgress object
Das processingProgress-Objekt enthält Informationen zum Fortschritt von YouTube bei der Verarbeitung des Videos. Die Werte sind wirklich nur relevant, wenn der Verarbeitungsstatus des Videos processing ist.
processingDetails.processingProgress.partsTotal unsigned long
Eine Schätzung der Gesamtzahl der Teile, die für das Video verarbeitet werden müssen. Während das Video von YouTube verarbeitet wird, können noch genauere Schätzungen erstellt werden.
processingDetails.processingProgress.partsProcessed unsigned long
Die Anzahl der Teile des Videos, die von YouTube bereits verarbeitet wurden. Du kannst den Prozentsatz des Videos, den YouTube bereits verarbeitet hat, mithilfe der folgenden Berechnungsmethode schätzen:
100 * parts_processed / parts_total

Da die geschätzte Anzahl der Teile steigen kann, ohne dass die Anzahl der bereits verarbeiteten Teile steigt, kann der berechnete Fortschritt während der Verarbeitung eines Videos durch YouTube in regelmäßigen Abständen abnehmen.
processingDetails.processingProgress.timeLeftMs unsigned long
Eine Schätzung der Zeit in Millisekunden, die YouTube benötigt, um die Verarbeitung des Videos abzuschließen.
processingDetails.processingFailureReason string
Der Grund, warum YouTube das Video nicht verarbeitet hat. Dieses Attribut hat nur dann einen Wert, wenn der Wert des Attributs processingStatus failed lautet.

Gültige Werte für dieses Attribut sind:
  • other: Eine andere Verarbeitungskomponente ist fehlgeschlagen.
  • streamingFailed: Das Video konnte nicht an Streamer gesendet werden.
  • transcodeFailed: Die Transcodierung des Inhalts ist fehlgeschlagen.
  • uploadFailed: Die Datei konnte nicht übermittelt werden.
processingDetails.fileDetailsAvailability string
Dieser Wert gibt an, ob für das hochgeladene Video Dateidetails verfügbar sind. Du kannst die Details einer Videodatei abrufen, indem du den fileDetails-Teil in deiner videos.list()-Anfrage anforderst.
processingDetails.processingIssuesAvailability string
Dieser Wert gibt an, ob die Videoverarbeitungs-Engine Vorschläge generiert hat, die die Verarbeitung des Videos durch YouTube verbessern könnten, Warnungen, die auf Probleme bei der Videoverarbeitung hinweisen, oder Fehler, die Probleme bei der Videoverarbeitung verursachen. Sie können diese Vorschläge abrufen, indem Sie den suggestions-Teil in Ihrer videos.list()-Anfrage anfordern.
processingDetails.tagSuggestionsAvailability string
Dieser Wert gibt an, ob Keyword-Vorschläge (Tag) für das Video verfügbar sind. Den Metadaten eines Videos können Tags hinzugefügt werden, damit andere Nutzer das Video leichter finden können. Sie können diese Vorschläge abrufen, indem Sie den suggestions-Teil in Ihrer videos.list()-Anfrage anfordern.
processingDetails.editorSuggestionsAvailability string
Dieser Wert gibt an, ob für das Video Vorschläge zur Videobearbeitung verfügbar sind, mit denen sich die Videoqualität oder die Wiedergabequalität verbessern lassen. Sie können diese Vorschläge abrufen, indem Sie den suggestions-Teil in Ihrer videos.list()-Anfrage anfordern.
processingDetails.thumbnailsAvailability string
Dieser Wert gibt an, ob für das Video Thumbnail-Bilder generiert wurden.
suggestions object
Das suggestions-Objekt enthält Vorschläge zur Verbesserung der Videoqualität oder der Metadaten für das hochgeladene Video. Diese Daten können nur vom Rechteinhaber des Videos abgerufen werden.

Das suggestions-Objekt wird nur zurückgegeben, wenn das Attribut processingDetails.tagSuggestionsAvailability oder processingDetails.editorSuggestionsAvailability den Wert available hat.
suggestions.processingErrors[] list
Eine Liste mit Fehlern, die verhindern, dass YouTube das hochgeladene Video erfolgreich verarbeitet. Diese Fehler weisen darauf hin, dass dieser Status unabhängig vom aktuellen Verarbeitungsstatus des Videos mit hoher Wahrscheinlichkeit failed ist.

Gültige Werte für diese Eigenschaft sind:
  • archiveFile: Eine Archivdatei (z.B. ein ZIP-Archiv).
  • audioFile: Die Datei enthält nur Audio (z.B. eine MP3-Datei).
  • docFile: Dokument oder Textdatei (z.B. MS Word-Dokument).
  • imageFile: Bilddatei (z. B. ein JPEG-Bild)
  • notAVideoFile: Andere Nicht-Videodatei.
  • projectFile: Filmprojektdatei (z.B. Microsoft Windows Movie Maker-Projekt).
suggestions.processingWarnings[] list
Eine Liste mit Gründen, aus denen YouTube möglicherweise Schwierigkeiten beim Transcodieren des hochgeladenen Videos hat oder zu einer fehlerhaften Transcodierung führen kann. Diese Warnungen werden generiert, bevor YouTube die hochgeladene Videodatei tatsächlich verarbeitet. Außerdem werden Probleme identifiziert, die nicht unbedingt darauf hindeuten, dass die Videoverarbeitung fehlschlägt, die aber dennoch Probleme wie Synchronisierungsprobleme, Videoartefakte oder einen fehlenden Audiotrack verursachen können.

Gültige Werte für diese Eigenschaft sind:
  • hasEditlist: Bearbeitungslisten werden derzeit nicht unterstützt.
  • inconsistentResolution: In Konflikt stehende Container- und Streamauflösungen.
  • problematicAudioCodec: Es wurde ein Audio-Codec verwendet, der bekanntermaßen Probleme verursacht.
  • problematicVideoCodec: Es wurde ein Video-Codec verwendet, der bekanntermaßen Probleme verursacht.
  • unknownAudioCodec: Unbekannter Audio-Codec. Die Transcodierung schlägt wahrscheinlich fehl.
  • unknownContainer: Nicht erkanntes Dateiformat. Die Transcodierung schlägt wahrscheinlich fehl.
  • unknownVideoCodec: Unbekannter Video-Codec. Die Transcodierung schlägt wahrscheinlich fehl.
suggestions.processingHints[] list
Eine Liste mit Vorschlägen, mit denen die Verarbeitung des Videos durch YouTube verbessert werden kann.

Gültige Werte für diese Property sind:
  • nonStreamableMov: Die MP4-Datei kann nicht gestreamt werden. Dadurch wird die Verarbeitung verlangsamt.
  • sendBestQualityVideo: Das Video gibt wahrscheinlich eine qualitativ bessere Version des Videos.
suggestions.tagSuggestions[] list
Eine Liste mit Keyword-Tags, die den Metadaten des Videos hinzugefügt werden können, um die Wahrscheinlichkeit zu erhöhen, dass Nutzer Ihr Video bei der Suche oder beim Stöbern auf YouTube finden.
suggestions.tagSuggestions[].tag string
Das für das Video vorgeschlagene Keyword-Tag.
suggestions.tagSuggestions[].categoryRestricts[] list
Eine Reihe von Videokategorien, für die das Tag relevant ist. Anhand dieser Informationen kannst du passende Tag-Vorschläge basierend auf der Videokategorie anzeigen, die der Video-Uploader mit dem Video verknüpft. Tag-Vorschläge sind standardmäßig für alle Kategorien relevant, wenn für das Keyword keine Einschränkungen festgelegt wurden.
suggestions.editorSuggestions[] list
Eine Liste mit Videobearbeitungsvorgängen, die die Videoqualität oder die Wiedergabequalität des hochgeladenen Videos verbessern können.

Gültige Werte für diese Eigenschaft sind:
  • audioQuietAudioSwap: Der Audiotrack ist lautlos und könnte durch einen qualitativ besseren Titel ersetzt werden.
  • videoAutoLevels – Die Helligkeit des Bilds scheint nicht zu stimmen und kann korrigiert werden.
  • videoCrop: Die Ränder (matt) um das Bild herum könnten zugeschnitten werden.
  • videoStabilize: Das Video erscheint verwackelt und könnte stabilisiert werden.
liveStreamingDetails object
Das Objekt liveStreamingDetails enthält Metadaten zu einer Live-Videoübertragung. Das Objekt ist nur dann in einer video-Ressource vorhanden, wenn es sich um eine anstehende, Live- oder abgeschlossene Liveübertragung handelt.
liveStreamingDetails.actualStartTime datetime
Der Zeitpunkt, zu dem die Übertragung tatsächlich begonnen hat. Der Wert wird im ISO 8601-Format angegeben. Dieser Wert ist erst verfügbar, wenn die Übertragung beginnt.
liveStreamingDetails.actualEndTime datetime
Der Zeitpunkt, zu dem die Übertragung tatsächlich beendet wurde. Der Wert wird im ISO 8601-Format angegeben. Dieser Wert ist erst nach Ende der Übertragung verfügbar.
liveStreamingDetails.scheduledStartTime datetime
Die Uhrzeit, zu der die Übertragung planmäßig beginnen soll. Der Wert wird im ISO 8601-Format angegeben.
liveStreamingDetails.scheduledEndTime datetime
Der Zeitpunkt, zu dem die Übertragung laut Plan endet. Der Wert wird im ISO 8601-Format angegeben. Wenn der Wert leer oder das Attribut nicht vorhanden ist, wird die Übertragung so geplant, dass sie auf unbestimmte Zeit fortgesetzt wird.
liveStreamingDetails.concurrentViewers unsigned long
Die Anzahl an Zuschauern, die sich die Übertragung gerade ansehen. Die Eigenschaft und ihr Wert sind vorhanden, wenn die Übertragung aktuelle Zuschauer hat und der Eigentümer der Übertragung die Anzahl der Aufrufe für das Video nicht ausgeblendet hat. Hinweis: Wenn die Übertragung endet, erfasst YouTube die Anzahl an gleichzeitigen Zuschauern nicht mehr. Diese Property würde also nicht die Anzahl der Zuschauer ermitteln, die sich ein archiviertes Video einer bereits beendeten Liveübertragung ansehen.
Die Anzahl der gleichzeitigen Zuschauer, die die YouTube Data API zurückgibt, kann von der Anzahl der verarbeiteten, bereinigten und gleichzeitigen Zuschauer abweichen, die über YouTube Analytics verfügbar sind. Weitere Informationen zu Messwerten für Livestreams findest du in der YouTube-Hilfe.
liveStreamingDetails.activeLiveChatId string
Die ID des aktuell aktiven Livechats, der an dieses Video angehängt ist. Dieses Feld wird nur ausgefüllt, wenn es sich bei dem Video um eine aktuelle Liveübertragung mit Livechat handelt. Sobald die Übertragung abgeschlossen ist, wird dieses Feld entfernt und der Livechat wird geschlossen. Bei dauerhaften Übertragungen ist die Livechat-ID nicht mehr mit diesem Video verknüpft. Stattdessen wird das neue Video auf der persistenten Seite angezeigt.
localizations object
Das Objekt localizations enthält Übersetzungen der Metadaten des Videos.
localizations.(key) object
Die Sprache des lokalisierten Textes, der dem Schlüssel/Wert-Paar zugeordnet ist. Der Wert ist ein String mit einem BCP-47-Sprachcode.
localizations.(key).title string
Der lokalisierte Videotitel.
localizations.(key).description string
Die lokalisierte Videobeschreibung.