Alle Videos, die über den Endpunkt
videos.insert
von nicht bestätigten API-Projekten hochgeladen werden, die nach dem 28. Juli 2020 erstellt wurden, werden auf den privaten Anzeigemodus eingeschränkt. Damit diese Einschränkung aufgehoben wird, muss jedes API-Projekt einer Prüfung unterzogen werden, um die Einhaltung der Nutzungsbedingungen zu bestätigen. 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 einer Liste bestimmter Videos gegeben 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.
- 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
- YouTube-Videos werden gelöscht. Hier kannst du die Funktion ausprobieren.
- Preis
- Füge einem Video eine „Mag ich“- oder „Mag ich nicht“-Bewertung hinzu oder entferne eine Bewertung. Hier kannst du die Funktion ausprobieren.
- berichtAbuse
- Videos wegen missbräuchlicher Inhalte 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 wie Titel, Beschreibung und Kategorie. |
snippet.publishedAt |
datetime Datum und Uhrzeit der Veröffentlichung des Videos. Der Zeitpunkt des Uploads kann von dem Zeitpunkt abweichen, zu dem das Video hochgeladen wurde. Wenn ein Video beispielsweise als privates Video hochgeladen und dann zu einem späteren Zeitpunkt veröffentlicht wird, gibt diese Property den Zeitpunkt der Veröffentlichung des Videos an. Es gibt einige Sonderfälle:
|
snippet.channelId |
string Die ID, mit der YouTube den Kanal eindeutig identifiziert, in den das Video hochgeladen wurde. |
snippet.title |
string Der Titel des Videos. Der Attributwert darf maximal 100 Zeichen lang sein und alle gültigen UTF-8-Zeichen außer < und > enthalten. 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.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 Miniaturansichten, die mit dem Video verknüpft sind Für jedes Objekt auf der Karte ist der Schlüssel der Name der Miniaturansicht und der Wert 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 Bild-URL. |
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:
|
snippet.categoryId |
string Die mit dem Video verknüpfte YouTube-Videokategorie Sie müssen einen Wert für diese Property festlegen, wenn Sie die Methode videos.update aufrufen und den snippet -Teil einer video -Ressource aktualisieren. |
snippet.liveBroadcastContent |
string Gibt an, ob das Video eine anstehende/aktive Liveübertragung ist Oder es ist „none“, wenn das Video keine anstehende/aktive Liveübertragung ist. Für diese Property sind folgende Werte gültig:
|
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 an, die im Standard-Audiotrack des Videos gesprochen wird. |
contentDetails |
object Das Objekt contentDetails enthält Informationen zum Videocontent, z. B. die Länge des Videos und Angaben darüber, ob für das Video Untertitel verfügbar sind. |
contentDetails.duration |
string Die Länge des Videos. Der Attributwert ist die Dauer von ISO 8601. Bei einem Video, das mindestens eine Minute lang und weniger als eine Stunde lang ist, hat die Dauer beispielsweise das Format PT#M#S . Die Buchstaben PT geben an, dass der Wert einen Zeitraum angibt, und die Buchstaben M und S beziehen sich auf die Länge in Minuten bzw. Sekunden. Die # -Zeichen vor den Buchstaben M und S sind ganze Zahlen, 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, hat die Dauer das Format PT#H#M#S , wobei der # vor dem Buchstaben H die Länge des Videos in Stunden angibt und alle anderen Details mit den oben beschriebenen übereinstimmen. Wenn das Video mindestens einen Tag lang ist, werden die Buchstaben P und T getrennt und das Format des Werts lautet P#DT#H#M#S . Ausführliche Informationen finden Sie in der Spezifikation ISO 8601. |
contentDetails.dimension |
string Gibt an, ob das Video in 3D oder in 2D verfügbar ist. |
contentDetails.definition |
string Gibt an, ob das Video in High Definition ( HD ) oder nur in Standard Definition 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. Für diese Property sind folgende Werte gültig:
|
contentDetails.licensedContent |
boolean Gibt an, ob das Video lizenzierte Inhalte darstellt. Das bedeutet, dass die Inhalte auf einen Kanal hochgeladen wurden, der mit einem YouTube-Content-Partner verknüpft ist, auf den dann Anspruch erhoben wurde. |
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 die Eigenschaft contentDetails.regionRestriction.allowed oder die Eigenschaft contentDetails.regionRestriction.blocked . |
contentDetails.regionRestriction.allowed[] |
list Eine Liste von Regionscodes, die Länder angeben, in denen das Video angesehen werden kann Wenn diese Property vorhanden und in ihrem Wert kein Land angegeben ist, wird das Video in diesem Land blockiert. Wenn diese Property vorhanden und eine leere Liste enthält, wird das Video in allen Ländern gesperrt. |
contentDetails.regionRestriction.blocked[] |
list Eine Liste von Regionscodes, die Länder identifizieren, in denen das Video gesperrt ist Wenn diese Property vorhanden ist und ein Land nicht in ihrem Wert aufgeführt ist, kann das Video in diesem Land angesehen werden. Wenn diese Property vorhanden und eine leere Liste enthält, kann das Video in allen Ländern angesehen werden. |
contentDetails.contentRating |
object Gibt die Altersfreigaben an, die das Video im Rahmen verschiedener Altersfreigaben erhalten hat. |
contentDetails.contentRating.acbRating |
string Die Bewertung des Videos durch das Australian Classification Board (ACB) oder die Australian Communications and Media Authority (ACMA) ACMA-Bewertungen werden verwendet, um Fernsehprogramme für Kinder zu klassifizieren. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.agcomRating |
string Die Altersfreigabe des Videos der Autorità per le Garanzie nelle Comunicazioni (AGCOM) in Italien. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.anatelRating |
string Die Altersfreigabe „Anatel (Asociación Nacional de Televisión)“ für das chilenische Fernsehen. Für diese Property sind folgende Werte gültig:
|
contentDetails.contentRating.bbfcRating |
string Bewertung der British Board of Film Classification (BBFC) für das Video. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.bfvcRating |
string Die Bewertung des Videos vom Board of Film and Video Censors in Thailand. Für diese Property sind folgende Werte gültig:
|
contentDetails.contentRating.bmukkRating |
string Die Bewertung des Videos vom österreichischen Board of Media Classification (Bundesministerium für Unterricht, Kunst und Kultur). Gültige Werte für diese Property:
|
contentDetails.contentRating.catvRating |
string Bewertungssystem für Canadian TV – Canadian TV Classification System Die Einstufung des Videos von der Canadian Radio-Television and Telecommunications Commission (CRTC) für englischsprachige Sendungen Weitere Informationen findest du auf der Canadian Broadcast Standards Council-Website. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.catvfrRating |
string Die Bewertung des Videos von der Canadian Radio-Television and Telecommunications Commission (CRTC) für Nachrichten in französischer Sprache Weitere Informationen findest du auf der Canadian Broadcast Standards Council-Website. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.cbfcRating |
string Altersfreigabe des Central Board of Film Certification (CBFC – Indien) Gültige Werte für diese Property:
|
contentDetails.contentRating.cccRating |
string Die Altersfreigabe für das Consejo de Calificación Cinematográfica (Chile) des Videos. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.cceRating |
string Die Bewertung des Videos von Portugals Comissão de Classificação de Espect `culos. Gültige Werte für diese Property:
|
contentDetails.contentRating.chfilmRating |
string Die Altersfreigabe des Videos in der Schweiz. Für diese Property sind folgende Werte gültig:
|
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:
|
contentDetails.contentRating.cicfRating |
string Die Bewertung des Videos durch die Commission de Contrôle des Films (Belgien) Gültige Werte für diese Property:
|
contentDetails.contentRating.cnaRating |
string Die Bewertung des Videos aus Rumänien CONSILIUL NATIONAL AL AUDIOVIZUALULUI (CNA). Gültige Werte für diese Eigenschaft:
|
contentDetails.contentRating.cncRating |
string Altersfreigabesystem in Frankreich – Commission de klassifizieren Cinematographique Gültige Werte für diese Property:
|
contentDetails.contentRating.csaRating |
string Die Bewertung des Videos vom französischen Conseil-Supermarkt de l?audio csa10 –10csa12 –12csa16 –16csa18 –18csaInterdiction – InterdictioncsaT –TcsaUnrated |
contentDetails.contentRating.cscfRating |
string Die Bewertung des Videos durch die Luxemburgs Commission de surveillance de la klassifizieren des films (CSCF) gültige Werte für diese Unterkunft:
|
contentDetails.contentRating.czfilmRating |
string Die Altersfreigabe des Videos in Tschechien. Für diese Property sind folgende Werte gültig:
|
contentDetails.contentRating.djctqRating |
string Bewertung des Hotels: Departamento de Justiça, Classificação, Qualificação e Títulos (DJCQT, Brasilien) Gültige Werte für diese Property:
|
contentDetails.contentRating.djctqRatingReasons[] |
list Gründe dafür, warum das Video die DJCQT-Bewertung (Brasilien) erhalten hat |
contentDetails.contentRating.ecbmctRating |
string Bewertungssystem 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 Altersfreigabe des Videos in Estland. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.egfilmRating |
string Die Altersfreigabe des Videos in Ägypten. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.eirinRating |
string Die Eirin-Bewertung (映倫) des Videos. Eirin ist das japanische Einstufungssystem. Für diese Unterkunft sind die folgenden Werte gültig:
|
contentDetails.contentRating.fcbmRating |
string Die Altersfreigabe des Videos vom Film Censorship Board von Malaysia. Für diese Property sind folgende Werte gültig:
|
contentDetails.contentRating.fcoRating |
string Die Bewertung des Videos durch die Hong Kong's 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. Verwenden Sie stattdessen die Property contentDetails.contentRating.cncRating .Die Altersfreigabe des Centre du du cinéma et de l'image animé (französisches Ministerium für Kultur) im Video. Für diese Property sind folgende Werte gültig:
|
contentDetails.contentRating.fpbRating |
string Die Bewertung des Videos vom südafrikanischen Film and Publication Board. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.fpbRatingReasons[] |
list Gründe dafür, warum das Video die FPB-Bewertung (Südafrika) erhalten hat |
contentDetails.contentRating.fskRating |
string Bewertung der Freiwilligen Selbstkontrolle der Filmwirtschaft (FSK – Deutschland) Gültige Werte für diese Unterkunft:
|
contentDetails.contentRating.grfilmRating |
string Die Altersfreigabe des Videos in Griechenland. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.icaaRating |
string Die Bewertung des Instituto de la Cinematografía y de las Artes Audiovisuales (ICAA – Spanien) des Videos. Für diese Property sind folgende Werte gültig:
|
contentDetails.contentRating.ifcoRating |
string Die Altersfreigabe des Irish Film Classification Office des Videos (IFCO – Ireland) Weitere Informationen finden Sie auf der IFCO-Website. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.ilfilmRating |
string Die Altersfreigabe des Videos in Israel. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.incaaRating |
string Die Einstufung des Videos ist die INCAA (Instituto Nacional de Cine y Artes Audiovisuales, Argentinien). Für diese Property sind folgende Werte gültig:
|
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 Property sind:
|
contentDetails.contentRating.kmrbRating |
string Die Altersfreigabe des Korea Media Rating Board (영상물등香위া회) für das Video. Die KMRB-Bewertung der Videos erfolgt in Südkorea. Für diese Property sind folgende Werte gültig:
|
contentDetails.contentRating.lsfRating |
string Die Bewertung des Videos aus dem indonesischen Lembaga-Sensorfilm. Für diese Property sind folgende Werte gültig:
|
contentDetails.contentRating.mccaaRating |
string Die Bewertung des Videos vom Malta Film Age Classification Board. Für diese Property sind folgende Werte gültig:
|
contentDetails.contentRating.mccypRating |
string Die Bewertung des Media Council for Children and Young People des Dänischen Filminstituts (Det Danske Filminstitut) Die gültigen Werte für diese Property sind:
|
contentDetails.contentRating.mcstRating |
string Das Bewertungssystem des Videos für Vietnam – MCST Für diese Property sind folgende Werte gültig:
|
contentDetails.contentRating.mdaRating |
string Die Bewertung des Videos von der Media Development Authority (MDA) in Singapur und insbesondere der Board of Film Censors (BFC). Gültige Werte für diese Property sind:
|
contentDetails.contentRating.medietilsynetRating |
string Die Bewertung des Videos von Medietilsynet, der norwegischen Medienagentur. Für diese Property sind folgende Werte gültig:
|
contentDetails.contentRating.mekuRating |
string Die Altersfreigabe des Videos vom finnischen Kansallinen Audiovisuaalinen Instituutti (National Audiovisual Institute) Gültige Werte für diese Property:
|
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 Property:
|
contentDetails.contentRating.mocRating |
string Die Altersfreigabe des Ministerio de Cultura (Kolumbien) Für diese Property sind folgende Werte gültig:
|
contentDetails.contentRating.moctwRating |
string Die Bewertung des taiwanesischen Ministeriums für Kultur (文化部) Gültige Werte für diese Property:
|
contentDetails.contentRating.mpaaRating |
string Die Motion Picture Association of America (MPAA)-Bewertung des Videos. Für diese Property sind folgende Werte gültig:
|
contentDetails.contentRating.mpaatRating |
string Die Altersfreigabe der Motion Picture Association of America für Filmtrailer und Vorschauen. Für diese Property sind folgende Werte gültig:
|
contentDetails.contentRating.mtrcbRating |
string Die Altersfreigabe des Videos vom Film and Television Review and Classification Board (Philippinen) Die gültigen Werte für diese Property sind:
|
contentDetails.contentRating.nbcRating |
string Die Bewertung des Videos vom Maldives National Bureau of Classification. Für diese Property sind folgende Werte gültig:
|
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 von Nigerias National Film and Video Censors Board. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.nkclvRating |
string Die Bewertung des Videos stammt vom Nacionãlais Kino Center (Lettland) Gültige Werte für diese Unterkunft:
|
contentDetails.contentRating.oflcRating |
string Die Bewertung des Office of Film and Literature Classification (OFLC – New Zealand) für das Video. Für diese Property sind folgende Werte gültig:
|
contentDetails.contentRating.pefilmRating |
string Die Altersfreigabe des Videos in Peru. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.resorteviolenciaRating |
string Die Altersfreigabe des Videos in Venezuela. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.rtcRating |
string Die Altersfreigabe des General Directorate of Radio, Television and Cinematography (Mexiko) Die gültigen Werte für diese Property sind:
|
contentDetails.contentRating.rteRating |
string Die Bewertung des Videos vom irischen Raidió Teilifís Éireann. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.russiaRating |
string Die Altersfreigabe für das National Film Registry der Russischen Föderation (MKRF – Russland) Gültige Werte für diese Property:
|
contentDetails.contentRating.skfilmRating |
string Die Bewertung des Videos in der Slowakei. Für diese Property sind folgende Werte gültig:
|
contentDetails.contentRating.smaisRating |
string Die Altersfreigabe des Videos in Island. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.smsaRating |
string Die Bewertung des Videos von Statens medieråd (Schwedens nationalem Medienrat) Gültige Werte für diese Property:
|
contentDetails.contentRating.tvpgRating |
string Die Altersfreigabe der TV Parental Guidelines (TVPG) des Videos. Gültige Werte für diese Property:
|
contentDetails.contentRating.ytRating |
string Eine Bewertung, die YouTube verwendet, um Inhalte mit Altersbeschränkung zu identifizieren. 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 Video-Uploader ein benutzerdefiniertes Thumbnail-Bild für das Video zur Verfügung gestellt hat. Diese Property ist nur für den Video-Uploader 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 Property sind:
|
status.failureReason |
string Dieser Wert erklärt, warum ein Video nicht hochgeladen werden konnte. Diese Property ist nur vorhanden, wenn die Property uploadStatus angibt, dass der Upload fehlgeschlagen ist.Gültige Werte für diese Property sind:
|
status.rejectionReason |
string Dieser Wert erklärt, warum YouTube ein hochgeladenes Video abgelehnt hat. Diese Property ist nur vorhanden, wenn die Property 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 Property:
|
status.license |
string Die Lizenz des Videos. 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 öffentlich sichtbar sind. Standardmäßig sind diese Statistiken sichtbar. Statistiken wie die Anzahl der Aufrufe und Bewertungen eines Videos sind selbst dann öffentlich sichtbar, wenn der Wert der Property auf false festgelegt ist. |
status.madeForKids |
boolean Dieser Wert gibt an, ob das Video als auf Kinder ausgerichtet eingestuft wurde und ob es sich um den aktuellen Status „Speziell für Kinder“ handelt. Der Status kann beispielsweise anhand des Werts der Property selfDeclaredMadeForKids bestimmt werden. In der YouTube-Hilfe findest du weitere Informationen dazu, wie du die Zielgruppe für deinen Kanal, deine Videos oder deine Übertragungen festlegst.
|
status.selfDeclaredMadeForKids |
boolean In einer videos.insert - oder
videos.update -Anfrage kann der Kanalinhaber mit dieser Property das Video als auf Kinder ausgerichtet kennzeichnen. In einer videos.list -Anfrage wird der Property-Wert 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 auf „Privat“ gesetzt. Das bedeutet, dass die Property nur dann in einer API-Antwort enthalten ist, wenn die API-Anfrage vom Videoinhaber authentifiziert wurde. Weitere Informationen finden Sie im Überarbeitungsverlauf.Die Anzahl der Nutzer, die 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 für das Video. |
player |
object Das player -Objekt enthält Informationen, mit denen du das Video in einem eingebetteten Player wiedergeben kannst. |
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 Property 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 Property 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 durch die topicDetails.relevantTopicIds[] -Property zurückgegeben. |
topicDetails.relevantTopicIds[] |
list Eine Liste von Themen-IDs, die für das Video relevant sind. Diese Property wurde am 10. November 2016 eingestellt. Sie wird noch bis zum 10. November 2017 unterstützt. Wichtig: Aufgrund der Einstellung von Freebase und der Freebase API funktionieren Themen-IDs ab dem 27. Februar 2017 anders. Zu diesem Zeitpunkt gab YouTube eine kleine Gruppe von ausgewählten Themen-IDs zurück. |
topicDetails.topicCategories[] |
list Eine Liste von Wikipedia-URLs, die eine detaillierte Beschreibung des Videoinhalts enthalten. |
recordingDetails |
object Das recordingDetails -Objekt enthält Informationen zu Ort, Datum und 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 Beschreibung des Ortes, an dem das Video aufgezeichnet wurde. |
recordingDetails.location |
object Die Standortinformationen für das Video. Die Werte der untergeordneten Properties geben den Standort an, den der Videoinhaber mit dem Video verknüpfen möchte. Der Wert kann in öffentlichen Videos bearbeitet und gesucht werden. Bei öffentlichen Videos kann er Nutzern 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 Videoaufnahme. Der Wert wird im ISO 8601-Format ( YYYY-MM-DDThh:mm:ss.sssZ ) angegeben. |
fileDetails |
object Das fileDetails -Objekt enthält Informationen zu der 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 die processingDetails.fileAvailability -Property 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, der 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. Für diese Property sind folgende Werte gültig:
|
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 des Codierungsprozesses als width_pixels /height_pixels berechnen. |
fileDetails.videoStreams[].heightPixels |
unsigned integer Die 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, den der Stream verwendet. |
fileDetails.videoStreams[].bitrateBps |
unsigned long Die Bitrate des Videostreams in Bit pro Sekunde. |
fileDetails.videoStreams[].rotation |
string Der Betrag, den YouTube benötigt, um den ursprünglichen Quellinhalt zu rotieren, damit das Video korrekt angezeigt 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, 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 der hochgeladenen Videodatei (Video und Audio) ist 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. Hier wird auch angegeben, ob verschiedene Arten von Daten oder Inhalten wie Dateidetails oder Miniaturansichten für das Video verfügbar sind.Das processingProgress -Objekt kann so abgefragt werden, dass 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 ob das Video noch verarbeitet wird. Für diese Property sind folgende Werte gültig:
|
processingDetails.processingProgress |
object Das processingProgress -Objekt enthält Informationen über den Fortschritt, den YouTube bei der Verarbeitung des Videos gemacht hat. Die Werte sind nur dann 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 der Verarbeitung des Videos durch YouTube kann die Zahl noch genauer angepasst werden. |
processingDetails.processingProgress.partsProcessed |
unsigned long Die Anzahl der Teile des Videos, die YouTube bereits verarbeitet hat. Du kannst den Prozentsatz des bereits von YouTube verarbeiteten Videos anhand der folgenden Berechnungen schätzen: 100 * parts_processed / parts_total Da die geschätzte Anzahl an Teilen ohne entsprechenden Anstieg an der Anzahl der bereits verarbeiteten Teile zunehmen könnte, kann es sein, dass der berechnete Fortschritt von Zeit zu Zeit sinkt, während YouTube ein Video verarbeitet. |
processingDetails.processingProgress.timeLeftMs |
unsigned long Eine Schätzung der Zeit in Millisekunden, die YouTube für die Verarbeitung des Videos benötigt. |
processingDetails.processingFailureReason |
string Der Grund, warum YouTube das Video nicht verarbeiten konnte. Diese Property hat nur einen Wert, wenn der Wert der Property processingStatus den Wert failed hat.Gültige Werte für diese Property sind:
|
processingDetails.fileDetailsAvailability |
string Dieser Wert gibt an, ob für das hochgeladene Video Dateidetails verfügbar sind. Sie können die Dateidetails eines Videos abrufen, indem Sie in der videos.list() -Anfrage den Teil fileDetails anfordern. |
processingDetails.processingIssuesAvailability |
string Dieser Wert gibt an, ob das Videoverarbeitungsmodul Vorschläge entwickelt hat, mit denen YouTube das Video besser verarbeiten kann, Warnungen zu Videoverarbeitungsproblemen oder Fehler, die zu Problemen bei der Videoverarbeitung führen. Sie können diese Vorschläge abrufen, indem Sie den Teil suggestions in Ihrer videos.list() -Anfrage anfordern. |
processingDetails.tagSuggestionsAvailability |
string Dieser Wert gibt an, ob für das Video Keyword- bzw. Tag-Vorschläge verfügbar sind. Tags können 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 Teil suggestions 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 lässt. Sie können diese Vorschläge abrufen, indem Sie den Teil suggestions in Ihrer videos.list() -Anfrage anfordern. |
processingDetails.thumbnailsAvailability |
string Dieser Wert gibt an, ob für das Video Miniaturansichten erstellt wurden. |
suggestions |
object Das suggestions -Objekt enthält Vorschläge, die Möglichkeiten zur Verbesserung der Videoqualität oder der Metadaten für das hochgeladene Video enthalten. Diese Daten können nur vom Rechteinhaber des Videos abgerufen werden. Das Objekt suggestions wird nur zurückgegeben, wenn die Property processingDetails.tagSuggestionsAvailability oder die Property processingDetails.editorSuggestionsAvailability den Wert available hat. |
suggestions.processingErrors[] |
list Eine Liste von Fehlern, die YouTube daran hindern, das hochgeladene Video zu verarbeiten. Diese Fehler weisen darauf hin, dass dieser Status unabhängig vom aktuellen Verarbeitungsstatus schließlich failed lautet.Gültige Werte für diese Property sind:
|
suggestions.processingWarnings[] |
list Eine Liste von Gründen, warum YouTube Schwierigkeiten beim Transcodieren des hochgeladenen Videos hat oder dass die Transcodierung fehlerhaft ist. Diese Warnungen werden generiert, bevor YouTube die hochgeladene Videodatei tatsächlich verarbeitet. Außerdem werden Probleme erkannt, die nicht unbedingt auf einen Fehler bei der Videoverarbeitung hinweisen, aber dennoch zu Problemen wie Synchronisierungsproblemen, Videoartefakten oder fehlendem Audiotrack führen können. Für diese Property sind folgende Werte gültig:
|
suggestions.processingHints[] |
list Eine Liste mit Vorschlägen, die dazu beitragen können, dass YouTube das Video besser verarbeiten 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 dein Video bei der Suche auf YouTube finden. |
suggestions.tagSuggestions[].tag |
string Das für das Video vorgeschlagene Keyword-Tag. |
suggestions.tagSuggestions[].categoryRestricts[] |
list Eine Gruppe von Videokategorien, für die das Tag relevant ist. Du kannst diese Informationen verwenden, um passende Tag-Vorschläge basierend auf der Videokategorie anzuzeigen, die der Video-Uploader dem Video zuordnet. Tag-Vorschläge sind standardmäßig für alle Kategorien relevant, wenn keine Einschränkungen für das Keyword definiert sind. |
suggestions.editorSuggestions[] |
list Eine Liste der Vorgänge zur Videobearbeitung, mit denen die Videoqualität oder die Videowiedergabe verbessert werden kann. Für diese Property sind folgende Werte gültig:
|
liveStreamingDetails |
object Das liveStreamingDetails -Objekt enthält Metadaten zu einer Livevideoübertragung. Das Objekt ist nur dann in einer video -Ressource vorhanden, wenn es sich um ein kommendes, ein laufendes oder abgeschlossenes Video handelt. |
liveStreamingDetails.actualStartTime |
datetime Die Uhrzeit, zu der die Übertragung tatsächlich gestartet wurde. Der Wert wird im ISO 8601-Format angegeben. Dieser Wert ist erst nach Beginn der Übertragung verfügbar. |
liveStreamingDetails.actualEndTime |
datetime Die Zeit, zu der die Übertragung tatsächlich beendet wurde. Der Wert wird im ISO 8601-Format angegeben. Dieser Wert ist erst nach der Übertragung verfügbar. |
liveStreamingDetails.scheduledStartTime |
datetime Die Uhrzeit, zu der die Übertragung geplant ist. Der Wert wird im ISO 8601-Format angegeben. |
liveStreamingDetails.scheduledEndTime |
datetime Die Zeit, zu der die Übertragung planmäßig endet. Der Wert wird im ISO 8601-Format angegeben. Wenn der Wert leer ist oder die Property nicht vorhanden ist, wird die Übertragung zeitlich unbegrenzt fortgesetzt. |
liveStreamingDetails.concurrentViewers |
unsigned long Die Anzahl der Zuschauer, die sich die Übertragung aktuell ansehen. Die Eigenschaft und ihr Wert werden angezeigt, wenn die Übertragung aktuelle Zuschauer hat und der Senderinhaber die Anzahl der Aufrufe des Videos nicht ausgeblendet hat. Hinweis: Sobald die Übertragung beendet ist, wird die Anzahl gleichzeitiger Zuschauer von YouTube für eine Übertragung nicht mehr erfasst. Diese Property kann daher nicht ermitteln, wie viele Zuschauer sich ein archiviertes Video einer bereits beendeten Liveübertragung ansehen. |
liveStreamingDetails.activeLiveChatId |
string Die ID des aktuell aktiven Livechats, der mit diesem Video verknüpft ist. Dieses Feld ist nur ausgefüllt, wenn das Video eine Liveübertragung mit Livechat ist. Sobald die Übertragung abgeschlossen ist, wird dieses Feld entfernt und der Livechat geschlossen. Bei dauerhaften Übertragungen wird die Livechat-ID nicht mehr an dieses Video gebunden, sondern an das neue Video, das auf der persistenten Seite angezeigt wird. |
localizations |
object Das localizations -Objekt enthält Übersetzungen der Metadaten des Videos. |
localizations.(key) |
object Die Sprache des lokalisierten Texts, der dem Schlü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 |