Alle Videos, die über den Endpunkt
videos.insert
aus nicht bestätigten API-Projekten hochgeladen wurden, die nach dem 28. Juli 2020 erstellt wurden, sind nur noch im privaten Wiedergabemodus verfügbar. 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 Überarbeitungsverlauf der API.
Eine video
-Ressource stellt ein YouTube-Video dar.
Methoden
Die API unterstützt die folgenden Methoden für videos
-Ressourcen:
- getRating
- Ruft die Bewertungen ab, die der autorisierte Nutzer einer Liste von angegebenen 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.
- 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öst ein YouTube-Video. Hier kannst du die Funktion ausprobieren.
- rate
- Du kannst ein Video mit „Mag ich“ oder „Mag ich nicht“ bewerten oder eine Bewertung entfernen. Hier kannst du die Funktion ausprobieren.
- reportAbuse
- Videos 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, "containsSyntheticMedia": boolean }, "statistics": { "viewCount": string, "likeCount": string, "dislikeCount": string, "favoriteCount": string, "commentCount": string }, "paidProductPlacementDetails": { "hasPaidProductPlacement": boolean }, "player": { "embedHtml": string, "embedHeight": long, "embedWidth": long }, "topicDetails": { "topicIds": [ string ], "relevantTopicIds": [ string ], "topicCategories": [ string ] }, "recordingDetails": { "recordingDate": datetime }, "fileDetails": { "fileName": string, "fileSize": unsigned long, "fileType": string, "container": string, "videoStreams": [ { "widthPixels": unsigned integer, "heightPixels": unsigned integer, "frameRateFps": double, "aspectRatio": double, "codec": string, "bitrateBps": unsigned long, "rotation": string, "vendor": string } ], "audioStreams": [ { "channelCount": unsigned integer, "codec": string, "bitrateBps": unsigned long, "vendor": string } ], "durationMs": unsigned long, "bitrateBps": unsigned long, "creationTime": string }, "processingDetails": { "processingStatus": string, "processingProgress": { "partsTotal": unsigned long, "partsProcessed": unsigned long, "timeLeftMs": unsigned long }, "processingFailureReason": string, "fileDetailsAvailability": string, "processingIssuesAvailability": string, "tagSuggestionsAvailability": string, "editorSuggestionsAvailability": string, "thumbnailsAvailability": string }, "suggestions": { "processingErrors": [ string ], "processingWarnings": [ string ], "processingHints": [ string ], "tagSuggestions": [ { "tag": string, "categoryRestricts": [ string ] } ], "editorSuggestions": [ string ] }, "liveStreamingDetails": { "actualStartTime": datetime, "actualEndTime": datetime, "scheduledStartTime": datetime, "scheduledEndTime": datetime, "concurrentViewers": unsigned long, "activeLiveChatId": string }, "localizations": { (key): { "title": string, "description": string } } }
Attribute
In der folgenden Tabelle werden die Eigenschaften 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. 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, wird in dieser Property der Zeitpunkt angegeben, zu dem das Video veröffentlicht wurde. 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 darf maximal 100 Zeichen lang sein und alle gültigen UTF-8-Zeichen enthalten, mit Ausnahme von < und >. Sie müssen einen Wert für dieses Attribut festlegen, wenn Sie die videos.update -Methode aufrufen und den snippet -Teil einer video -Ressource aktualisieren. |
snippet.description |
string Die Videobeschreibung. Der Attributwert darf maximal 5.000 Byte lang sein und alle gültigen UTF-8-Zeichen enthalten, mit Ausnahme von < und >. |
snippet.thumbnails |
object Eine Karte mit Miniaturansichten, die mit dem Video verknüpft sind. Für jedes Objekt in der Karte ist der Schlüssel der Name des Thumbnail-Bilds und der Wert ist ein Objekt, das weitere Informationen zum Thumbnail enthält. |
snippet.thumbnails.(key) |
object Gültige Schlüsselwerte:
|
snippet.thumbnails.(key).url |
string Die URL des Bildes. |
snippet.thumbnails.(key).width |
unsigned integer Die Breite des Bilds. |
snippet.thumbnails.(key).height |
unsigned integer Die Höhe des Bilds. |
snippet.channelTitle |
string Kanaltitel des Kanals, zu dem das Video gehört. |
snippet.tags[] |
list Eine Liste der Keyword-Tags, die mit dem Video verknüpft sind. Tags dürfen Leerzeichen enthalten. Der Attributwert darf maximal 500 Zeichen lang sein. Beachten Sie die folgenden Regeln zur Berechnung des Zeichenlimits:
|
snippet.categoryId |
string Die mit dem Video verknüpfte YouTube-Videokategorie. Sie müssen einen Wert für dieses Attribut festlegen, wenn Sie die Methode videos.update aufrufen und den snippet -Teil einer video -Ressource aktualisieren. |
snippet.liveBroadcastContent |
string Gibt an, ob es sich bei dem Video um eine anstehende/aktive Liveübertragung handelt. Andernfalls wird „none“ (kein) zurückgegeben, wenn es sich nicht um eine anstehende oder aktive Live-Übertragung handelt. Gültige Werte für dieses Attribut sind:
|
snippet.defaultLanguage |
string Die Sprache des Texts in den Eigenschaften snippet.title und snippet.description der video -Ressource. |
snippet.localized |
object Das snippet.localized -Objekt enthält entweder einen lokalisierten Titel und eine lokalisierte Beschreibung für das Video oder den Titel in der Standardsprache für die Metadaten des Videos.
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 einen Hinweis darauf, ob für das Video Untertitel verfügbar sind. |
contentDetails.duration |
string Die Länge des Videos. Der Attributwert ist eine Dauer nach ISO 8601. Bei einem Video, das mindestens eine Minute 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 Ganzzahlen, die die Anzahl der Minuten (oder Sekunden) des Videos angeben. Ein Wert von PT15M33S gibt beispielsweise an, dass das Video 15 Minuten und 33 Sekunden lang ist.Wenn das Video mindestens eine Stunde lang ist, wird die Dauer im Format PT#H#M#S angegeben. Dabei gibt die # vor dem Buchstaben H die Länge des Videos in Stunden an. Alle anderen Details entsprechen denen oben. Wenn das Video mindestens einen Tag lang ist, sind die Buchstaben P und T getrennt und der Wert hat das Format P#DT#H#M#S . Ausführliche Informationen finden Sie in der ISO 8601-Spezifikation. |
contentDetails.dimension |
string Gibt an, ob das Video in 3D oder in 2D verfügbar ist. |
contentDetails.definition |
string Gibt an, ob das Video in HD ( HD ) oder nur in Standardauflösung verfügbar ist.Gültige Werte für dieses Attribut 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 es sich bei dem Video um lizenzierte Inhalte handelt. Das bedeutet, dass die Inhalte auf einen Kanal hochgeladen wurden, der mit einem YouTube-Contentpartner verknüpft ist, und dann von diesem Partner einen Anspruch erhoben hat. |
contentDetails.regionRestriction |
object Das regionRestriction -Objekt enthält Informationen zu den Ländern, in denen ein Video verfügbar ist (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 ein Land nicht in ihrem Wert aufgeführt ist, wird die Auslieferung des Videos in diesem Land blockiert. Wenn dieses Attribut vorhanden ist und eine leere Liste enthält, wird das Video in allen Ländern blockiert. |
contentDetails.regionRestriction.blocked[] |
list Eine Liste mit Regionscodes, die Länder angeben, in denen das Video blockiert ist. Wenn diese Eigenschaft vorhanden ist und ein Land nicht in ihrem Wert aufgeführt ist, kann das Video in diesem Land angesehen werden. Wenn diese Property vorhanden ist und eine leere Liste enthält, kann das Video in allen Ländern angesehen werden. |
contentDetails.contentRating |
object Gibt die Bewertungen an, die das Video nach verschiedenen Bewertungssystemen erhalten hat. |
contentDetails.contentRating.acbRating |
string Die Altersfreigabe des Australian Classification Board (ACB) oder der Australian Communications and Media Authority (ACMA) für das Video. ACMA-Altersfreigaben werden zur Klassifizierung von Fernsehprogrammen für Kinder verwendet. Gültige Werte für diese Property 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 sind:
|
contentDetails.contentRating.anatelRating |
string Die Bewertung „Anatel“ (Asociación Nacional de Televisión) für das chilenische Fernsehen des Videos. Gültige Werte für diese Unterkunft sind:
|
contentDetails.contentRating.bbfcRating |
string Die Altersfreigabe des 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 thailändischen Board of Film and Video Censors. Gültige Werte für diese Unterkunft sind:
|
contentDetails.contentRating.bmukkRating |
string Die Altersfreigabe des Videos durch das österreichische Bundesministerium für Unterricht, Kunst und Kultur. Gültige Werte für dieses Attribut sind:
|
contentDetails.contentRating.catvRating |
string Bewertungssystem für das kanadische Fernsehen – Canadian TV Classification System – Die Einstufung des Videos durch die Canadian Radio-Television and Telecommunications Commission (CRTC) für englischsprachige Sender in Kanada. Weitere Informationen findest du auf der Website des Canadian Broadcast Standards Council. Gültige Werte für dieses Attribut sind:
|
contentDetails.contentRating.catvfrRating |
string Die Altersfreigabe des Videos durch die Canadian Radio-Television and Telecommunications Commission (CRTC) für französischsprachige Sendungen in Kanada. Weitere Informationen findest du auf der Website des Canadian Broadcast Standards Council. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.cbfcRating |
string Die Altersfreigabe des Central Board of Film Certification (CBFC, Indien) für das Video. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.cccRating |
string Die Altersfreigabe des Consejo de Calificación Cinematográfica (Chile) für das Video. Zulässige Werte für diese Property sind:
|
contentDetails.contentRating.cceRating |
string Die Bewertung des Videos durch die portugiesische Comissão de Classificação de Espect 'culos. Gültige Werte für diese Unterkunft sind:
|
contentDetails.contentRating.chfilmRating |
string Die Bewertung des Videos in der Schweiz. Gültige Werte für diese Unterkunft sind:
|
contentDetails.contentRating.chvrsRating |
string Die Bewertung des Canadian Home Video Rating System (CHVRS) des Videos. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.cicfRating |
string Altersfreigabe 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 von der rumänischen Behörde CONSILIUL NATIONAL AL AUDIOVIZUALULUI (CNA). Gültige Werte für diese Property sind:
|
contentDetails.contentRating.cncRating |
string Altersfreigabe in Frankreich – Kinotografie der Kommission zur Deklassifizierung Gültige Werte für diese Unterkunft:
|
contentDetails.contentRating.csaRating |
string Altersfreigabe des Videos durch den französischen Conseil supérieur de l'audiovisuel, der die Altersfreigabe für ausgestrahlte Inhalte festlegt. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.cscfRating |
string Die Bewertung des Videos durch die Luxemburgische Kommission zur Überwachung von Überwachungs- und Klassifizierungen des Films (CSCF) Gültige Werte für diese Property sind:
|
contentDetails.contentRating.czfilmRating |
string Die Bewertung des Videos in Tschechien. Gültige Werte für diese Unterkunft sind:
|
contentDetails.contentRating.djctqRating |
string Die Altersfreigabe des Departamento de Justiça, Classificação, Qualificação e Títulos (DJCQT – Brasilien) für das Video. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.djctqRatingReasons[] |
list Gründe, warum das Video die Bewertung „DJCQT“ (Brasilien) erhalten hat. |
contentDetails.contentRating.ecbmctRating |
string Bewertungssystem in der Türkei – Bewertungs- und Klassifizierungsbehörde des Ministeriums für Kultur und Tourismus Gültige Werte für diese Unterkunft sind:
|
contentDetails.contentRating.eefilmRating |
string Altersfreigabe des Videos in Estland. Gültige Werte für dieses Attribut sind:
|
contentDetails.contentRating.egfilmRating |
string Altersfreigabe des Videos in Ägypten. Gültige Werte für dieses Attribut sind:
|
contentDetails.contentRating.eirinRating |
string Die Eirin-Altersfreigabe (映倫) des Videos. Eirin ist das japanische Bewertungssystem. Gültige Werte für diese Unterkunft sind:
|
contentDetails.contentRating.fcbmRating |
string Die Altersfreigabe des Videos durch die Filmzensurbehörde von Malaysia. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.fcoRating |
string Altersfreigabe des Videos durch das Office for Film, Newspaper and Article Administration in Hongkong. 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 französischen Kulturministeriums (Centre national du cinéma et de l'image animé) für das Video. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.fpbRating |
string Die Altersfreigabe des Videos durch die Film and Publication Board von Südafrika. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.fpbRatingReasons[] |
list Gründe, die erklären, warum das Video die Altersfreigabe des FPB (Südafrika) erhalten hat. |
contentDetails.contentRating.fskRating |
string Die Altersfreigabe der Freiwilligen Selbstkontrolle der Filmwirtschaft (FSK – Deutschland) für das Video. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.grfilmRating |
string Die Bewertung des Videos in Griechenland. Gültige Werte für diese Unterkunft sind:
|
contentDetails.contentRating.icaaRating |
string Altersfreigabe des Instituto de la Cinematografía y de las Artes Audiovisuales (ICAA, Spanien) für das Video. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.ifcoRating |
string Die Altersfreigabe des Irish Film Classification Office (IFCO – Irland) für das Video. Weitere Informationen finden Sie auf der IFCO-Website. Gültige Werte für dieses Attribut sind:
|
contentDetails.contentRating.ilfilmRating |
string Altersfreigabe des Videos in Israel. Gültige Werte für dieses Attribut sind:
|
contentDetails.contentRating.incaaRating |
string Die INCAA-Einstufung (Instituto Nacional de Cine y Artes Audiovisuales – Argentinien) des Videos. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.kfcbRating |
string Die Bewertung des Videos vom Kenya Film Classification Board. Gültige Werte für diese Unterkunft sind:
|
contentDetails.contentRating.kijkwijzerRating |
string voor de Classificatie van Audiovisuele Media (Niederlande). Zulässige Werte für diese Property:
|
contentDetails.contentRating.kmrbRating |
string Die Altersfreigabe des Korea Media Rating Board (영상물등급위원회) für das Video. Das KMRB ist für die Altersfreigabe von Videos in Südkorea zuständig. Gültige Werte für dieses Attribut sind:
|
contentDetails.contentRating.lsfRating |
string Die Altersfreigabe des Videos durch die indonesische Lembaga Sensor Film. Gültige Werte für dieses Attribut sind:
|
contentDetails.contentRating.mccaaRating |
string Altersfreigabe des Videos durch die Film Age-Classification Board von Malta. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.mccypRating |
string Die Bewertung des Videos vom dänischen Filminstitut (Det Danske Filminstitut) Media Council for Children and Young People. Gültige Werte für diese Unterkunft:
|
contentDetails.contentRating.mcstRating |
string Altersfreigabe des Videos für Vietnam – MCST Gültige Werte für dieses Attribut sind:
|
contentDetails.contentRating.mdaRating |
string Die Altersfreigabe des Videos durch die Media Development Authority (MDA) von Singapur und insbesondere durch das Board of Film Censors (BFC). Gültige Werte für diese Property sind:
|
contentDetails.contentRating.medietilsynetRating |
string Altersfreigabe des Videos von Medietilsynet, der norwegischen Medienaufsicht. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.mekuRating |
string Altersfreigabe des Videos vom finnischen Kansallinen Audiovisuaalinen Instituutti (National Audiovisual Institute). Gültige Werte für diese Property sind:
|
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 Die Altersfreigabe des Ministerio de Cultura (Kolumbien) für das Video. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.moctwRating |
string Die Bewertung des Videos durch das taiwanesische Ministerium für Kultur (LANGUAGE化部). Gültige Werte für diese Unterkunft sind:
|
contentDetails.contentRating.mpaaRating |
string Die MPAA-Altersfreigabe (Motion Picture Association of America) des Videos. Gültige Werte für dieses Attribut sind:
|
contentDetails.contentRating.mpaatRating |
string Altersfreigabe 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 Altersfreigabe des Videos vom National Bureau of Classification der Malediven. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.nfrcRating |
string Die Altersfreigabe des Videos durch das Bulgarische Nationale Filmzentrum. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.nfvcbRating |
string Die Altersfreigabe des Videos durch die National Film and Video Censors Board von Nigeria. Gültige Werte für dieses Attribut sind:
|
contentDetails.contentRating.nkclvRating |
string Altersfreigabe des Videos vom Nacionãlais Kino centrs (Lettisches Nationales Filmzentrum). Gültige Werte für diese Property sind:
|
contentDetails.contentRating.oflcRating |
string Die Altersfreigabe des Office of Film and Literature Classification (OFLC, Neuseeland) für das Video. Gültige Werte für dieses Attribut sind:
|
contentDetails.contentRating.pefilmRating |
string Altersfreigabe des Videos in Peru. Gültige Werte für dieses Attribut sind:
|
contentDetails.contentRating.resorteviolenciaRating |
string Altersfreigabe des Videos in Venezuela. Gültige Werte für dieses Attribut sind:
|
contentDetails.contentRating.rtcRating |
string Die Altersfreigabe des Videos durch die Generaldirektion für Radio, Fernsehen und Film (Mexiko). Gültige Werte für diese Property sind:
|
contentDetails.contentRating.rteRating |
string Die Bewertung des Videos durch die irische Raidió Teilifís Éireann. Gültige Werte für diese Unterkunft sind:
|
contentDetails.contentRating.russiaRating |
string Altersfreigabe des National Film Registry of the Russian Federation (MKRF – Russland) für das Video. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.skfilmRating |
string Altersfreigabe des Videos in der Slowakei. Gültige Werte für dieses Attribut sind:
|
contentDetails.contentRating.smaisRating |
string Altersfreigabe des Videos in Island. Gültige Werte für dieses Attribut sind:
|
contentDetails.contentRating.smsaRating |
string Altersfreigabe des Videos durch Statens medieråd (Schwedischer Medienrat). Gültige Werte für dieses Attribut sind:
|
contentDetails.contentRating.tvpgRating |
string Altersfreigabe des Videos gemäß den TV Parental Guidelines (TVPG). Gültige Werte für diese Unterkunft sind:
|
contentDetails.contentRating.ytRating |
string Altersfreigabe, die von YouTube für Inhalte mit Altersbeschränkung verwendet wird. Gültige Werte für dieses Attribut:
|
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 bereitgestellt hat. Diese Eigenschaft ist nur für den Uploader des Videos sichtbar. |
status |
object Das status -Objekt enthält Informationen zum Upload-, Verarbeitungs- und Datenschutzstatus des Videos. |
status.uploadStatus |
string Der Status des hochgeladenen Videos. Gültige Werte für dieses Attribut sind:
|
status.failureReason |
string Dieser Wert gibt an, warum der Upload eines Videos fehlgeschlagen ist. 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 gibt an, 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 dieses Attribut 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 außerdem Folgendes:
|
status.license |
string Die Lizenz des Videos. Gültige Werte für dieses Attribut 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. Standardmäßig sind diese Statistiken sichtbar. Statistiken wie die Aufrufzahlen und Bewertungen eines Videos sind auch dann öffentlich sichtbar, wenn der Wert dieser Property auf false festgelegt ist. |
status.madeForKids |
boolean Dieser Wert gibt an, ob das Video als an Kinder gerichtet gekennzeichnet ist. Außerdem enthält er den aktuellen Status „speziell für Kinder“ des Videos. Der Status kann beispielsweise anhand des Werts der Property selfDeclaredMadeForKids ermittelt werden. Weitere Informationen dazu, wie du die Zielgruppe für deinen Kanal, deine Videos oder deine Livestreams festlegst, findest du in der YouTube-Hilfe.
|
status.selfDeclaredMadeForKids |
boolean Mit dieser Property kann der Kanalinhaber in einer videos.insert - oder videos.update -Anfrage 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. |
status.containsSyntheticMedia |
boolean Mit dieser Eigenschaft kann der Kanalinhaber in einer videos.insert - oder videos.update -Anfrage angeben, dass ein Video realistische veränderte oder synthetische (A/S) Inhalte enthält. Weitere Informationen zu den YouTube-Richtlinien zu A/S-InhaltenBeispiele für solche Inhalte sind Videos, in denen:
|
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: Das Attribut
statistics.dislikeCount ist seit dem 13. Dezember 2021 nicht mehr öffentlich zugänglich. Das bedeutet, dass das Attribut 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 erfolgt am 28. August 2015. Der Wert des Attributs ist jetzt immer auf 0 festgelegt. |
statistics.commentCount |
unsigned long Die Anzahl der Kommentare zum Video. |
paidProductPlacementDetails |
object Das paidProductPlacementDetails -Objekt enthält Informationen zu bezahlten Product-Placements im Video. |
paidProductPlacementDetails.hasPaidProductPlacement |
boolean Wähle true aus, wenn in den Inhalten bezahlte Produktplatzierungen verwendet werden. Die Standardeinstellung ist false . |
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, über den das Video wiedergegeben wird.
|
player.embedHeight |
long Die Höhe des eingebetteten Players, die in der Property player.embedHtml zurückgegeben wird. Diese Property wird nur zurückgegeben, wenn in der Anfrage ein Wert für die Parameter maxHeight und/oder maxWidth angegeben wurde und das Seitenverhältnis des Videos bekannt ist. |
player.embedWidth |
long Die Breite des eingebetteten Players, die in der Eigenschaft player.embedHtml zurückgegeben wird. Diese Property wird nur zurückgegeben, wenn in der Anfrage ein Wert für die Parameter maxHeight und/oder maxWidth angegeben wurde und das Seitenverhältnis des Videos bekannt ist. |
topicDetails |
object Das topicDetails -Objekt enthält Informationen zu Themen, die mit dem Video in Verbindung stehen.Wichtig: Weitere Informationen zu den bevorstehenden Änderungen im Zusammenhang mit Themen-IDs finden Sie in den Definitionen der Properties topicDetails.relevantTopicIds[] und topicDetails.topicIds[] sowie im Überarbeitungsverlauf. |
topicDetails.topicIds[] |
list Wichtig: Dieses Attribut 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 über den Property-Wert topicDetails.relevantTopicIds[] zurückgegeben. |
topicDetails.relevantTopicIds[] |
list Eine Liste von Themen-IDs, die für das Video relevant sind. Diese Property wird seit dem 10. November 2016 nicht mehr unterstützt. 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 an ausgewählten Themen-IDs zurück. |
topicDetails.topicCategories[] |
list Eine Liste mit Wikipedia-URLs, die eine allgemeine Beschreibung des Videoinhalts enthalten. |
recordingDetails |
object Das recordingDetails -Objekt enthält Informationen zum Aufnahmeort, zum Aufnahmedatum und zur Adresse, an der das Video aufgenommen wurde. |
recordingDetails.locationDescription |
string Dieses Attribut wird seit dem 1. Juni 2017 nicht mehr unterstützt. Weitere Informationen finden Sie in der Mitteilung zur Einstellung. Die Textbeschreibung des Ortes, an dem das Video aufgezeichnet wurde. |
recordingDetails.location |
object Die mit dem Video verknüpften Informationen zur Standortbestimmung. Die Werte der untergeordneten Properties geben den Ort an, den der Inhaber des Videos mit dem Video verknüpfen möchte. Der Wert kann bearbeitet werden, ist in öffentlichen Videos suchbar und wird Nutzern bei öffentlichen Videos möglicherweise angezeigt. |
recordingDetails.location.latitude |
double Dieses Attribut wird seit dem 1. Juni 2017 nicht mehr unterstützt. Weitere Informationen finden Sie in der Mitteilung zur Einstellung. Breitengrad in Grad. |
recordingDetails.location.longitude |
double Dieses Attribut wird seit dem 1. Juni 2017 nicht mehr unterstützt. Weitere Informationen finden Sie in der Mitteilung zur Einstellung. Längengrad in Grad |
recordingDetails.location.altitude |
double Dieses Attribut wird seit dem 9. Juli 2018 nicht mehr unterstützt. Weitere Informationen finden Sie in der Mitteilung zur Einstellung. Höhe über der Referenzellipsoid in Metern. |
recordingDetails.recordingDate |
datetime Datum und Uhrzeit der Aufnahme des Videos. Der Wert wird im ISO 8601-Format ( YYYY-MM-DDThh:mm:ss.sssZ ) angegeben. |
fileDetails |
object Das fileDetails -Objekt enthält Informationen zur Videodatei, die auf YouTube hochgeladen wurde, z. B. Auflösung, Dauer, Audio- und Videocodecs sowie Streambitraten. 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 unabhängig davon vorhanden, ob eine Videodatei oder eine andere Datei hochgeladen wurde. |
fileDetails.fileSize |
unsigned long Die Größe der hochgeladenen Datei in Byte. Dieses Feld ist unabhängig davon vorhanden, ob eine Videodatei oder eine andere Datei hochgeladen wurde. |
fileDetails.fileType |
string Der Typ der hochgeladenen Datei, wie er von der Videoverarbeitungs-Engine von YouTube erkannt wurde. Derzeit werden auf YouTube nur Videodateien verarbeitet. Dieses Feld ist jedoch vorhanden, unabhängig davon, ob eine Videodatei oder eine andere Datei hochgeladen wurde. Gültige Werte für diese Property sind:
|
fileDetails.container |
string Das Containerformat der hochgeladenen Videodatei. |
fileDetails.videoStreams[] |
list Eine Liste der Videostreams in der hochgeladenen Videodatei. Jedes Element in der Liste enthält detaillierte Metadaten zu einem Videostream. |
fileDetails.videoStreams[].widthPixels |
unsigned integer Die Breite des codierten Videoinhalts in Pixeln. Das Codierungsseitenverhältnis des Videos lässt sich mit width_pixels ÷ height_pixels berechnen. |
fileDetails.videoStreams[].heightPixels |
unsigned integer Die Höhe der codierten Videoinhalte in Pixeln. |
fileDetails.videoStreams[].frameRateFps |
double Die Framerate des Videostreams in Bildern pro Sekunde. |
fileDetails.videoStreams[].aspectRatio |
double Das Seitenverhältnis der Videoinhalte, das angibt, in welchem Seitenverhältnis 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 Bits pro Sekunde. |
fileDetails.videoStreams[].rotation |
string Um wie viel YouTube die ursprünglichen Quellinhalte drehen muss, um das Video richtig anzuzeigen. Gültige Werte für diese Property sind:
|
fileDetails.videoStreams[].vendor |
string Ein Wert, mit dem ein Videoanbieter eindeutig identifiziert wird. In der Regel ist der Wert ein aus vier Buchstaben bestehender Anbietercode. |
fileDetails.audioStreams[] |
list Eine Liste der Audiostreams in der hochgeladenen Videodatei. Jedes Element in der Liste enthält detaillierte Metadaten zu einem Audiostream. |
fileDetails.audioStreams[].channelCount |
unsigned integer Die Anzahl der Audiokanäle, die der Stream enthält. |
fileDetails.audioStreams[].codec |
string Der Audio-Codec, der vom Stream verwendet wird. |
fileDetails.audioStreams[].bitrateBps |
unsigned long Die Bitrate des Audiostreams in Bits pro Sekunde. |
fileDetails.audioStreams[].vendor |
string Ein Wert, der einen Videoanbieter eindeutig identifiziert. In der Regel ist der Wert ein vierstelliger Anbietercode. |
fileDetails.durationMs |
unsigned long Die Länge des hochgeladenen Videos in Millisekunden. |
fileDetails.bitrateBps |
unsigned long Die kombinierte Bitrate (Video und Audio) der hochgeladenen Videodatei in Bit pro Sekunde. |
fileDetails.creationTime |
string Das Datum und die Uhrzeit, an dem bzw. der die hochgeladene Videodatei erstellt wurde. Der Wert wird im ISO 8601-Format angegeben. Derzeit werden die folgenden ISO 8601-Formate unterstützt:
|
processingDetails |
object Das Objekt processingDetails 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 bis zur vollständigen Verarbeitung des Videos an. In diesem Teil wird auch angegeben, ob verschiedene Arten von Daten oder Inhalten für das Video verfügbar sind, z. B. Dateidetails oder Thumbnails.Das processingProgress -Objekt ist für Polling ausgelegt, damit der Uploader den Fortschritt der Verarbeitung der hochgeladenen Videodatei auf YouTube 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 es noch verarbeitet wird. Gültige Werte für diese Property:
|
processingDetails.processingProgress |
object Das Objekt processingProgress 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 YouTube das Video verarbeitet, wird die Zahl möglicherweise mit genaueren Schätzungen aktualisiert. |
processingDetails.processingProgress.partsProcessed |
unsigned long Die Anzahl der Videoteile, die YouTube bereits verarbeitet hat. Du kannst den Prozentsatz des Videos, der bereits von YouTube verarbeitet wurde, anhand der folgenden Formel schätzen: 100 * parts_processed / parts_total Hinweis: Da sich die geschätzte Anzahl der Teile erhöhen kann, ohne dass sich die Anzahl der bereits verarbeiteten Teile entsprechend erhöht, kann es sein, dass der berechnete Fortschritt während der Verarbeitung eines Videos regelmäßig abnimmt. |
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 das Video nicht verarbeitet werden konnte. Diese Property hat nur dann einen Wert, wenn der Wert der Property processingStatus failed ist.Gültige Werte für diese Property sind:
|
processingDetails.fileDetailsAvailability |
string Dieser Wert gibt an, ob Dateidetails für das hochgeladene Video 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 zur Verbesserung der Verarbeitung des Videos durch YouTube, Warnungen zu Problemen bei der Videoverarbeitung oder Fehler, die zu Problemen bei der Videoverarbeitung führen, generiert hat. Sie können diese Vorschläge abrufen, indem Sie in Ihrer videos.list() -Anfrage den Teil suggestions anfordern. |
processingDetails.tagSuggestionsAvailability |
string Dieser Wert gibt an, ob Keyword-Vorschläge (Tags) für das Video verfügbar sind. Du kannst den Metadaten eines Videos Tags hinzufügen, damit andere Nutzer es leichter finden. 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 Wiedergabe verbessern lassen. Sie können diese Vorschläge abrufen, indem Sie in Ihrer videos.list() -Anfrage den Teil suggestions anfordern. |
processingDetails.thumbnailsAvailability |
string Dieser Wert gibt an, ob für das Video Miniaturansichten generiert wurden. |
suggestions |
object Das suggestions -Objekt enthält Vorschläge, wie die Videoqualität oder die Metadaten für das hochgeladene Video verbessert werden können. Diese Daten können nur vom Rechteinhaber des Videos abgerufen werden. Das suggestions -Objekt wird nur zurückgegeben, wenn die Property processingDetails.tagSuggestionsAvailability oder die Property processingDetails.editorSuggestionsAvailability den Wert available hat. |
suggestions.processingErrors[] |
list Eine Liste der Fehler, die verhindern, dass YouTube das hochgeladene Video verarbeiten kann. Diese Fehler weisen darauf hin, dass der Status des Videos unabhängig vom aktuellen Verarbeitungsstatus mit ziemlicher Sicherheit failed sein wird.Gültige Werte für dieses Attribut sind:
|
suggestions.processingWarnings[] |
list Eine Liste von Gründen, warum bei YouTube Probleme beim Transcodieren des hochgeladenen Videos auftreten können oder die zu einer fehlerhaften Transcodierung führen können. Diese Warnungen werden generiert, bevor YouTube die hochgeladene Videodatei tatsächlich verarbeitet. Außerdem werden Probleme erkannt, die nicht unbedingt darauf hinweisen, dass die Videoverarbeitung fehlschlägt, aber dennoch zu Problemen wie Synchronisationsproblemen, Videoartefakten oder einem fehlenden Audiotrack führen können. Gültige Werte für diese Property sind:
|
suggestions.processingHints[] |
list Eine Liste mit Vorschlägen, mit denen die Verarbeitung des Videos auf 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 dein Video finden, wenn sie auf YouTube suchen oder stöbern. |
suggestions.tagSuggestions[].tag |
string Das für das Video vorgeschlagene Keyword-Tag. |
suggestions.tagSuggestions[].categoryRestricts[] |
list Eine Reihe von Videokategorien, für die das Tag relevant ist. Anhand dieser Informationen können Sie passende Tag-Vorschläge basierend auf der Videokategorie anzeigen lassen, die der Uploader dem Video zugewiesen hat. Wenn keine Einschränkungen für das Keyword definiert sind, sind Tag-Vorschläge standardmäßig für alle Kategorien relevant. |
suggestions.editorSuggestions[] |
list Eine Liste von Videobearbeitungsaktionen, die die Videoqualität oder Wiedergabe des hochgeladenen Videos verbessern können. Gültige Werte für diese Property sind:
|
liveStreamingDetails |
object Das Objekt liveStreamingDetails enthält Metadaten zu einer Live-Videoübertragung. Das Objekt ist nur in einer video -Ressource vorhanden, wenn es sich bei dem Video um eine anstehende, laufende oder abgeschlossene Livestream-Übertragung 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 verfügbar, wenn die Übertragung gestartet wurde. |
liveStreamingDetails.actualEndTime |
datetime Die Uhrzeit, zu der 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 beginnen soll. Der Wert wird im ISO 8601-Format angegeben. |
liveStreamingDetails.scheduledEndTime |
datetime Die Uhrzeit, zu der die Übertragung enden soll. Der Wert wird im ISO 8601-Format angegeben. Wenn der Wert leer ist oder die Property nicht vorhanden ist, wird die Übertragung auf unbestimmte Zeit fortgesetzt. |
liveStreamingDetails.concurrentViewers |
unsigned long Die Anzahl der Zuschauer, die sich die Übertragung gerade ansehen. Die Property und ihr Wert sind vorhanden, wenn die Übertragung aktuelle Zuschauer hat und der Inhaber der Übertragung die Aufrufzahlen für das Video nicht ausgeblendet hat. Die Anzahl der gleichzeitigen Zuschauer wird von YouTube nicht mehr erfasst, wenn die Übertragung beendet ist. Mit dieser Property wird also nicht die Anzahl der Zuschauer ermittelt, die sich ein archiviertes Video einer bereits beendeten Live-Übertragung ansehen. Die Anzahl der gleichzeitigen Zuschauer, die über die YouTube Data API zurückgegeben wird, kann von der Anzahl der verarbeiteten, von Spam befreiten gleichzeitigen Zuschauer abweichen, die über YouTube Analytics verfügbar ist. Weitere Informationen zu Messwerten für Livestreams findest du in der YouTube-Hilfe.
|
liveStreamingDetails.activeLiveChatId |
string Die ID des aktuell aktiven Livechats, der mit diesem Video verknüpft ist. Dieses Feld wird nur ausgefüllt, wenn 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 geschlossen. Bei dauerhaften Übertragungen ist die Livechat-ID nicht mehr mit diesem Video verknüpft, sondern mit dem neuen Video, das auf der dauerhaften Seite angezeigt wird. |
localizations |
object Das Objekt localizations enthält Übersetzungen der Metadaten des Videos. |
localizations.(key) |
object Die Sprache des lokalisierten Texts, der mit dem Schlüsselwert verknüpft ist. Der Wert ist ein String, der einen BCP-47-Sprachcode enthält. |
localizations.(key).title |
string Der Titel des lokalisierten Videos. |
localizations.(key).description |
string Die lokalisierte Videobeschreibung. |