Videos

Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
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:
  • Wenn ein Video als privates Video hochgeladen wird und die Videometadaten vom Kanalinhaber abgerufen werden, gibt der Property-Wert das Datum und die Uhrzeit des Uploads an.
  • Wenn ein Video als nicht gelistetes Video hochgeladen wird, gibt der Property-Wert auch Datum und Uhrzeit des Uploads an. In diesem Fall kann jeder, der die eindeutige Video-ID des Videos kennt, die Videometadaten abrufen.
Der Wert wird im ISO 8601-Format angegeben.
snippet.channelId string
Die ID, 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:
  • default: Das Standard-Thumbnail. Das Standard-Thumbnail für ein Video oder eine Ressource, die auf ein Video verweist, z. B. ein Playlist-Element oder ein Suchergebnis, ist 120 Pixel breit und 90 Pixel hoch. Das Standard-Thumbnail für einen Kanal ist 88 Pixel breit und 88 Pixel hoch.
  • medium: Eine Version der Miniaturansicht mit einer höheren Auflösung. Bei einem Video (oder einer Ressource, die sich auf ein Video bezieht) ist dieses Bild 320 Pixel breit und 180 Pixel hoch. Bei einem Kanal ist dieses Bild 240 Pixel breit und 240 Pixel hoch.
  • high: Eine hochauflösende Version der Miniaturansicht. Bei einem Video (oder einer Ressource, die sich auf ein Video bezieht) ist dieses Bild 480 Pixel breit und 360 Pixel hoch. Bei einem Kanal ist dieses Bild 800 Pixel breit und 800 Pixel hoch.
  • standard: Eine noch höhere Auflösung der Miniaturansicht als die Auflösung von high. Dieses Bild ist für einige Videos und andere Ressourcen verfügbar, die sich auf Videos beziehen, z. B. Playlist-Elemente oder Suchergebnisse. Dieses Bild ist 640 Pixel breit und 480 Pixel hoch.
  • maxres: Die Version mit der höchsten Auflösung der Miniaturansicht. Diese Bildgröße ist für einige Videos und andere Ressourcen verfügbar, die sich auf Videos beziehen, z. B. Playlist-Elemente oder Suchergebnisse. Dieses Bild ist 1.280 Pixel breit und 720 Pixel hoch.
snippet.thumbnails.(key).url string
Die 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:
  • Der Property-Wert ist eine Liste. Kommas zwischen den Elementen in der Liste werden auf das Limit angerechnet.
  • Wenn ein Tag ein Leerzeichen enthält, verarbeitet der API-Server den Tag-Wert so, als ob er in Anführungszeichen gesetzt ist, und die Anführungszeichen werden auf die Zeichenbeschränkung angerechnet. Bei Zeichenbeschränkungen enthält das Tag Foo-Baz also sieben Zeichen, das Tag Foo Baz jedoch neun Zeichen.
snippet.categoryId string
Die mit dem Video verknüpfte YouTube-Videokategorie Sie müssen einen Wert für 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:
  • live
  • none
  • upcoming
snippet.defaultLanguage string
Die Sprache des Textes in den Attributen snippet.title und snippet.description der Ressource video.
snippet.localized object
Das snippet.localized-Objekt enthält entweder einen lokalisierten Titel und eine Beschreibung für das Video oder den Titel in der Standardsprache für die Metadaten des Videos.
  • Lokalisierter Text wird im Ressourcen-Snippet zurückgegeben, wenn in der videos.list-Anfrage der Parameter hl verwendet wurde, um eine Sprache anzugeben, für die lokalisierter Text zurückgegeben werden soll, und lokalisierter Text in dieser Sprache verfügbar ist.
  • Metadaten für die Standardsprache werden zurückgegeben, wenn ein hl-Parameterwert nicht angegeben ist oder ein Wert angegeben ist, aber keine lokalisierten Metadaten für die angegebene Sprache verfügbar sind.
Die Property enthält einen schreibgeschützten Wert. Mit dem Objekt 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:
  • hd
  • sd
contentDetails.caption string
Gibt an, ob für das Video Untertitel verfügbar sind.

Für diese Property sind folgende Werte gültig:
  • false
  • true
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:
  • acbC: Programme, die von der Australian Communications and Media Authority mit C klassifiziert wurden. Diese Programme sind für Kinder (außer Vorschulkinder) gedacht, die jünger als 14 Jahre sind.
  • acbE–E
  • acbG – G
  • acbM–M
  • acbMa15plus–MA15+
  • acbP: Programme, die von der Australian Communications and Media Authority mit P klassifiziert wurden. Diese Programme sind für Kinder im Vorschulalter gedacht.
  • acbPg–PG
  • acbR18plus bis R18+
  • acbUnrated
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:
  • agcomT–T
  • agcomUnrated
  • agcomVm14 – VM14
  • agcomVm18 – VM18
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:
  • anatelA–A
  • anatelF–F
  • anatelI – I
  • anatelI10 – I-10
  • anatelI12 – I-12
  • anatelI7 – I-7
  • anatelR–R
  • anatelUnrated
contentDetails.contentRating.bbfcRating string
Bewertung der British Board of Film Classification (BBFC) für das Video.

Gültige Werte für diese Property sind:
  • bbfc12–12
  • bbfc12a–12 A
  • bbfc15–15
  • bbfc18–18
  • bbfcPg–PG
  • bbfcR18–R18
  • bbfcU–U
  • bbfcUnrated
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:
  • bfvc13–13
  • bfvc15–15
  • bfvc18–18
  • bfvc20–20
  • bfvcB–B
  • bfvcE–E
  • bfvcG – G
  • bfvcUnrated
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:
  • bmukk10–10+
  • bmukk12–12 Jahre
  • bmukk14–14+
  • bmukk16–16 Jahre
  • bmukk6 bis 6 Jahre
  • bmukk8 bis 8 Jahre
  • bmukkAa – Uneingeschränkt
  • bmukkUnrated
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:
  • catv14plus–14+
  • catv18plus–18+
  • catvC–C
  • catvC8–C8
  • catvG – G
  • catvPg–PG
  • catvUnrated
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:
  • catvfr13plus–13 Jahre
  • catvfr16plus–16 Jahre
  • catvfr18plus–18+
  • catvfr8plus bis 8 Jahre
  • catvfrG – G
  • catvfrUnrated
contentDetails.contentRating.cbfcRating string
Altersfreigabe des Central Board of Film Certification (CBFC – Indien)

Gültige Werte für diese Property:
  • cbfcA–A
  • cbfcS–S
  • cbfcU–U
  • cbfcUnrated
  • cbfcUA – k. A.
  • cbfcUA7plus – k. A.
  • cbfcUA13plus – k. A.
  • cbfcUA16plus – k. A.
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:
  • ccc14–14+
  • ccc18–18+
  • ccc18s–18 Jahre – contenido pornográfico
  • ccc18v bis 18 Jahre – contenido excesivamente gewalttätigo
  • ccc6–6 Jahre – ungünstige Beschreibung der 7 Años
  • cccTe – Todo-Espectador
  • cccUnrated
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:
  • cceM12–12
  • cceM14–14
  • cceM16–16
  • cceM18–18
  • cceM4–4
  • cceM6–6
  • cceUnrated
contentDetails.contentRating.chfilmRating string
Die Altersfreigabe des Videos in der Schweiz.

Für diese Property sind folgende Werte gültig:
  • chfilm0–0
  • chfilm12–12
  • chfilm16–16
  • chfilm18–18
  • chfilm6–6
  • chfilmUnrated
contentDetails.contentRating.chvrsRating string
Die Bewertung des Canadian Home Video Rating System (CHVRS) für das Video.

Gültige Werte für diese Property sind:
  • chvrs14a–14 A
  • chvrs18a–18 A
  • chvrsE–E
  • chvrsG – G
  • chvrsPg–PG
  • chvrsR–R
  • chvrsUnrated
contentDetails.contentRating.cicfRating string
Die Bewertung des Videos durch die Commission de Contrôle des Films (Belgien)

Gültige Werte für diese Property:
  • cicfE–E
  • cicfKntEna – KNT/ENA
  • cicfKtEa – KT/EA
  • cicfUnrated
contentDetails.contentRating.cnaRating string
Die Bewertung des Videos aus Rumänien CONSILIUL NATIONAL AL AUDIOVIZUALULUI (CNA).

Gültige Werte für diese Eigenschaft:
  • cna12–12
  • cna15–15
  • cna18–18
  • cna18plus–18+
  • cnaAp – AP
  • cnaUnrated
contentDetails.contentRating.cncRating string
Altersfreigabesystem in Frankreich – Commission de klassifizieren Cinematographique

Gültige Werte für diese Property:
  • cnc10–10
  • cnc12–12
  • cnc16–16
  • cnc18–18
  • cncE–E
  • cncT–T
  • cncUnrated
contentDetails.contentRating.csaRating string
Die Bewertung des Videos vom französischen Conseil-Supermarkt de l?audio
  • csa10–10
  • csa12–12
  • csa16–16
  • csa18–18
  • csaInterdiction – Interdiction
  • csaT–T
  • csaUnrated
  • 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:
    • cscf12–12
    • cscf16–16
    • cscf18–18
    • cscf6–6
    • cscf9–9
    • cscfA–A
    • cscfAl–AL
    • cscfUnrated
    contentDetails.contentRating.czfilmRating string
    Die Altersfreigabe des Videos in Tschechien.

    Für diese Property sind folgende Werte gültig:
    • czfilm12–12
    • czfilm14–14
    • czfilm18–18
    • czfilmU–U
    • czfilmUnrated
    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:
    • djctq10–10
    • djctq12–12
    • djctq14–14
    • djctq16–16
    • djctq18–18
    • djctqL–L
    • djctqUnrated
    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:
    • ecbmct13a–13 A
    • ecbmct13plus–13 Jahre
    • ecbmct15a–15 A
    • ecbmct15plus–15 Jahre
    • ecbmct18plus–18+
    • ecbmct7a–7 A
    • ecbmct7plus–7+
    • ecbmctG – G
    • ecbmctUnrated
    • ecbmct6a–6 A
    • ecbmct6plus bis 6 Jahre
    • ecbmct10a–10 A
    • ecbmct10plus–10+
    • ecbmct16plus–16 Jahre
    contentDetails.contentRating.eefilmRating string
    Die Altersfreigabe des Videos in Estland.

    Gültige Werte für diese Property sind:
    • eefilmK12 – Primar- und Sekundarstufe
    • eefilmK14–K-14
    • eefilmK16 bis 16. Klasse
    • eefilmK6–K-6
    • eefilmL–L
    • eefilmMs12–MS-12
    • eefilmMs6–MS-6
    • eefilmPere – Pere
    • eefilmUnrated
    contentDetails.contentRating.egfilmRating string
    Die Altersfreigabe des Videos in Ägypten.

    Gültige Werte für diese Property sind:
    • egfilm18–18
    • egfilmBn–BN
    • egfilmGn – GN
    • egfilmUnrated
    contentDetails.contentRating.eirinRating string
    Die Eirin-Bewertung (映倫) des Videos. Eirin ist das japanische Einstufungssystem.

    Für diese Unterkunft sind die folgenden Werte gültig:
    • eirinG – G
    • eirinPg12–PG-12
    • eirinR15plus bis R15+
    • eirinR18plus bis R18+
    • eirinUnrated
    contentDetails.contentRating.fcbmRating string
    Die Altersfreigabe des Videos vom Film Censorship Board von Malaysia.

    Für diese Property sind folgende Werte gültig:
    • fcbm18–18
    • fcbm18pa–18 PA
    • fcbm18pl–18 PL
    • fcbm18sg–18 SG
    • fcbm18sx–18 SX
    • fcbmP13–P13
    • fcbmPg13–PG13
    • fcbmU–U
    • fcbmUnrated
    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:
    • fcoI – I
    • fcoIi–II
    • fcoIia–IA
    • fcoIib–IIB
    • fcoIii–III
    • fcoUnrated
    contentDetails.contentRating.fmocRating string
    Diese Property wurde am 2. November 2015 eingestellt. Verwenden Sie stattdessen die Property contentDetails.contentRating.cncRating.

    Die Altersfreigabe des 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:
    • fmoc10–10
    • fmoc12–12
    • fmoc16–16
    • fmoc18–18
    • fmocE–E
    • fmocU–U
    • fmocUnrated
    contentDetails.contentRating.fpbRating string
    Die Bewertung des Videos vom südafrikanischen Film and Publication Board.

    Gültige Werte für diese Property sind:
    • fpb10–10
    • fpb1012Pg–10–12 PG
    • fpb13–13
    • fpb16–16
    • fpb18–18
    • fpb79Pg–7–9 PG
    • fpbA–A
    • fpbPg–PG
    • fpbUnrated
    • fpbX18–X18
    • fpbXx–XX
    contentDetails.contentRating.fpbRatingReasons[] list
    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:
    • fsk0 – FSK 0
    • fsk12 – FSK 12
    • fsk16 – FSK 16
    • fsk18 – FSK 18
    • fsk6 – FSK 6
    • fskUnrated
    contentDetails.contentRating.grfilmRating string
    Die Altersfreigabe des Videos in Griechenland.

    Gültige Werte für diese Property sind:
    • grfilmE–E
    • grfilmK–K
    • grfilmK12 – Primar- und Sekundarstufe
    • grfilmK13 bis K-13
    • grfilmK15 bis 15. Klasse
    • grfilmK17–K-17
    • grfilmK18–K-18
    • grfilmUnrated
    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:
    • icaa12–12
    • icaa13–13
    • icaa16–16
    • icaa18–18
    • icaa7–7
    • icaaApta – APTA
    • icaaUnrated
    • icaaX–X
    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:
    • ifco12–12
    • ifco12a–12 A
    • ifco15–15
    • ifco15a–15 A
    • ifco16–16
    • ifco18–18
    • ifcoG – G
    • ifcoPg–PG
    • ifcoUnrated
    contentDetails.contentRating.ilfilmRating string
    Die Altersfreigabe des Videos in Israel.

    Gültige Werte für diese Property sind:
    • ilfilm12–12
    • ilfilm16–16
    • ilfilm18–18
    • ilfilmAa–AA
    • ilfilmUnrated
    contentDetails.contentRating.incaaRating string
    Die Einstufung des Videos ist die INCAA (Instituto Nacional de Cine y Artes Audiovisuales, Argentinien).

    Für diese Property sind folgende Werte gültig:
    • incaaAtp: ATP (Apta para todo publico)
    • incaaC–X (Solo apta para mayores de 18 años, de exhibición condicionada)
    • incaaSam13–13 (Solo apta para mayores de 13 años)
    • incaaSam16–16 (Solo apta para mayores de 16 años)
    • incaaSam18–18 (Solo apta para mayores de 18 años)
    • incaaUnrated
    contentDetails.contentRating.kfcbRating string
    Die Bewertung des Videos vom Kenya Film Classification Board.

    Gültige Werte für diese Property sind:
    • kfcb16plus–16
    • kfcbG – GE
    • kfcbPg–PG
    • kfcbR–18
    • kfcbUnrated
    contentDetails.contentRating.kijkwijzerRating string
    voor de Classificatie van Audiovisuele Media (Niederlande)

    Gültige Werte für diese Property sind:
    • kijkwijzer12–12
    • kijkwijzer16–16
    • kijkwijzer18–18
    • kijkwijzer6–6
    • kijkwijzer9–9
    • kijkwijzerAl–AL
    • kijkwijzerUnrated
    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:
    • kmrb12plus – 12 스상 관람苯
    • kmrb15plus–15 電상 관람া
    • kmrbAll – 촴관람ল
    • kmrbR – 청소년 관람불香
    • kmrbTeenr
    • kmrbUnrated
    contentDetails.contentRating.lsfRating string
    Die Bewertung des Videos aus dem indonesischen Lembaga-Sensorfilm.

    Für diese Property sind folgende Werte gültig:
    • lsf13–13
    • lsf17–17
    • lsf21–21
    • lsfA–A
    • lsfBo – BO
    • lsfD–D
    • lsfR–R
    • lsfSu–SU
    • lsfUnrated
    contentDetails.contentRating.mccaaRating string
    Die Bewertung des Videos vom Malta Film Age Classification Board.

    Für diese Property sind folgende Werte gültig:
    • mccaa12–12
    • mccaa12a–12 A
    • mccaa14 – 14: Diese Bewertung wurde aus der 2013 eingeführten neuen Klassifizierungsstruktur entfernt.
    • mccaa15–15
    • mccaa16 – 16: Diese Bewertung wurde aus der 2013 eingeführten neuen Klassifizierungsstruktur entfernt.
    • mccaa18–18
    • mccaaPg–PG
    • mccaaU–U
    • mccaaUnrated
    contentDetails.contentRating.mccypRating string
    Die Bewertung des Media Council for Children and Young People des Dänischen Filminstituts (Det Danske Filminstitut)

    Die gültigen Werte für diese Property sind:
    • mccyp11–11
    • mccyp15–15
    • mccyp7–7
    • mccypA–A
    • mccypUnrated
    contentDetails.contentRating.mcstRating string
    Das Bewertungssystem des Videos für Vietnam – MCST

    Für diese Property sind folgende Werte gültig:
    • mcst0–0
    • mcst16plus–16 Jahre
    • mcstC13–C13
    • mcstC16–C16
    • mcstC18–C18
    • mcstP–P
    • mcstUnrated
    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:
    • mdaG – G
    • mdaM18–M18
    • mdaNc16–NC16
    • mdaPg–PG
    • mdaPg13–PG13
    • mdaR21–R21
    • mdaUnrated
    contentDetails.contentRating.medietilsynetRating string
    Die Bewertung des Videos von Medietilsynet, der norwegischen Medienagentur.

    Für diese Property sind folgende Werte gültig:
    • medietilsynet11–11
    • medietilsynet12–12
    • medietilsynet15–15
    • medietilsynet18–18
    • medietilsynet6–6
    • medietilsynet7–7
    • medietilsynet9–9
    • medietilsynetA–A
    • medietilsynetUnrated
    contentDetails.contentRating.mekuRating string
    Die Altersfreigabe des Videos vom finnischen Kansallinen Audiovisuaalinen Instituutti (National Audiovisual Institute)

    Gültige Werte für diese Property:
    • meku12–12
    • meku16–16
    • meku18–18
    • meku7–7
    • mekuS–S
    • mekuUnrated
    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:
    • mibacT
    • mibacUnrated
    • mibacVap
    • mibacVm6
    • mibacVm12
    • mibacVm14
    • mibacVm18
    contentDetails.contentRating.mocRating string
    Die Altersfreigabe des Ministerio de Cultura (Kolumbien)

    Für diese Property sind folgende Werte gültig:
    • moc12–12
    • moc15–15
    • moc18–18
    • moc7–7
    • mocBanned – verboten
    • mocE–E
    • mocT–T
    • mocUnrated
    • mocX–X
    contentDetails.contentRating.moctwRating string
    Die Bewertung des taiwanesischen Ministeriums für Kultur (文化部)

    Gültige Werte für diese Property:
    • moctwG – G
    • moctwP–P
    • moctwPg–PG
    • moctwR–R
    • moctwR12 – R-12
    • moctwR15 – R-15
    • moctwUnrated
    contentDetails.contentRating.mpaaRating string
    Die Motion Picture Association of America (MPAA)-Bewertung des Videos.

    Für diese Property sind folgende Werte gültig:
    • mpaaG – G
    • mpaaNc17–NC-17
    • mpaaPg–PG
    • mpaaPg13–PG-13
    • mpaaR–R
    • mpaaUnrated
    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:
    • mpaatGb – GB (grünes Band – für alle Zielgruppen genehmigt)
    • mpaatRb: RB (rotes Armband für Kinder ab 17 Jahren empfohlen)
    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:
    • mtrcbG – G
    • mtrcbPg–PG
    • mtrcbR13–R13
    • mtrcbR16–R16
    • mtrcbR18–R8
    • mtrcbUnrated
    • mtrcbX–X
    contentDetails.contentRating.nbcRating string
    Die Bewertung des Videos vom Maldives National Bureau of Classification.

    Für diese Property sind folgende Werte gültig:
    • nbc12plus–12 Jahre
    • nbc15plus–15 Jahre
    • nbc18plus–18+
    • nbc18plusr–18+R
    • nbcG – G
    • nbcPg–PG
    • nbcPu – PU
    • nbcUnrated
    contentDetails.contentRating.nfrcRating string
    Die Bewertung des Videos vom Bulgarischen Nationalen Filmzentrum.

    Gültige Werte für diese Unterkunft sind:
    • nfrcA–A
    • nfrcB–B
    • nfrcC–C
    • nfrcD–D
    • nfrcUnrated
    • nfrcX–X
    contentDetails.contentRating.nfvcbRating string
    Die Bewertung des Videos von Nigerias National Film and Video Censors Board.

    Gültige Werte für diese Property sind:
    • nfvcb12–12
    • nfvcb12a–12 A
    • nfvcb15–15
    • nfvcb18–18
    • nfvcbG – G
    • nfvcbPg–PG
    • nfvcbRe – RE
    • nfvcbUnrated
    contentDetails.contentRating.nkclvRating string
    Die Bewertung des Videos stammt vom Nacionãlais Kino Center (Lettland)

    Gültige Werte für diese Unterkunft:
    • nkclv12plus–12 Jahre
    • nkclv18plus–18+
    • nkclv7plus–7+
    • nkclvU–U
    • nkclvUnrated
    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:
    • oflcG – G
    • oflcM–M
    • oflcPg–PG
    • oflcR13–R13
    • oflcR15–15 R
    • oflcR16–R16
    • oflcR18–R18
    • oflcRp13 – RP13
    • oflcRp16 – RP16
    • oflcUnrated
    contentDetails.contentRating.pefilmRating string
    Die Altersfreigabe des Videos in Peru.

    Gültige Werte für diese Property sind:
    • pefilm14–14
    • pefilm18–18
    • pefilmPg–PG
    • pefilmPt bis PT
    • pefilmUnrated
    contentDetails.contentRating.resorteviolenciaRating string
    Die Altersfreigabe des Videos in Venezuela.

    Gültige Werte für diese Property sind:
    • resorteviolenciaA–A
    • resorteviolenciaB–B
    • resorteviolenciaC–C
    • resorteviolenciaD–D
    • resorteviolenciaE–E
    • resorteviolenciaUnrated
    contentDetails.contentRating.rtcRating string
    Die Altersfreigabe des General Directorate of Radio, Television and Cinematography (Mexiko)

    Die gültigen Werte für diese Property sind:
    • rtcA–A
    • rtcAa–AA
    • rtcB–B
    • rtcB15–B15
    • rtcC–C
    • rtcD–D
    • rtcUnrated
    contentDetails.contentRating.rteRating string
    Die Bewertung des Videos vom irischen Raidió Teilifís Éireann.

    Gültige Werte für diese Property sind:
    • rteCh–CH
    • rteGa – GA
    • rteMa–MA
    • rtePs – PS
    • rteUnrated
    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:
    • russia0–0+
    • russia12–12 Jahre
    • russia16–16 Jahre
    • russia18–18+
    • russia6 bis 6 Jahre
    • russiaUnrated
    contentDetails.contentRating.skfilmRating string
    Die Bewertung des Videos in der Slowakei.

    Für diese Property sind folgende Werte gültig:
    • skfilmG – G
    • skfilmP2–P2
    • skfilmP5–P5
    • skfilmP8–P8
    • skfilmUnrated
    contentDetails.contentRating.smaisRating string
    Die Altersfreigabe des Videos in Island.

    Gültige Werte für diese Property sind:
    • smais12–12
    • smais14–14
    • smais16–16
    • smais18–18
    • smais7–7
    • smaisL–L
    • smaisUnrated
    contentDetails.contentRating.smsaRating string
    Die Bewertung des Videos von Statens medieråd (Schwedens nationalem Medienrat)

    Gültige Werte für diese Property:
    • smsa11–11
    • smsa15–15
    • smsa7–7
    • smsaA – Alle Altersgruppen
    • smsaUnrated
    contentDetails.contentRating.tvpgRating string
    Die Altersfreigabe der TV Parental Guidelines (TVPG) des Videos.

    Gültige Werte für diese Property:
    • tvpgG – TV-G
    • tvpgMa – TV-MA
    • tvpgPg – TV-PG
    • tvpgUnrated
    • tvpgY – TV-Y
    • tvpgY7 – TV-Y7
    • tvpgY7Fv – TV-Y7-FV
    • pg14 – TV-14
    contentDetails.contentRating.ytRating string
    Eine Bewertung, die YouTube verwendet, um Inhalte mit Altersbeschränkung zu identifizieren.

    Gültige Werte für diese Property sind:
    • ytAgeRestricted
    contentDetails.projection string
    Gibt das Projektionsformat des Videos an.

    Gültige Werte für dieses Attribut sind:
    • 360
    • rectangular
    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:
    • deleted
    • failed
    • processed
    • rejected
    • uploaded
    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:
    • codec
    • conversion
    • emptyFile
    • invalidFile
    • tooSmall
    • uploadAborted
    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:
    • claim
    • copyright
    • duplicate
    • inappropriate
    • legal
    • length
    • termsOfUse
    • trademark
    • uploaderAccountClosed
    • uploaderAccountSuspended
    status.privacyStatus string
    Der Datenschutzstatus des Videos.

    Gültige Werte für diese Property sind:
    • private
    • public
    • unlisted
    status.publishAt datetime
    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:
    • Wenn du den Wert dieser Eigenschaft beim Aufrufen der Methode videos.update festlegst, musst du auch den Wert der Eigenschaft status.privacyStatus auf private setzen, auch wenn das Video bereits privat ist.
    • Wenn in deiner Anfrage die Veröffentlichung eines Videos zu einem früheren Zeitpunkt geplant ist, wird es sofort veröffentlicht. Daher hat das Einstellen der Eigenschaft status.publishAt auf ein früheres Datum und eine vergangene Zeit dieselbe Wirkung wie das Ändern der privacyStatus des Videos von private zu public.
    status.license string
    Die Lizenz des Videos.

    Gültige Werte für diese Property sind:
    • creativeCommon
    • youtube
    status.embeddable boolean
    Dieser Wert gibt an, ob das Video auf einer anderen Website eingebettet werden kann.
    status.publicStatsViewable boolean
    Dieser Wert gibt an, ob die erweiterten Videostatistiken auf der Wiedergabeseite ö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.
    • Wenn die API-Anfrage zum Abrufen der Ressource einen Wert für die Parameter maxHeight und/oder maxWidth angibt, wird die Größe des eingebetteten Players so angepasst, dass die Anforderungen maxHeight und/oder maxWidth erfüllt sind.
    • Wenn das Seitenverhältnis des Videos unbekannt ist, verwendet der eingebettete Player standardmäßig ein 4:3-Format.
    player.embedHeight long
    Die Höhe des eingebetteten Players, 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:
    • archive: Die Datei ist eine Archivdatei, z. B. ein ZIP-Archiv.
    • audio: Die Datei ist ein bekannter Audiodateityp, z. B. eine MP3-Datei.
    • document: Die Datei ist ein Dokument oder eine Textdatei, z. B. ein MS Word-Dokument.
    • image: Die Datei ist eine Bilddatei, z. B. ein JPEG-Bild.
    • other: Die Datei ist ein anderer Dateityp.
    • project: Die Datei ist eine Videoprojektdatei, die keine tatsächlichen Videodaten enthält, z. B. ein Microsoft Windows Movie Maker-Projekt.
    • video: Die Datei ist ein bekannter Videodateityp, z. B. eine MP4-Datei.
    fileDetails.container string
    Das Containerformat der hochgeladenen Videodatei.
    fileDetails.videoStreams[] list
    Eine Liste der Videostreams, 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:
    • clockwise: Das Video muss um 90 Grad im Uhrzeigersinn gedreht werden.
    • counterClockwise: Das Video muss um 90 Grad gegen den Uhrzeigersinn gedreht werden.
    • none: Das Video muss nicht gedreht werden.
    • other: Das Video muss auf andere Weise gedreht werden.
    • upsideDown: Das Video muss auf dem Kopf gedreht werden.
    fileDetails.videoStreams[].vendor string
    Ein Wert, der einen Videoanbieter eindeutig identifiziert. In der Regel ist der Wert ein aus vier Buchstaben bestehender Anbietercode.
    fileDetails.audioStreams[] list
    Eine Liste der Audiostreams, 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:
    • Nur Datum: YYYY-MM-DD
    • Naive Time: YYYY-MM-DDTHH:MM:SS
    • Uhrzeit mit Zeitzone: YYYY-MM-DDTHH:MM:SS+HH:MM
    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:
    • failed: Die Videoverarbeitung ist fehlgeschlagen. Siehe „ProcessingFailureReason“.
    • processing: Das Video wird gerade verarbeitet. Siehe Verarbeitungsfortschritt.
    • succeeded: Das Video wurde verarbeitet.
    • terminated: Die Informationen zur Verarbeitung sind nicht mehr verfügbar.
    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:
    • other: Eine andere Verarbeitungskomponente ist fehlgeschlagen.
    • streamingFailed: Das Video konnte nicht an Streamer gesendet werden.
    • transcodeFailed: Die Transcodierung der Inhalte ist fehlgeschlagen.
    • uploadFailed: Die Datei konnte nicht zugestellt werden.
    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:
    • archiveFile: Eine Archivdatei (z.B. ein ZIP-Archiv).
    • audioFile: Die Datei enthält nur Audiodateien (z.B. eine MP3-Datei).
    • docFile: Dokument oder Textdatei (z.B. MS Word-Dokument).
    • imageFile: Bilddatei (z.B. ein JPEG-Bild).
    • notAVideoFile – Andere Nicht-Videodatei.
    • projectFile – Filmprojektdatei (z.B. Microsoft Windows Movie Maker-Projekt).
    suggestions.processingWarnings[] list
    Eine Liste 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:
    • hasEditlist: Bearbeitungslisten werden derzeit nicht unterstützt.
    • inconsistentResolution: In Konflikt stehende Container- und Streamauflösungen.
    • problematicAudioCodec: Der Audio-Codec, der bekanntermaßen Probleme verursacht, wurde verwendet.
    • problematicVideoCodec: Der Video-Codec, der bekanntermaßen Probleme verursacht, wurde verwendet.
    • unknownAudioCodec: Der Audio-Codec wurde nicht erkannt. Die Transcodierung schlägt wahrscheinlich fehl.
    • unknownContainer: Das Dateiformat wurde nicht erkannt. Die Transcodierung schlägt wahrscheinlich fehl.
    • unknownVideoCodec: Der Video-Codec wurde nicht erkannt. Die Transcodierung schlägt wahrscheinlich fehl.
    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:
    • nonStreamableMov: Die MP4-Datei kann nicht gestreamt werden. Dadurch wird die Verarbeitung verlangsamt.
    • sendBestQualityVideo: Wahrscheinlich gibt es eine bessere Version des Videos.
    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:
    • audioQuietAudioSwap: Der Titel ist stumm und kann durch einen Audiotrack mit besserer Qualität ersetzt werden.
    • videoAutoLevels: Die Helligkeit des Bildes scheint deaktiviert und könnte korrigiert werden.
    • videoCrop: Ränder (matte) um das Bild herum können zugeschnitten werden.
    • videoStabilize: Das Video ist verwackelt und kann stabilisiert werden.
    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