Videos

Für alle Videos, die über den Endpunkt videos.insert von nicht bestätigten API-Projekten hochgeladen werden, die nach dem 28. Juli 2020 erstellt wurden, ist der private Wiedergabemodus verfügbar. Damit diese Einschränkung aufgehoben wird, muss jedes API-Projekt einem Audit 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 von Videos zurück, die den API-Anfrageparametern entsprechen. Hier kannst du die Funktion ausprobieren.

insert

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

Update

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 von einem Video entfernen Hier kannst du die Funktion ausprobieren.

reportAbuse

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 sich von dem Zeitpunkt des Uploads des Videos unterscheiden. Wenn ein Video beispielsweise als privat hochgeladen und später veröffentlicht wird, gibt diese Property 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 des Uploads an. Wenn ein Video als nicht gelistetes Video hochgeladen wird, gibt der Eigenschaftswert auch das Datum und die Uhrzeit des Uploads an. In diesem Fall kann jeder, der die eindeutige Video-ID des Videos kennt, die Metadaten des Videos 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 Eigenschaftswert 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 Videobeschreibung. 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. Bei jedem 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 sich auf ein Video bezieht) ist dieses Bild 320 Pixel breit und 180 Pixel hoch. Dieses Bild eines Kanals ist 240 Pixel breit und 240 Pixel hoch. high: Eine Version des Thumbnails mit hoher Auflösung. Bei einem Video (oder einer Ressource, die sich auf ein Video bezieht) ist dieses Bild 480 Pixel breit und 360 Pixel hoch. Dieses Bild eines Kanals ist 800 Pixel breit und 800 Pixel hoch. standard: Das Thumbnail-Bild hat eine höhere Auflösung als das Bild mit einer Auflösung von high. Dieses Bild ist für einige Videos und andere Ressourcen verfügbar, die sich auf Videos beziehen, z. B. Playlist-Elemente oder Suchergebnisse. Dieses Bild ist 640 Pixel breit und 480 Pixel hoch. maxres: Das Thumbnail-Bild 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 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 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 die folgenden Regeln zur Berechnung der Zeichenbeschränkung: Beim Attributwert handelt es sich um eine Liste. 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 dann auf die Zeichenbeschränkung angerechnet. Aus Gründen der Zeichenbeschränkung enthält das Tag Foo-Baz also sieben Zeichen, das Tag Foo Baz jedoch neun.
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 Teil snippet einer video-Ressource aktualisieren.
snippet.liveBroadcastContent	string Gibt an, ob das Video eine anstehende/aktive Liveübertragung ist. Oder „Keine“, wenn das Video keine anstehende/aktive Liveübertragung ist. Gültige Werte für diese Eigenschaft 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 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 oder ein Wert angegeben ist, aber für die angegebene Sprache keine lokalisierten Metadaten verfügbar sind. Die Eigenschaft enthält einen schreibgeschützten Wert. Mit dem localizations-Objekt 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 einer Angabe, ob für das Video Untertitel verfügbar sind.
contentDetails.duration	string Die Länge des Videos. Der Wert der Eigenschaft ist eine Dauer gemäß ISO 8601. Bei einem Video, das mindestens eine Minute und weniger als eine Stunde lang ist, wird die Dauer beispielsweise im Format PT#M#S angegeben. Dabei geben die Buchstaben PT an, 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 ganze Zahlen, die die Anzahl der Minuten (oder Sekunden) des Videos angeben. Beispielsweise gibt der Wert PT15M33S 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 der # 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. Vollständige Details finden Sie in der Spezifikation ISO 8601.
contentDetails.dimension	string Gibt an, ob das Video in 3D oder 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 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 repräsentiert. Das bedeutet, dass die Inhalte auf einen Kanal hochgeladen wurden, 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 Eigenschaft vorhanden ist und im Wert kein Land angegeben ist, wird das Video in diesem Land nicht gezeigt. 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 angesehen werden.
contentDetails.contentRating	object Gibt die Bewertungen an, die das Video gemäß verschiedenen Bewertungssystemen 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 Fernsehprogramme für Kinder zu klassifizieren. Gültige Werte für diese Unterkunft: acbC: Programme, die von der Australian Communications and Media Authority als C klassifiziert wurden. Diese Programme sind für Kinder (keine Vorschulkinder) gedacht, die jünger als 14 Jahre sind. acbE – O acbG bis 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–18 R+ 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 Bewertung „Anatel (Asociación Nacional de Televisión)“ 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 British Board of Film Classification (BBFC) für das Video. Gültige Werte für diese Unterkunft sind: bbfc12 – 12 bbfc12a – 12A bbfc15 – 15 bbfc18 – 18 bbfcPg – PG bbfcR18–18 R 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: bfvc13 – 13 bfvc15 – 15 bfvc18 – 18 bfvc20 – 20 bfvcB – B bfvcE – O bfvcG bis G bfvcUnrated
contentDetails.contentRating.bmukkRating	string Einstufung des Videos durch die österreichische Medienklassifikation (Bundesministerium für Unterricht, Kunst und Kultur). Gültige Werte für diese Unterkunft sind: bmukk10 – 10+ bmukk12 – 12+ bmukk14 – 14+ bmukk16 – 16+ bmukk6 – 6+ bmukk8 – 8+ bmukkAa – uneingeschränkt bmukkUnrated
contentDetails.contentRating.catvRating	string Einstufungssystem für das kanadische Fernsehen – Canadian TV Classification System Die Einstufung des Videos durch die Canadian Radio-Television and Telecommunications Commission (CRTC) für kanadisch-englischsprachige Sendungen. Weitere Informationen finden Sie auf der Website des Canadian Broadcast Standards Council. Gültige Werte für diese Property: catv14plus – 14+ catv18plus – 18+ catvC – C catvC8 – C8 catvG bis G catvPg – PG catvUnrated
contentDetails.contentRating.catvfrRating	string Die Einstufung des Videos durch die Canadian 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 – 13+ catvfr16plus – 16+ catvfr18plus – 18+ catvfr8plus – 8+ catvfrG bis G catvfrUnrated
contentDetails.contentRating.cbfcRating	string Die Bewertung des Central Board of Film Certification (CBFC – Indien) des Videos. Gültige Werte für diese Unterkunft: 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 „Consejo de Calificación Cinematográfica (Chile)“ des Videos. Gültige Werte für diese Unterkunft: ccc14 – 14+ ccc18 – 18+ ccc18s – 18+ – contenido pornográfico ccc18v–18+ – contenido excesivamente Gewalto ccc6 – 6+ – Inconveniente para menores de 7 años cccTe – Todo Espectador cccUnrated
contentDetails.contentRating.cceRating	string Die Bewertung des Videos aus dem portugiesischen Comissão de Classificação de Espect 'culos. Gültige Werte für diese Unterkunft: cceM12 – 12 cceM14 – 14 cceM16 – 16 cceM18 – 18 cceM4 – 4 cceM6 – 6 cceUnrated
contentDetails.contentRating.chfilmRating	string Die Bewertung des Videos in der Schweiz. Gültige Werte für diese Unterkunft sind: chfilm0 – 0 chfilm12 – 12 chfilm16 – 16 chfilm18 – 18 chfilm6 – 6 chfilmUnrated
contentDetails.contentRating.chvrsRating	string Die Bewertung des Canadian Home Video Rating System (CHVRS) für das Video. Gültige Werte für diese Property sind: chvrs14a – 14A chvrs18a – 18A chvrsE – O chvrsG bis G chvrsPg – PG chvrsR – R chvrsUnrated
contentDetails.contentRating.cicfRating	string Die Einstufung des Videos durch die Commission de Contrôle des Films (Belgien). Gültige Werte für diese Unterkunft: cicfE – O cicfKntEna – KNT/ENA cicfKtEa – KT/EA cicfUnrated
contentDetails.contentRating.cnaRating	string Die Bewertung des Videos aus Rumäniens CONSILIUL NATIONAL AL AUDIOVIZUALULUI (CNA). Gültige Werte für diese Property sind: cna12 – 12 cna15 – 15 cna18 – 18 cna18plus – 18+ cnaAp – ZP cnaUnrated
contentDetails.contentRating.cncRating	string Bewertungssystem in Frankreich – Kinematografie der Kommission für Deklassifikation Gültige Werte für diese Unterkunft: cnc10 – 10 cnc12 – 12 cnc16 – 16 cnc18 – 18 cncE – O cncT – T cncUnrated
contentDetails.contentRating.csaRating	string Die Bewertung des Videos durch den französischen Conseil supérieur de l?audiovisuel, der Übertragungsinhalte bewertet. Gültige Werte für diese Unterkunft sind: csa10 – 10 csa12 – 12 csa16 – 16 csa18 – 18 csaInterdiction – Verbot csaT – T csaUnrated
contentDetails.contentRating.cscfRating	string Die Bewertung des Videos durch die Luxemburgische Commission de surveillance de la classification desmovies (CSCF). Gültige Werte für diese Unterkunft sind: cscf12 – 12 cscf16 – 16 cscf18 – 18 cscf6 – 6 cscf9 – 9 cscfA – A cscfAl – AL cscfUnrated
contentDetails.contentRating.czfilmRating	string Die Bewertung des Videos in Tschechien. Gültige Werte für diese Unterkunft sind: czfilm12 – 12 czfilm14 – 14 czfilm18 – 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: djctq10 – 10 djctq12 – 12 djctq14 – 14 djctq16 – 16 djctq18 – 18 djctqL – L djctqUnrated
contentDetails.contentRating.djctqRatingReasons[]	list Eine Erklärung, warum das Video die Bewertung als DJCQT (Brasilien) erhalten hat.
contentDetails.contentRating.ecbmctRating	string Bewertungssystem in der Türkei: Board of Culturas of Culture und Tourismus für die Bewertung und Klassifizierung Gültige Werte für diese Unterkunft: ecbmct13a – 13A ecbmct13plus – 13+ ecbmct15a – 15A ecbmct15plus – 15+ ecbmct18plus – 18+ ecbmct7a–7:00 ecbmct7plus – 7+ ecbmctG bis G ecbmctUnrated ecbmct6a – 6A ecbmct6plus – 6+ ecbmct10a – 10A ecbmct10plus – 10+ ecbmct16plus – 16+
contentDetails.contentRating.eefilmRating	string Die Bewertung des Videos in Estland. Gültige Werte für diese Unterkunft: 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 – 18 egfilmBn – BN egfilmGn – GN egfilmUnrated
contentDetails.contentRating.eirinRating	string Die Eirin-Bewertung (映倫) des Videos. Eirin ist das japanische Bewertungssystem. Gültige Werte für diese Unterkunft sind: eirinG bis G eirinPg12 – PG-12 eirinR15plus–15 R+ eirinR18plus–18 R+ eirinUnrated
contentDetails.contentRating.fcbmRating	string Die Bewertung des Videos durch das malaysische Film Censorship Board. Gültige Werte für diese Unterkunft: fcbm13 – 13 fcbm16 – 16 fcbm18 – 18 fcbm18pa–18 p.A. fcbm18pl–18 PLN fcbm18sg – 18SG fcbm18sx – 18SX fcbmP12 – P12 fcbmP13 – P13 fcbmPg13 – PG13 fcbmU – U fcbmUnrated
contentDetails.contentRating.fcoRating	string Die Bewertung 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. Verwende stattdessen die Property contentDetails.contentRating.cncRating. Die Bewertung des Videos im 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 – 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 Unterkunft sind: fpb10 – 10 fpb1012Pg–10–12 PG fpb13 – 13 fpb16 – 16 fpb18 – 18 fpb79Pg–7–9 PG fpbA – A fpbPg – PG fpbUnrated fpbX18 – X18 fpbXx – XX
contentDetails.contentRating.fpbRatingReasons[]	list Begründe, warum das Video die FPB-Bewertung (Südafrika) erhalten hat.
contentDetails.contentRating.fskRating	string Einstufung der Freiwilligen Selbstkontrolle der Filmwirtschaft (FSK – Deutschland) für das Video. Gültige Werte für diese Unterkunft: fsk0 – FSK 0 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: 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 Die Bewertung des 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 – 18 icaa7 – 7 icaaApta – APTA icaaUnrated icaaX – X
contentDetails.contentRating.ifcoRating	string Einstufung des Videos durch die irische Filmklassifikationsstelle (IFCO – Ireland). Weitere Informationen finden Sie auf der Website von IFCO. Gültige Werte für dieses Attribut sind: ifco12 – 12 ifco12a – 12A ifco15 – 15 ifco15a – 15A ifco16 – 16 ifco18 – 18 ifcoG bis G ifcoPg – PG ifcoUnrated
contentDetails.contentRating.ilfilmRating	string Die Bewertung des Videos in Israel. Gültige Werte für diese Unterkunft: ilfilm12 – 12 ilfilm16 – 16 ilfilm18 – 18 ilfilmAa – AA ilfilmUnrated
contentDetails.contentRating.incaaRating	string Die INAA-Bewertung (Instituto Nacional de Cine y Artes Audiovisuales – Argentinien) des Videos. Gültige Werte für diese Unterkunft: incaaAtp: Anzeigentechnologie-Anbieter (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 Jahre (Solo apta para Mayores de 18 años) incaaUnrated
contentDetails.contentRating.kfcbRating	string Die Bewertung des Videos durch das Kenya Film Classification Board. Gültige Werte für diese Unterkunft sind: kfcb16plus – 16 kfcbG – GE kfcbPg – PG kfcbR – 18 kfcbUnrated
contentDetails.contentRating.kijkwijzerRating	string voor de Classificatie van Audiovisuele Media (Niederlande). Gültige Werte für diese Unterkunft: kijkwijzer12 – 12 kijkwijzer14 – 14 kijkwijzer16 – 16 kijkwijzer18 – 18 kijkwijzer6 – 6 kijkwijzer9 – 9 kijkwijzerAl – AL kijkwijzerUnrated
contentDetails.contentRating.kmrbRating	string Bewertung des Videos durch das Korea Media Rating Board (영상물등용위원회) KMRB bewertet Videos in Südkorea. Gültige Werte für diese Unterkunft sind: kmrb12plus – 12세 이상 관람커 kmrb15plus – 15〝 이상 관람커 kmrbAll – 전체관람트 kmrbR – 청소년 관람불 verbleibenden kmrbTeenr kmrbUnrated
contentDetails.contentRating.lsfRating	string Die Bewertung des Videos aus dem indonesischen Lembaga Sensor Film. Gültige Werte für diese Unterkunft: lsf13 – 13 lsf17 – 17 lsf21 – 21 lsfA – A lsfBo – BO lsfD – D lsfR – R lsfSu – SU lsfUnrated
contentDetails.contentRating.mccaaRating	string Die Bewertung des Videos durch das Film Age-Classification Board von Malta. Gültige Werte für diese Unterkunft sind: mccaa12 – 12 mccaa12a – 12A mccaa14 – 14: Diese Bewertung wurde aus der neuen Klassifizierungsstruktur von 2013 entfernt. mccaa15 – 15 mccaa16 – 16: Diese Bewertung wurde aus der 2013 eingeführten neuen Klassifizierungsstruktur entfernt. mccaa18 – 18 mccaaPg – PG mccaaU – U mccaaUnrated
contentDetails.contentRating.mccypRating	string Die Bewertung des Videos durch das dänische Filminstitut (Det Danske Filminstitut) Media Council for Children and Young People. Gültige Werte für diese Unterkunft sind: mccyp11 – 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 Unterkunft: 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 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 Property sind: mdaG bis G mdaM18 – M18 mdaNc16 – NC16 mdaPg – PG mdaPg13 – PG13 mdaR21–21 R mdaUnrated
contentDetails.contentRating.medietilsynetRating	string Die Bewertung des Videos durch Medietilsynet, die norwegische 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 Bewertung des Videos durch die finnische Kansallinen Audiovisuaalinen Instituutti (Nationales Audiovisuelles Institut). Gültige Werte für diese Unterkunft: meku12 – 12 meku16 – 16 meku18 – 18 meku7 – 7 mekuS – S mekuUnrated
contentDetails.contentRating.mibacRating	string Die Bewertung des Videos durch das Ministero dei Beni e delle Attività Culturali e del Turismo (Italien). Gültige Werte für diese Unterkunft: mibacT mibacUnrated mibacVap mibacVm6 mibacVm12 mibacVm14 mibacVm18
contentDetails.contentRating.mocRating	string Die Bewertung des Videos Ministerio de Cultura (Kolumbien). Gültige Werte für diese Unterkunft: moc12 – 12 moc15 – 15 moc18 – 18 moc7 – 7 mocBanned – gesperrt mocE – O mocT – T mocUnrated mocX – X
contentDetails.contentRating.moctwRating	string Die Bewertung des Videos durch das taiwanesische Kulturministerium (FirstName化部). Gültige Werte für diese Unterkunft: moctwG bis G moctwP – P moctwPg – PG moctwR – R moctwR12 – R-12 moctwR15–15 R-15 moctwUnrated
contentDetails.contentRating.mpaaRating	string Die Bewertung der Motion Picture Association of America (MPAA) für das Video. Gültige Werte für diese Eigenschaft sind: mpaaG bis G mpaaNc17 – NC-17 mpaaPg – PG mpaaPg13 – PG-13 mpaaR – R mpaaUnrated
contentDetails.contentRating.mpaatRating	string Bewertung von Filmtrailern und Vorschau durch die Motion Picture Association of America. Gültige Werte für diese Property sind: mpaatGb – GB (Grünes Band – für alle Zielgruppen genehmigt) mpaatRb – RB (Rotes Band – empfohlen für Kinder ab 17 Jahren)
contentDetails.contentRating.mtrcbRating	string Die Bewertung des Videos durch das Movie and Television Review and Classification Board (Philippinen) Gültige Werte für diese Unterkunft: mtrcbG bis G mtrcbPg – PG mtrcbR13 – R-13 mtrcbR16 – R-16 mtrcbR18 – R-18 mtrcbUnrated mtrcbX – X
contentDetails.contentRating.nbcRating	string Die Einstufung des Videos durch das National Bureau of Classification auf den Malediven. Gültige Werte für diese Unterkunft sind: nbc12plus – 12+ nbc15plus – 15+ nbc18plus – 18+ nbc18plusr – 18+R nbcG bis 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: nfrcA – A nfrcB – B nfrcC – C nfrcD – D nfrcUnrated nfrcX – X
contentDetails.contentRating.nfvcbRating	string Die Bewertung des Videos durch das National Film and Video Censors Board in Nigeria. Gültige Werte für diese Unterkunft: nfvcb12 – 12 nfvcb12a – 12A nfvcb15 – 15 nfvcb18 – 18 nfvcbG bis G nfvcbPg – PG nfvcbRe – RE nfvcbUnrated
contentDetails.contentRating.nkclvRating	string Die Bewertung des Videos vom Nacionãlais Kino centrs (Nationales Filmzentrum Lettlands). Gültige Werte für diese Unterkunft sind: nkclv12plus – 12+ nkclv18plus – 18+ nkclv7plus – 7+ nkclvU – U nkclvUnrated
contentDetails.contentRating.oflcRating	string Die Bewertung des Office of Film and Literature Classification (OFLC – Neuseeland) des Videos. Gültige Werte für diese Unterkunft: oflcG bis G oflcM – M oflcPg – PG oflcR13–13 R oflcR15–15 R oflcR16–16 R oflcR18–18 R oflcRp13 – RP13 oflcRp16 – RP16 oflcUnrated
contentDetails.contentRating.pefilmRating	string Die Bewertung des Videos in Peru. Gültige Werte für diese Unterkunft sind: pefilm14 – 14 pefilm18 – 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 Die Bewertung der Generaldirektion für Radio, Fernsehen und Kino (Mexiko) des Videos. Gültige Werte für diese Unterkunft: rtcA – A rtcAa – AA rtcB – B rtcB15 – B15 rtcC – C rtcD – D rtcUnrated
contentDetails.contentRating.rteRating	string Die Bewertung des Videos durch die irische Raidió Teilifís Éireann. Gültige Werte für diese Unterkunft sind: rteCh – CH rteGa – GA rteMa – MA rtePs – PS rteUnrated
contentDetails.contentRating.russiaRating	string Einstufung des Videos vom National Film Registry of the Russian Federation (MKRF – Russland). Gültige Werte für diese Property sind: russia0 – 0+ russia12 – 12+ russia16 – 16+ russia18 – 18+ russia6 – 6+ russiaUnrated
contentDetails.contentRating.skfilmRating	string Die Bewertung des Videos in der Slowakei. Gültige Werte für diese Unterkunft sind: skfilmG bis G skfilmP2 – P2 skfilmP5 – P5 skfilmP8 – P8 skfilmUnrated
contentDetails.contentRating.smaisRating	string Die Bewertung des Videos in Island. Gültige Werte für diese Unterkunft: smais12 – 12 smais14 – 14 smais16 – 16 smais18 – 18 smais7 – 7 smaisL – L smaisUnrated
contentDetails.contentRating.smsaRating	string Die Bewertung des Videos durch Statens medieråd (Swedens National Media Council). Gültige Werte für diese Property sind: smsa11 – 11 smsa15 – 15 smsa7 – 7 smsaA – Alle Altersgruppen smsaUnrated
contentDetails.contentRating.tvpgRating	string Die Einstufung 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-J tvpgY7 – TV-Y7 tvpgY7Fv – TV-Y7-FV pg14 – TV-14
contentDetails.contentRating.ytRating	string Eine Einstufung, anhand derer YouTube Inhalte mit Altersbeschränkung erkennt. 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 Uploader ein benutzerdefiniertes Thumbnail für das Video bereitgestellt hat. Diese Property 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 Unterkunft: 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. Diese Eigenschaft ist nur vorhanden, wenn das Attribut uploadStatus angibt, dass der Upload abgelehnt wurde. Gültige Werte für diese Eigenschaft 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 für die geplante 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 Property: 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 planst, wird das Video sofort veröffentlicht. Wenn du also die status.publishAt-Property auf ein Datum und eine Uhrzeit in der Vergangenheit festlegst, hat dies dieselbe Auswirkung wie eine Änderung der privacyStatus des Videos von private zu public.
status.license	string Die Lizenz des Videos. 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 können standardmäßig aufgerufen werden. 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 wurde. Außerdem enthält er den aktuellen Status „Speziell für Kinder“ des Videos. Der Status kann beispielsweise anhand des Werts der Eigenschaft selfDeclaredMadeForKids ermittelt werden. Weitere Informationen dazu, wie du die Zielgruppe für deinen Kanal, deine Videos oder Sendungen festlegst, findest du in der YouTube-Hilfe.
status.selfDeclaredMadeForKids	boolean Bei einer videos.insert- oder videos.update-Anfrage kann der Kanalinhaber mithilfe dieser Property angeben, dass das Video auf Kinder ausgerichtet ist. Bei einer videos.list-Anfrage wird der Attributwert nur zurückgegeben, wenn der Kanalinhaber die API-Anfrage autorisiert hat.
statistics	object Das statistics-Objekt 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 eine API-Antwort aufgenommen wird, wenn die API-Anfrage vom Videoinhaber authentifiziert wurde. Weitere Informationen finden Sie im Überarbeitungsverlauf. Die Anzahl der Nutzer, die angegeben haben, dass ihnen das Video nicht gefallen hat.
statistics.favoriteCount	unsigned long Hinweis:Diese Property 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 zum Video.
player	object Das player-Objekt enthält Informationen, die du zum Abspielen des Videos in einem eingebetteten Player verwenden 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 entsprechend den Anforderungen für maxHeight und/oder maxWidth skaliert. Wenn das Seitenverhältnis des Videos unbekannt ist, verwendet der eingebettete Player standardmäßig ein 4:3-Format.
player.embedHeight	long Die Höhe des eingebetteten Players, der in der Eigenschaft player.embedHtml zurückgegeben wurde. 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 topicDetails-Objekt enthält Informationen zu den mit dem Video verknüpften Themen. Wichtig:In den Definitionen der Properties topicDetails.relevantTopicIds[] und topicDetails.topicIds[] sowie im Überarbeitungsverlauf finden Sie weitere Informationen zu anstehenden Änderungen in Bezug auf Themen-IDs.
topicDetails.topicIds[]	list Wichtig:Diese Property wurde am 10. November 2016 eingestellt. Die API gibt keine Werte mehr für diese Eigenschaft zurück und alle mit einem Video verknüpften Themen werden jetzt über den Eigenschaftswert 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. Früher gab YouTube einige ausgewählte Themen-IDs zurück. Themen-IDs, die ab dem 15. Februar 2017 unterstützt werden 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 Independent-Musik /m/03_d0 Jazz /m/028sqc Asien-Musik /m/0g293 Lateinamerikanische Musik /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 Action-Spiel /m/02ntfj Action-Abenteuerspiel /m/0b1vjn Casual Game /m/02hygl Musikvideospiel /m/04q1x3q Rätselvideospiel /m/01sjng Rennsport-Videospiel /m/0403l3g Video-Rollenspiel /m/021bp2 Simulations-Videospiel /m/022dc6 Sportspiel /m/03hf_rm Strategie-Videospiel 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 Körperliche Attraktivität [Schönheit] /m/07c1v Technologie /m/07bxq Tourismus /m/07yv9 Fahrzeuge Gesellschaftsthemen /m/098wr Gesellschaft (übergeordnetes Thema) /m/09s1f Unternehmen /m/0kt51 Zustand /m/01h6rj Militär /m/05qt0 Politik /m/06bvp Religion Weitere Informationen /m/01k8wb Wissen
topicDetails.topicCategories[]	list Eine Liste von Wikipedia-URLs, die eine allgemeine Beschreibung der Inhalte des Videos bieten.
recordingDetails	object Das recordingDetails-Objekt enthält Informationen zum Ort, zum Datum und zur Adresse, an dem das Video aufgezeichnet wurde.
recordingDetails.locationDescription	string Diese Property wurde am 1. Juni 2017 eingestellt. Weitere Informationen finden Sie in der Ankündigung. Die Textbeschreibung des Ortes, an dem das Video aufgenommen wurde.
recordingDetails.location	object Die mit dem Video verknüpften Standortinformationen. Beachte, dass die Werte der untergeordneten Property den Standort angeben, den der Videoinhaber mit dem Video verknüpfen möchte. Der Wert kann bearbeitet, bei öffentlichen Videos gesucht und Nutzern für öffentliche Videos angezeigt werden.
recordingDetails.location.latitude	double Diese Property wurde am 1. Juni 2017 eingestellt. Weitere Informationen finden Sie in der Ankündigung. Breitengrad in Grad.
recordingDetails.location.longitude	double Diese Property wurde am 1. Juni 2017 eingestellt. Weitere Informationen finden Sie in der Ankündigung. Längengrad in Grad.
recordingDetails.location.altitude	double Diese Property wurde am 9. Juli 2018 eingestellt. Weitere Informationen finden Sie in der Ankündigung. 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 zur 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 Videoinhaber 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 immer 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 immer vorhanden, unabhängig davon, ob eine Videodatei oder ein anderer Dateityp hochgeladen wurde.
fileDetails.fileType	string Der Typ der hochgeladenen Datei, der vom Videoverarbeitungssystem von YouTube erkannt wurde. YouTube verarbeitet derzeit 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: Bei der Datei handelt es sich um einen bekannten 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 der Datei handelt es sich um einen anderen Dateityp, der keine Videodatei ist. project: Die Datei ist eine Videoprojektdatei, z. B. ein Projekt in Microsoft Windows Movie Maker, die keine tatsächlichen Videodaten enthält. video: Bei der Datei handelt es sich um einen bekannten 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. Jeder Eintrag 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 Videocontents, das das Seitenverhältnis angibt, in dem das Video angezeigt werden soll.
fileDetails.videoStreams[].codec	string Der Video-Codec, der vom 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 korrekt 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 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 in der hochgeladenen Videodatei. Jeder Eintrag 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 Audio-Codec, den der Stream verwendet.
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 (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 Normalzeit: YYYY-MM-DDTHH:MM:SS Zeit mit Zeitzone: YYYY-MM-DDTHH:MM:SS+HH:MM
processingDetails	object Das processingDetails-Objekt enthält Informationen zum Fortschritt von YouTube bei der Verarbeitung der hochgeladenen Videodatei. Die Properties 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 z. B. Dateidetails oder Miniaturansichten, für das Video verfügbar sind. Das processingProgress-Objekt ist für Abfragen konzipiert, damit das hochgeladene Video den Fortschritt von YouTube bei der Verarbeitung der hochgeladenen Videodatei verfolgen kann. Diese Daten können nur vom Videoinhaber abgerufen werden.
processingDetails.processingStatus	string Der Verarbeitungsstatus des Videos. Dieser Wert gibt an, ob das Video von YouTube verarbeitet werden konnte oder 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 erfolgreich verarbeitet. terminated: Es sind keine Verarbeitungsinformationen mehr verfügbar.
processingDetails.processingProgress	object Das processingProgress-Objekt enthält Informationen zum Fortschritt von YouTube bei der Verarbeitung des Videos. 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. Während das Video von YouTube verarbeitet wird, wird die Zahl unter Umständen mit präziseren Schätzungen aktualisiert.
processingDetails.processingProgress.partsProcessed	unsigned long Die Anzahl der Teile des Videos, die von YouTube bereits verarbeitet wurden. Den Prozentsatz des Videos, den YouTube bereits verarbeitet hat, kannst du schätzen: 100 * parts_processed / parts_total Hinweis: Da die geschätzte Anzahl der Videoteile ohne entsprechende Zunahme der bereits verarbeiteten Teile zunehmen könnte, 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 das Video zu verarbeiten.
processingDetails.processingFailureReason	string Der Grund, warum YouTube das Video nicht verarbeiten konnte. Dieses Attribut hat nur dann einen Wert, wenn der Wert des Attributs processingStatus failed ist. 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 Inhaltstranscodierung ist fehlgeschlagen. uploadFailed: Die Dateiübermittlung ist fehlgeschlagen.
processingDetails.fileDetailsAvailability	string Dieser Wert gibt an, ob Dateidetails für das hochgeladene Video verfügbar sind. Du kannst die Dateidetails eines Videos 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, in denen Probleme bei der Videoverarbeitung erklärt werden, oder Fehler, die zu Problemen bei der Videoverarbeitung führen. 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. Tags können zu den Metadaten eines Videos 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, die zur Verbesserung der Videoqualität oder der Wiedergabe beitragen können. 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, mit denen du die Videoqualität oder die Metadaten des hochgeladenen Videos verbessern kannst. Diese Daten können nur vom Videoinhaber 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 mit Fehlern, die verhindern, dass das hochgeladene Video auf YouTube verarbeitet wird. 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 Datei, die keine Videodatei ist. projectFile: Filmprojektdatei (z.B. Microsoft Windows Movie Maker-Projekt).
suggestions.processingWarnings[]	list Eine Liste mit möglichen Gründen, warum YouTube das hochgeladene Video nicht transkodieren kann oder eine fehlerhafte Transcodierung zur Folge hat. Diese Warnungen werden angezeigt, bevor YouTube die hochgeladene Videodatei tatsächlich verarbeitet. Außerdem werden Probleme identifiziert, die nicht unbedingt auf eine fehlerhafte Videoverarbeitung hinweisen, 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: Der Audio-Codec, der bekanntermaßen Probleme verursacht, wurde verwendet. problematicVideoCodec: Der Video-Codec, der bekanntermaßen Probleme verursacht, wurde verwendet. unknownAudioCodec: Unbekannter Audio-Codec. Die Transcodierung schlägt wahrscheinlich fehl. unknownContainer: Unbekanntes 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, wie YouTube die Verarbeitung des Videos verbessern kann. Gültige Werte für diese Property sind: nonStreamableMov: Die MP4-Datei kann nicht gestreamt werden, was die Verarbeitung verlangsamt. sendBestQualityVideo: Das Video ist vermutlich in einer qualitativ höherwertigen Version verfügbar.
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 dein Video beim Suchen oder 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 für die Videokategorie anzeigen, die der Video-Uploader mit dem Video verknüpft. Standardmäßig sind Tag-Vorschläge für alle Kategorien relevant, sofern für das Keyword keine Einschränkungen festgelegt wurden.
suggestions.editorSuggestions[]	list Eine Liste mit Videobearbeitungsvorgängen, mit denen die Videoqualität oder die Wiedergabequalität des hochgeladenen Videos verbessert werden können. Gültige Werte für diese Eigenschaft sind: audioQuietAudioSwap: Der Audiotrack erscheint lautlos und könnte durch einen qualitativ besseren Audiotrack ausgetauscht werden. videoAutoLevels: Die Helligkeit des Bilds scheint nicht zu stimmen und kann korrigiert werden. videoCrop: Die Ränder (Matte) um das Bild herum könnten zugeschnitten werden. videoStabilize: Das Video erscheint verwackelt und könnte stabilisiert werden.
liveStreamingDetails	object Das liveStreamingDetails-Objekt enthält Metadaten zu einer Live-Videoübertragung. Das Objekt ist nur dann in einer video-Ressource vorhanden, wenn das Video eine anstehende, eine Liveübertragung oder eine beendete Liveübertragung ist.
liveStreamingDetails.actualStartTime	datetime Der tatsächliche Startzeitpunkt der Übertragung. 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 verfügbar, wenn die Übertragung beendet ist.
liveStreamingDetails.scheduledStartTime	datetime Die Uhrzeit, zu der die Übertragung geplant ist. Der Wert wird im ISO 8601-Format angegeben.
liveStreamingDetails.scheduledEndTime	datetime Die Uhrzeit, zu der die Übertragung planmäßig 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 der Zuschauer, 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. Beachte, dass YouTube die Anzahl an gleichzeitigen Zuschauern einer Übertragung nach dem Ende der Übertragung nicht mehr verfolgt. Diese Property kann 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 und bereinigten gleichzeitigen Zuschauer abweichen, die in 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 das Video eine aktuelle Liveübertragung mit Livechat ist. Sobald die Übertragung abgeschlossen ist, wird dieses Feld entfernt und der Livechat geschlossen. Bei dauerhaften Broadcasts ist die Livechat-ID nicht mehr mit diesem Video verknüpft. Stattdessen wird das neue Video auf der persistenten Seite angezeigt.
localizations	object Das localizations-Objekt enthält Übersetzungen der Metadaten des Videos.
localizations.(key)	object Die Sprache des lokalisierten Textes, der mit dem Schlüssel/Wert-Paar verknüpft 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.