Videos

Alle Videos, die über den videos.insert-Endpunkt von nicht bestätigten API-Projekten hochgeladen werden, die nach dem 28. Juli 2020 erstellt wurden, sind nur im privaten Ansichtsmodus verfügbar. Um diese Einschränkung aufzuheben, muss jedes API-Projekt geprüft werden, um die Einhaltung der Nutzungsbedingungen zu bestätigen. Weitere Informationen finden Sie im API-Überarbeitungsverlauf.

Eine video-Ressource stellt ein YouTube-Video dar.

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 angegebener Videos abgegeben hat. Hier kannst du die Funktion ausprobieren.

list

Gibt eine Liste von Videos zurück, die den Parametern der API-Anfrage entsprechen. Hier kannst du die Funktion ausprobieren.

batchGetStats

Ruft eine Liste von Videostatistiken ab, die den Parametern der API-Anfrage entsprechen. Hier kannst du die Funktion ausprobieren.

insert

Lädt ein Video auf YouTube hoch und legt optional die Metadaten des Videos fest.

Aktualisierung

Aktualisiert die Metadaten eines Videos. Hier kannst du die Funktion ausprobieren.

Delete

Löscht ein YouTube-Video. Hier kannst du die Funktion ausprobieren.

rate [Steuersatz]

Ein Video mit „Mag ich“ oder „Mag ich nicht“ bewerten oder eine Bewertung aus einem Video entfernen. Hier kannst du die Funktion ausprobieren.

reportAbuse

Ein Video melden, das missbräuchliche Inhalte enthält. 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,
    "containsSyntheticMedia": boolean
  },
  "statistics": {
    "viewCount": string,
    "likeCount": string,
    "dislikeCount": string,
    "favoriteCount": string,
    "commentCount": string
  },
  "paidProductPlacementDetails": {
    "hasPaidProductPlacement": boolean
  },
  "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
    }
  }
}

Properties

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

Properties
kind	string Gibt den Typ der API-Ressource an. Der Wert ist youtube#video.
etag	etag Das ETag dieser Ressource.
id	string Die ID, die YouTube zur eindeutigen Identifizierung des Videos verwendet.
snippet	object Das snippet-Objekt enthält grundlegende Details zum Video, z. B. Titel, Beschreibung und Kategorie.
snippet.publishedAt	datetime Das Datum und die Uhrzeit, zu der das Video veröffentlicht wurde. Diese Zeit kann sich von der Zeit unterscheiden, zu der das Video hochgeladen wurde. Wenn ein Video beispielsweise als privates Video hochgeladen und später veröffentlicht wird, gibt diese Eigenschaft den Zeitpunkt an, zu dem das Video veröffentlicht wurde. 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 an, zu der das Video hochgeladen wurde. Wenn ein Video als nicht gelistetes Video hochgeladen wird, gibt der Eigenschaftswert auch das Datum und die Uhrzeit an, zu der das Video hochgeladen wurde. In diesem Fall kann jeder, der die eindeutige Video-ID des Videos kennt, die Videometadaten abrufen.  Der Wert wird im ISO 8601-Format angegeben.
snippet.channelId	string Die ID, die YouTube verwendet, um den Kanal, auf den das Video hochgeladen wurde, eindeutig zu identifizieren.
snippet.title	string Der Titel des Videos. Der Eigenschaftswert darf maximal 100 Zeichen lang sein und alle gültigen UTF-8-Zeichen mit Ausnahme von < und > enthalten. Sie müssen einen Wert für diese Eigenschaft festlegen, wenn Sie die Methode videos.update aufrufen und den Teil snippet einer video-Ressource aktualisieren.
snippet.description	string Die Beschreibung des Videos. Der Eigenschaftswert darf maximal 5.000 Byte lang sein und alle gültigen UTF‑8-Zeichen mit Ausnahme von < und > enthalten.
snippet.thumbnails	object Eine Karte mit Thumbnail-Bildern, die dem Video zugeordnet sind. Für jedes Objekt auf der Karte ist der Schlüssel der Name des Vorschaubilds und der Wert ein Objekt, das weitere Informationen zum Vorschaubild enthält.
snippet.thumbnails.(key)	object Gültige Schlüsselwerte sind: default: Die Standard-Miniaturansicht. Die Standard-Miniaturansicht für ein Video oder eine Ressource, die sich auf ein Video bezieht, z. B. ein Playlist-Element oder ein Suchergebnis, ist 120 Pixel breit und 90 Pixel hoch. Die Standard-Miniaturansicht 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 dieses Bild 320 Pixel breit und 180 Pixel hoch. Für einen Channel ist dieses Bild 240 Pixel breit und 240 Pixel hoch. high – Eine hochauflösende Version des Thumbnails. Bei einem Video (oder einer Ressource, die auf ein Video verweist) ist dieses Bild 480 Pixel breit und 360 Pixel hoch. Für einen Kanal ist dieses Bild 800 Pixel breit und 800 Pixel hoch. standard: Eine noch höher aufgelöste Version des Thumbnail-Bilds als das Bild mit der Auflösung high. Dieses Bild ist für einige Videos und andere Ressourcen verfügbar, die sich auf Videos beziehen, z. B. Playlist-Elemente oder Suchergebnisse. Es ist 640 Pixel breit und 480 Pixel hoch. maxres: Die Version des Thumbnail-Bilds mit der höchsten Auflösung. Diese Bildgröße ist für einige Videos und andere Ressourcen verfügbar, die sich auf Videos beziehen, z. B. Playlist-Elemente oder Suchergebnisse. Dieses Bild ist 1.280 Pixel breit und 720 Pixel hoch.
snippet.thumbnails.(key).url	string Die URL des Bildes.
snippet.thumbnails.(key).width	unsigned integer Die Breite des Bildes.
snippet.thumbnails.(key).height	unsigned integer Die Höhe des Bildes.
snippet.channelTitle	string Der Titel des Kanals, zu dem das Video gehört.
snippet.tags[]	list Eine Liste von Keyword-Tags, die mit dem Video verknüpft sind. Tags dürfen Leerzeichen enthalten. Der Wert der Property darf maximal 500 Zeichen lang sein. Beachten Sie die folgenden Regeln zur Berechnung des Zeichenlimits: Der Attributwert ist eine Liste und Kommas zwischen Elementen in der Liste werden auf das Limit angerechnet. Wenn ein Tag ein Leerzeichen enthält, behandelt der API-Server den Tag-Wert so, als wäre er in Anführungszeichen eingeschlossen. Die Anführungszeichen werden auf die Zeichenbeschränkung angerechnet. Für die Zeichenbeschränkung enthält das Tag Foo-Baz also sieben Zeichen, das Tag Foo Baz jedoch neun Zeichen.
snippet.categoryId	string Die mit dem Video verknüpfte YouTube-Videokategorie. 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.liveBroadcastContent	string Gibt an, ob es sich bei dem Video um eine bevorstehende oder aktive Liveübertragung handelt. Der Wert ist none, wenn das Video keine bevorstehende/aktive Liveübertragung ist. Gültige Werte für diese Eigenschaft sind: live none upcoming
snippet.defaultLanguage	string Die Sprache des Texts 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 lokalisierte Beschreibung für das Video oder den Titel in der Standardsprache für die Metadaten des Videos. Lokalisierter Text wird im Ressourcenausschnitt zurückgegeben, wenn in der videos.list-Anfrage mit dem Parameter hl eine Sprache angegeben wurde, 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 ist oder ein Wert angegeben ist, aber keine lokalisierten Metadaten für die angegebene Sprache verfügbar sind. Die Property enthält einen schreibgeschützten Wert. Verwenden Sie das localizations-Objekt, um lokalisierte Titel hinzuzufügen, zu aktualisieren oder zu löschen.
snippet.localized.title	string Der lokalisierte Videotitel.
snippet.localized.description	string Die lokalisierte Videobeschreibung.
snippet.defaultAudioLanguage	string Das Attribut default_audio_language gibt die Sprache an, die im Standard-Audiotrack des Videos gesprochen wird.
contentDetails	object Das contentDetails-Objekt enthält Informationen zum Videoinhalt, einschließlich der Länge des Videos und einer Angabe dazu, ob Untertitel für das Video verfügbar sind.
contentDetails.duration	string Die Länge des Videos. Der Property-Wert ist eine ISO 8601-Dauer. Bei einem Video, das mindestens eine Minute und weniger als eine Stunde lang ist, wird die Dauer beispielsweise im Format PT#M#S angegeben. Die Buchstaben PT geben an, dass der Wert einen Zeitraum angibt, und die Buchstaben M und S beziehen sich auf die Länge in Minuten bzw. Sekunden. Die # Zeichen vor den Buchstaben M und S sind beides Ganzzahlen, die die Anzahl der Minuten (oder Sekunden) des Videos angeben. Ein Wert von 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 die # vor dem Buchstaben H die Länge des Videos in Stunden an. Alle anderen Details sind wie oben beschrieben. Wenn das Video mindestens einen Tag lang ist, werden die Buchstaben P und T getrennt und der Wert hat das Format 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 in 2D verfügbar ist.
contentDetails.definition	string Gibt an, ob das Video in High Definition (HD) oder nur in Standardauflösung verfügbar ist. Gültige Werte für dieses Attribut sind: hd sd
contentDetails.caption	string Gibt an, ob für das Video Untertitel verfügbar sind. Gültige Werte für dieses Attribut sind: false true
contentDetails.licensedContent	boolean Gibt an, ob das Video lizenzierte Inhalte enthält. Das bedeutet, dass die Inhalte auf einen Kanal hochgeladen wurden, der mit einem YouTube-Content-Partner verknüpft ist, und dann von diesem Partner beansprucht wurden.
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 von Regionscodes, die Länder angeben, in denen das Video angesehen werden kann. Wenn diese Eigenschaft vorhanden ist und ein Land nicht in ihrem Wert aufgeführt ist, wird das Video in diesem Land nicht angezeigt. Wenn diese Property vorhanden ist und eine leere Liste enthält, ist das Video in allen Ländern gesperrt.
contentDetails.regionRestriction.blocked[]	list Eine Liste von Regionscodes, die Länder angeben, in denen das Video gesperrt ist. Wenn diese Property vorhanden ist und ein Land nicht in ihrem Wert 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 angesehen werden.
contentDetails.contentRating	object Gibt die Bewertungen an, die das Video in verschiedenen Bewertungssystemen erhalten hat.
contentDetails.contentRating.acbRating	string Die Einstufung des Videos durch das Australian Classification Board (ACB) oder die Australian Communications and Media Authority (ACMA). ACMA-Altersfreigaben werden verwendet, um Fernsehprogramme für Kinder zu klassifizieren. Gültige Werte für diese Eigenschaft sind: acbC – Sendungen, die von der Australian Communications and Media Authority mit C eingestuft wurden. Diese Sendungen sind für Kinder (keine Vorschulkinder) vorgesehen, die jünger als 14 Jahre sind. acbE – E acbG – G acbM – M acbMa15plus – MA15+ acbP – Sendungen, die von der Australian Communications and Media Authority mit P eingestuft wurden. Diese Sendungen sind für Vorschulkinder vorgesehen. acbPg – PG acbR18plus – R18+ acbUnrated
contentDetails.contentRating.agcomRating	string Die Altersfreigabe des Videos von der italienischen Autorità per le Garanzie nelle Comunicazioni (AGCOM). Gültige Werte für diese Eigenschaft sind: agcomT – T agcomUnrated agcomVm14 – VM14 agcomVm18 – VM18
contentDetails.contentRating.anatelRating	string Die Anatel-Altersfreigabe (Asociación Nacional de Televisión) des Videos für das chilenische Fernsehen. Gültige Werte für diese Property sind: anatelA – A anatelF – F anatelI – I anatelI10 – I-10 anatelI12 – I-12 anatelI7 – I-7 anatelR – R anatelUnrated
contentDetails.contentRating.bbfcRating	string Die Altersfreigabe des Videos durch das British Board of Film Classification (BBFC). Gültige Werte für diese Property sind: bbfc12 – 12 bbfc12a – 12A bbfc15 – 15 bbfc18 – 18 bbfcPg – PG bbfcR18 – R18 bbfcU – U bbfcUnrated
contentDetails.contentRating.bfvcRating	string The video's rating from Thailand's Board of Film and Video Censors. Valid values for this property are: bfvc13 – 13 bfvc15 – 15 bfvc18 – 18 bfvc20 – 20 bfvcB – B bfvcE – E bfvcG – G bfvcUnrated
contentDetails.contentRating.bmukkRating	string Die Altersfreigabe des Videos durch das österreichische Bundesministerium für Unterricht, Kunst und Kultur. Gültige Werte für diese Property sind: bmukk10 – 10+ bmukk12 – 12+ bmukk14 – 14+ bmukk16 – 16+ bmukk6 – 6+ bmukk8 – 8+ bmukkAa – Uneingeschränkt bmukkUnrated
contentDetails.contentRating.catvRating	string Bewertungssystem für kanadisches Fernsehen – Canadian TV Classification System Die Bewertung des Videos durch die Canadian Radio-Television and Telecommunications Commission (CRTC) für englischsprachige Sendungen in Kanada. Weitere Informationen finden Sie auf der Website des Canadian Broadcast Standards Council. Gültige Werte für dieses Attribut sind: catv14plus – 14+ catv18plus – 18+ catvC – C catvC8 – C8 catvG – G catvPg – PG catvUnrated
contentDetails.contentRating.catvfrRating	string Die Altersfreigabe des Videos von der Canadian Radio-Television and Telecommunications Commission (CRTC) für französischsprachige Sendungen in Kanada. Weitere Informationen finden Sie auf der Website des Canadian Broadcast Standards Council. Gültige Werte für diese Property sind: catvfr13plus – 13+ catvfr16plus – 16+ catvfr18plus – 18+ catvfr8plus – 8+ catvfrG – G catvfrUnrated
contentDetails.contentRating.cbfcRating	string Die Bewertung des Videos durch das Central Board of Film Certification (CBFC – Indien). Gültige Werte für diese Property 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 durch den Consejo de Calificación Cinematográfica (Chile). Gültige Werte für diese Property sind: ccc14 – 14+ ccc18 – 18+ ccc18s – 18+ – contenido pornográfico ccc18v – 18+ - contenido excesivamente violento ccc6 – 6+ – Nicht geeignet für Kinder unter 7 Jahren cccTe – Alle Zuschauer cccUnrated
contentDetails.contentRating.cceRating	string Die Altersfreigabe 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 – 18 cceM4 – 4 cceM6 – 6 cceUnrated
contentDetails.contentRating.chfilmRating	string Die Altersfreigabe des Videos in der Schweiz. Gültige Werte für dieses Attribut sind: chfilm0 – 0 chfilm12 – 12 chfilm16 – 16 chfilm18 – 18 chfilm6 – 6 chfilmUnrated
contentDetails.contentRating.chvrsRating	string Die Altersfreigabe des Videos gemäß dem Canadian Home Video Rating System (CHVRS). Gültige Werte für diese Property sind: chvrs14a – 14A chvrs18a – 18A chvrsE – E chvrsG – G chvrsPg – PG chvrsR – R chvrsUnrated
contentDetails.contentRating.cicfRating	string Die Altersfreigabe des Videos von der Commission de Contrôle des Films (Belgien). Gültige Werte für diese Property sind: cicfE – E cicfKntEna – KNT/ENA cicfKtEa – KT/EA cicfUnrated
contentDetails.contentRating.cnaRating	string Die Altersfreigabe des Videos vom CONSILIUL NATIONAL AL AUDIOVIZUALULUI (CNA) in Rumänien. Gültige Werte für diese Property sind: cna12 – 12 cna15 – 15 cna18 – 18 cna18plus – 18+ cnaAp – AP cnaUnrated
contentDetails.contentRating.cncRating	string Bewertungssystem in Frankreich – Commission de classification cinematographique Zulässige Werte für diese Property sind: cnc10 – 10 cnc12 – 12 cnc16 – 16 cnc18 – 18 cncE – E cncT – T cncUnrated
contentDetails.contentRating.csaRating	string Die Altersfreigabe des Videos vom Conseil supérieur de l'audiovisuel (CSA) in Frankreich, der Rundfunkinhalte bewertet. Gültige Werte für diese Property sind: csa10 – 10 csa12 – 12 csa16 – 16 csa18 – 18 csaInterdiction – Interdiction csaT – T csaUnrated
contentDetails.contentRating.cscfRating	string Die Altersfreigabe des Videos von der Commission de surveillance de la classification des films (CSCF) in Luxemburg. Gültige Werte für diese Property sind: cscf12 – 12 cscf16 – 16 cscf18 – 18 cscf6 – 6 cscf9 – 9 cscfA – A cscfAl – AL cscfUnrated
contentDetails.contentRating.czfilmRating	string Die Altersfreigabe des Videos in der Tschechischen Republik. Gültige Werte für diese Property sind: czfilm12 – 12 czfilm14 – 14 czfilm18 – 18 czfilmU – U czfilmUnrated
contentDetails.contentRating.djctqRating	string Die Altersfreigabe des Videos durch das Departamento de Justiça, Classificação, Qualificação e Títulos (DJCQT) in Brasilien. Gültige Werte für diese Property sind: djctq10 – 10 djctq12 – 12 djctq14 – 14 djctq16 – 16 djctq18 – 18 djctqL – L djctqUnrated
contentDetails.contentRating.djctqRatingReasons[]	list Gründe für die DJCQT-Altersfreigabe (Brasilien) des Videos.
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 Property sind: ecbmct13a – 13A ecbmct13plus – 13+ ecbmct15a – 15A ecbmct15plus – 15+ ecbmct18plus – 18+ ecbmct7a – 7A ecbmct7plus – 7+ ecbmctG – G ecbmctUnrated ecbmct6a – 6A ecbmct6plus – 6+ ecbmct10a – 10A ecbmct10plus – 10+ ecbmct16plus – 16+
contentDetails.contentRating.eefilmRating	string Die Altersfreigabe des Videos in Estland. Gültige Werte für diese Property sind: eefilmK12 – Primar- und Sekundarstufe eefilmK14 – K-14 eefilmK16 – K-16 eefilmK6 – K-6 eefilmL – L eefilmMs12 – MS-12 eefilmMs6 – MS-6 eefilmPere – Pere eefilmUnrated
contentDetails.contentRating.egfilmRating	string Die Altersfreigabe des Videos in Ägypten. Gültige Werte für diese Property sind: egfilm18 – 18 egfilmBn – BN egfilmGn – GN egfilmUnrated
contentDetails.contentRating.eirinRating	string Die Altersfreigabe des Videos von Eirin (映倫). Eirin ist das japanische Bewertungssystem. Gültige Werte für diese Property sind: eirinG – G eirinPg12 – PG-12 eirinR15plus – R15+ eirinR18plus – R18+ eirinUnrated
contentDetails.contentRating.fcbmRating	string Die Altersfreigabe des Videos durch das Film Censorship Board von Malaysia. Gültige Werte für diese Property sind: fcbm13 – 13 fcbm16 – 16 fcbm18 – 18 fcbm18pa – 18PA fcbm18pl – 18PL fcbm18sg – 18SG fcbm18sx – 18SX fcbmP12 – P12 fcbmP13 – P13 fcbmPg13 – PG13 fcbmU – U fcbmUnrated
contentDetails.contentRating.fcoRating	string Die Altersfreigabe des Videos durch das Office for Film, Newspaper and Article Administration in Hongkong. 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. Verwenden Sie stattdessen die Property contentDetails.contentRating.cncRating. Die Altersfreigabe des Videos durch das Centre national du cinéma et de l'image animé (französisches Kulturministerium). Gültige Werte für diese Property sind: fmoc10 – 10 fmoc12 – 12 fmoc16 – 16 fmoc18 – 18 fmocE – E fmocU – U fmocUnrated
contentDetails.contentRating.fpbRating	string Die Altersfreigabe des Videos vom Film and Publication Board in Südafrika. Gültige Werte für diese Property sind: fpb10 – 10 fpb1012Pg – 10-12PG fpb13 – 13 fpb16 – 16 fpb18 – 18 fpb79Pg – 7-9PG fpbA – A fpbPg – PG fpbUnrated fpbX18 – X18 fpbXx – XX
contentDetails.contentRating.fpbRatingReasons[]	list Gründe für die Altersfreigabe des FPB (Südafrika) für das Video.
contentDetails.contentRating.fskRating	string Die Altersfreigabe der Freiwilligen Selbstkontrolle der Filmwirtschaft (FSK – Deutschland) für das Video. Gültige Werte für diese Property sind: fsk0 – FSK 0 fsk12 – FSK 12 fsk16 – FSK 16 fsk18 – FSK 18 fsk6 – FSK 6 fskUnrated
contentDetails.contentRating.grfilmRating	string Die Altersfreigabe des Videos in Griechenland. Gültige Werte für diese Property sind: grfilmE – E grfilmK – K grfilmK12 – Primar- und Sekundarstufe grfilmK13 – K-13 grfilmK15 – K-15 grfilmK17 – K-17 grfilmK18 – K-18 grfilmUnrated
contentDetails.contentRating.icaaRating	string Die Altersfreigabe des Videos vom Instituto de la Cinematografía y de las Artes Audiovisuales (ICAA – Spanien). Gültige Werte für diese Property sind: icaa12 – 12 icaa13 – 13 icaa16 – 16 icaa18 – 18 icaa7 – 7 icaaApta – APTA icaaUnrated icaaX – X
contentDetails.contentRating.ifcoRating	string Die Altersfreigabe des Videos durch das Irish Film Classification Office (IFCO – Irland). Weitere Informationen finden Sie auf der IFCO. Gültige Werte für dieses Attribut sind: ifco12 – 12 ifco12a – 12A ifco15 – 15 ifco15a – 15A ifco16 – 16 ifco18 – 18 ifcoG – G ifcoPg – PG ifcoUnrated
contentDetails.contentRating.ilfilmRating	string Die Altersfreigabe des Videos in Israel. Gültige Werte für diese Property sind: ilfilm12 – 12 ilfilm16 – 16 ilfilm18 – 18 ilfilmAa – AA ilfilmUnrated
contentDetails.contentRating.incaaRating	string Die INCAA-Bewertung (Instituto Nacional de Cine y Artes Audiovisuales – Argentinien) des Videos. Gültige Werte für diese Property sind: incaaAtp – ATP (Apta para todo publico) incaaC – X (Nur für Erwachsene ab 18 Jahren, eingeschränkte Vorführung) incaaSam13 – 13 (Nur für Nutzer ab 13 Jahren) incaaSam16 – 16 (Nur für Personen ab 16 Jahren) incaaSam18 – 18 (Nur für Personen ab 18 Jahren) incaaUnrated
contentDetails.contentRating.kfcbRating	string Die Bewertung des Videos durch das Kenya Film Classification Board. Gültige Werte für diese Property sind: kfcb16plus – 16 kfcbG – GE kfcbPg – PG kfcbR – 18 kfcbUnrated
contentDetails.contentRating.kijkwijzerRating	string voor de Classificatie van Audiovisuele Media (Niederlande). Zulässige Werte für diese Property sind: kijkwijzer12 – 12 kijkwijzer14 – 14 kijkwijzer16 – 16 kijkwijzer18 – 18 kijkwijzer6 – 6 kijkwijzer9 – 9 kijkwijzerAl – AL kijkwijzerUnrated
contentDetails.contentRating.kmrbRating	string Die Altersfreigabe des Videos durch das Korea Media Rating Board (영상물등급위원회). Das KMRB bewertet Videos in Südkorea. Gültige Werte für diese Eigenschaft sind: kmrb12plus – 12세 이상 관람가 kmrb15plus – 15세 이상 관람가 kmrbAll – 전체관람가 kmrbR – 청소년 관람불가 kmrbTeenr kmrbUnrated
contentDetails.contentRating.lsfRating	string Die Altersfreigabe des Videos von der indonesischen Lembaga Sensor Film. Gültige Werte für diese Property sind: lsf13 – 13 lsf17 – 17 lsf21 – 21 lsfA – A lsfBo – BO lsfD – D lsfR – R lsfSu – SU lsfUnrated
contentDetails.contentRating.mccaaRating	string Die Altersempfehlung des Film Age-Classification Board von Malta für das Video. Gültige Werte für diese Property sind: mccaa12 – 12 mccaa12a – 12A mccaa14 – 14: Diese Altersfreigabe wurde aus der neuen Klassifizierungsstruktur entfernt, die 2013 eingeführt wurde. mccaa15 – 15 mccaa16 – 16: Diese Altersfreigabe wurde aus der neuen Klassifizierungsstruktur entfernt, die 2013 eingeführt wurde. mccaa18 – 18 mccaaPg – PG mccaaU – U mccaaUnrated
contentDetails.contentRating.mccypRating	string Die Altersfreigabe des Videos vom Media Council for Children and Young People des Danish Film Institute (Det Danske Filminstitut). Gültige Werte für diese Property sind: mccyp11 – 11 mccyp15 – 15 mccyp7 – 7 mccypA – A mccypUnrated
contentDetails.contentRating.mcstRating	string Das Bewertungssystem für Videos in Vietnam – MCST Gültige Werte für diese Property sind: mcst0 – 0 mcst16plus – 16+ mcstC13 – C13 mcstC16 – C16 mcstC18 – C18 mcstP – P mcstUnrated mcstT13 – T13 mcstT16 – T16 mcstT18 – T18 mcstK – K
contentDetails.contentRating.mdaRating	string Die Altersfreigabe des Videos durch die Media Development Authority (MDA) von Singapur und insbesondere durch das Board of Film Censors (BFC). Gültige Werte für diese Property sind: mdaG – G mdaM18 – M18 mdaNc16 – NC16 mdaPg – PG mdaPg13 – PG13 mdaR21 – R21 mdaUnrated
contentDetails.contentRating.medietilsynetRating	string Die Altersfreigabe des Videos von Medietilsynet, der norwegischen Medienbehörde. Gültige Werte für diese Property sind: medietilsynet11 – 11 medietilsynet12 – 12 medietilsynet15 – 15 medietilsynet18 – 18 medietilsynet6 – 6 medietilsynet7 – 7 medietilsynet9 – 9 medietilsynetA – A medietilsynetUnrated
contentDetails.contentRating.mekuRating	string Die Altersfreigabe des Videos vom finnischen Kansallinen Audiovisuaalinen Instituutti (National Audiovisual Institute). Gültige Werte für diese Property sind: meku12 – 12 meku16 – 16 meku18 – 18 meku7 – 7 mekuS – S mekuUnrated
contentDetails.contentRating.mibacRating	string Die Altersfreigabe des Videos vom Ministero dei Beni e delle Attività Culturali e del Turismo (Italien). Gültige Werte für diese Eigenschaft sind: mibacT mibacUnrated mibacVap mibacVm6 mibacVm12 mibacVm14 mibacVm18
contentDetails.contentRating.mocRating	string Die Bewertung des Videos durch das Ministerio de Cultura (Kolumbien). Gültige Werte für diese Property sind: moc12 – 12 moc15 – 15 moc18 – 18 moc7 – 7 mocBanned – Gesperrt mocE – E mocT – T mocUnrated mocX – X
contentDetails.contentRating.moctwRating	string Die Altersfreigabe des Videos vom taiwanesischen Kulturministerium (文化部). Gültige Werte für diese Property sind: moctwG – G moctwP – P moctwPg – PG moctwR – R moctwR12 – R-12 moctwR15 – R-15 moctwUnrated
contentDetails.contentRating.mpaaRating	string Die Bewertung des Videos durch die 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 ‑vorschauen. Gültige Werte für diese Property sind: mpaatGb – GB (Green Band – für alle Nutzer geeignet) mpaatRb – RB (Red Band – empfohlen ab 17 Jahren)
contentDetails.contentRating.mtrcbRating	string Die Altersfreigabe des Videos durch das 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 Altersfreigabe des Videos vom Maldives National Bureau of Classification. Gültige Werte für diese Property sind: nbc12plus – 12+ nbc15plus – 15+ nbc18plus – 18+ nbc18plusr – 18+R nbcG – G nbcPg – PG nbcPu – PU nbcUnrated
contentDetails.contentRating.nfrcRating	string Die Altersfreigabe des Videos vom Bulgarian National Film Center. Gültige Werte für diese Property sind: nfrcA – A nfrcB – B nfrcC – C nfrcD – D nfrcUnrated nfrcX – X
contentDetails.contentRating.nfvcbRating	string Die Altersfreigabe des Videos durch das National Film and Video Censors Board in Nigeria. Gültige Werte für diese Property sind: nfvcb12 – 12 nfvcb12a – 12A nfvcb15 – 15 nfvcb18 – 18 nfvcbG – G nfvcbPg – PG nfvcbRe – RE nfvcbUnrated
contentDetails.contentRating.nkclvRating	string Die Altersfreigabe des Videos vom Nacionãlais Kino centrs (National Film Centre of Latvia). Gültige Werte für diese Property sind: nkclv12plus – 12+ nkclv18plus – 18+ nkclv7plus – 7+ nkclvU – U nkclvUnrated
contentDetails.contentRating.oflcRating	string Die Altersfreigabe des Videos durch das Office of Film and Literature Classification (OFLC – Neuseeland). Gültige Werte für dieses Attribut sind: oflcG – G oflcM – M oflcPg – PG oflcR13 – R13 oflcR15 – R15 oflcR16 – R16 oflcR18 – R18 oflcRp13 – RP13 oflcRp16 – RP16 oflcUnrated
contentDetails.contentRating.pefilmRating	string Die Altersfreigabe des Videos in Peru. Gültige Werte für diese Property sind: pefilm14 – 14 pefilm18 – 18 pefilmPg – PG pefilmPt – PT pefilmUnrated
contentDetails.contentRating.resorteviolenciaRating	string Die Altersfreigabe des Videos in Venezuela. Gültige Werte für diese Property sind: resorteviolenciaA – A resorteviolenciaB – B resorteviolenciaC – C resorteviolenciaD – D resorteviolenciaE – E resorteviolenciaUnrated
contentDetails.contentRating.rtcRating	string Die Bewertung des Videos durch die mexikanische Generaldirektion für Radio, Fernsehen und Kinematografie. Gültige Werte für diese Eigenschaft sind: rtcA – A rtcAa – AA rtcB – B rtcB15 – B15 rtcC – C rtcD – D rtcUnrated
contentDetails.contentRating.rteRating	string Die Altersfreigabe des Videos von Raidió Teilifís Éireann in Irland. Gültige Werte für diese Property sind: rteCh – CH rteGa – GA rteMa – MA rtePs – PS rteUnrated
contentDetails.contentRating.russiaRating	string Die Altersfreigabe des Videos gemäß dem Nationalen Filmregister der Russischen Föderation (MKRF – Russland). Gültige Werte für dieses Attribut sind: russia0 – 0+ russia12 – 12+ russia16 – 16+ russia18 – 18+ russia6 – 6+ russiaUnrated
contentDetails.contentRating.skfilmRating	string Die Altersfreigabe des Videos in der Slowakei. Gültige Werte für dieses Attribut sind: skfilmG – G skfilmP2 – P2 skfilmP5 – P5 skfilmP8 – P8 skfilmUnrated
contentDetails.contentRating.smaisRating	string Die Altersfreigabe des Videos in Island. Gültige Werte für diese Property sind: smais12 – 12 smais14 – 14 smais16 – 16 smais18 – 18 smais7 – 7 smaisL – L smaisUnrated
contentDetails.contentRating.smsaRating	string Die Altersfreigabe des Videos vom Statens medieråd (National Media Council, Schweden). Gültige Werte für diese Property sind: smsa11 – 11 smsa15 – 15 smsa7 – 7 smsaA – Alle Altersgruppen smsaUnrated
contentDetails.contentRating.tvpgRating	string Die Altersfreigabe des Videos gemäß den TV Parental Guidelines (TVPG). 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 Altersfreigabe, die YouTube verwendet, um Inhalte mit Altersbeschränkung zu identifizieren. Gültige Werte für diese Property sind: ytAgeRestricted
contentDetails.projection	string Gibt das Projektionsformat des Videos an. Gültige Werte für diese Property sind: 360 rectangular
contentDetails.hasCustomThumbnail	boolean Gibt an, ob der Video-Uploader ein benutzerdefiniertes Thumbnail-Bild für das Video bereitgestellt hat. Diese Eigenschaft ist nur für den Uploader des Videos sichtbar.
status	object Das status-Objekt enthält Informationen zum Upload-, Verarbeitungs- und Datenschutzstatus des Videos.
status.uploadStatus	string Der Status des hochgeladenen Videos. Gültige Werte für diese Eigenschaft sind: deleted failed processed rejected uploaded
status.failureReason	string Dieser Wert gibt an, warum ein Video nicht hochgeladen werden konnte. Diese Property ist nur vorhanden, wenn die Property uploadStatus angibt, dass der Upload fehlgeschlagen ist. Gültige Werte für diese Property sind: codec conversion emptyFile invalidFile tooSmall uploadAborted
status.rejectionReason	string Dieser Wert gibt an, warum ein hochgeladenes Video von YouTube abgelehnt wurde. Dieses Attribut ist nur vorhanden, wenn das Attribut uploadStatus angibt, dass der Upload abgelehnt wurde. Gültige Werte für dieses Attribut 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 Das Datum und die Uhrzeit, zu der das Video veröffentlicht werden soll. Kann nur festgelegt werden, wenn der Sichtbarkeitsstatus des Videos „Privat“ ist. Der Wert wird im ISO 8601-Format angegeben. Beachten Sie die folgenden zwei zusätzlichen Punkte zum Verhalten dieser Property: Wenn Sie den Wert dieses Attributs beim Aufrufen der Methode videos.update festlegen, müssen Sie auch den Attributwert status.privacyStatus auf private setzen, auch wenn das Video bereits privat ist. Diese Eigenschaft kann nur festgelegt werden, wenn der Sichtbarkeitsstatus des Videos private ist und das Video noch nie veröffentlicht wurde. Wenn du in deiner Anfrage ein Video für einen Zeitpunkt in der Vergangenheit planst, wird es sofort veröffentlicht. Das Festlegen der Eigenschaft status.publishAt auf ein Datum und eine Uhrzeit in der Vergangenheit hat also denselben Effekt wie das Ändern der privacyStatus des Videos von private in public.
status.license	string Die Lizenz des Videos. Gültige Werte für diese Eigenschaft 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. Standardmäßig sind diese Statistiken sichtbar. Statistiken wie die Aufrufzahlen und Bewertungen eines Videos sind weiterhin öffentlich sichtbar, auch wenn der Wert dieser Eigenschaft auf false gesetzt ist.
status.madeForKids	boolean Dieser Wert gibt an, ob das Video als speziell für Kinder gekennzeichnet ist, und enthält den aktuellen Status des Videos in Bezug auf die Kennzeichnung „speziell für Kinder“. Der Status kann beispielsweise anhand des Werts der Eigenschaft selfDeclaredMadeForKids ermittelt werden. Weitere Informationen zum Festlegen der Zielgruppe für deinen Kanal, deine Videos oder deine Livestreams findest du in der YouTube-Hilfe.
status.selfDeclaredMadeForKids	boolean In einer videos.insert- oder videos.update-Anfrage kann der Kanalinhaber mit dieser Property das Video als auf Kinder ausgerichtet kennzeichnen. Bei einer videos.list-Anfrage wird der Attributwert nur zurückgegeben, wenn der Kanalinhaber die API-Anfrage autorisiert hat.
status.containsSyntheticMedia	boolean In einer videos.insert- oder videos.update-Anfrage kann der Kanalinhaber mit dieser Eigenschaft offenlegen, dass ein Video realistisch wirkende veränderte oder synthetische (V/S) Inhalte enthält. Weitere Informationen zu den YouTube-Richtlinien für Inhalte zu Alkohol und Tabak Beispiele für Inhalte zu Alkohol und Tabak sind Videos, in denen: Eine reale Person etwas sagen oder tun lassen, was sie nicht gesagt oder getan hat Aufnahmen eines realen Ereignisses oder Ortes verändern Eine realistisch anmutende Szene, die nicht wirklich stattgefunden hat, enthalten
statistics	object Das statistics-Objekt enthält Statistiken zum Video.
statistics.viewCount	unsigned long Gibt an, wie oft das Video aufgerufen wurde. Ab dem 31. März 2025 gibt „viewCount“ für Shorts die Anzahl der Wiedergaben oder wiederholten Wiedergaben eines Shorts zurück. Die Wiedergabezeit ist dabei unerheblich.
statistics.likeCount	unsigned long Die Anzahl der Nutzer, die das Video mit „Mag ich“ bewertet haben.
statistics.dislikeCount	unsigned long Hinweis:Die Property statistics.dislikeCount ist seit dem 13. Dezember 2021 privat. 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 der Nutzer, die das Video mit „Mag ich nicht“ bewertet haben.
statistics.favoriteCount	unsigned long Hinweis:Diese Eigenschaft wurde eingestellt. Die Einstellung erfolgt am 28. August 2015. Der Wert der Property ist jetzt immer auf 0 festgelegt.
statistics.commentCount	unsigned long Die Anzahl der Kommentare zum Video.
paidProductPlacementDetails	object Das paidProductPlacementDetails-Objekt enthält Informationen zu bezahlten Produktplatzierungen im Video.
paidProductPlacementDetails.hasPaidProductPlacement	boolean Auf true setzen, wenn in den Inhalten bezahlte Produktplatzierungen verwendet werden. Die Standardeinstellung ist false.
player	object Das player-Objekt enthält Informationen, die Sie zum Abspielen des Videos in einem eingebetteten Player verwenden können.
player.embedHtml	string Ein <iframe>-Tag, mit dem ein Player eingebettet wird, 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 für maxHeight und/oder maxWidth erfüllt werden. Wenn das Seitenverhältnis des Videos unbekannt ist, wird im eingebetteten Player standardmäßig das Format 4:3 verwendet.
player.embedHeight	long Die Höhe des eingebetteten Players, die in der Eigenschaft player.embedHtml zurückgegeben wird. Diese Property 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 Property player.embedHtml zurückgegeben wird. Diese Property 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 topicDetails-Objekt enthält Informationen zu Themen, die mit dem Video verknüpft sind. Wichtig:Weitere Informationen zu anstehenden Änderungen im Zusammenhang mit Themen-IDs findest du in den Definitionen der Eigenschaften topicDetails.relevantTopicIds[] und topicDetails.topicIds[] sowie im Überarbeitungsverlauf.
topicDetails.topicIds[]	list Wichtig:Diese Eigenschaft wurde am 10. November 2016 eingestellt. Die API gibt keine Werte mehr für diese Eigenschaft zurück. Alle Themen, die mit einem Video verknüpft sind, werden jetzt vom Eigenschaftswert topicDetails.relevantTopicIds[] zurückgegeben.
topicDetails.relevantTopicIds[]	list Eine Liste von Themen-IDs, die für das Video relevant sind. Diese Property ist seit dem 10. November 2016 veraltet. 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 diesem Zeitpunkt begann YouTube, eine kleine Gruppe kuratierter Themen-IDs zurückzugeben. Unterstützte Themen-IDs ab dem 15. Februar 2017 Themen Musikthemen /m/04rlf Musik (übergeordnetes Thema) /m/02mscn Christliche Musik /m/0ggq0m Klassische Musik /m/01lyv Land /m/02lkt Elektronische Musik /m/0glt670 Hip-Hop /m/05rwpb Unabhängige Musik /m/03_d0 Jazz /m/028sqc Musik aus Asien /m/0g293 Musik aus Lateinamerika /m/064t9 Popmusik /m/06cqb Reggae /m/06j6l Rhythm and Blues /m/06by7 Rockmusik /m/0gywn Soul Gaming-Themen /m/0bzvm2 Gaming (übergeordnetes Thema) /m/025zzc Actionspiel /m/02ntfj Action-Adventure /m/0b1vjn Casual Game /m/02hygl Musikvideospiel /m/04q1x3q Tüftel- und Rätselvideospiel /m/01sjng Rennspiel /m/0403l3g Video-Rollenspiel /m/021bp2 Simulationsspiel /m/022dc6 Sportspiele /m/03hf_rm Strategievideospiel Sportthemen /m/06ntj Sport (übergeordnetes Thema) /m/0jm_ American Football /m/018jz Baseball /m/018w8 Basketball /m/01cgz Boxen /m/09xp_ Cricket /m/02vx4 American Football /m/037hz Golf /m/03tmr Eishockey /m/01h7lh Mixed Martial Arts /m/0410tth Motorsport /m/07bs0 Tennis /m/07_53 Volleyball Unterhaltungsthemen /m/02jjt Unterhaltung (übergeordnetes Thema) /m/09kqc Humor /m/02vxn Filme /m/05qjc Darstellende Künste /m/066wd Professionelles Wrestling /m/0f2f9 Serien Lifestyle-Themen /m/019_rr Lifestyle (übergeordnetes Thema) /m/032tl Mode /m/027x7n Fitness /m/02wbm Essen /m/03glg Hobby /m/068hy Haustiere /m/041xxh Physische Attraktivität [Schönheit] /m/07c1v Technologie /m/07bxq Tourismus /m/07yv9 Fahrzeuge Gesellschaftliche Themen /m/098wr Gesellschaft (übergeordnetes Thema) /m/09s1f Unternehmen /m/0kt51 Gesundheit /m/01h6rj Militär /m/05qt0 Politik /m/06bvp Religion Weitere Themen /m/01k8wb Wissen
topicDetails.topicCategories[]	list Eine Liste von Wikipedia-URLs, die eine allgemeine Beschreibung des Videoinhalts enthalten.
recordingDetails	object Das recordingDetails-Objekt enthält Informationen zum Ort, Datum und zur Adresse, an der das Video aufgenommen wurde.
recordingDetails.locationDescription	string Dieses Attribut wird seit dem 1. Juni 2017 nicht mehr unterstützt. Weitere Informationen finden Sie in der Mitteilung zur Einstellung. Die Textbeschreibung des Orts, an dem das Video aufgenommen wurde.
recordingDetails.location	object Die mit dem Video verknüpften geografischen Informationen. Die Werte der untergeordneten Attribute geben den Standort an, den der Videoinhaber mit dem Video verknüpfen möchte. Der Wert ist bearbeitbar, bei öffentlichen Videos durchsuchbar und wird Nutzern möglicherweise bei öffentlichen Videos angezeigt.
recordingDetails.location.latitude	double Dieses Attribut wird seit dem 1. Juni 2017 nicht mehr unterstützt. Weitere Informationen finden Sie in der Mitteilung zur Einstellung. Breitengrad in Grad.
recordingDetails.location.longitude	double Dieses Attribut wird seit dem 1. Juni 2017 nicht mehr unterstützt. Weitere Informationen finden Sie in der Mitteilung zur Einstellung. Längengrad in Grad.
recordingDetails.location.altitude	double Dieses Attribut wird seit dem 9. Juli 2018 nicht mehr unterstützt. 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 ISO 8601-Format (YYYY-MM-DDThh:mm:ss.sssZ) angegeben.
fileDetails	object Das fileDetails-Objekt enthält Informationen zur Videodatei, die auf YouTube hochgeladen wurde, z. B. die Auflösung, Dauer, Audio- und Video-Codecs sowie die Bitraten der Streams. Diese Daten können nur vom Videoinhaber abgerufen werden. Das fileDetails-Objekt wird nur zurückgegeben, wenn die processingDetails.fileAvailability-Eigenschaft den Wert available hat.
fileDetails.fileName	string Der Name der hochgeladenen Datei. Dieses Feld ist unabhängig davon vorhanden, ob eine Videodatei oder ein anderer Dateityp hochgeladen wurde.
fileDetails.fileSize	unsigned long Die Größe der hochgeladenen Datei in Byte. Dieses Feld ist unabhängig davon vorhanden, ob eine Videodatei oder ein anderer Dateityp hochgeladen wurde.
fileDetails.fileType	string Der von der Videoverarbeitungs-Engine von YouTube erkannte Typ der hochgeladenen Datei. 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: Die Datei hat einen anderen Dateityp als Video. project: Die Datei ist eine Videoprojektdatei, z. B. ein Microsoft Windows Movie Maker-Projekt, 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 in der hochgeladenen Videodatei. Jedes Element in der Liste enthält detaillierte Metadaten zu einem Videostream.
fileDetails.videoStreams[].widthPixels	unsigned integer Die Breite des codierten Videoinhalts in Pixeln. Das Codierungs-Seitenverhältnis des Videos lässt sich als width_pixels / height_pixels berechnen.
fileDetails.videoStreams[].heightPixels	unsigned integer Die Höhe des codierten Videoinhalts in Pixeln.
fileDetails.videoStreams[].frameRateFps	double Die Framerate des Videostreams in Bildern pro Sekunde.
fileDetails.videoStreams[].aspectRatio	double Das Seitenverhältnis des Videocontents, das angibt, in welchem Seitenverhältnis das Video angezeigt werden soll.
fileDetails.videoStreams[].codec	string Der Videocodec, der vom Stream verwendet wird.
fileDetails.videoStreams[].bitrateBps	unsigned long Die Bitrate des Videostreams in Bits pro Sekunde.
fileDetails.videoStreams[].rotation	string Der Betrag, um den YouTube die ursprünglichen Quellinhalte drehen muss, damit das Video richtig angezeigt 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 andere, nicht triviale Weise gedreht werden. upsideDown – Das Video muss auf den Kopf gedreht werden.
fileDetails.videoStreams[].vendor	string Ein Wert, der einen Videoanbieter eindeutig identifiziert. Normalerweise ist der Wert ein vierstelliger Anbietercode.
fileDetails.audioStreams[]	list Eine Liste der in der hochgeladenen Videodatei enthaltenen Audiostreams. Jedes Element in der Liste enthält detaillierte Metadaten zu einem Audiostream.
fileDetails.audioStreams[].channelCount	unsigned integer Die Anzahl der Audiokanäle, die der Stream enthält.
fileDetails.audioStreams[].codec	string Der Audiocodec, der vom 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. Normalerweise ist der Wert ein vierstelliger Anbietercode.
fileDetails.durationMs	unsigned long Die Länge des hochgeladenen Videos in Millisekunden.
fileDetails.bitrateBps	unsigned long Die kombinierte Bitrate (Video und Audio) der hochgeladenen Videodatei 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 Naive Zeit: YYYY-MM-DDTHH:MM:SS Uhrzeit mit Zeitzone: YYYY-MM-DDTHH:MM:SS+HH:MM
processingDetails	object Das processingDetails-Objekt enthält Informationen zum Fortschritt der Verarbeitung der hochgeladenen Videodatei durch YouTube. Die Attribute im Objekt geben den aktuellen Verarbeitungsstatus und eine Schätzung der verbleibenden Zeit an, bis YouTube die Verarbeitung des Videos abgeschlossen hat. In diesem Bereich wird auch angegeben, ob für das Video verschiedene Arten von Daten oder Inhalten wie Dateidetails oder Thumbnails verfügbar sind.  Das processingProgress-Objekt ist so konzipiert, dass es abgefragt werden kann, um den Fortschritt der Verarbeitung der hochgeladenen Videodatei durch YouTube zu verfolgen. 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 ob das Video noch verarbeitet wird. Gültige Werte für diese Eigenschaft sind: failed – Die Videoverarbeitung ist fehlgeschlagen. Siehe ProcessingFailureReason. processing – Das Video wird gerade verarbeitet. Siehe ProcessingProgress. succeeded – Das Video wurde verarbeitet. terminated: Verarbeitungsinformationen sind nicht mehr verfügbar.
processingDetails.processingProgress	object Das processingProgress-Objekt enthält Informationen zum Fortschritt der Videoverarbeitung durch YouTube. Die Werte sind 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. Die Zahl kann aktualisiert werden, wenn YouTube das Video verarbeitet und genauere Schätzungen vorliegen.
processingDetails.processingProgress.partsProcessed	unsigned long Die Anzahl der Teile des Videos, die YouTube bereits verarbeitet hat. Du kannst den Prozentsatz des Videos, den YouTube bereits verarbeitet hat, so berechnen: 100 * parts_processed / parts_total Da die geschätzte Anzahl der Teile ohne entsprechende Erhöhung der Anzahl der bereits verarbeiteten Teile steigen kann, ist es möglich, dass der berechnete Fortschritt sinkt, während YouTube ein Video verarbeitet.
processingDetails.processingProgress.timeLeftMs	unsigned long Eine Schätzung der Zeit in Millisekunden, die YouTube für die Verarbeitung des Videos benötigt.
processingDetails.processingFailureReason	string Der Grund, warum YouTube das Video nicht verarbeiten konnte. Diese Property hat nur einen Wert, wenn der Wert der Property processingStatus failed ist. Gültige Werte für diese Property sind: other – Eine andere Verarbeitungskomponente ist fehlgeschlagen. streamingFailed – Das Video konnte nicht an Streamer gesendet werden. transcodeFailed – Die Inhalts-Transcodierung ist fehlgeschlagen. uploadFailed – Die Dateizustellung ist fehlgeschlagen.
processingDetails.fileDetailsAvailability	string Dieser Wert gibt an, ob für das hochgeladene Video Dateidetails verfügbar sind. Sie können die Dateidetails eines Videos abrufen, indem Sie in Ihrer videos.list()-Anfrage den fileDetails-Teil anfordern.
processingDetails.processingIssuesAvailability	string Dieser Wert gibt an, ob die Videoverarbeitungs-Engine Vorschläge zur Verbesserung der Videoverarbeitung, Warnungen zu Problemen bei der Videoverarbeitung oder Fehler, die Probleme bei der Videoverarbeitung verursachen, generiert hat. Sie können diese Vorschläge abrufen, indem Sie in Ihrer videos.list()-Anfrage den Teil suggestions anfordern.
processingDetails.tagSuggestionsAvailability	string Dieser Wert gibt an, ob für das Video Keyword- (Tag-)Vorschläge verfügbar sind. Tags können den Metadaten eines Videos hinzugefügt werden, damit andere Nutzer das Video leichter finden. Sie können diese Vorschläge abrufen, indem Sie in Ihrer videos.list()-Anfrage den Teil suggestions anfordern.
processingDetails.editorSuggestionsAvailability	string Dieser Wert gibt an, ob für das Video Vorschläge zur Videobearbeitung verfügbar sind, die die Videoqualität oder die Wiedergabe verbessern könnten. Sie können diese Vorschläge abrufen, indem Sie in Ihrer videos.list()-Anfrage den Teil suggestions anfordern.
processingDetails.thumbnailsAvailability	string Dieser Wert gibt an, ob für das Video Thumbnails generiert wurden.
suggestions	object Das suggestions-Objekt enthält Vorschläge, die Möglichkeiten zur Verbesserung der Videoqualität oder der Metadaten für das hochgeladene Video aufzeigen. Diese Daten können nur vom Rechteinhaber des Videos abgerufen werden. Das suggestions-Objekt wird nur zurückgegeben, wenn das Attribut processingDetails.tagSuggestionsAvailability oder das Attribut processingDetails.editorSuggestionsAvailability den Wert available hat.
suggestions.processingErrors[]	list Eine Liste von Fehlern, die verhindern, dass YouTube das hochgeladene Video erfolgreich verarbeitet. Diese Fehler deuten darauf hin, dass der Verarbeitungsstatus des Videos letztendlich mit hoher Wahrscheinlichkeit failed sein wird. Gültige Werte für diese Eigenschaft sind: archiveFile – Eine Archivdatei, z.B. ein ZIP-Archiv. audioFile – Die Datei enthält nur Audioinhalte (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, warum YouTube Schwierigkeiten beim Transkodieren des hochgeladenen Videos haben könnte oder warum es zu einer fehlerhaften Transkodierung kommen könnte. Diese Warnungen werden generiert, bevor YouTube die hochgeladene Videodatei tatsächlich verarbeitet. Außerdem werden Probleme erkannt, die nicht unbedingt dazu führen, dass die Videoverarbeitung fehlschlägt, aber dennoch Probleme wie Synchronisationsprobleme, Videoartefakte oder ein fehlender Audiotrack verursachen können. Gültige Werte für diese Property 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 – Der Audiocodec wurde nicht erkannt. Die Transcodierung schlägt wahrscheinlich fehl. unknownContainer – Unbekanntes Dateiformat. Die Transcodierung wird wahrscheinlich fehlschlagen. unknownVideoCodec: Der Video-Codec wird nicht erkannt. Die Transcodierung schlägt wahrscheinlich fehl.
suggestions.processingHints[]	list Eine Liste mit Vorschlägen, die die Verarbeitung des Videos durch YouTube verbessern können. Gültige Werte für diese Property sind: nonStreamableMov: Die MP4-Datei kann nicht gestreamt werden. Das verlangsamt die Verarbeitung. sendBestQualityVideo: Wahrscheinlich ist eine Version des Videos in besserer Qualität verfügbar.
suggestions.tagSuggestions[]	list Eine Liste von Keyword-Tags, die den Metadaten des Videos hinzugefügt werden könnten, um die Wahrscheinlichkeit zu erhöhen, dass Nutzer das Video bei der Suche oder beim Browsen 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 können Sie passende Tag-Vorschläge basierend auf der Videokategorie anzeigen, die der Video-Uploader dem Video zuweist. Standardmäßig sind Tag-Vorschläge für alle Kategorien relevant, wenn für das Keyword keine Einschränkungen definiert sind.
suggestions.editorSuggestions[]	list Eine Liste der Videobearbeitungsvorgänge, die die Videoqualität oder die Wiedergabe des hochgeladenen Videos verbessern könnten. Gültige Werte für diese Eigenschaft sind: audioQuietAudioSwap: Der Audiotrack ist stumm und könnte durch einen mit besserer Qualität ersetzt werden. videoAutoLevels – Die Helligkeitsstufen des Bildes scheinen nicht korrekt zu sein und könnten korrigiert werden. videoCrop – Um das Bild herum erkannte Ränder (Matten) könnten zugeschnitten werden. videoStabilize – Das Video ist verwackelt und könnte stabilisiert werden.
liveStreamingDetails	object Das liveStreamingDetails-Objekt enthält Metadaten zu einer Live-Videoübertragung. Das Objekt ist nur in einer video-Ressource vorhanden, wenn das Video eine bevorstehende, laufende oder abgeschlossene Liveübertragung ist.
liveStreamingDetails.actualStartTime	datetime Die tatsächliche Startzeit der Übertragung. Der Wert wird im ISO 8601-Format angegeben. Dieser Wert ist erst verfügbar, wenn die Übertragung beginnt.
liveStreamingDetails.actualEndTime	datetime Die tatsächliche Endzeit der Übertragung. 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 Die Zeit, zu der die Übertragung beendet werden soll. Der Wert wird im ISO 8601-Format angegeben. Wenn der Wert leer ist oder die Eigenschaft nicht vorhanden ist, soll die Übertragung unbegrenzt fortgesetzt werden.
liveStreamingDetails.concurrentViewers	unsigned long Die Anzahl der Zuschauer, die sich die Übertragung gerade ansehen. Die Property und ihr Wert sind vorhanden, wenn die Übertragung aktuelle Zuschauer hat und der Übertragungsinhaber die Anzahl der Aufrufe für das Video nicht ausgeblendet hat. Hinweis: YouTube beendet die Erfassung der Anzahl der gleichzeitigen Zuschauer für eine Übertragung, wenn die Übertragung endet. Diese Property gibt also nicht die Anzahl der Zuschauer an, die sich ein archiviertes Video einer bereits beendeten Liveübertragung ansehen. Die von der YouTube Data API zurückgegebenen Zahlen für gleichzeitige Zuschauer können von den verarbeiteten, von Spam bereinigten Zahlen für gleichzeitige Zuschauer abweichen, die über YouTube Analytics verfügbar sind. Weitere Informationen zu Livestreaming-Messwerten findest du in der YouTube-Hilfe.
liveStreamingDetails.activeLiveChatId	string Die ID des aktuell aktiven Livechats, der mit diesem Video verknüpft ist. Dieses Feld wird nur ausgefüllt, wenn das Video eine aktuelle Liveübertragung mit Livechat ist. Sobald die Übertragung abgeschlossen ist, wird dieses Feld entfernt und der Livechat geschlossen. Bei persistenten Übertragungen ist die Livechat-ID nicht mehr mit diesem Video, sondern mit dem neuen Video verknüpft, das auf der persistenten Seite angezeigt wird.
localizations	object Das localizations-Objekt enthält Übersetzungen der Metadaten des Videos.
localizations.(key)	object Die Sprache des lokalisierten Texts, der dem Schlüsselwert zugeordnet ist. Der Wert ist ein String, der einen BCP-47-Sprachcode enthält.
localizations.(key).title	string Der lokalisierte Videotitel.
localizations.(key).description	string Die lokalisierte Videobeschreibung.