Videos

Alle Videos, die über den Endpunkt videos.insert aus nicht bestätigten API-Projekten hochgeladen wurden, die nach dem 28. Juli 2020 erstellt wurden, können nur noch privat angesehen werden. Damit diese Einschränkung aufgehoben werden kann, muss jedes API-Projekt einer Prüfung unterzogen werden, um die Einhaltung der Nutzungsbedingungen zu überprüfen. 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
Ladet 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
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 sind die Eigenschaften aufgeführt, 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 die Zeit angegeben, zu der das Video veröffentlicht wurde.

Es gibt einige Sonderfälle:
  • Wenn ein Video als privates Video hochgeladen wird und die Videometadaten vom Kanalinhaber abgerufen werden, gibt der Property-Wert das Datum und die Uhrzeit an, zu dem das Video hochgeladen wurde.
  • Wenn ein Video als nicht gelistetes Video hochgeladen wird, enthält der Property-Wert auch das Datum und die Uhrzeit, zu dem das Video hochgeladen wurde. 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, 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 den Thumbnail-Bildern, 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:
  • default – das Standard-Thumbnail-Bild. Die Standardminiaturansicht für ein Video oder eine Ressource, die sich auf ein Video bezieht, z. B. ein Playlist-Element oder ein Suchergebnis, ist 120 Pixel breit und 90 Pixel hoch. Das Standard-Thumbnail für einen Kanal ist 88 Pixel breit und 88 Pixel hoch.
  • medium – Eine Version des Thumbnails mit höherer Auflösung. Bei einem Video (oder einer Ressource, die sich auf ein Video bezieht) ist dieses Bild 320 Pixel breit und 180 Pixel hoch. Bei einem Kanal ist dieses Bild 240 Pixel breit und 240 Pixel hoch.
  • high – eine hochauflösende Version des Thumbnail-Bilds. 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 Version des Thumbnails mit einer noch höheren Auflösung als das Bild mit high Pixeln. 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 des Thumbnails mit der höchsten Auflösung. 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 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:
  • Der Property-Wert ist eine Liste. Kommas zwischen den Elementen in der Liste werden auf das Limit angerechnet.
  • Wenn ein Tag einen Leerraum enthält, behandelt der API-Server den Tag-Wert so, als wäre er in Anführungszeichen gesetzt. Die Anführungszeichen werden auf die Zeichenbeschränkung angerechnet. Unter Berücksichtigung der Zeichenbeschränkung enthält das Tag Foo-Baz also sieben Zeichen, das Tag Foo Baz hingegen neun.
snippet.categoryId string
Die mit dem Video verknüpfte YouTube-Videokategorie. Sie müssen einen Wert für dieses Attribut festlegen, wenn Sie die Methode videos.update aufrufen und den snippet-Teil einer video-Ressource aktualisieren.
snippet.liveBroadcastContent string
Gibt an, ob es sich bei dem Video um eine anstehende/aktive Livestream-Ü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:
  • live
  • none
  • upcoming
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.
  • Lokalisierter Text wird im Ressourcen-Snippet zurückgegeben, wenn in der videos.list-Anfrage mit dem Parameter hl eine Sprache angegeben wurde, für die lokalisierter Text zurückgegeben werden soll und lokalisierter Text in dieser Sprache verfügbar ist.
  • Metadaten für die Standardsprache werden zurückgegeben, wenn kein hl-Parameterwert angegeben 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
Das Attribut default_audio_language gibt die Sprache an, die im Standard-Audiotrack des Videos gesprochen wird.
contentDetails object
Das contentDetails-Objekt enthält Informationen zum Videoinhalt, einschließlich der Länge des Videos und einer Angabe dazu, ob Untertitel für das Video verfügbar sind.
contentDetails.duration string
Die Länge des Videos. Der Property-Wert ist eine Dauer im ISO 8601-Format. 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:
  • hd
  • sd
contentDetails.caption string
Gibt an, ob für das Video Untertitel verfügbar sind.

Gültige Werte für diese Property sind:
  • false
  • true
contentDetails.licensedContent boolean
Gibt an, ob 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 die Länder angeben, in denen das Video blockiert 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 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 verwendet, um Kinderfernsehprogramme zu klassifizieren.

Gültige Werte für diese Property sind:
  • acbC – Sendungen, die von der Australian Communications and Media Authority die Einstufung C erhalten haben. Diese Sendungen sind für Kinder (keine Vorschulkinder) vorgesehen, die jünger als 14 Jahre sind.
  • acbE – E
  • acbG – G
  • acbM – M
  • acbMa15plus – MA15+
  • acbP – Sendungen, die von der Australian Communications and Media Authority die Einstufung P erhalten haben. Diese Programme sind für Vorschulkinder vorgesehen.
  • acbPg – PG
  • acbR18plus – R18+
  • acbUnrated
contentDetails.contentRating.agcomRating string
Altersfreigabe des Videos durch die italienische Autorità per le Garanzie nelle Comunicazioni (AGCOM).

Gültige Werte für dieses Attribut sind:
  • agcomT – T
  • agcomUnrated
  • agcomVm14 – VM14
  • agcomVm18 – VM18
contentDetails.contentRating.anatelRating string
Die Altersfreigabe der chilenischen Fernsehbehörde Anatel (Asociación Nacional de Televisión) für das Video.

Gültige Werte für diese Property sind:
  • anatelA – A
  • anatelF – F
  • anatelI – I
  • anatelI10 – I-10
  • anatelI12 – I-12
  • anatelI7 – I-7
  • anatelR – R
  • anatelUnrated
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:
  • bbfc12 – 12
  • bbfc12a – 12A
  • bbfc15 – 15
  • bbfc18 – 18
  • bbfcPg – PG
  • bbfcR18 – R18
  • bbfcU – U
  • bbfcUnrated
contentDetails.contentRating.bfvcRating string
Altersfreigabe des Videos durch die thailändische Film- und Videozensurbehörde.

Gültige Werte für diese Property sind:
  • bfvc13 – 13
  • bfvc15 – 15
  • bfvc18 – 18
  • bfvc20 – 20
  • bfvcB – B
  • bfvcE – E
  • bfvcG – G
  • bfvcUnrated
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:
  • bmukk10 – 10 oder mehr
  • bmukk12 – 12 Jahre und älter
  • bmukk14 – 14 Jahre und älter
  • bmukk16 – 16 Jahre und älter
  • bmukk6 – 6+
  • bmukk8 – 8 Jahre und älter
  • bmukkAa – uneingeschränkt
  • bmukkUnrated
contentDetails.contentRating.catvRating string
Altersfreigabe für kanadisches Fernsehen – Canadian TV Classification System: Altersfreigabe des kanadischen Radio-, Fernseh- und Fernmeldeausschusses (Canadian Radio-Television and Telecommunications Commission, CRTC) für englischsprachige Sendungen in Kanada. Weitere Informationen finden Sie auf der Website des Canadian Broadcast Standards Council.

Gültige Werte für dieses Attribut sind:
  • catv14plus – 14 Jahre und älter
  • catv18plus – 18 Jahre oder älter
  • catvC – C
  • catvC8 – C8
  • catvG – G
  • catvPg – PG
  • catvUnrated
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 finden Sie auf der Website des Canadian Broadcast Standards Council.

Gültige Werte für dieses Attribut sind:
  • catvfr13plus – 13 Jahre und älter
  • catvfr16plus – 16 Jahre und älter
  • catvfr18plus – 18 Jahre oder älter
  • catvfr8plus – 8 Jahre und älter
  • catvfrG – G
  • catvfrUnrated
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:
  • cbfcA – A
  • cbfcS – S
  • cbfcU – U
  • cbfcUnrated
  • cbfcUA – U/A
  • cbfcUA7plus – U/A
  • cbfcUA13plus – U/A
  • cbfcUA16plus – U/A
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:
  • ccc14 – 14 Jahre und älter
  • ccc18 – 18 Jahre oder älter
  • ccc18s – 18 Jahre und älter – contenido pornográfico
  • ccc18v – 18+ - contenido excesivamente violento
  • ccc6 – 6+ - Inconveniente para menores de 7 años
  • cccTe – Todo espectador
  • cccUnrated
contentDetails.contentRating.cceRating string
Die Altersfreigabe des Videos durch die Comissão de Classificação de Espectáculos in Portugal.

Gültige Werte für diese Property sind:
  • cceM12 – 12
  • cceM14 – 14
  • cceM16 – 16
  • cceM18 – 18
  • cceM4 – 4
  • cceM6 – 6
  • cceUnrated
contentDetails.contentRating.chfilmRating string
Altersfreigabe des Videos in der Schweiz.

Gültige Werte für dieses Attribut sind:
  • chfilm0 – 0
  • chfilm12 – 12
  • chfilm16 – 16
  • chfilm18 – 18
  • chfilm6 – 6
  • chfilmUnrated
contentDetails.contentRating.chvrsRating string
Die Altersfreigabe des Canadian Home Video Rating System (CHVRS) für das Video.

Gültige Werte für diese Property sind:
  • chvrs14a – 14A
  • chvrs18a – 18A
  • chvrsE – E
  • chvrsG – G
  • chvrsPg – PG
  • chvrsR – R
  • chvrsUnrated
contentDetails.contentRating.cicfRating string
Altersfreigabe 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 Altersfreigabe des rumänischen CONSILIUL NATIONAL AL AUDIOVIZUALULUI (CNA) für das Video.

Gültige Werte für diese Property sind:
  • cna12 – 12
  • cna15 – 15
  • cna18 – 18
  • cna18plus – 18 Jahre oder älter
  • cnaAp – ZP
  • cnaUnrated
contentDetails.contentRating.cncRating string
Altersfreigabesystem in Frankreich – Commission de classification cinématographique

Zulässige Werte für diese Property:
  • cnc10 – 10
  • cnc12 – 12
  • cnc16 – 16
  • cnc18 – 18
  • cncE – E
  • cncT – T
  • cncUnrated
contentDetails.contentRating.csaRating string
Altersfreigabe des französischen Conseil supérieur de l'audiovisuel für das Video.

Gültige Werte für diese Property sind:
  • csa10 – 10
  • csa12 – 12
  • csa16 – 16
  • csa18 – 18
  • csaInterdiction – Interdiction
  • csaT – T
  • csaUnrated
contentDetails.contentRating.cscfRating string
Altersfreigabe des Videos durch die Commission de surveillance de la classification des films (CSCF) in Luxemburg.

Gültige Werte für diese Property sind:
  • cscf12 – 12
  • cscf16 – 16
  • cscf18 – 18
  • cscf6 – 6
  • cscf9 – 9
  • cscfA – A
  • cscfAl – AL
  • cscfUnrated
contentDetails.contentRating.czfilmRating string
Altersfreigabe des Videos in der Tschechischen Republik.

Gültige Werte für dieses Attribut sind:
  • czfilm12 – 12
  • czfilm14 – 14
  • czfilm18 – 18
  • czfilmU – U
  • czfilmUnrated
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:
  • djctq10 – 10
  • djctq12 – 12
  • djctq14 – 14
  • djctq16 – 16
  • djctq18 – 18
  • djctqL – L
  • djctqUnrated
contentDetails.contentRating.djctqRatingReasons[] list
Gründe, die erklären, warum das Video die DJCQT-Altersfreigabe (Brasilien) erhalten hat.
contentDetails.contentRating.ecbmctRating string
Altersfreigabesystem in der Türkei – Bewertungs- und Klassifizierungsausschuss des Ministeriums für Kultur und Tourismus

Gültige Werte für diese Property sind:
  • ecbmct13a – 13A
  • ecbmct13plus – 13 Jahre und älter
  • ecbmct15a – 15 A
  • ecbmct15plus – 15 Jahre und älter
  • ecbmct18plus – 18 Jahre oder älter
  • ecbmct7a – 7A
  • ecbmct7plus – 7+
  • ecbmctG – G
  • ecbmctUnrated
  • ecbmct6a – 6A
  • ecbmct6plus – 6+
  • ecbmct10a – 10A
  • ecbmct10plus – 10 oder mehr
  • ecbmct16plus – 16 Jahre und älter
contentDetails.contentRating.eefilmRating string
Altersfreigabe des Videos in Estland.

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

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

Gültige Werte für diese Property sind:
  • eirinG – G
  • eirinPg12 – PG-12
  • eirinR15plus – R15+
  • eirinR18plus – R18+
  • eirinUnrated
contentDetails.contentRating.fcbmRating string
Die Altersfreigabe des Videos durch die Filmzensurbehörde von Malaysia.

Gültige Werte für diese Property sind:
  • fcbm13 – 13
  • fcbm16 – 16
  • fcbm18 – 18
  • fcbm18pa – 18PA
  • fcbm18pl – 18PL
  • fcbm18sg – 18SG
  • fcbm18sx – 18SX
  • fcbmP12 – P12
  • fcbmP13 – P13
  • fcbmPg13 – PG13
  • fcbmU – U
  • fcbmUnrated
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:
  • fcoI – I
  • fcoIi – II
  • fcoIia – IIA
  • 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 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:
  • fmoc10 – 10
  • fmoc12 – 12
  • fmoc16 – 16
  • fmoc18 – 18
  • fmocE – E
  • fmocU – U
  • fmocUnrated
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:
  • fpb10 – 10
  • fpb1012Pg – 10-12PG
  • fpb13 – 13
  • fpb16 – 16
  • fpb18 – 18
  • fpb79Pg – 7-9PG
  • fpbA – A
  • fpbPg – PG
  • fpbUnrated
  • fpbX18 – X18
  • fpbXx – XX
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:
  • fsk0 – FSK 0
  • fsk12 – FSK 12
  • fsk16 – FSK 16
  • fsk18 – FSK 18
  • fsk6 – FSK 6
  • fskUnrated
contentDetails.contentRating.grfilmRating string
Altersfreigabe des Videos in Griechenland.

Gültige Werte für dieses Attribut sind:
  • grfilmE – E
  • grfilmK – K
  • grfilmK12 – Primar- und Sekundarstufe
  • grfilmK13 – K-13
  • grfilmK15 – K-15
  • grfilmK17 – K-17
  • grfilmK18 – K-18
  • grfilmUnrated
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:
  • 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 (IFCO – Irland) für das Video. Weitere Informationen finden Sie auf der IFCO.

Gültige Werte für dieses Attribut sind:
  • ifco12 – 12
  • ifco12a – 12A
  • ifco15 – 15
  • ifco15a – 15 A
  • ifco16 – 16
  • ifco18 – 18
  • ifcoG – G
  • ifcoPg – PG
  • ifcoUnrated
contentDetails.contentRating.ilfilmRating string
Altersfreigabe des Videos in Israel.

Gültige Werte für dieses Attribut sind:
  • ilfilm12 – 12
  • ilfilm16 – 16
  • ilfilm18 – 18
  • ilfilmAa – AA
  • ilfilmUnrated
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:
  • 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 Altersfreigabe des Videos durch die 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).

Zulässige Werte für diese Property sind:
  • kijkwijzer12 – 12
  • kijkwijzer14 – 14
  • 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. Das KMRB ist für die Altersfreigabe von Videos in Südkorea zuständig.

Gültige Werte für dieses Attribut sind:
  • kmrb12plus – 12세 이상 관람가
  • kmrb15plus – 15세 이상 관람가
  • kmrbAll – 전체관람가
  • kmrbR – 청소년 관람불가
  • kmrbTeenr
  • kmrbUnrated
contentDetails.contentRating.lsfRating string
Die Altersfreigabe des Videos durch die indonesische Lembaga Sensor Film.

Gültige Werte für dieses Attribut sind:
  • lsf13 – 13
  • lsf17 – 17
  • lsf21 – 21
  • lsfA – A
  • lsfBo – BO
  • lsfD – D
  • lsfR – R
  • lsfSu – SU
  • lsfUnrated
contentDetails.contentRating.mccaaRating string
Altersfreigabe des Videos durch die Film Age-Classification Board von Malta.

Gültige Werte für diese Property sind:
  • mccaa12 – 12
  • mccaa12a – 12A
  • mccaa14 – 14 – diese Altersfreigabe wurde aus der neuen Klassifizierungsstruktur entfernt, die 2013 eingeführt wurde.
  • mccaa15 – 15
  • mccaa16 – 16 – diese Altersfreigabe wurde aus der neuen Klassifizierungsstruktur entfernt, die 2013 eingeführt wurde.
  • mccaa18 – 18
  • mccaaPg – PG
  • mccaaU – U
  • mccaaUnrated
contentDetails.contentRating.mccypRating string
Altersfreigabe des Videos durch den Media Council for Children and Young People des Dänischen Filminstituts (Det Danske Filminstitut).

Gültige Werte für diese Property sind:
  • mccyp11 – 11
  • mccyp15 – 15
  • mccyp7 – 7
  • mccypA – A
  • mccypUnrated
contentDetails.contentRating.mcstRating string
Altersfreigabe des Videos für Vietnam – MCST

Gültige Werte für dieses Attribut sind:
  • mcst0 – 0
  • mcst16plus – 16 Jahre und älter
  • mcstC13 – C13
  • mcstC16 – C16
  • mcstC18 – C18
  • mcstP – P
  • mcstUnrated
  • mcstT13 – T13
  • mcstT16 – T16
  • mcstT18 – T18
  • mcstK – K
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:
  • mdaG – G
  • mdaM18 – M18
  • mdaNc16 – NC16
  • mdaPg – PG
  • mdaPg13 – PG13
  • mdaR21 – R21
  • mdaUnrated
contentDetails.contentRating.medietilsynetRating string
Altersfreigabe des Videos von Medietilsynet, der norwegischen Medienaufsicht.

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

Gültige Werte für diese Property sind:
  • meku12 – 12
  • meku16 – 16
  • meku18 – 18
  • meku7 – 7
  • mekuS – S
  • mekuUnrated
contentDetails.contentRating.mibacRating string
Altersfreigabe des Videos durch das italienische Ministerium für Kulturgüter und Tourismus.

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 das Video.

Gültige Werte für diese Property sind:
  • moc12 – 12
  • moc15 – 15
  • moc18 – 18
  • moc7 – 7
  • mocBanned – gesperrt
  • mocE – E
  • mocT – T
  • mocUnrated
  • mocX – X
contentDetails.contentRating.moctwRating string
Die Altersfreigabe des taiwanischen Kulturministeriums (文化部) für das Video.

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

Gültige Werte für dieses Attribut sind:
  • mpaaG – G
  • mpaaNc17 – NC-17
  • mpaaPg – PG
  • mpaaPg13 – PG-13
  • mpaaR – R
  • mpaaUnrated
contentDetails.contentRating.mpaatRating string
Altersfreigabe der Motion Picture Association of America für Filmtrailer und -vorschau.

Gültige Werte für diese Property sind:
  • mpaatGb – Vereinigtes Königreich (grünes Band – für alle Altersgruppen geeignet)
  • mpaatRb – RB (Rote Kennzeichnung – empfohlen ab 17 Jahren)
contentDetails.contentRating.mtrcbRating string
Die Altersfreigabe des Videos durch die Movie and Television Review and Classification Board (Philippinen).

Gültige Werte für diese Property sind:
  • mtrcbG – G
  • mtrcbPg – PG
  • mtrcbR13 – R-13
  • mtrcbR16 – R-16
  • mtrcbR18 – R-18
  • mtrcbUnrated
  • mtrcbX – X
contentDetails.contentRating.nbcRating string
Altersfreigabe des Videos vom National Bureau of Classification der Malediven.

Gültige Werte für diese Property sind:
  • nbc12plus – 12 Jahre und älter
  • nbc15plus – 15 Jahre und älter
  • nbc18plus – 18 Jahre oder älter
  • nbc18plusr – 18+R
  • nbcG – G
  • nbcPg – PG
  • nbcPu – PU
  • nbcUnrated
contentDetails.contentRating.nfrcRating string
Die Altersfreigabe des Videos vom Bulgarischen Nationalen Filmzentrum.

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

Gültige Werte für dieses Attribut sind:
  • nfvcb12 – 12
  • nfvcb12a – 12A
  • nfvcb15 – 15
  • nfvcb18 – 18
  • nfvcbG – G
  • nfvcbPg – PG
  • nfvcbRe – RE
  • nfvcbUnrated
contentDetails.contentRating.nkclvRating string
Altersfreigabe des Videos vom Nacionãlais Kino centrs (Lettisches Nationales Filmzentrum).

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

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

Gültige Werte für dieses Attribut sind:
  • resorteviolenciaA – A
  • resorteviolenciaB – B
  • resorteviolenciaC – C
  • resorteviolenciaD – D
  • resorteviolenciaE – E
  • resorteviolenciaUnrated
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:
  • rtcA – A
  • rtcAa – AA
  • rtcB – B
  • rtcB15 – B15
  • rtcC – C
  • rtcD – D
  • rtcUnrated
contentDetails.contentRating.rteRating string
Die Altersfreigabe des Videos von Raidió Teilifís Éireann (RTE) in Irland.

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

Gültige Werte für dieses Attribut sind:
  • skfilmG – G
  • skfilmP2 – P2
  • skfilmP5 – P5
  • skfilmP8 – P8
  • skfilmUnrated
contentDetails.contentRating.smaisRating string
Altersfreigabe des Videos in Island.

Gültige Werte für dieses Attribut sind:
  • smais12 – 12
  • smais14 – 14
  • smais16 – 16
  • smais18 – 18
  • smais7 – 7
  • smaisL – L
  • smaisUnrated
contentDetails.contentRating.smsaRating string
Altersfreigabe des Videos durch Statens medieråd (Schwedischer Medienrat).

Gültige Werte für dieses Attribut sind:
  • smsa11 – 11
  • smsa15 – 15
  • smsa7 – 7
  • smsaA – Alle Altersgruppen
  • smsaUnrated
contentDetails.contentRating.tvpgRating string
Die Altersfreigabe des Videos gemäß den TV Parental Guidelines (TVPG).

Gültige Werte für dieses Attribut sind:
  • 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
Altersfreigabe, die von YouTube für Inhalte mit Altersbeschränkung verwendet wird.

Gültige Werte für dieses Attribut:
  • ytAgeRestricted
contentDetails.projection string
Gibt das Projektionsformat des Videos an.

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

Gültige Werte für dieses Attribut 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 außerdem Folgendes:
  • Wenn du den Wert dieser Property beim Aufrufen der videos.update-Methode festlegst, musst du auch den Wert der Property status.privacyStatus auf private setzen, auch wenn das Video bereits privat ist.
  • Wenn du in deinem Antrag die Veröffentlichung eines Videos in der Vergangenheit festlegst, wird es sofort veröffentlicht. Wenn du also das Datum und die Uhrzeit für die Property „status.publishAt“ auf ein Datum in der Vergangenheit festlegst, hat das denselben Effekt wie das Ändern des privacyStatus-Werts des Videos von private in public.
status.license string
Die Lizenz des Videos.

Gültige Werte für dieses Attribut sind:
  • creativeCommon
  • youtube
status.embeddable boolean
Dieser Wert gibt an, ob das Video auf einer anderen Website eingebettet werden kann.
status.publicStatsViewable boolean
Dieser Wert gibt an, ob die erweiterten Videostatistiken auf der Wiedergabeseite des Videos öffentlich sichtbar sind. 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 gesetzt 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 Inhalten mit Altersfreigabe

Beispiele für solche Inhalte sind Videos, in denen:
  • Wirkt, als ob eine echte Person darin etwas sagt oder tut, was sie nicht gesagt oder getan hat
  • veränderte Aufnahmen eines realen Ereignisses oder Orts enthalten
  • Es enthält eine realistisch anmutende Szene, die nicht wirklich stattgefunden hat.
statistics object
Das statistics-Objekt enthält Statistiken zum Video.
statistics.viewCount unsigned long

Gibt an, wie oft das Video aufgerufen wurde.

Ab dem 31. März 2025 entspricht die Anzahl der Aufrufe dann der Anzahl der Wiedergaben oder wiederholten Wiedergaben eines Shorts. Die Wiedergabezeit ist dabei unerheblich.
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:Dieses Attribut wird nicht mehr unterstützt. Die Einstellung erfolgt am 28. August 2015. Der Wert der Property 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 kannst.
player.embedHtml string
Ein <iframe>-Tag, das einen Player einbettet, über den das Video wiedergegeben wird.
  • Wenn in der API-Anfrage zum Abrufen der Ressource ein Wert für die Parameter maxHeight und/oder maxWidth angegeben ist, wird die Größe des eingebetteten Players so skaliert, dass die Anforderungen an maxHeight und/oder maxWidth erfüllt werden.
  • Wenn das Seitenverhältnis des Videos nicht bekannt ist, wird im eingebetteten Player standardmäßig das Format 4:3 verwendet.
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 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.
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 von Wikipedia-URLs, die eine allgemeine Beschreibung des Inhalts des Videos 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 Orts, an dem das Video aufgenommen 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 dem 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 die Property 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:
  • 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. eine JPEG-Datei.
  • other: Die Datei ist ein anderer Dateityp, der keine Videodatei ist.
  • project – Die Datei ist eine Videoprojektdatei, z. B. ein Microsoft Windows Movie Maker-Projekt, das keine Videodaten enthält.
  • 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 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 als 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 Videocodec, 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:
  • clockwise – Das Video muss um 90 Grad im Uhrzeigersinn gedreht werden.
  • counterClockwise – Das Video muss um 90 Grad gegen den Uhrzeigersinn gedreht werden.
  • none – Das Video muss nicht gedreht werden.
  • other – Das Video muss auf eine andere, nicht triviale Weise gedreht werden.
  • upsideDown – Das Video muss auf den Kopf gestellt werden.
fileDetails.videoStreams[].vendor string
Ein Wert, mit dem ein Videoanbieter eindeutig identifiziert wird. In der Regel ist der Wert ein vierstelliger 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 im Stream.
fileDetails.audioStreams[].codec string
Der Audio-Codec, der vom Stream verwendet wird.
fileDetails.audioStreams[].bitrateBps unsigned long
Die Bitrate des Audiostreams in Bit pro Sekunde.
fileDetails.audioStreams[].vendor string
Ein Wert, mit dem ein Videoanbieter eindeutig identifiziert wird. 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:
  • Nur Datum: YYYY-MM-DD
  • Naive Zeit: YYYY-MM-DDTHH:MM:SS
  • Uhrzeit mit Zeitzone: YYYY-MM-DDTHH:MM:SS+HH:MM
processingDetails object
Das processingDetails-Objekt enthält Informationen zum Fortschritt der Verarbeitung der hochgeladenen Videodatei auf YouTube. Die Eigenschaften im Objekt geben den aktuellen Verarbeitungsstatus und eine Schätzung der verbleibenden Zeit bis zur vollständigen Verarbeitung des Videos an. Außerdem wird hier angezeigt, ob verschiedene Daten- oder Inhaltstypen wie Dateidetails oder Thumbnail-Bilder für das Video verfügbar sind.

Das processingProgress-Objekt ist für Abfragen konzipiert, 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:
  • failed: Die Videoverarbeitung ist fehlgeschlagen. Siehe ProcessingFailureReason.
  • processing – Das Video wird gerade verarbeitet. Siehe ProcessingProgress.
  • succeeded – Das Video wurde erfolgreich verarbeitet.
  • terminated – Verarbeitungsinformationen sind nicht mehr verfügbar.
processingDetails.processingProgress object
Das processingProgress-Objekt enthält Informationen zum Fortschritt der Verarbeitung des Videos auf YouTube. 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. Die Zahl wird möglicherweise aktualisiert, wenn YouTube das Video verarbeitet.
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 zeitweise 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:
  • other – Eine andere Verarbeitungskomponente ist fehlgeschlagen.
  • streamingFailed – Das Video konnte nicht an die Streamer gesendet werden.
  • transcodeFailed – Die Transcodierung des Inhalts ist fehlgeschlagen.
  • uploadFailed – Die Dateiübermittlung ist fehlgeschlagen.
processingDetails.fileDetailsAvailability string
Dieser Wert gibt an, ob Dateidetails für das hochgeladene Video verfügbar sind. Du kannst die Dateidetails eines Videos abrufen, indem du in deiner videos.list()-Anfrage den Teil fileDetails 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 in Ihrer videos.list()-Anfrage den Teil suggestions 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 diese Property sind:
  • archiveFile – eine Archivdatei (z. B. ein ZIP-Archiv)
  • audioFile – Die Datei enthält nur Audioinhalte (z.B. eine MP3-Datei).
  • docFile – Dokument oder Textdatei (z.B. MS Word-Dokument).
  • imageFile – Bilddatei (z. B. JPEG-Bild)
  • notAVideoFile – Andere Datei, keine Videodatei.
  • projectFile – Filmprojektdatei (z.B. Microsoft Windows Movie Maker-Projekt).
suggestions.processingWarnings[] list
Eine Liste von Gründen, warum bei YouTube möglicherweise Probleme beim Transcodieren des hochgeladenen Videos auftreten oder eine fehlerhafte Transcodierung resultieren könnte. 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:
  • hasEditlist: Die Bearbeitung von Listen wird derzeit nicht unterstützt.
  • inconsistentResolution – In Konflikt stehende Container- und Streamauflösungen.
  • problematicAudioCodec – Es wurde ein Audiocodec verwendet, der bekanntermaßen Probleme verursacht.
  • problematicVideoCodec – Es wurde ein Video-Codec verwendet, der bekanntermaßen Probleme verursacht.
  • unknownAudioCodec – Unbekannter Audiocodec, die Transcodierung schlägt wahrscheinlich fehl.
  • unknownContainer – Unbekanntes Dateiformat, die Transcodierung wird wahrscheinlich fehlschlagen.
  • unknownVideoCodec – Unbekannter Videocodec, die Transcodierung schlägt wahrscheinlich fehl.
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:
  • nonStreamableMov – Die MP4-Datei kann nicht gestreamt werden, was die Verarbeitung verlangsamt.
  • sendBestQualityVideo – Es gibt wahrscheinlich eine Version des Videos in besserer Qualität.
suggestions.tagSuggestions[] list
Eine Liste von 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 oder beim Stöbern auf YouTube finden.
suggestions.tagSuggestions[].tag string
Das für das Video vorgeschlagene Keyword-Tag.
suggestions.tagSuggestions[].categoryRestricts[] list
Eine Reihe von Videokategorien, für die das Tag relevant ist. Anhand dieser Informationen können Sie passende Tag-Vorschläge basierend auf der Videokategorie anzeigen lassen, die der Uploader dem Video zugewiesen hat. Standardmäßig sind Tag-Vorschläge für alle Kategorien relevant, wenn für das Keyword keine Einschränkungen definiert sind.
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:
  • audioQuietAudioSwap: Der Audiotrack ist stumm und könnte durch einen Track mit besserer Qualität ersetzt werden.
  • videoAutoLevels – Die Bildhelligkeit scheint nicht korrekt zu sein und könnte korrigiert werden.
  • videoCrop – Ränder (Mattes), die um das Bild herum erkannt wurden, können zugeschnitten werden.
  • videoStabilize: Das Video ist verwackelt und könnte stabilisiert werden.
liveStreamingDetails object
Das liveStreamingDetails-Objekt 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-Ausstrahlung 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 aktuell 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 localizations-Objekt 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 lokalisierte Videotitel.
localizations.(key).description string
Die lokalisierte Videobeschreibung.