Videos

Alle Videos, die über den Endpunkt videos.insert in nicht bestätigten API-Projekten hochgeladen werden, die nach dem 28. Juli 2020 erstellt wurden, können nur privat angesehen werden. Um diese Einschränkung aufzuheben, muss jedes API-Projekt geprüft werden, um die Einhaltung der Nutzungsbedingungen zu bestätigen. Weitere Informationen finden Sie im Überarbeitungsverlauf der API.

Eine video-Ressource stellt ein YouTube-Video dar.

Methoden

Die API unterstützt die folgenden Methoden für videos-Ressourcen:

getRating
Ruft die Bewertungen ab, die der autorisierte Nutzer für eine Liste angegebener Videos abgegeben hat. Hier kannst du die Funktion ausprobieren.
list
Gibt eine Liste von Videos zurück, die den Parametern der API-Anfrage entsprechen. Hier kannst du die Funktion ausprobieren.
batchGetStats
Ruft eine Liste von Videostatistiken ab, die den Parametern der API-Anfrage entsprechen. Hier kannst du die Funktion ausprobieren.
insert
Lädt ein Video auf YouTube hoch und legt optional die Metadaten des Videos fest.
Aktualisierung
Aktualisiert die Metadaten eines Videos. Hier kannst du die Funktion ausprobieren.
Delete
Löscht ein YouTube-Video. Hier kannst du die Funktion ausprobieren.
rate [Steuersatz]
Ein Video mit „Mag ich“ oder „Mag ich nicht“ bewerten oder eine Bewertung aus einem Video entfernen. Hier kannst du die Funktion ausprobieren.
reportAbuse
Ein Video melden, das missbräuchliche Inhalte enthält. 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
  },
  "brandPartner": {
    "channelId": string,
    "channelHandle": string
  },
  "localizations": {
    (key): {
      "title": string,
      "description": string
    }
  }
}

Attribute

In der folgenden Tabelle werden die Attribute definiert, die in dieser Ressource enthalten sind:

Attribute
kind string
Gibt den Typ der API-Ressource an. Der Wert ist youtube#video.
etag etag
Das ETag dieser Ressource.
id string
Die ID, die YouTube zur eindeutigen Identifizierung des Videos verwendet.
snippet object
Das snippet-Objekt enthält grundlegende Details zum Video, z. B. Titel, Beschreibung und Kategorie.
snippet.publishedAt datetime
Das Datum und die Uhrzeit, zu der das Video veröffentlicht wurde. Diese Zeit kann sich von der Zeit unterscheiden, zu der das Video hochgeladen wurde. Wenn ein Video beispielsweise als privates Video hochgeladen und später veröffentlicht wird, gibt diese Eigenschaft den Zeitpunkt an, zu dem 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 Eigenschaftswert das Datum und die Uhrzeit an, zu der das Video hochgeladen wurde.
  • Wenn ein Video als nicht gelistetes Video hochgeladen wird, gibt der Attributwert auch das Datum und die Uhrzeit an, zu der das Video hochgeladen wurde. In diesem Fall kann jeder, der die eindeutige Video-ID kennt, die Videometadaten abrufen.
  • Wenn ein Video als Video nur für Mitglieder hochgeladen wird, gibt der Property-Wert das Datum und die Uhrzeit an, zu der das Video hochgeladen wurde.
Der Wert wird im ISO 8601-Format angegeben.
snippet.channelId string
Die ID, die YouTube verwendet, um den Kanal, auf den das Video hochgeladen wurde, eindeutig zu identifizieren. Dieser Wert kann sich im Laufe der Zeit ändern, z. B. wenn ein Video einem anderen Kanal zugewiesen wird (z. B. einem Themenkanal oder Künstlerkanal).
snippet.title string
Der Titel des Videos. Der Eigenschaftswert darf maximal 100 Zeichen lang sein und alle gültigen UTF-8-Zeichen mit Ausnahme von < und > enthalten. Sie müssen einen Wert für diese Eigenschaft festlegen, wenn Sie die Methode videos.update aufrufen und den Teil snippet einer video-Ressource aktualisieren.
snippet.description string
Die Beschreibung des Videos. Der Property-Wert darf maximal 5.000 Byte lang sein und alle gültigen UTF‑8-Zeichen mit Ausnahme von < und > enthalten.

Du kannst Videokapitel erstellen, indem du formatierte Zeitstempel (z. B. 00:00) in den Beschreibungstext einfügst.
snippet.thumbnails object
Eine Karte mit Thumbnail-Bildern, die dem Video zugeordnet sind. Für jedes Objekt auf der Karte ist der Schlüssel der Name des Vorschaubilds und der Wert ein Objekt, das weitere Informationen zum Vorschaubild enthält.
snippet.thumbnails.(key) object
Gültige Schlüsselwerte sind:
  • default: Das Standard-Thumbnail-Bild. Die Standard-Miniaturansicht 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 Channel 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 auf ein Video verweist) ist dieses Bild 320 Pixel breit und 180 Pixel hoch. Für einen Channel ist dieses Bild 240 Pixel breit und 240 Pixel hoch.
  • high – Eine Version des Thumbnail-Bilds mit hoher Auflösung. Bei einem Video (oder einer Ressource, die auf ein Video verweist) ist dieses Bild 480 Pixel breit und 360 Pixel hoch. Für einen Kanal ist dieses Bild 800 Pixel breit und 800 Pixel hoch.
  • standard: Eine noch höhere Auflösung des Thumbnail-Bilds als bei der high-Auflösung. 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 – Eine Version des Thumbnail-Bilds mit hoher 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.
  • fhd: Die Full HD-Version (1080p) des Vorschaubilds. Diese Bildgröße ist für einige Videos verfügbar. Dieses Bild ist 1.920 Pixel breit und 1.080 Pixel hoch.
  • qhd: Die Quad-HD-Version (1440p / 2K) des Thumbnails. Diese Bildgröße ist für einige Videos verfügbar. Dieses Bild ist 2.560 Pixel breit und 1.440 Pixel hoch.
  • uhd: Die Version des Thumbnails in ultrahoher Auflösung (4K). Diese Bildgröße ist für einige Videos verfügbar. Dieses Bild ist 3.840 Pixel breit und 2.160 Pixel hoch.
snippet.thumbnails.(key).url string
Die URL des Bildes.
snippet.thumbnails.(key).width unsigned integer
Die Breite des Bildes.
snippet.thumbnails.(key).height unsigned integer
Die Höhe des Bildes.
snippet.channelTitle string
Der Titel des Kanals, zu dem das Video gehört.
snippet.tags[] list
Eine Liste von Keyword-Tags, die mit dem Video verknüpft sind. Tags dürfen Leerzeichen enthalten. Der Wert der Property darf maximal 500 Zeichen lang sein. Beachten Sie die folgenden Regeln zur Berechnung des Zeichenlimits:
  • Der Attributwert ist eine Liste und Kommas zwischen Elementen in der Liste werden auf das Limit angerechnet.
  • Wenn ein Tag ein Leerzeichen enthält, behandelt der API-Server den Tag-Wert so, als wäre er in Anführungszeichen eingeschlossen. Die Anführungszeichen werden auf die Zeichenbeschränkung angerechnet. Für die Zeichenbeschränkung 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 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 bevorstehende oder aktive Liveübertragung handelt. Der Wert ist none, wenn das Video keine bevorstehende oder aktive Liveübertragung ist.



Gültige Werte für diese Eigenschaft sind:
  • live
  • none
  • upcoming
snippet.defaultLanguage string
Die Sprache des Texts 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 lokalisierte Beschreibung für das Video oder den Titel in der Standardsprache für die Metadaten des Videos.
  • Lokalisierter Text wird im Ressourcenausschnitt 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.
Das Attribut enthält einen schreibgeschützten Wert. Mit dem localizations-Objekt können Sie 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
Mit dem Attribut default_audio_language wird die Sprache angegeben, 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 ISO 8601-Dauer. Bei einem Video, das mindestens eine Minute und weniger als eine Stunde lang ist, wird die Dauer beispielsweise im Format PT#M#S angegeben. 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 beides 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 sind wie oben beschrieben. Wenn das Video mindestens einen Tag lang ist, werden 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 High Definition (HD) oder nur in Standardauflösung verfügbar ist.

Gültige Werte für diese Eigenschaft sind:
  • hd
  • sd
contentDetails.caption string
Gibt an, ob für das Video Untertitel verfügbar sind.

Gültige Werte für dieses Attribut sind:
  • false
  • true
contentDetails.licensedContent boolean
Gibt an, ob das Video lizenzierte Inhalte enthält. Das bedeutet, dass die Inhalte auf einen Kanal hochgeladen wurden, der mit einem YouTube-Content-Partner verknüpft ist, und dann von diesem Partner beansprucht wurden.
contentDetails.regionRestriction object
Das regionRestriction-Objekt enthält Informationen zu den Ländern, in denen ein Video angesehen werden kann (oder nicht). Das Objekt enthält entweder das Attribut contentDetails.regionRestriction.allowed oder das Attribut contentDetails.regionRestriction.blocked.
contentDetails.regionRestriction.allowed[] list
Eine Liste von Regionscodes, die Länder angeben, in denen das Video angesehen werden kann. Wenn diese Eigenschaft vorhanden ist und ein Land nicht in ihrem Wert aufgeführt ist, wird das Video in diesem Land nicht angezeigt. Wenn diese Property vorhanden ist und eine leere Liste enthält, ist das Video in allen Ländern gesperrt.
contentDetails.regionRestriction.blocked[] list
Eine Liste von Regionscodes, die Länder angeben, 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 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 in verschiedenen Bewertungssystemen erhalten hat.
contentDetails.contentRating.acbRating string
Die Einstufung des Videos durch das Australian Classification Board (ACB) oder die Australian Communications and Media Authority (ACMA). ACMA-Altersfreigaben werden verwendet, um Fernsehprogramme für Kinder zu klassifizieren.

Gültige Werte für diese Eigenschaft sind:
  • acbC – Sendungen, die von der Australian Communications and Media Authority als C eingestuft wurden. 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 mit P eingestuft wurden. Diese Sendungen sind für Vorschulkinder vorgesehen.
  • acbPg – PG
  • acbR18plus – R18+
  • acbUnrated
contentDetails.contentRating.agcomRating string
Die Altersfreigabe des Videos von der italienischen Autorità per le Garanzie nelle Comunicazioni (AGCOM).

Gültige Werte für diese Eigenschaft sind:
  • agcomT – T
  • agcomUnrated
  • agcomVm14 – VM14
  • agcomVm18 – VM18
contentDetails.contentRating.anatelRating string
Die Anatel-Altersfreigabe (Asociación Nacional de Televisión) des Videos für das chilenische Fernsehen.

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 Videos durch das British Board of Film Classification (BBFC).

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
Die Altersfreigabe des Videos durch das Board of Film and Video Censors in Thailand.

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 vom Bundesministerium für Unterricht, Kunst und Kultur.

Gültige Werte für diese Property sind:
  • bmukk10 – 10+
  • bmukk12 – 12+
  • bmukk14 – 14+
  • bmukk16 – 16+
  • bmukk6 – 6+
  • bmukk8 – 8+
  • bmukkAa – Uneingeschränkt
  • bmukkUnrated
contentDetails.contentRating.catvRating string
Bewertungssystem für kanadisches Fernsehen – Canadian TV Classification System Die Altersfreigabe des Videos von der 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 diese Property sind:
  • catv14plus – 14+
  • catv18plus – 18+
  • catvC – C
  • catvC8 – C8
  • catvG – G
  • catvPg – PG
  • catvUnrated
contentDetails.contentRating.catvfrRating string
Die Altersfreigabe des Videos von der 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 diese Property sind:
  • catvfr13plus – 13+
  • catvfr16plus – 16+
  • catvfr18plus – 18+
  • catvfr8plus – 8+
  • catvfrG – G
  • catvfrUnrated
contentDetails.contentRating.cbfcRating string
Die Bewertung des Videos durch das Central Board of Film Certification (CBFC – Indien).

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 Videos gemäß Consejo de Calificación Cinematográfica (Chile).

Gültige Werte für diese Property sind:
  • ccc14 – 14+
  • ccc18 – 18+
  • ccc18s – 18+ – contenido pornográfico
  • ccc18v – 18+ - contenido excesivamente violento
  • ccc6 – 6+ – Nicht geeignet für Kinder unter 7 Jahren
  • cccTe – Alle Zuschauer
  • cccUnrated
contentDetails.contentRating.cceRating string
Die Altersfreigabe des Videos von der portugiesischen Comissão de Classificação de Espect´culos.

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
Die 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 Videos gemäß dem Canadian Home Video Rating System (CHVRS).

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
Die Altersfreigabe des Videos von der Commission de Contrôle des Films (Belgien).

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

Gültige Werte für diese Property sind:
  • cna12 – 12
  • cna15 – 15
  • cna18 – 18
  • cna18plus – 18+
  • cnaAp – AP
  • cnaUnrated
contentDetails.contentRating.cncRating string
Bewertungssystem in Frankreich – Commission de classification cinematographique

Gültige Werte für diese Property sind:
  • cnc10 – 10
  • cnc12 – 12
  • cnc16 – 16
  • cnc18 – 18
  • cncE – E
  • cncT – T
  • cncUnrated
contentDetails.contentRating.csaRating string
Die Altersfreigabe des Videos vom Conseil supérieur de l'audiovisuel (CSA) in Frankreich, der Rundfunkinhalte bewertet.

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
Die Altersfreigabe des Videos von der 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
Die Altersfreigabe des Videos in der Tschechischen Republik.

Gültige Werte für diese Property sind:
  • czfilm12 – 12
  • czfilm14 – 14
  • czfilm18 – 18
  • czfilmU – U
  • czfilmUnrated
contentDetails.contentRating.djctqRating string
Die Altersfreigabe des Videos durch das Departamento de Justiça, Classificação, Qualificação e Títulos (DJCQT) in Brasilien.

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 für die DJCQT-Altersfreigabe (Brasilien) des Videos.
contentDetails.contentRating.ecbmctRating string
Bewertungssystem in der Türkei – Evaluation and Classification Board des Ministeriums für Kultur und Tourismus

Gültige Werte für diese Property sind:
  • ecbmct13a – 13A
  • ecbmct13plus – 13+
  • ecbmct15a – 15A
  • ecbmct15plus – 15+
  • ecbmct18plus – 18+
  • ecbmct7a – 7A
  • ecbmct7plus – 7+
  • ecbmctG – G
  • ecbmctUnrated
  • ecbmct6a – 6A
  • ecbmct6plus – 6+
  • ecbmct10a – 10A
  • ecbmct10plus – 10+
  • ecbmct16plus – 16+
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 – K-16
  • 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 Altersfreigabe des Videos von Eirin (映倫). Eirin ist das japanische Bewertungssystem.

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 das Film Censorship Board 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
Die 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 wird seit dem 2. November 2015 nicht mehr unterstützt. Verwenden Sie stattdessen die Property contentDetails.contentRating.cncRating.

Die Altersfreigabe des Videos durch das Centre national du cinéma et de l'image animé (französisches Kulturministerium).

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 vom Film and Publication Board in 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 für die Altersfreigabe des FPB (Südafrika) für das Video.
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
Die Altersfreigabe des Videos in Griechenland.

Gültige Werte für diese Property 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
Die 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 Videos durch das Irish Film Classification Office (IFCO – Irland). Weitere Informationen finden Sie auf der IFCO.

Gültige Werte für dieses Attribut sind:
  • ifco12 – 12
  • ifco12a – 12A
  • ifco15 – 15
  • ifco15a – 15A
  • 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 INCAA-Bewertung (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 (Nur für Erwachsene ab 18 Jahren, eingeschränkte Vorführung)
  • incaaSam13 – 13 (Nur für Nutzer ab 13 Jahren)
  • incaaSam16 – 16 (Nur für Personen ab 16 Jahren)
  • incaaSam18 – 18 (Nur für Personen ab 18 Jahren)
  • incaaUnrated
contentDetails.contentRating.kfcbRating string
Die Altersfreigabe 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).

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 Videos durch das Korea Media Rating Board (영상물등급위원회). Das KMRB bewertet Videos in Südkorea.

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

Gültige Werte für diese Property sind:
  • lsf13 – 13
  • lsf17 – 17
  • lsf21 – 21
  • lsfA – A
  • lsfBo – BO
  • lsfD – D
  • lsfR – R
  • lsfSu – SU
  • lsfUnrated
contentDetails.contentRating.mccaaRating string
Die Altersempfehlung des Film Age-Classification Board von Malta für das Video.

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
Die Altersfreigabe des Videos vom Media Council for Children and Young People des Danish Film Institute (Det Danske Filminstitut).

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

Gültige Werte für diese Property sind:
  • mcst0 – 0
  • mcst16plus – 16+
  • 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
Die Altersfreigabe des Videos von Medietilsynet, der norwegischen Medienbehörde.

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
Die 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
Die Altersfreigabe des Videos vom Ministero dei Beni e delle Attività Culturali e del Turismo (Italien).

Gültige Werte für diese Eigenschaft sind:
  • mibacT
  • mibacUnrated
  • mibacVap
  • mibacVm6
  • mibacVm12
  • mibacVm14
  • mibacVm18
contentDetails.contentRating.mocRating string
Die Altersfreigabe des Videos vom Ministerio de Cultura (Kolumbien).

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 Videos vom taiwanesischen Kulturministerium (文化部).

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 Bewertung des Videos durch die Motion Picture Association of America (MPAA).

Gültige Werte für diese Property sind:
  • mpaaG – G
  • mpaaNc17 – NC-17
  • mpaaPg – PG
  • mpaaPg13 – PG-13
  • mpaaR – R
  • mpaaUnrated
contentDetails.contentRating.mpaatRating string
Die Bewertung der Motion Picture Association of America für Filmtrailer und Vorschauen.

Gültige Werte für diese Property sind:
  • mpaatGb – GB (Green Band – für alle Nutzer geeignet)
  • mpaatRb – RB (Red Band – empfohlen ab 17 Jahren)
contentDetails.contentRating.mtrcbRating string
Die Altersfreigabe des Videos durch das 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
Die Altersfreigabe des Videos vom Maldives National Bureau of Classification.

Gültige Werte für diese Property sind:
  • nbc12plus – 12+
  • nbc15plus – 15+
  • nbc18plus – 18+
  • nbc18plusr – 18+R
  • nbcG – G
  • nbcPg – PG
  • nbcPu – PU
  • nbcUnrated
contentDetails.contentRating.nfrcRating string
Die Altersfreigabe des Videos vom Bulgarian National Film Center.

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

Gültige Werte für diese Property sind:
  • nfvcb12 – 12
  • nfvcb12a – 12A
  • nfvcb15 – 15
  • nfvcb18 – 18
  • nfvcbG – G
  • nfvcbPg – PG
  • nfvcbRe – RE
  • nfvcbUnrated
contentDetails.contentRating.nkclvRating string
Die Altersfreigabe des Videos vom Nacionãlais Kino centrs (National Film Centre of Latvia).

Gültige Werte für diese Property sind:
  • nkclv12plus – 12+
  • nkclv18plus – 18+
  • 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
Die Altersfreigabe des Videos in Peru.

Gültige Werte für diese Property sind:
  • pefilm14 – 14
  • pefilm18 – 18
  • pefilmPg – PG
  • pefilmPt – 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 Bewertung des Videos durch die Generaldirektion für Radio, Fernsehen und Kinematografie (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 in Irland.

Gültige Werte für diese Property sind:
  • rteCh – CH
  • rteGa – GA
  • rteMa – MA
  • rtePs – PS
  • rteUnrated
contentDetails.contentRating.russiaRating string
Die Altersfreigabe des Videos gemäß dem Nationalen Filmregister der Russischen Föderation (MKRF – Russland).

Gültige Werte für dieses Attribut sind:
  • russia0 – 0+
  • russia12 – 12+
  • russia16 – 16+
  • russia18 – 18+
  • russia6 – 6+
  • russiaUnrated
contentDetails.contentRating.skfilmRating string
Die 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
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 Altersfreigabe des Videos vom Statens medieråd (National Media Council, Schweden).

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

Gültige Werte für diese Property 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
Eine Altersfreigabe, 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 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, zur Verarbeitung und zum Datenschutzstatus des Videos.
status.uploadStatus string
Der Status des hochgeladenen Videos.

Gültige Werte für diese Eigenschaft sind:
  • deleted
  • failed
  • processed
  • rejected
  • uploaded
status.failureReason string
Dieser Wert gibt an, 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 gibt an, warum YouTube ein hochgeladenes Video abgelehnt hat. Dieses Attribut ist nur vorhanden, wenn das Attribut uploadStatus angibt, dass der Upload abgelehnt wurde.

Gültige Werte für dieses Attribut sind:
  • claim
  • copyright
  • duplicate
  • inappropriate
  • legal
  • length
  • termsOfUse
  • trademark
  • uploaderAccountClosed
  • uploaderAccountSuspended
status.privacyStatus string
Der Datenschutzstatus des Videos.

Gültige Werte für diese Eigenschaft sind:
  • private
  • public
  • unlisted
status.publishAt datetime
Das Datum und die Uhrzeit, zu der das Video veröffentlicht werden soll. Kann nur festgelegt werden, wenn der Sichtbarkeitsstatus 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 Sie den Wert dieses Attributs beim Aufrufen der Methode videos.update festlegen, müssen Sie auch den Attributwert status.privacyStatus auf private setzen, auch wenn das Video bereits privat ist.
  • Diese Eigenschaft kann nur festgelegt werden, wenn der Sichtbarkeitsstatus des Videos private ist und das Video noch nie veröffentlicht wurde.
  • Wenn du in deinem Antrag festlegst, dass ein Video zu einem Zeitpunkt in der Vergangenheit veröffentlicht werden soll, wird es sofort veröffentlicht. Daher hat es denselben Effekt, wenn Sie die Eigenschaft status.publishAt auf ein Datum und eine Uhrzeit in der Vergangenheit festlegen, als wenn Sie die privacyStatus des Videos von private in public ändern.
status.license string
Die Lizenz des Videos.

Gültige Werte für diese Eigenschaft 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 weiterhin öffentlich sichtbar, auch wenn der Wert dieser Eigenschaft auf false gesetzt ist.
status.madeForKids boolean
Dieser Wert gibt an, ob das Video als speziell für Kinder gekennzeichnet ist, und enthält den aktuellen Status des Videos in Bezug auf die Kennzeichnung „speziell für Kinder“. Der Status kann beispielsweise anhand des Werts der Eigenschaft selfDeclaredMadeForKids ermittelt werden. Weitere Informationen zum Festlegen der Zielgruppe für deinen Kanal, deine Videos oder deine Livestreams findest du in der YouTube-Hilfe.
status.selfDeclaredMadeForKids boolean
In einer videos.insert- oder videos.update-Anfrage kann der Kanalinhaber mit dieser Property das Video als auf Kinder ausgerichtet kennzeichnen. Bei einer videos.list-Anfrage wird der Attributwert nur zurückgegeben, wenn der Kanalinhaber die API-Anfrage autorisiert hat.
status.containsSyntheticMedia boolean
In einer videos.insert- oder videos.update-Anfrage kann der Kanalinhaber mit dieser Eigenschaft offenlegen, dass ein Video realistisch wirkende veränderte oder synthetische (V/S) Inhalte enthält. Weitere Informationen zu den YouTube-Richtlinien für Inhalte zu Alkohol und Tabak

Beispiele für Inhalte zu Alkohol und Tabak sind Videos, in denen:
  • den Anschein erwecken, dass eine echte Person etwas sagt oder tut, was sie nicht gesagt oder getan hat
  • Aufnahmen eines realen Ereignisses oder Ortes verändern
  • Generiert 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 24. August 2026 wird viewCount für alle Videoformate (Videos im Langformat, Livestreams und Shorts) auf einem Kanal aktualisiert. Aufrufe werden dann gezählt, sobald die Wiedergabe eines Videos beginnt. Das gilt auch für die automatische Wiedergabe, wenn der Mauszeiger über das Video bewegt wird, und wenn auf das Video geklickt oder getippt wird.

statistics.likeCount unsigned long
Die Anzahl der Nutzer, die das Video mit „Mag ich“ bewertet haben.
statistics.dislikeCount unsigned long
Hinweis:Die Property statistics.dislikeCount ist seit dem 13. Dezember 2021 privat. 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 das Video mit „Mag ich nicht“ bewertet haben.
statistics.favoriteCount unsigned long
Hinweis:Diese Eigenschaft wurde eingestellt. Die Einstellung ist seit dem 28. August 2015 wirksam. 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 Produktplatzierungen im Video.
paidProductPlacementDetails.hasPaidProductPlacement boolean
Auf true setzen, wenn in den Inhalten bezahlte Produktplatzierungen verwendet werden. Die Standardeinstellung ist false.
player object
Das player-Objekt enthält Informationen, die Sie zum Abspielen des Videos in einem eingebetteten Player benötigen.
player.embedHtml string
Ein <iframe>-Tag, mit dem ein Player eingebettet wird, der das Video abspielt.
  • 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 für maxHeight und/oder maxWidth erfüllt werden.
  • Wenn das Seitenverhältnis des Videos unbekannt ist, wird im eingebetteten Player standardmäßig das Format 4:3 verwendet.
player.embedHeight long
Die Höhe des eingebetteten Players, die in der Eigenschaft player.embedHtml zurückgegeben wird. Diese Property wird nur zurückgegeben, wenn in der Anfrage ein Wert für die Parameter maxHeight und/oder maxWidth angegeben wurde und das Seitenverhältnis des Videos bekannt ist.
player.embedWidth long
Die Breite des eingebetteten Players, die in der Eigenschaft player.embedHtml zurückgegeben wird. Diese Property wird nur zurückgegeben, wenn in der Anfrage ein Wert für die Parameter maxHeight und/oder maxWidth angegeben wurde und das Seitenverhältnis des Videos bekannt ist.
topicDetails object
Das topicDetails-Objekt enthält Informationen zu Themen, die mit dem Video verknüpft sind.

Wichtig:Weitere Informationen zu anstehenden Ä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:Diese Eigenschaft wurde am 10. November 2016 eingestellt. Die API gibt keine Werte mehr für diese Eigenschaft zurück. Alle Themen, die mit einem Video verknüpft sind, werden jetzt vom Eigenschaftswert topicDetails.relevantTopicIds[] zurückgegeben.
topicDetails.relevantTopicIds[] list
Eine Liste von Themen-IDs, die für das Video relevant sind.

Diese Property ist seit dem 10. November 2016 veraltet. 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 diesem Zeitpunkt begann YouTube, eine kleine Gruppe kuratierter Themen-IDs zurückzugeben.

topicDetails.topicCategories[] list
Eine Liste von Wikipedia-URLs, die eine allgemeine Beschreibung des Videoinhalts enthalten.
recordingDetails object
Das recordingDetails-Objekt enthält Informationen zum Ort, Datum 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
Dieses Attribut wird nicht mehr unterstützt. Alle untergeordneten Eigenschaften (Breitengrad, Längengrad, Höhe) sind veraltet.

Die mit dem Video verknüpften Geolocation-Informationen. Die Werte der untergeordneten Property geben den Ort an, den der Videoinhaber mit dem Video verknüpfen möchte. Der Wert kann bearbeitet werden, ist in öffentlichen Videos suchbar und wird Nutzern möglicherweise für öffentliche Videos 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 Videoaufnahme. 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, einschließlich der Auflösung, Dauer, Audio- und Videocodecs, Stream-Bitraten und mehr. Diese Daten können nur vom Rechteinhaber des Videos abgerufen werden.

Das fileDetails-Objekt wird nur zurückgegeben, wenn das Attribut processingDetails.fileAvailability den Wert available hat.
fileDetails.fileName string
Der Name der hochgeladenen Datei. Dieses Feld ist unabhängig davon vorhanden, ob eine Videodatei oder ein anderer Dateityp 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 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.

Gültige Werte für diese Eigenschaft 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. ein JPEG-Bild.
  • other: Die Datei hat einen anderen Dateityp als Video.
  • project: Die Datei ist eine Videoprojektdatei, z. B. ein Microsoft Windows Movie Maker-Projekt, die keine tatsächlichen 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 Codierungs-Seitenverhältnis des Videos lässt sich als width_pixels / height_pixels berechnen.
fileDetails.videoStreams[].heightPixels unsigned integer
Die Höhe des codierten Videoinhalts in Pixeln.
fileDetails.videoStreams[].frameRateFps double
Die Framerate des Videostreams in Bildern pro Sekunde.
fileDetails.videoStreams[].aspectRatio double
Das Seitenverhältnis des Videocontents, 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 Bit pro Sekunde.
fileDetails.videoStreams[].rotation string
Der Betrag, um den YouTube den ursprünglichen Quellinhalt drehen muss, damit das Video richtig 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, nicht triviale Weise gedreht werden.
  • upsideDown – Das Video muss auf den Kopf gedreht werden.
fileDetails.videoStreams[].vendor string
Ein Wert, der einen Videoanbieter eindeutig identifiziert. Normalerweise 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, die der Stream enthält.
fileDetails.audioStreams[].codec string
Der Audiocodec, der vom Stream verwendet wird.
fileDetails.audioStreams[].bitrateBps unsigned long
Die Bitrate des Audiostreams in Bit pro Sekunde.
fileDetails.audioStreams[].vendor string
Ein Wert, der einen Videoanbieter eindeutig identifiziert. Normalerweise 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
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 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 durch YouTube. Die Attribute im Objekt geben den aktuellen Verarbeitungsstatus und eine Schätzung der verbleibenden Zeit an, bis YouTube die Verarbeitung des Videos abgeschlossen hat. In diesem Bereich wird auch angegeben, ob für das Video verschiedene Arten von Daten oder Inhalten wie Dateidetails oder Thumbnails verfügbar sind.

 Das processingProgress-Objekt ist so konzipiert, dass es abgefragt werden kann, um den Fortschritt der Verarbeitung der hochgeladenen Videodatei durch YouTube zu verfolgen. 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.

Gültige Werte für diese Eigenschaft sind:
  • failed – Die Videoverarbeitung ist fehlgeschlagen. Siehe ProcessingFailureReason.
  • processing: Das Video wird gerade verarbeitet. Siehe ProcessingProgress.
  • succeeded – Das Video wurde verarbeitet.
  • terminated: Verarbeitungsinformationen sind nicht mehr verfügbar.
processingDetails.processingProgress object
Das processingProgress-Objekt enthält Informationen zum Fortschritt der Videoverarbeitung durch 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 kann aktualisiert werden, wenn YouTube das Video verarbeitet und genauere Schätzungen vorliegen.
processingDetails.processingProgress.partsProcessed unsigned long
Die Anzahl der Teile des Videos, die YouTube bereits verarbeitet hat. Du kannst den Prozentsatz des Videos, den YouTube bereits verarbeitet hat, so berechnen:
100 * parts_processed / parts_total

Da die geschätzte Anzahl der Teile ohne entsprechende Erhöhung der Anzahl der bereits verarbeiteten Teile steigen kann, ist es möglich, dass der berechnete Fortschritt 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 failed ist.

Gültige Werte für diese Property sind:
  • other – Eine andere Verarbeitungskomponente ist fehlgeschlagen.
  • streamingFailed – Video konnte nicht an Streamer gesendet werden.
  • transcodeFailed – Die Inhalts-Transcodierung ist fehlgeschlagen.
  • uploadFailed – Die Dateizustellung ist fehlgeschlagen.
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 Ihrer videos.list()-Anfrage den fileDetails-Teil anfordern.
processingDetails.processingIssuesAvailability string
Dieser Wert gibt an, ob die Videoverarbeitungs-Engine Vorschläge zur Verbesserung der Videoverarbeitung, Warnungen zu Problemen bei der Videoverarbeitung oder Fehler, die Probleme bei der Videoverarbeitung verursachen, 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 für das Video Keyword- (Tag-)Vorschläge verfügbar sind. Tags können den Metadaten eines Videos hinzugefügt werden, damit andere Nutzer das Video 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, die die Videoqualität oder die Wiedergabe verbessern könnten. 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 Thumbnails generiert 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 aufzeigen. Diese Daten können nur vom Rechteinhaber des Videos abgerufen werden.

Das suggestions-Objekt wird nur zurückgegeben, wenn das Attribut processingDetails.tagSuggestionsAvailability oder das Attribut 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 Verarbeitungsstatus des Videos mit hoher Wahrscheinlichkeit failed sein wird, unabhängig davon, wie der aktuelle Status lautet.

Gültige Werte für diese Eigenschaft 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. ein JPEG-Bild).
  • notAVideoFile: Andere Dateien, die keine Videos sind.
  • projectFile – Filmprojektdatei (z.B. Microsoft Windows Movie Maker-Projekt).
suggestions.processingWarnings[] list
Eine Liste mit Gründen, warum YouTube Schwierigkeiten beim Transkodieren des hochgeladenen Videos haben könnte oder warum es zu einer fehlerhaften Transkodierung kommen könnte. Diese Warnungen werden generiert, bevor YouTube die hochgeladene Videodatei tatsächlich verarbeitet. Außerdem werden Probleme erkannt, die nicht unbedingt darauf hindeuten, dass die Videoverarbeitung fehlschlägt, aber dennoch Probleme wie Synchronisationsprobleme, Videoartefakte oder ein fehlender Audiotrack verursachen können.

Gültige Werte für diese Property sind:
  • hasEditlist – Bearbeitungslisten werden derzeit nicht unterstützt.
  • inconsistentResolution – In Konflikt stehende Container- und Streamauflösungen.
  • problematicAudioCodec: Es wurde ein Audio-Codec verwendet, der bekanntermaßen Probleme verursacht.
  • problematicVideoCodec – Es wurde ein Video-Codec verwendet, der bekanntermaßen Probleme verursacht.
  • unknownAudioCodec – Der Audiocodec wurde nicht erkannt. Die Transcodierung schlägt wahrscheinlich fehl.
  • unknownContainer – Unbekanntes Dateiformat. Die Transcodierung wird wahrscheinlich fehlschlagen.
  • unknownVideoCodec – Unbekannter Video-Codec. Die Transcodierung schlägt wahrscheinlich fehl.
suggestions.processingHints[] list
Eine Liste mit Vorschlägen, die die Verarbeitung des Videos durch YouTube verbessern können.

Gültige Werte für diese Property sind:
  • nonStreamableMov – Die MP4-Datei kann nicht gestreamt werden. Das verlangsamt die Verarbeitung.
  • sendBestQualityVideo: Wahrscheinlich ist eine Version des Videos in besserer Qualität verfügbar.
suggestions.tagSuggestions[] list
Eine Liste von Keyword-Tags, die den Metadaten des Videos hinzugefügt werden könnten, um die Wahrscheinlichkeit zu erhöhen, dass Nutzer das Video bei der Suche oder beim Browsen 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, die der Video-Uploader dem Video zuweist. 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 Videobearbeitungsvorgängen, die die Videoqualität oder die Wiedergabe des hochgeladenen Videos verbessern könnten.

Gültige Werte für diese Eigenschaft sind:
  • audioQuietAudioSwap – Der Audiotrack ist stumm und könnte durch einen Track in besserer Qualität ersetzt werden.
  • videoAutoLevels – Die Helligkeitsstufen des Bildes scheinen nicht korrekt zu sein und könnten korrigiert werden.
  • videoCrop – Um das Bild herum erkannte Ränder (Masken) könnten zugeschnitten werden.
  • videoStabilize – Das Video wirkt 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 das Video eine bevorstehende, laufende oder abgeschlossene Liveübertragung ist.
liveStreamingDetails.actualStartTime datetime
Die Uhrzeit, zu der die Übertragung tatsächlich begonnen hat. Der Wert wird im ISO 8601-Format angegeben. Dieser Wert ist erst verfügbar, wenn die Übertragung beginnt.
liveStreamingDetails.actualEndTime datetime
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 planmäßig 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 das Attribut nicht vorhanden ist, wird die Übertragung auf unbestimmte Zeit geplant.
liveStreamingDetails.concurrentViewers unsigned long
Die Anzahl der Zuschauer, die sich den Livestream gerade ansehen. Das Attribut und sein Wert sind vorhanden, wenn die Übertragung aktuelle Zuschauer hat und der Inhaber der Übertragung die Zuschauerzahl für das Video nicht ausgeblendet hat. Hinweis: YouTube erfasst die Anzahl der gleichzeitigen Zuschauer für eine Übertragung nicht mehr, wenn die Übertragung endet. 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 von der YouTube Data API zurückgegeben wird, kann von der Anzahl der gleichzeitigen Zuschauer abweichen, die über YouTube Analytics verfügbar ist und bei der Spam herausgefiltert wurde. Weitere Informationen zu Messwerten für Livestreams finden Sie in der YouTube-Hilfe.
liveStreamingDetails.activeLiveChatId string
Die ID des aktuell aktiven Live-Chats, der mit diesem Video verknüpft ist. Dieses Feld wird nur ausgefüllt, wenn das Video eine aktuelle Live-Übertragung mit Live-Chat ist. Sobald die Übertragung abgeschlossen ist, wird dieses Feld entfernt und der Livechat geschlossen. Bei persistenten Übertragungen ist die Live-Chat-ID nicht mehr mit diesem Video, sondern mit dem neuen Video verknüpft, das auf der persistenten Seite angezeigt wird.
brandPartner object
Das brandPartner-Objekt enthält Details zum Markenpartner, der mit dem Video für den vom Creator initiierten Zugriff für Markenpartner (Creator Initiated Brand Partner Access, CI BPA) verknüpft ist.
brandPartner.channelId string
Die externe Kanal-ID des Markenpartners. Dieses Feld muss mit „UC“ beginnen. Beim Einrichten des Zugriffs muss entweder channelId oder channelHandle festgelegt werden. In der Antwort wird jedoch nur channelId zurückgegeben.
brandPartner.channelHandle string
Der Kanal-Alias des Markenpartners. Dieses Feld muss mit „@“ beginnen. Beim Einrichten des Zugriffs muss entweder channelId oder channelHandle festgelegt werden. In der Antwort wird jedoch nur channelId zurückgegeben.
localizations object
Das localizations-Objekt enthält Übersetzungen der Metadaten des Videos.
localizations.(key) object
Die Sprache des lokalisierten Texts, der dem Schlüsselwert zugeordnet 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.