Alle Videos, die über den Endpunkt
videos.insert
aus nicht bestätigten API-Projekten hochgeladen werden, die nach dem 28. Juli 2020 erstellt wurden, werden auf den privaten Modus beschränkt. Damit diese Einschränkung aufgehoben werden kann, muss jedes API-Projekt einer Prüfung unterzogen werden, um die Einhaltung der Nutzungsbedingungen zu verifizieren. Weitere Informationen finden Sie im API-Überarbeitungsverlauf.
Eine video
-Ressource steht für ein YouTube-Video.
Methoden
Die API unterstützt die folgenden Methoden für videos
-Ressourcen:
- getRating
- Ruft die Bewertungen ab, die der autorisierte Nutzer für eine Liste bestimmter Videos abgegeben hat. Hier kannst du die Funktion ausprobieren.
- list
- Gibt eine Liste der Videos zurück, die den API-Anfrageparametern entsprechen. Hier kannst du die Funktion ausprobieren.
- einfügen
- Lädt ein Video auf YouTube hoch und legt optional die Metadaten des Videos fest.
- aktualisieren
- Aktualisiert die Metadaten eines Videos. Hier kannst du die Funktion ausprobieren.
- delete
- Hiermit wird ein YouTube-Video gelöscht. Hier kannst du die Funktion ausprobieren.
- Steuersatz
- Ein Video mit „Mag ich“ oder „Mag ich nicht“ bewerten oder eine Bewertung entfernen Hier kannst du die Funktion ausprobieren.
- Missbrauch melden
- Ein Video mit missbräuchlichen Inhalten melden Hier kannst du die Funktion ausprobieren.
Ressourcendarstellung
Die folgende JSON-Struktur zeigt das Format einer videos
-Ressource:
{ "kind": "youtube#video", "etag": etag, "id": string, "snippet": { "publishedAt": datetime, "channelId": string, "title": string, "description": string, "thumbnails": { (key): { "url": string, "width": unsigned integer, "height": unsigned integer } }, "channelTitle": string, "tags": [ string ], "categoryId": string, "liveBroadcastContent": string, "defaultLanguage": string, "localized": { "title": string, "description": string }, "defaultAudioLanguage": string }, "contentDetails": { "duration": string, "dimension": string, "definition": string, "caption": string, "licensedContent": boolean, "regionRestriction": { "allowed": [ string ], "blocked": [ string ] }, "contentRating": { "acbRating": string, "agcomRating": string, "anatelRating": string, "bbfcRating": string, "bfvcRating": string, "bmukkRating": string, "catvRating": string, "catvfrRating": string, "cbfcRating": string, "cccRating": string, "cceRating": string, "chfilmRating": string, "chvrsRating": string, "cicfRating": string, "cnaRating": string, "cncRating": string, "csaRating": string, "cscfRating": string, "czfilmRating": string, "djctqRating": string, "djctqRatingReasons": [, string ], "ecbmctRating": string, "eefilmRating": string, "egfilmRating": string, "eirinRating": string, "fcbmRating": string, "fcoRating": string, "fmocRating": string, "fpbRating": string, "fpbRatingReasons": [, string ], "fskRating": string, "grfilmRating": string, "icaaRating": string, "ifcoRating": string, "ilfilmRating": string, "incaaRating": string, "kfcbRating": string, "kijkwijzerRating": string, "kmrbRating": string, "lsfRating": string, "mccaaRating": string, "mccypRating": string, "mcstRating": string, "mdaRating": string, "medietilsynetRating": string, "mekuRating": string, "mibacRating": string, "mocRating": string, "moctwRating": string, "mpaaRating": string, "mpaatRating": string, "mtrcbRating": string, "nbcRating": string, "nbcplRating": string, "nfrcRating": string, "nfvcbRating": string, "nkclvRating": string, "oflcRating": string, "pefilmRating": string, "rcnofRating": string, "resorteviolenciaRating": string, "rtcRating": string, "rteRating": string, "russiaRating": string, "skfilmRating": string, "smaisRating": string, "smsaRating": string, "tvpgRating": string, "ytRating": string }, "projection": string, "hasCustomThumbnail": boolean }, "status": { "uploadStatus": string, "failureReason": string, "rejectionReason": string, "privacyStatus": string, "publishAt": datetime, "license": string, "embeddable": boolean, "publicStatsViewable": boolean, "madeForKids": boolean, "selfDeclaredMadeForKids": boolean }, "statistics": { "viewCount": string, "likeCount": string, "dislikeCount": string, "favoriteCount": string, "commentCount": string }, "player": { "embedHtml": string, "embedHeight": long, "embedWidth": long }, "topicDetails": { "topicIds": [ string ], "relevantTopicIds": [ string ], "topicCategories": [ string ] }, "recordingDetails": { "recordingDate": datetime }, "fileDetails": { "fileName": string, "fileSize": unsigned long, "fileType": string, "container": string, "videoStreams": [ { "widthPixels": unsigned integer, "heightPixels": unsigned integer, "frameRateFps": double, "aspectRatio": double, "codec": string, "bitrateBps": unsigned long, "rotation": string, "vendor": string } ], "audioStreams": [ { "channelCount": unsigned integer, "codec": string, "bitrateBps": unsigned long, "vendor": string } ], "durationMs": unsigned long, "bitrateBps": unsigned long, "creationTime": string }, "processingDetails": { "processingStatus": string, "processingProgress": { "partsTotal": unsigned long, "partsProcessed": unsigned long, "timeLeftMs": unsigned long }, "processingFailureReason": string, "fileDetailsAvailability": string, "processingIssuesAvailability": string, "tagSuggestionsAvailability": string, "editorSuggestionsAvailability": string, "thumbnailsAvailability": string }, "suggestions": { "processingErrors": [ string ], "processingWarnings": [ string ], "processingHints": [ string ], "tagSuggestions": [ { "tag": string, "categoryRestricts": [ string ] } ], "editorSuggestions": [ string ] }, "liveStreamingDetails": { "actualStartTime": datetime, "actualEndTime": datetime, "scheduledStartTime": datetime, "scheduledEndTime": datetime, "concurrentViewers": unsigned long, "activeLiveChatId": string }, "localizations": { (key): { "title": string, "description": string } } }
Attribute
In der folgenden Tabelle werden die Attribute definiert, die in dieser Ressource angezeigt werden:
Attribute | |
---|---|
kind |
string Identifiziert den Typ der API-Ressource. Der Wert ist youtube#video . |
etag |
etag Das ETag dieser Ressource. |
id |
string Die ID, mit der YouTube das Video eindeutig identifiziert. |
snippet |
object Das snippet -Objekt enthält grundlegende Details zum Video, z. B. Titel, Beschreibung und Kategorie. |
snippet.publishedAt |
datetime Datum und Uhrzeit der Veröffentlichung des Videos. Hinweis: Dieser Zeitpunkt kann von dem Zeitpunkt abweichen, zu dem das Video hochgeladen wurde. Wenn ein Video beispielsweise als privates Video hochgeladen und später veröffentlicht wird, gibt diese Property den Zeitpunkt der Veröffentlichung an. Es gibt einige Sonderfälle:
|
snippet.channelId |
string Die ID, mit der YouTube den Kanal eindeutig identifiziert, auf den das Video hochgeladen wurde. |
snippet.title |
string Der Titel des Videos. Der Attributwert hat eine maximale Länge von 100 Zeichen und kann alle gültigen UTF-8-Zeichen außer < und > enthalten. Sie müssen einen Wert für dieses Attribut festlegen, wenn Sie die Methode videos.update aufrufen und den snippet -Teil einer video -Ressource aktualisieren. |
snippet.description |
string Die Beschreibung des Videos. Der Attributwert hat eine maximale Länge von 5.000 Byte und kann alle gültigen UTF-8-Zeichen außer < und > enthalten. |
snippet.thumbnails |
object Eine Karte mit den mit dem Video verknüpften Thumbnail-Bildern. Für jedes Objekt auf der Karte ist der Schlüssel der Name der Miniaturansicht. Der Wert ist ein Objekt, das weitere Informationen zur Miniaturansicht enthält. |
snippet.thumbnails.(key) |
object Gültige Schlüssel/Wert-Paare sind:
|
snippet.thumbnails.(key).url |
string Die URL des Bilds. |
snippet.thumbnails.(key).width |
unsigned integer Die Breite des Bildes. |
snippet.thumbnails.(key).height |
unsigned integer Die Höhe des Bildes. |
snippet.channelTitle |
string Kanaltitel des Kanals, zu dem das Video gehört. |
snippet.tags[] |
list Eine Liste der mit dem Video verknüpften Keyword-Tags. Tags können Leerzeichen enthalten. Der Attributwert darf maximal 500 Zeichen lang sein. Beachten Sie folgende Regeln zur Berechnung der Zeichenbeschränkung:
|
snippet.categoryId |
string Die YouTube-Videokategorie, die dem Video zugeordnet ist. Du musst einen Wert für dieses Attribut festlegen, wenn du die Methode videos.update aufrufst und den snippet -Teil einer video -Ressource aktualisierst. |
snippet.liveBroadcastContent |
string Gibt an, ob das Video eine anstehende/aktive Liveübertragung ist. Wenn das Video keine anstehende/aktive Liveübertragung ist, lautet der Wert „none“. Gültige Werte für diese Property sind:
|
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.
localizations kannst du lokalisierte Titel hinzufügen, aktualisieren oder löschen. |
snippet.localized.title |
string Der lokalisierte Videotitel. |
snippet.localized.description |
string Die lokalisierte Videobeschreibung. |
snippet.defaultAudioLanguage |
string Die Eigenschaft default_audio_language gibt die Sprache des Standard-Audiotracks des Videos an. |
contentDetails |
object Das contentDetails -Objekt enthält Informationen zum Videoinhalt, einschließlich der Länge des Videos und einen Hinweis darauf, ob für das Video Untertitel verfügbar sind. |
contentDetails.duration |
string Die Länge des Videos. Der Wert des Attributs ist eine Dauer gemäß ISO 8601. Beispiel: Für ein Video, das mindestens eine Minute und weniger als eine Stunde lang ist, hat die Dauer das Format PT#M#S , wobei die Buchstaben PT angeben, dass der Wert einen Zeitraum angibt, und die Buchstaben M und S sich auf die Länge in Minuten bzw. Sekunden beziehen. Die # -Zeichen vor den Buchstaben M und S sind beides Ganzzahlen, die die Anzahl der Minuten (oder Sekunden) des Videos angeben. Der Wert PT15M33S gibt beispielsweise an, dass das Video 15 Minuten und 33 Sekunden lang ist.Wenn das Video mindestens eine Stunde lang ist, wird die Dauer im Format PT#H#M#S angegeben. Dabei gibt das # vor dem Buchstaben H die Länge des Videos in Stunden an und alle anderen Details sind wie oben beschrieben. Wenn das Video mindestens einen Tag lang ist, werden die Buchstaben P und T voneinander getrennt und das Format des Werts ist P#DT#H#M#S . Ausführliche Informationen finden Sie in der ISO 8601-Spezifikation. |
contentDetails.dimension |
string Gibt an, ob das Video in 3D oder 2D verfügbar ist. |
contentDetails.definition |
string Gibt an, ob das Video in HD ( HD ) oder nur in Standardauflösung verfügbar ist.Gültige Werte für diese Property sind:
|
contentDetails.caption |
string Gibt an, ob für das Video Untertitel verfügbar sind. Gültige Werte für diese Property sind:
|
contentDetails.licensedContent |
boolean Gibt an, ob das Video lizenzierte Inhalte darstellt. Das bedeutet, dass der Inhalt auf einen Kanal hochgeladen wurde, der mit einem YouTube-Contentpartner verknüpft ist, und dann von diesem Partner Anspruch erhoben hat. |
contentDetails.regionRestriction |
object Das regionRestriction -Objekt enthält Informationen zu den Ländern, in denen ein Video angesehen werden kann oder nicht. Das Objekt enthält entweder das Attribut contentDetails.regionRestriction.allowed oder das Attribut contentDetails.regionRestriction.blocked . |
contentDetails.regionRestriction.allowed[] |
list Eine Liste mit Regionscodes, die die Länder angeben, in denen das Video angesehen werden kann. Wenn diese Property vorhanden ist und im Wert kein Land aufgeführt ist, wird das Video in diesem Land nicht angezeigt. Wenn diese Property vorhanden ist und eine leere Liste enthält, wird das Video in allen Ländern gesperrt. |
contentDetails.regionRestriction.blocked[] |
list Eine Liste mit Regionscodes, die die Länder angeben, in denen das Video gesperrt ist. Wenn diese Eigenschaft vorhanden ist und im Wert kein Land aufgeführt ist, kann das Video in diesem Land angesehen werden. Wenn diese Property vorhanden ist und eine leere Liste enthält, kann das Video in allen Ländern wiedergegeben werden. |
contentDetails.contentRating |
object Gibt die Altersfreigaben an, die das Video nach verschiedenen Bewertungsschemata erhalten hat. |
contentDetails.contentRating.acbRating |
string Einstufung des Videos durch das Australian Classification Board (ACB) oder die Australian Communications and Media Authority (ACMA). ACMA-Altersfreigaben werden verwendet, um Fernsehsendungen für Kinder zu klassifizieren. Gültige Werte für diese Eigenschaft sind:
|
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:
|
contentDetails.contentRating.anatelRating |
string Die Anatel (Asociación Nacional de Televisión)-Bewertung des Videos für das chilenische Fernsehen. Gültige Werte für diese Unterkunft sind:
|
contentDetails.contentRating.bbfcRating |
string Die Bewertung des Videos wurde von der British Board of Film Classification (BBFC) bewertet. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.bfvcRating |
string Die Bewertung des Videos durch das thailändische Board of Film and Video Censors. Gültige Werte für diese Unterkunft sind:
|
contentDetails.contentRating.bmukkRating |
string Die Bewertung des Videos vom österreichischen Bundesministerium für Unterricht, Kunst und Kultur. Gültige Werte für diese Unterkunft:
|
contentDetails.contentRating.catvRating |
string Altersfreigabesystem für das kanadische Fernsehen – kanadisches TV-Klassifizierungssystem (Canadian TV Classification System) Weitere Informationen finden Sie auf der Website des Canadian Broadcast Standards Council. Gültige Werte für diese Property:
|
contentDetails.contentRating.catvfrRating |
string Die Altersfreigabe des Videos durch die kanadische Radio-Television and Telecommunications Commission (CRTC) für kanadisch-französische Sendungen. Weitere Informationen finden Sie auf der Website des Canadian Broadcast Standards Council. Gültige Werte für diese Property:
|
contentDetails.contentRating.cbfcRating |
string Bewertung des Central Board of Film Certification (CBFC – Indien) des Videos. Gültige Werte für diese Unterkunft sind:
|
contentDetails.contentRating.cccRating |
string Die Bewertung des Videos zur Consejo de Calificación Cinematográfica (Chile). Gültige Werte für diese Unterkunft:
|
contentDetails.contentRating.cceRating |
string Die Bewertung des Videos von der portugiesischen Comissão de Classificação de Espect ́culos. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.chfilmRating |
string Die Bewertung des Videos in der Schweiz. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.chvrsRating |
string Bewertung des Videos gemäß der CHVRS-Bewertung (Canadian Home Video Rating System). Gültige Werte für diese Property sind:
|
contentDetails.contentRating.cicfRating |
string Die Bewertung des Videos von der Commission de Contrôle des Films (Belgien). Gültige Werte für diese Unterkunft sind:
|
contentDetails.contentRating.cnaRating |
string Die Bewertung des Videos aus der rumänischen CONSILIUL NATIONAL AL AUDIOVIZUALULUI (CNA). Gültige Werte für diese Property sind:
|
contentDetails.contentRating.cncRating |
string Bewertungssystem in Frankreich – Kinematografie der Kommission zur Deklassifizierung Gültige Werte für diese Unterkunft sind:
|
contentDetails.contentRating.csaRating |
string Die Bewertung des Videos der französischen Conseil de l?audiovisuel, in der Übertragungsinhalte bewertet werden. Gültige Werte für diese Unterkunft sind:
|
contentDetails.contentRating.cscfRating |
string Die Bewertung des Videos durch die Luxemburger Commission de surveillance de la classification des films (CSCF). Gültige Werte für diese Unterkunft:
|
contentDetails.contentRating.czfilmRating |
string Die Bewertung des Videos in der Tschechischen Republik. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.djctqRating |
string Die Bewertung im Departamento de Justiça, Classificação, Qualificação e Títulos (DJCQT – Brasilien) des Videos. Gültige Werte für diese Unterkunft sind:
|
contentDetails.contentRating.djctqRatingReasons[] |
list Gründe, warum das Video die Bewertung als DJCQT (Brasilien) erhalten hat |
contentDetails.contentRating.ecbmctRating |
string Bewertungssystem in der Türkei – Evaluation and Classification Board des Ministeriums für Kultur und Tourismus Gültige Werte für diese Unterkunft:
|
contentDetails.contentRating.eefilmRating |
string Die Bewertung des Videos in Estland. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.egfilmRating |
string Die Bewertung des Videos in Ägypten. Gültige Werte für diese Unterkunft sind:
|
contentDetails.contentRating.eirinRating |
string Die Bewertung von Eirin (映倫) für das Video. Eirin ist das japanische Bewertungssystem. Gültige Werte für diese Unterkunft sind:
|
contentDetails.contentRating.fcbmRating |
string Die Bewertung des Videos vom malaysischen Film Censorship Board. Gültige Werte für diese Unterkunft sind:
|
contentDetails.contentRating.fcoRating |
string Die Bewertung des Videos vom Hongkonger Office for Film, Newspaper and Article Administration. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.fmocRating |
string Diese Property wurde am 2. November 2015 eingestellt. Verwende stattdessen die Property contentDetails.contentRating.cncRating .Die Bewertung „Centre national du cinéma et de l'image animé“ (französisches Kulturministerium) des Videos. Gültige Werte für diese Unterkunft sind:
|
contentDetails.contentRating.fpbRating |
string Die Bewertung des Videos durch die südafrikanische Film- und Publikationsbehörde. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.fpbRatingReasons[] |
list Gründe, warum das Video die FPB-Altersfreigabe erhalten hat (Südafrika) |
contentDetails.contentRating.fskRating |
string Die Bewertung der Freiwilligen Selbstkontrolle der Filmwirtschaft (FSK – Deutschland) für das Video. Gültige Werte für diese Unterkunft sind:
|
contentDetails.contentRating.grfilmRating |
string Die Bewertung des Videos in Griechenland. Gültige Werte für diese Unterkunft sind:
|
contentDetails.contentRating.icaaRating |
string Bewertung vom Instituto de la Cinematografía y de las Artes Audiovisuales (ICAA – Spanien) des Videos. Gültige Werte für diese Unterkunft:
|
contentDetails.contentRating.ifcoRating |
string Bewertung des Videos durch die Irish Film Classification Office (IFCO – Ireland) Weitere Informationen finden Sie auf der Website von IFCO. Gültige Werte für diese Unterkunft sind:
|
contentDetails.contentRating.ilfilmRating |
string Die Bewertung des Videos in Israel. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.incaaRating |
string Die INAA-Bewertung des Videos (Instituto Nacional de Cine y Artes Audiovisuales – Argentinien) für das Video. Gültige Werte für diese Unterkunft sind:
|
contentDetails.contentRating.kfcbRating |
string Die Bewertung des Videos vom Kenya Film Classification Board. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.kijkwijzerRating |
string voor de Classificatie van Audiovisuele Media (Niederlande). Gültige Werte für diese Unterkunft sind:
|
contentDetails.contentRating.kmrbRating |
string Die Bewertung des Videos vom Korea Media Rating Board (영상물등전위원회) Der KMRB bewertet Videos in Südkorea. Gültige Werte für diese Unterkunft sind:
|
contentDetails.contentRating.lsfRating |
string Die Bewertung des Videos vom indonesischen Lembaga Sensor Film. Gültige Werte für diese Unterkunft sind:
|
contentDetails.contentRating.mccaaRating |
string Die Bewertung des Videos vom Malta Film Age-Classification Board. Gültige Werte für diese Unterkunft sind:
|
contentDetails.contentRating.mccypRating |
string Die Bewertung des Videos durch den Media Council for Children and Young People des Dänischen Filminstituts (Det Danske Filminstitut) Gültige Werte für diese Unterkunft:
|
contentDetails.contentRating.mcstRating |
string Das Bewertungssystem des Videos für Vietnam – MCST Gültige Werte für diese Property:
|
contentDetails.contentRating.mdaRating |
string Die Bewertung des Videos durch die Media Development Authority (MDA) in Singapur und insbesondere das Board of Film Censors (BFC). Gültige Werte für diese Unterkunft sind:
|
contentDetails.contentRating.medietilsynetRating |
string Die Bewertung des Videos von Medietilsynet, der norwegischen Medienbehörde. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.mekuRating |
string Die Bewertung des Videos vom finnischen Kansallinen Audiovisuaalinen Instituutti (Nationales Audiovisuelles Institut). Gültige Werte für diese Unterkunft:
|
contentDetails.contentRating.mibacRating |
string Die Bewertung des Videos vom Ministero dei Beni e delle Attività Culturali e del Turismo (Italien). Gültige Werte für diese Unterkunft sind:
|
contentDetails.contentRating.mocRating |
string Bewertung des Videos vom Ministerio de Cultura (Kolumbien). Gültige Werte für diese Unterkunft sind:
|
contentDetails.contentRating.moctwRating |
string Die Bewertung des Videos durch das taiwanesische Kulturministerium (文化部). Gültige Werte für diese Unterkunft sind:
|
contentDetails.contentRating.mpaaRating |
string Die Bewertung des Videos von der Motion Picture Association of America (MPAA). Gültige Werte für diese Property sind:
|
contentDetails.contentRating.mpaatRating |
string Die Bewertung der Motion Picture Association of America für Filmtrailer und Vorschau. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.mtrcbRating |
string Die Bewertung des Videos vom Movie and Television Review and Classification Board (Philippinen) Gültige Werte für diese Property sind:
|
contentDetails.contentRating.nbcRating |
string Die Bewertung des Videos vom Maldives National Bureau of Classification. Gültige Werte für diese Unterkunft sind:
|
contentDetails.contentRating.nfrcRating |
string Die Bewertung des Videos vom Bulgarischen Nationalen Filmzentrum. Gültige Werte für diese Unterkunft sind:
|
contentDetails.contentRating.nfvcbRating |
string Die Bewertung des Videos vom National Film and Video Censors Board in Nigeria. Gültige Werte für diese Unterkunft sind:
|
contentDetails.contentRating.nkclvRating |
string Die Bewertung des Videos vom Nacionãlais Kino centrs (Nationales Filmzentrum von Lettland). Gültige Werte für diese Unterkunft sind:
|
contentDetails.contentRating.oflcRating |
string Bewertung des Office of Film and Literature Classification (OFLC – Neuseeland) des Videos. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.pefilmRating |
string Die Bewertung des Videos in Peru. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.resorteviolenciaRating |
string Die Bewertung des Videos in Venezuela. Gültige Werte für diese Unterkunft sind:
|
contentDetails.contentRating.rtcRating |
string Bewertung der Generaldirektion für Radio, Fernsehen und Kino (Mexiko) des Videos. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.rteRating |
string Die Bewertung des Videos von der irischen Raidió Teilifís Éireann. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.russiaRating |
string Bewertung des Videos vom National Film Registry of the Russian Federation (MKRF – Russland). Gültige Werte für diese Property sind:
|
contentDetails.contentRating.skfilmRating |
string Die Bewertung des Videos in der Slowakei. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.smaisRating |
string Die Bewertung des Videos in Island. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.smsaRating |
string Die Bewertung des Videos durch Statens medieråd (National Media Council in Schweden). Gültige Werte für diese Property sind:
|
contentDetails.contentRating.tvpgRating |
string Die Altersfreigabe „TV Parental Guidelines“ (TVPG) des Videos. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.ytRating |
string Eine Bewertung, die YouTube zur Identifizierung von Inhalten mit Altersbeschränkung verwendet. Gültige Werte für diese Property sind:
|
contentDetails.projection |
string Gibt das Projektionsformat des Videos an. Gültige Werte für dieses Attribut sind:
|
contentDetails.hasCustomThumbnail |
boolean Gibt an, ob der Uploader ein benutzerdefiniertes Thumbnail für das Video bereitgestellt hat. Diese Eigenschaft ist nur für den Video-Uploader sichtbar. |
status |
object Das status -Objekt enthält Informationen zum Upload- und Verarbeitungsstatus sowie zum Datenschutzstatus des Videos. |
status.uploadStatus |
string Der Status des hochgeladenen Videos. Gültige Werte für diese Property sind:
|
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:
|
status.rejectionReason |
string Dieser Wert gibt an, warum YouTube ein hochgeladenes Video abgelehnt hat. Dieses Attribut ist nur vorhanden, wenn das Attribut uploadStatus angibt, dass der Upload abgelehnt wurde.Gültige Werte für diese Property sind:
|
status.privacyStatus |
string Der Datenschutzstatus des Videos. Gültige Werte für diese Property sind:
|
status.publishAt |
datetime Datum und Uhrzeit der geplanten Veröffentlichung des Videos. Sie kann nur festgelegt werden, wenn der Datenschutzstatus des Videos „Privat“ ist. Der Wert wird im ISO 8601-Format angegeben. Beachten Sie die folgenden zwei zusätzlichen Punkte zum Verhalten dieser Eigenschaft:
|
status.license |
string Die Lizenz für das Video. Gültige Werte für diese Property sind:
|
status.embeddable |
boolean Dieser Wert gibt an, ob das Video auf einer anderen Website eingebettet werden kann. |
status.publicStatsViewable |
boolean Dieser Wert gibt an, ob die erweiterten Videostatistiken auf der Wiedergabeseite des Videos öffentlich sichtbar sind. Diese Statistiken sind standardmäßig sichtbar. Statistiken wie die Anzahl der Aufrufe und Bewertungen eines Videos sind auch dann öffentlich sichtbar, wenn der Wert dieser Eigenschaft auf false gesetzt ist. |
status.madeForKids |
boolean Dieser Wert gibt an, ob das Video als „Für Kinder“ gekennzeichnet ist, und enthält den aktuellen Status „Speziell für Kinder“ des Videos. Der Status kann beispielsweise anhand des Werts des Attributs selfDeclaredMadeForKids ermittelt werden. Weitere Informationen zum Festlegen der Zielgruppe für deinen Kanal, deine Videos oder deine Übertragungen findest du in der YouTube-Hilfe.
|
status.selfDeclaredMadeForKids |
boolean In einer videos.insert - oder videos.update -Anfrage kann der Kanalinhaber das Video mit dieser Property als auf Kinder ausgerichtet kennzeichnen. Bei einer videos.list -Anfrage wird der Attributwert nur zurückgegeben, wenn der Kanalinhaber die API-Anfrage autorisiert hat. |
statistics |
object Das Objekt statistics enthält Statistiken zum Video. |
statistics.viewCount |
unsigned long Gibt an, wie oft das Video aufgerufen wurde. |
statistics.likeCount |
unsigned long Die Anzahl der Nutzer, die angegeben haben, dass ihnen das Video gefallen hat. |
statistics.dislikeCount |
unsigned long Hinweis:Die Property
statistics.dislikeCount wurde am 13. Dezember 2021 als privat gekennzeichnet. Das bedeutet, dass die Property nur dann in einer API-Antwort enthalten ist, wenn die API-Anfrage vom Videoinhaber authentifiziert wurde. Weitere Informationen finden Sie im Überarbeitungsverlauf.Die Anzahl an Nutzern, die angegeben haben, dass ihnen das Video nicht gefallen hat. |
statistics.favoriteCount |
unsigned long Hinweis:Dieses Attribut wurde eingestellt. Die Einstellung tritt am 28. August 2015 in Kraft. Der Wert des Attributs ist jetzt immer auf 0 festgelegt. |
statistics.commentCount |
unsigned long Die Anzahl der Kommentare für das Video. |
player |
object Das player -Objekt enthält Informationen, mit denen du das Video in einem eingebetteten Player abspielen würdest. |
player.embedHtml |
string Ein <iframe> -Tag, das einen Player einbettet, der das Video abspielt.
|
player.embedHeight |
long Die Höhe des eingebetteten Players, die in der Eigenschaft player.embedHtml zurückgegeben wird. Diese Eigenschaft wird nur zurückgegeben, wenn in der Anfrage ein Wert für die Parameter maxHeight und/oder maxWidth angegeben wurde und das Seitenverhältnis des Videos bekannt ist. |
player.embedWidth |
long Die Breite des eingebetteten Players, die in der Eigenschaft player.embedHtml zurückgegeben wird. Diese Eigenschaft wird nur zurückgegeben, wenn in der Anfrage ein Wert für die Parameter maxHeight und/oder maxWidth angegeben wurde und das Seitenverhältnis des Videos bekannt ist. |
topicDetails |
object Das Objekt topicDetails enthält Informationen zu Themen, die mit dem Video verknüpft sind.Wichtig:Weitere Informationen zu anstehenden Änderungen in Bezug auf Themen-IDs finden Sie in den Definitionen der Properties topicDetails.relevantTopicIds[] und topicDetails.topicIds[] sowie im Überarbeitungsverlauf. |
topicDetails.topicIds[] |
list Wichtig:Diese Property wurde am 10. November 2016 eingestellt. Die API gibt keine Werte mehr für diese Property zurück. Alle mit einem Video verknüpften Themen werden jetzt vom Property-Wert topicDetails.relevantTopicIds[] zurückgegeben. |
topicDetails.relevantTopicIds[] |
list Eine Liste mit Themen-IDs, die für das Video relevant sind. Diese Property wurde am 10. November 2016 eingestellt. Sie wird bis zum 10. November 2017 unterstützt. Wichtig: Aufgrund der Einstellung von Freebase und der Freebase API funktionieren Themen-IDs seit dem 27. Februar 2017 anders. Zu dieser Zeit gab YouTube eine kleine Auswahl ausgewählter Themen-IDs zurück. |
topicDetails.topicCategories[] |
list Eine Liste von Wikipedia-URLs, die eine allgemeine Beschreibung des Videoinhalts enthalten. |
recordingDetails |
object Das recordingDetails -Objekt enthält Informationen über den Ort, das Datum und die Adresse, an der das Video aufgezeichnet wurde. |
recordingDetails.locationDescription |
string Diese Property wurde am 1. Juni 2017 eingestellt. Weitere Informationen finden Sie in der Mitteilung zur Einstellung. Die Textbeschreibung des Orts, an dem das Video aufgezeichnet wurde. |
recordingDetails.location |
object Die Informationen zur Standortbestimmung, die mit dem Video verknüpft sind. Die Werte der untergeordneten Property geben den Standort an, den der Videoinhaber mit dem Video verknüpfen möchte. Der Wert kann bearbeitet, bei öffentlichen Videos gesucht und Nutzern bei öffentlichen Videos angezeigt werden. |
recordingDetails.location.latitude |
double Diese Property wurde am 1. Juni 2017 eingestellt. Weitere Informationen finden Sie in der Mitteilung zur Einstellung. Breitengrad in Grad. |
recordingDetails.location.longitude |
double Diese Property wurde am 1. Juni 2017 eingestellt. Weitere Informationen finden Sie in der Mitteilung zur Einstellung. Längengrad in Grad. |
recordingDetails.location.altitude |
double Diese Property wurde am 9. Juli 2018 eingestellt. Weitere Informationen finden Sie in der Mitteilung zur Einstellung. Höhe über dem Referenzellipsoid in Metern. |
recordingDetails.recordingDate |
datetime Datum und Uhrzeit der Videoaufzeichnung. Der Wert wird im Format ISO 8601 ( YYYY-MM-DDThh:mm:ss.sssZ ) angegeben. |
fileDetails |
object Das fileDetails -Objekt enthält Informationen über die Videodatei, die auf YouTube hochgeladen wurde, einschließlich Auflösung, Dauer, Audio- und Video-Codecs, Stream-Bitraten und mehr. Diese Daten können nur vom Rechteinhaber des Videos abgerufen werden.Das fileDetails -Objekt wird nur zurückgegeben, wenn das Attribut processingDetails.fileAvailability den Wert available hat. |
fileDetails.fileName |
string Der Name der hochgeladenen Datei. Dieses Feld ist vorhanden, unabhängig davon, ob eine Videodatei oder ein anderer Dateityp hochgeladen wurde. |
fileDetails.fileSize |
unsigned long Die Größe der hochgeladenen Datei in Byte. Dieses Feld ist vorhanden, unabhängig davon, ob eine Videodatei oder ein anderer Dateityp hochgeladen wurde. |
fileDetails.fileType |
string Der Typ der hochgeladenen Datei, wie er von der Videoverarbeitungs-Engine von YouTube erkannt wurde. Derzeit verarbeitet YouTube nur Videodateien. Dieses Feld ist jedoch vorhanden, unabhängig davon, ob eine Videodatei oder ein anderer Dateityp hochgeladen wurde. Gültige Werte für diese Eigenschaft sind:
|
fileDetails.container |
string Das Containerformat der hochgeladenen Videodatei. |
fileDetails.videoStreams[] |
list Eine Liste der Videostreams, die in der hochgeladenen Videodatei enthalten sind. Jedes Element in der Liste enthält detaillierte Metadaten zu einem Videostream. |
fileDetails.videoStreams[].widthPixels |
unsigned integer Die Breite des codierten Videocontents in Pixeln. Du kannst das Seitenverhältnis für die Codierung des Videos als width_pixels / height_pixels berechnen. |
fileDetails.videoStreams[].heightPixels |
unsigned integer Höhe des codierten Videocontents in Pixeln |
fileDetails.videoStreams[].frameRateFps |
double Die Framerate des Videostreams in Bildern pro Sekunde. |
fileDetails.videoStreams[].aspectRatio |
double Das Seitenverhältnis des Videoinhalts, das angibt, in welchem Seitenverhältnis das Video angezeigt werden soll. |
fileDetails.videoStreams[].codec |
string Der Video-Codec, der für den Stream verwendet wird. |
fileDetails.videoStreams[].bitrateBps |
unsigned long Die Bitrate des Videostreams in Bit pro Sekunde. |
fileDetails.videoStreams[].rotation |
string Der Betrag, um den YouTube den ursprünglichen Quellcontent rotieren muss, damit das Video richtig wiedergegeben wird. Gültige Werte für diese Property sind:
|
fileDetails.videoStreams[].vendor |
string Ein Wert, der einen Videoanbieter eindeutig identifiziert. In der Regel ist der Wert ein aus vier Buchstaben bestehender Anbietercode. |
fileDetails.audioStreams[] |
list Eine Liste der Audiostreams, die in der hochgeladenen Videodatei enthalten sind. Jedes Element in der Liste enthält detaillierte Metadaten zu einem Audiostream. |
fileDetails.audioStreams[].channelCount |
unsigned integer Die Anzahl der Audiokanäle im Stream. |
fileDetails.audioStreams[].codec |
string Der Audio-Codec, der für den Stream verwendet wird. |
fileDetails.audioStreams[].bitrateBps |
unsigned long Die Bitrate des Audiostreams in Bit pro Sekunde. |
fileDetails.audioStreams[].vendor |
string Ein Wert, der einen Videoanbieter eindeutig identifiziert. In der Regel ist der Wert ein aus vier Buchstaben bestehender Anbietercode. |
fileDetails.durationMs |
unsigned long Die Länge des hochgeladenen Videos in Millisekunden. |
fileDetails.bitrateBps |
unsigned long Die kombinierte Bitrate der hochgeladenen Videodatei (Video und Audio) in Bit pro Sekunde. |
fileDetails.creationTime |
string Datum und Uhrzeit der Erstellung der hochgeladenen Videodatei Der Wert wird im ISO 8601-Format angegeben. Derzeit werden die folgenden ISO 8601-Formate unterstützt:
|
processingDetails |
object Das processingDetails -Objekt enthält Informationen über den Fortschritt von YouTube bei der Verarbeitung der hochgeladenen Videodatei. Die Eigenschaften im Objekt geben den aktuellen Verarbeitungsstatus und eine Schätzung der verbleibenden Zeit an, bis YouTube das Video verarbeitet hat. Dieser Teil gibt auch an, ob verschiedene Arten von Daten oder Inhalten wie Dateidetails oder Miniaturansichten für das Video verfügbar sind.Das processingProgress -Objekt ist für den Abruf vorgesehen, damit das hochgeladene Video den Fortschritt von YouTube bei der Verarbeitung der hochgeladenen Videodatei verfolgen kann. Diese Daten können nur vom Rechteinhaber des Videos abgerufen werden. |
processingDetails.processingStatus |
string Der Verarbeitungsstatus des Videos. Dieser Wert gibt an, ob YouTube das Video verarbeiten konnte oder noch verarbeitet wird. Gültige Werte für diese Property sind:
|
processingDetails.processingProgress |
object Das processingProgress -Objekt enthält Informationen zum Fortschritt von YouTube bei der Verarbeitung des Videos. Die Werte sind wirklich nur relevant, wenn der Verarbeitungsstatus des Videos processing ist. |
processingDetails.processingProgress.partsTotal |
unsigned long Eine Schätzung der Gesamtzahl der Teile, die für das Video verarbeitet werden müssen. Während das Video von YouTube verarbeitet wird, können noch genauere Schätzungen erstellt werden. |
processingDetails.processingProgress.partsProcessed |
unsigned long Die Anzahl der Teile des Videos, die von YouTube bereits verarbeitet wurden. Du kannst den Prozentsatz des Videos, den YouTube bereits verarbeitet hat, mithilfe der folgenden Berechnungsmethode schätzen: 100 * parts_processed / parts_total Da die geschätzte Anzahl der Teile steigen kann, ohne dass die Anzahl der bereits verarbeiteten Teile steigt, kann der berechnete Fortschritt während der Verarbeitung eines Videos durch YouTube in regelmäßigen Abständen abnehmen. |
processingDetails.processingProgress.timeLeftMs |
unsigned long Eine Schätzung der Zeit in Millisekunden, die YouTube benötigt, um die Verarbeitung des Videos abzuschließen. |
processingDetails.processingFailureReason |
string Der Grund, warum YouTube das Video nicht verarbeitet hat. Dieses Attribut hat nur dann einen Wert, wenn der Wert des Attributs processingStatus failed lautet.Gültige Werte für dieses Attribut sind:
|
processingDetails.fileDetailsAvailability |
string Dieser Wert gibt an, ob für das hochgeladene Video Dateidetails verfügbar sind. Du kannst die Details einer Videodatei abrufen, indem du den fileDetails -Teil in deiner videos.list() -Anfrage anforderst. |
processingDetails.processingIssuesAvailability |
string Dieser Wert gibt an, ob die Videoverarbeitungs-Engine Vorschläge generiert hat, die die Verarbeitung des Videos durch YouTube verbessern könnten, Warnungen, die auf Probleme bei der Videoverarbeitung hinweisen, oder Fehler, die Probleme bei der Videoverarbeitung verursachen. Sie können diese Vorschläge abrufen, indem Sie den suggestions -Teil in Ihrer videos.list() -Anfrage anfordern. |
processingDetails.tagSuggestionsAvailability |
string Dieser Wert gibt an, ob Keyword-Vorschläge (Tag) für das Video verfügbar sind. Den Metadaten eines Videos können Tags hinzugefügt werden, damit andere Nutzer das Video leichter finden können. Sie können diese Vorschläge abrufen, indem Sie den suggestions -Teil in Ihrer videos.list() -Anfrage anfordern. |
processingDetails.editorSuggestionsAvailability |
string Dieser Wert gibt an, ob für das Video Vorschläge zur Videobearbeitung verfügbar sind, mit denen sich die Videoqualität oder die Wiedergabequalität verbessern lassen. Sie können diese Vorschläge abrufen, indem Sie den suggestions -Teil in Ihrer videos.list() -Anfrage anfordern. |
processingDetails.thumbnailsAvailability |
string Dieser Wert gibt an, ob für das Video Thumbnail-Bilder generiert wurden. |
suggestions |
object Das suggestions -Objekt enthält Vorschläge zur Verbesserung der Videoqualität oder der Metadaten für das hochgeladene Video. Diese Daten können nur vom Rechteinhaber des Videos abgerufen werden. Das suggestions -Objekt wird nur zurückgegeben, wenn das Attribut processingDetails.tagSuggestionsAvailability oder processingDetails.editorSuggestionsAvailability den Wert available hat. |
suggestions.processingErrors[] |
list Eine Liste mit Fehlern, die verhindern, dass YouTube das hochgeladene Video erfolgreich verarbeitet. Diese Fehler weisen darauf hin, dass dieser Status unabhängig vom aktuellen Verarbeitungsstatus des Videos mit hoher Wahrscheinlichkeit failed ist.Gültige Werte für diese Eigenschaft sind:
|
suggestions.processingWarnings[] |
list Eine Liste mit Gründen, aus denen YouTube möglicherweise Schwierigkeiten beim Transcodieren des hochgeladenen Videos hat oder zu einer fehlerhaften Transcodierung führen kann. Diese Warnungen werden generiert, bevor YouTube die hochgeladene Videodatei tatsächlich verarbeitet. Außerdem werden Probleme identifiziert, die nicht unbedingt darauf hindeuten, dass die Videoverarbeitung fehlschlägt, die aber dennoch Probleme wie Synchronisierungsprobleme, Videoartefakte oder einen fehlenden Audiotrack verursachen können. Gültige Werte für diese Eigenschaft sind:
|
suggestions.processingHints[] |
list Eine Liste mit Vorschlägen, mit denen die Verarbeitung des Videos durch YouTube verbessert werden kann. Gültige Werte für diese Property sind:
|
suggestions.tagSuggestions[] |
list Eine Liste mit Keyword-Tags, die den Metadaten des Videos hinzugefügt werden können, um die Wahrscheinlichkeit zu erhöhen, dass Nutzer Ihr Video bei der Suche oder beim Stöbern auf YouTube finden. |
suggestions.tagSuggestions[].tag |
string Das für das Video vorgeschlagene Keyword-Tag. |
suggestions.tagSuggestions[].categoryRestricts[] |
list Eine Reihe von Videokategorien, für die das Tag relevant ist. Anhand dieser Informationen kannst du passende Tag-Vorschläge basierend auf der Videokategorie anzeigen, die der Video-Uploader mit dem Video verknüpft. Tag-Vorschläge sind standardmäßig für alle Kategorien relevant, wenn für das Keyword keine Einschränkungen festgelegt wurden. |
suggestions.editorSuggestions[] |
list Eine Liste mit Videobearbeitungsvorgängen, die die Videoqualität oder die Wiedergabequalität des hochgeladenen Videos verbessern können. Gültige Werte für diese Eigenschaft sind:
|
liveStreamingDetails |
object Das Objekt liveStreamingDetails enthält Metadaten zu einer Live-Videoübertragung. Das Objekt ist nur dann in einer video -Ressource vorhanden, wenn es sich um eine anstehende, Live- oder abgeschlossene Liveübertragung handelt. |
liveStreamingDetails.actualStartTime |
datetime Der Zeitpunkt, zu dem die Übertragung tatsächlich begonnen hat. Der Wert wird im ISO 8601-Format angegeben. Dieser Wert ist erst verfügbar, wenn die Übertragung beginnt. |
liveStreamingDetails.actualEndTime |
datetime Der Zeitpunkt, zu dem die Übertragung tatsächlich beendet wurde. Der Wert wird im ISO 8601-Format angegeben. Dieser Wert ist erst nach Ende der Übertragung verfügbar. |
liveStreamingDetails.scheduledStartTime |
datetime Die Uhrzeit, zu der die Übertragung planmäßig beginnen soll. Der Wert wird im ISO 8601-Format angegeben. |
liveStreamingDetails.scheduledEndTime |
datetime Der Zeitpunkt, zu dem die Übertragung laut Plan endet. Der Wert wird im ISO 8601-Format angegeben. Wenn der Wert leer oder das Attribut nicht vorhanden ist, wird die Übertragung so geplant, dass sie auf unbestimmte Zeit fortgesetzt wird. |
liveStreamingDetails.concurrentViewers |
unsigned long Die Anzahl an Zuschauern, die sich die Übertragung gerade ansehen. Die Eigenschaft und ihr Wert sind vorhanden, wenn die Übertragung aktuelle Zuschauer hat und der Eigentümer der Übertragung die Anzahl der Aufrufe für das Video nicht ausgeblendet hat. Hinweis: Wenn die Übertragung endet, erfasst YouTube die Anzahl an gleichzeitigen Zuschauern nicht mehr. Diese Property würde also nicht die Anzahl der Zuschauer ermitteln, die sich ein archiviertes Video einer bereits beendeten Liveübertragung ansehen. Die Anzahl der gleichzeitigen Zuschauer, die die YouTube Data API zurückgibt, kann von der Anzahl der verarbeiteten, bereinigten und gleichzeitigen Zuschauer abweichen, die über YouTube Analytics verfügbar sind. Weitere Informationen zu Messwerten für Livestreams findest du in der YouTube-Hilfe.
|
liveStreamingDetails.activeLiveChatId |
string Die ID des aktuell aktiven Livechats, der an dieses Video angehängt ist. Dieses Feld wird nur ausgefüllt, wenn es sich bei dem Video um eine aktuelle Liveübertragung mit Livechat handelt. Sobald die Übertragung abgeschlossen ist, wird dieses Feld entfernt und der Livechat wird geschlossen. Bei dauerhaften Übertragungen ist die Livechat-ID nicht mehr mit diesem Video verknüpft. Stattdessen wird das neue Video auf der persistenten Seite angezeigt. |
localizations |
object Das Objekt localizations enthält Übersetzungen der Metadaten des Videos. |
localizations.(key) |
object Die Sprache des lokalisierten Textes, der dem Schlüssel/Wert-Paar zugeordnet ist. Der Wert ist ein String mit einem BCP-47-Sprachcode. |
localizations.(key).title |
string Der lokalisierte Videotitel. |
localizations.(key).description |
string Die lokalisierte Videobeschreibung. |