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.
- update
- Aktualisiert die Metadaten eines Videos. Hier kannst du die Funktion ausprobieren.
- Delete
- Löscht ein YouTube-Video. Hier kannst du die Funktion ausprobieren.
- rate
- Ein Video mit „Mag ich“ oder „Mag ich nicht“ bewerten oder eine Bewertung entfernen. Hier kannst du die Funktion ausprobieren.
- reportAbuse
- Video wegen missbräuchlicher Inhalte melden Hier kannst du die Funktion ausprobieren.
Ressourcendarstellung
Die folgende JSON-Struktur zeigt das Format einer videos-Ressource:
{
"kind": "youtube#video",
"etag": etag,
"id": string,
"snippet": {
"publishedAt": datetime,
"channelId": string,
"title": string,
"description": string,
"thumbnails": {
(key): {
"url": string,
"width": unsigned integer,
"height": unsigned integer
}
},
"channelTitle": string,
"tags": [
string
],
"categoryId": string,
"liveBroadcastContent": string,
"defaultLanguage": string,
"localized": {
"title": string,
"description": string
},
"defaultAudioLanguage": string
},
"contentDetails": {
"duration": string,
"dimension": string,
"definition": string,
"caption": string,
"licensedContent": boolean,
"regionRestriction": {
"allowed": [
string
],
"blocked": [
string
]
},
"contentRating": {
"acbRating": string,
"agcomRating": string,
"anatelRating": string,
"bbfcRating": string,
"bfvcRating": string,
"bmukkRating": string,
"catvRating": string,
"catvfrRating": string,
"cbfcRating": string,
"cccRating": string,
"cceRating": string,
"chfilmRating": string,
"chvrsRating": string,
"cicfRating": string,
"cnaRating": string,
"cncRating": string,
"csaRating": string,
"cscfRating": string,
"czfilmRating": string,
"djctqRating": string,
"djctqRatingReasons": [,
string
],
"ecbmctRating": string,
"eefilmRating": string,
"egfilmRating": string,
"eirinRating": string,
"fcbmRating": string,
"fcoRating": string,
"fmocRating": string,
"fpbRating": string,
"fpbRatingReasons": [,
string
],
"fskRating": string,
"grfilmRating": string,
"icaaRating": string,
"ifcoRating": string,
"ilfilmRating": string,
"incaaRating": string,
"kfcbRating": string,
"kijkwijzerRating": string,
"kmrbRating": string,
"lsfRating": string,
"mccaaRating": string,
"mccypRating": string,
"mcstRating": string,
"mdaRating": string,
"medietilsynetRating": string,
"mekuRating": string,
"mibacRating": string,
"mocRating": string,
"moctwRating": string,
"mpaaRating": string,
"mpaatRating": string,
"mtrcbRating": string,
"nbcRating": string,
"nbcplRating": string,
"nfrcRating": string,
"nfvcbRating": string,
"nkclvRating": string,
"oflcRating": string,
"pefilmRating": string,
"rcnofRating": string,
"resorteviolenciaRating": string,
"rtcRating": string,
"rteRating": string,
"russiaRating": string,
"skfilmRating": string,
"smaisRating": string,
"smsaRating": string,
"tvpgRating": string,
"ytRating": string
},
"projection": string,
"hasCustomThumbnail": boolean
},
"status": {
"uploadStatus": string,
"failureReason": string,
"rejectionReason": string,
"privacyStatus": string,
"publishAt": datetime,
"license": string,
"embeddable": boolean,
"publicStatsViewable": boolean,
"madeForKids": boolean,
"selfDeclaredMadeForKids": boolean,
"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 |
stringGibt den Typ der API-Ressource an. Der Wert ist youtube#video. |
etag |
etagDas ETag dieser Ressource. |
id |
stringDie ID, mit der YouTube das Video eindeutig identifiziert. |
snippet |
objectDas snippet-Objekt enthält grundlegende Details zum Video, z. B. Titel, Beschreibung und Kategorie. |
snippet.publishedAt |
datetimeDatum und Uhrzeit der Veröffentlichung des Videos. 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 öffentlich gemacht wird, wird in dieser Eigenschaft der Zeitpunkt angegeben, zu dem das Video öffentlich gemacht wurde. Es gibt einige Sonderfälle:
|
snippet.channelId |
stringDie 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 |
stringDer Titel des Videos. Der Attributwert darf maximal 100 Zeichen lang sein und alle gültigen UTF-8-Zeichen außer < und > enthalten. Du musst einen Wert für dieses Attribut festlegen, wenn du die Methode videos.update aufrufst und den Teil snippet einer video-Ressource aktualisierst. |
snippet.description |
stringDie Videobeschreibung. 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 |
objectEine Zuordnung von Thumbnail-Bildern, die mit dem Video verknüpft sind. Für jedes Objekt in der Map ist der Schlüssel der Name des Thumbnail-Bildes und der Wert ein Objekt, das weitere Informationen zum Thumbnail enthält. |
snippet.thumbnails.(key) |
objectGültige Schlüsselwerte sind:
|
snippet.thumbnails.(key).url |
stringDie URL des Bildes. |
snippet.thumbnails.(key).width |
unsigned integerDie Breite des Bildes. |
snippet.thumbnails.(key).height |
unsigned integerDie Höhe des Bildes. |
snippet.channelTitle |
stringTitel des Kanals, zu dem das Video gehört. |
snippet.tags[] |
listEine Liste mit Keyword-Tags, die mit dem Video verknüpft sind. Tags dürfen Leerzeichen enthalten. Der Eigenschaftswert darf maximal 500 Zeichen lang sein. Beachten Sie die folgenden Regeln zur Berechnung der Zeichenbeschränkung:
|
snippet.categoryId |
stringDie 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 Teil snippet einer video-Ressource aktualisieren. |
snippet.liveBroadcastContent |
stringGibt an, ob es sich bei dem Video um eine anstehende oder aktive Liveübertragung handelt. Der Wert ist Gültige Werte für dieses Attribut sind:
|
snippet.defaultLanguage |
stringDie Sprache des Texts in den Properties snippet.title und snippet.description der Ressource video. |
snippet.localized |
objectDas Objekt snippet.localized enthält entweder einen lokalisierten Titel und eine lokalisierte Beschreibung für das Video oder den Titel in der Standardsprache für die Metadaten des Videos.
localizations, um lokalisierte Titel hinzuzufügen, zu aktualisieren oder zu löschen. |
snippet.localized.title |
stringDer lokalisierte Videotitel. |
snippet.localized.description |
stringDie lokalisierte Videobeschreibung. |
snippet.defaultAudioLanguage |
stringMit der Property default_audio_language wird die Sprache angegeben, die im Standard-Audiotrack des Videos gesprochen wird. |
contentDetails |
objectDas contentDetails-Objekt enthält Informationen zum Videoinhalt, einschließlich der Länge des Videos und einer Angabe, ob Untertitel für das Video verfügbar sind. |
contentDetails.duration |
stringDie Länge des Videos. Der Attributwert 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. Der Wert 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 # vor dem Buchstaben H die Länge des Videos in Stunden an. Alle anderen Details sind mit den oben beschriebenen identisch. Wenn das Video mindestens einen Tag lang ist, werden die Buchstaben P und T getrennt und das Format des Werts ist P#DT#H#M#S. Ausführliche Informationen finden Sie in der ISO 8601-Spezifikation. |
contentDetails.dimension |
stringGibt an, ob das Video in 3D oder in 2D verfügbar ist. |
contentDetails.definition |
stringGibt an, ob das Video in High Definition ( HD) oder nur in Standard Definition verfügbar ist.Gültige Werte für diese Property sind:
|
contentDetails.caption |
stringGibt an, ob für das Video Untertitel verfügbar sind. Gültige Werte für diese Property sind:
|
contentDetails.licensedContent |
booleanGibt an, ob das Video lizenzierte Inhalte enthält. Das bedeutet, dass die Inhalte auf einen Kanal hochgeladen wurden, der mit einem YouTube-Inhaltspartner verknüpft ist, und dann von diesem Partner beansprucht wurden. |
contentDetails.regionRestriction |
objectDas 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[] |
listEine Liste mit Regionscodes, die 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, wird das Video in allen Ländern gesperrt. |
contentDetails.regionRestriction.blocked[] |
listEine Liste mit Regionscodes, die Länder angeben, in denen das Video gesperrt ist. Wenn diese Eigenschaft vorhanden ist und ein Land nicht in ihrem Wert aufgeführt ist, kann das Video in diesem Land angesehen werden. Wenn diese Property vorhanden ist und eine leere Liste enthält, kann das Video in allen Ländern angesehen werden. |
contentDetails.contentRating |
objectGibt die Bewertungen an, die das Video im Rahmen verschiedener Bewertungssysteme erhalten hat. |
contentDetails.contentRating.acbRating |
stringDie 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 dieses Attribut sind:
|
contentDetails.contentRating.agcomRating |
stringDie Altersfreigabe des Videos von der italienischen Autorità per le Garanzie nelle Comunicazioni (AGCOM). Gültige Werte für diese Eigenschaft sind:
|
contentDetails.contentRating.anatelRating |
stringDie Anatel-Altersfreigabe (Asociación Nacional de Televisión) des Videos für das chilenische Fernsehen. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.bbfcRating |
stringDie Altersfreigabe des Videos durch das British Board of Film Classification (BBFC). Gültige Werte für diese Property sind:
|
contentDetails.contentRating.bfvcRating |
stringDie Altersfreigabe des Videos vom Board of Film and Video Censors in Thailand. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.bmukkRating |
stringDie Altersfreigabe des Videos durch das Bundesministerium für Unterricht, Kunst und Kultur. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.catvRating |
stringBewertungssystem 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 findest du auf der Website des Canadian Broadcast Standards Council. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.catvfrRating |
stringDie 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 dieses Attribut sind:
|
contentDetails.contentRating.cbfcRating |
stringDie Altersfreigabe des Videos durch das Central Board of Film Certification (CBFC, Indien). Gültige Werte für diese Property sind:
|
contentDetails.contentRating.cccRating |
stringDie Altersfreigabe des Videos durch den Consejo de Calificación Cinematográfica (Chile). Gültige Werte für diese Property sind:
|
contentDetails.contentRating.cceRating |
stringDie Altersfreigabe des Videos von der portugiesischen Comissão de Classificação de Espect´culos. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.chfilmRating |
stringDie Altersfreigabe des Videos in der Schweiz. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.chvrsRating |
stringDie Altersfreigabe des Videos gemäß dem Canadian Home Video Rating System (CHVRS). Gültige Werte für diese Property sind:
|
contentDetails.contentRating.cicfRating |
stringDie Altersfreigabe des Videos durch die Commission de Contrôle des Films (Belgien). Gültige Werte für diese Property sind:
|
contentDetails.contentRating.cnaRating |
stringDie Altersfreigabe des Videos vom CONSILIUL NATIONAL AL AUDIOVIZUALULUI (CNA) in Rumänien. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.cncRating |
stringBewertungssystem in Frankreich – Commission de classification cinematographique Gültige Werte für diese Property sind:
|
contentDetails.contentRating.csaRating |
stringDie Altersfreigabe des Videos vom Conseil supérieur de l'audiovisuel (CSA) in Frankreich, der Rundfunkinhalte bewertet. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.cscfRating |
stringDie Altersfreigabe des Videos durch die Commission de surveillance de la classification des films (CSCF) in Luxemburg. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.czfilmRating |
stringDie Altersfreigabe des Videos in Tschechien. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.djctqRating |
stringDie Altersfreigabe des Videos durch das Departamento de Justiça, Classificação, Qualificação e Títulos (DJCQT – Brasilien). Gültige Werte für diese Property sind:
|
contentDetails.contentRating.djctqRatingReasons[] |
listGründe für die Altersfreigabe des DJCTQ (Brasilien) für das Video. |
contentDetails.contentRating.ecbmctRating |
stringBewertungssystem in der Türkei – Evaluation and Classification Board of the Ministry of Culture and Tourism Gültige Werte für diese Property:
|
contentDetails.contentRating.eefilmRating |
stringDie Altersfreigabe des Videos in Estland. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.egfilmRating |
stringDie Altersfreigabe des Videos in Ägypten. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.eirinRating |
stringDie Altersfreigabe des Videos von der EIRIN (映倫). Eirin ist das japanische Bewertungssystem. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.fcbmRating |
stringDie Altersfreigabe des Videos durch das Film Censorship Board von Malaysia. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.fcoRating |
stringDie Altersfreigabe des Videos durch das Office for Film, Newspaper and Article Administration in Hongkong. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.fmocRating |
stringDiese Property wird seit dem 2. November 2015 nicht mehr unterstützt. Verwende stattdessen die Property contentDetails.contentRating.cncRating.Die Altersfreigabe des Videos durch das Centre national du cinéma et de l'image animée (französisches Kulturministerium). Gültige Werte für diese Property sind:
|
contentDetails.contentRating.fpbRating |
stringDie Altersfreigabe des Videos durch das Film and Publication Board in Südafrika. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.fpbRatingReasons[] |
listGründe, warum das Video die entsprechende FPB-Altersfreigabe (Südafrika) erhalten hat. |
contentDetails.contentRating.fskRating |
stringDie Altersfreigabe der Freiwilligen Selbstkontrolle der Filmwirtschaft (FSK) für das Video. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.grfilmRating |
stringDie Altersfreigabe des Videos in Griechenland. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.icaaRating |
stringDie Altersfreigabe des Videos durch das Instituto de la Cinematografía y de las Artes Audiovisuales (ICAA – Spanien). Gültige Werte für diese Property sind:
|
contentDetails.contentRating.ifcoRating |
stringDie 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:
|
contentDetails.contentRating.ilfilmRating |
stringDie Altersfreigabe des Videos in Israel. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.incaaRating |
stringDie INCAA-Bewertung (Instituto Nacional de Cine y Artes Audiovisuales – Argentinien) des Videos. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.kfcbRating |
stringDie Altersfreigabe des Videos vom Kenya Film Classification Board. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.kijkwijzerRating |
stringvoor de Classificatie van Audiovisuele Media (Niederlande). Gültige Werte für diese Property sind:
|
contentDetails.contentRating.kmrbRating |
stringDie Altersfreigabe des Videos durch das Korea Media Rating Board (영상물등급위원회). Das KMRB bewertet Videos in Südkorea. Gültige Werte für diese Eigenschaft sind:
|
contentDetails.contentRating.lsfRating |
stringDie Altersfreigabe des Videos von der indonesischen Lembaga Sensor Film. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.mccaaRating |
stringDie Altersfreigabe des Videos durch das Film Age-Classification Board von Malta. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.mccypRating |
stringDie Altersfreigabe des Videos durch den Medienrat für Kinder und Jugendliche des Dänischen Filminstituts (Det Danske Filminstitut). Gültige Werte für diese Property sind:
|
contentDetails.contentRating.mcstRating |
stringDas Bewertungssystem des Videos für Vietnam – MCST Gültige Werte für diese Property sind:
|
contentDetails.contentRating.mdaRating |
stringDie Altersfreigabe des Videos durch die Media Development Authority (MDA) von Singapur und insbesondere durch das Board of Film Censors (BFC). Gültige Werte für diese Property sind:
|
contentDetails.contentRating.medietilsynetRating |
stringDie Altersfreigabe des Videos von Medietilsynet, der norwegischen Medienbehörde. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.mekuRating |
stringDie Altersfreigabe des Videos vom Kansallinen Audiovisuaalinen Instituutti (National Audiovisual Institute) in Finnland. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.mibacRating |
stringDie Altersfreigabe des Videos vom Ministero dei Beni e delle Attività Culturali e del Turismo (Italien). Gültige Werte für diese Property sind:
|
contentDetails.contentRating.mocRating |
stringDie Bewertung des Videos durch das Ministerio de Cultura (Kolumbien). Zulässige Werte für diese Property sind:
|
contentDetails.contentRating.moctwRating |
stringDie Altersfreigabe des Videos vom taiwanesischen Kulturministerium (文化部). Gültige Werte für diese Property sind:
|
contentDetails.contentRating.mpaaRating |
stringDie Bewertung des Videos durch die Motion Picture Association of America (MPAA). Gültige Werte für diese Property sind:
|
contentDetails.contentRating.mpaatRating |
stringDie Altersfreigabe der Motion Picture Association of America für Filmtrailer und Vorschauen. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.mtrcbRating |
stringDie Altersfreigabe des Videos vom Movie and Television Review and Classification Board (Philippinen). Gültige Werte für diese Property sind:
|
contentDetails.contentRating.nbcRating |
stringDie Altersfreigabe des Videos vom Maldives National Bureau of Classification. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.nfrcRating |
stringDie Altersfreigabe des Videos vom Bulgarian National Film Center. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.nfvcbRating |
stringDie Altersfreigabe des Videos durch das National Film and Video Censors Board in Nigeria. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.nkclvRating |
stringDie Altersfreigabe des Videos vom Nacionãlais Kino centrs (National Film Centre of Latvia). Gültige Werte für diese Property:
|
contentDetails.contentRating.oflcRating |
stringDie Altersfreigabe des Office of Film and Literature Classification (OFLC – Neuseeland) für das Video. Gültige Werte für diese Eigenschaft sind:
|
contentDetails.contentRating.pefilmRating |
stringDie Altersfreigabe des Videos in Peru. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.resorteviolenciaRating |
stringDie Altersfreigabe des Videos in Venezuela. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.rtcRating |
stringDie Altersfreigabe des Videos durch die Dirección General de Radio, Televisión y Cinematografía (Mexiko). Gültige Werte für diese Property sind:
|
contentDetails.contentRating.rteRating |
stringDie Altersfreigabe des Videos von Raidió Teilifís Éireann in Irland. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.russiaRating |
stringDie Altersfreigabe des Videos gemäß dem Nationalen Filmregister der Russischen Föderation (MKRF – Russland). Gültige Werte für dieses Attribut sind:
|
contentDetails.contentRating.skfilmRating |
stringDie Altersfreigabe des Videos in der Slowakei. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.smaisRating |
stringDie Altersfreigabe des Videos in Island. Gültige Werte für diese Property sind:
|
contentDetails.contentRating.smsaRating |
stringDie Altersfreigabe des Videos von Statens medieråd (schwedischer Medienrat). Gültige Werte für diese Property sind:
|
contentDetails.contentRating.tvpgRating |
stringDie TVPG-Altersfreigabe (TV Parental Guidelines) des Videos. Gültige Werte für diese Property:
|
contentDetails.contentRating.ytRating |
stringEine Altersfreigabe, die YouTube verwendet, um Inhalte mit Altersbeschränkung zu kennzeichnen. Gültige Werte für diese Property sind:
|
contentDetails.projection |
stringGibt das Projektionsformat des Videos an. Gültige Werte für diese Property sind:
|
contentDetails.hasCustomThumbnail |
booleanGibt an, ob der Uploader des Videos ein benutzerdefiniertes Thumbnail-Bild für das Video bereitgestellt hat. Diese Eigenschaft ist nur für den Uploader des Videos sichtbar. |
status |
objectDas status-Objekt enthält Informationen zum Upload-, Verarbeitungs- und Datenschutzstatus des Videos. |
status.uploadStatus |
stringDer Status des hochgeladenen Videos. Gültige Werte für diese Property sind:
|
status.failureReason |
stringDieser 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:
|
status.rejectionReason |
stringDieser Wert gibt an, warum YouTube ein hochgeladenes Video abgelehnt hat. Diese Property ist nur vorhanden, wenn die Property uploadStatus angibt, dass der Upload abgelehnt wurde.Gültige Werte für diese Property sind:
|
status.privacyStatus |
stringDatenschutzeinstellung des Videos. Wenn du in einer videos.insert-Anfrage keinen Wert für diese Property angibst, wird der Datenschutzstatus des hochgeladenen Videos standardmäßig auf public gesetzt. Bestimmte Uploads werden möglicherweise standardmäßig auf private gesetzt. Das hängt von den Kontoeinstellungen des Creators ab. Weitere Informationen dazu findest du in der YouTube-Hilfe. Videos, die über nicht verifizierte API-Projekte hochgeladen wurden, sind nicht auf den privaten Anzeigemodus beschränkt.Gültige Werte für diese Property sind:
|
status.publishAt |
datetimeDas 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 beiden zusätzlichen Punkte zum Verhalten dieses Attributs:
|
status.license |
stringDie Lizenz des Videos. Gültige Werte für diese Property sind:
|
status.embeddable |
booleanDieser Wert gibt an, ob das Video auf einer anderen Website eingebettet werden kann. |
status.publicStatsViewable |
booleanDieser Wert gibt an, ob die erweiterten Videostatistiken auf der Wiedergabeseite des Videos öffentlich sichtbar sind. Standardmäßig sind diese Statistiken sichtbar. Statistiken wie die Aufrufzahl und die Bewertungen eines Videos sind weiterhin öffentlich sichtbar, auch wenn der Wert dieser Eigenschaft auf false festgelegt ist. |
status.madeForKids |
booleanDieser Wert gibt an, ob das Video als „speziell für Kinder“ gekennzeichnet ist, und enthält den aktuellen Status des Videos. Der Status kann beispielsweise anhand des Werts des Attributs selfDeclaredMadeForKids ermittelt werden. Weitere Informationen zum Festlegen der Zielgruppe für deinen Kanal, deine Videos oder deine Übertragungen findest du in der YouTube-Hilfe.
|
status.selfDeclaredMadeForKids |
booleanIn einer videos.insert- oder videos.update-Anfrage kann der Kanalinhaber mit dieser Property 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 |
booleanIn einer videos.insert- oder videos.update-Anfrage ermöglicht dieses Attribut dem Kanalinhaber, offenzulegen, dass ein Video realistisch wirkende veränderte oder synthetische (V/S) Inhalte enthält. Weitere Informationen zu den YouTube-Richtlinien für Inhalte mit AltersbeschränkungBeispiele für Inhalte zu Alkohol und Tabak sind Videos, in denen:
|
statistics |
objectDas statistics-Objekt enthält Statistiken zum Video. |
statistics.viewCount |
unsigned longGibt an, wie oft das Video aufgerufen wurde. Ab dem 24. August 2026 wird |
statistics.likeCount |
unsigned longDie Anzahl der Nutzer, die angegeben haben, dass ihnen das Video gefällt. |
statistics.dislikeCount |
unsigned longHinweis: Das Attribut
statistics.dislikeCount wurde am 13. Dezember 2021 als privat festgelegt. Das bedeutet, dass die Property nur dann in einer API-Antwort enthalten ist, wenn die API-Anfrage vom Videoinhaber authentifiziert wurde. Weitere Informationen finden Sie im Überarbeitungsverlauf.Die Anzahl der Nutzer, die angegeben haben, dass ihnen das Video nicht gefallen hat. |
statistics.favoriteCount |
unsigned longHinweis: Diese Property wurde verworfen. Die Einstellung gilt ab dem 28. August 2015. Der Wert des Attributs ist jetzt immer auf 0 festgelegt. |
statistics.commentCount |
unsigned longDie Anzahl der Kommentare zum Video. |
paidProductPlacementDetails |
objectDas paidProductPlacementDetails-Objekt enthält Informationen zu bezahlten Produktplatzierungen im Video. |
paidProductPlacementDetails.hasPaidProductPlacement |
booleanWird auf true gesetzt, wenn der Inhalt bezahlte Produktplatzierungen enthält. Die Standardeinstellung ist false. |
player |
objectDas player-Objekt enthält Informationen, die du zum Abspielen des Videos in einem eingebetteten Player verwenden würdest. |
player.embedHtml |
stringEin <iframe>-Tag, das einen Player einbettet, in dem das Video abgespielt wird.
|
player.embedHeight |
longDie Höhe des eingebetteten Players, die in der Eigenschaft player.embedHtml zurückgegeben wird. Diese Eigenschaft wird nur zurückgegeben, wenn in der Anfrage ein Wert für die Parameter maxHeight und/oder maxWidth angegeben wurde und das Seitenverhältnis des Videos bekannt ist. |
player.embedWidth |
longDie 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 |
objectDas topicDetails-Objekt enthält Informationen zu Themen, die mit dem Video verknüpft sind.Wichtig: Weitere Informationen zu den anstehenden Änderungen im Zusammenhang mit Themen-IDs finden Sie in den Definitionen der Properties topicDetails.relevantTopicIds[] und topicDetails.topicIds[] sowie im Überarbeitungsverlauf. |
topicDetails.topicIds[] |
listWichtig:Diese Eigenschaft 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 vom Property-Wert topicDetails.relevantTopicIds[] zurückgegeben. |
topicDetails.relevantTopicIds[] |
listEine Liste mit Themen-IDs, die für das Video relevant sind. Diese Property wurde am 10. November 2016 eingestellt. 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. Damals hat YouTube damit begonnen, eine kleine Auswahl an ausgewählten Themen-IDs zurückzugeben. |
topicDetails.topicCategories[] |
listEine Liste von Wikipedia-URLs, die eine allgemeine Beschreibung des Videoinhalts enthalten. |
recordingDetails |
objectDas recordingDetails-Objekt enthält Informationen zum Ort, Datum und zur Adresse, an der das Video aufgenommen wurde. |
recordingDetails.locationDescription |
stringDiese Property wurde am 1. Juni 2017 eingestellt. Weitere Informationen finden Sie in der Mitteilung zur Einstellung. Die Textbeschreibung des Orts, an dem das Video aufgenommen wurde. |
recordingDetails.location |
objectDieses Attribut wird nicht mehr unterstützt. Alle untergeordneten Properties (latitude, longitude, altitude) sind veraltet. Die mit dem Video verknüpften Standortinformationen. Die Werte der untergeordneten Property geben den Ort an, den der Videoinhaber mit dem Video verknüpfen möchte. Der Wert ist bearbeitbar, kann in öffentlichen Videos gesucht werden und wird Nutzern möglicherweise für öffentliche Videos angezeigt. |
recordingDetails.location.latitude |
doubleDieses Attribut wurde am 1. Juni 2017 eingestellt. Weitere Informationen finden Sie in der Mitteilung zur Einstellung. Breitengrad in Grad. |
recordingDetails.location.longitude |
doubleDieses Attribut wurde am 1. Juni 2017 eingestellt. Weitere Informationen finden Sie in der Mitteilung zur Einstellung. Längengrad in Grad. |
recordingDetails.location.altitude |
doubleDiese Property wurde am 9. Juli 2018 eingestellt. Weitere Informationen finden Sie in der Mitteilung zur Einstellung. Höhe über dem Referenzellipsoid in Metern. |
recordingDetails.recordingDate |
datetimeDatum und Uhrzeit der Aufnahme des Videos. Der Wert wird im ISO 8601-Format ( YYYY-MM-DDThh:mm:ss.sssZ) angegeben. |
fileDetails |
objectDas fileDetails-Objekt enthält Informationen zur Videodatei, die auf YouTube hochgeladen wurde, einschließlich Auflösung, Dauer, Audio- und Videocodecs, Stream-Bitraten und mehr. Diese Daten können nur vom Videoinhaber abgerufen werden.Das fileDetails-Objekt wird nur zurückgegeben, wenn die processingDetails.fileAvailability-Property den Wert available hat. |
fileDetails.fileName |
stringDer Name der hochgeladenen Datei. Dieses Feld ist vorhanden, unabhängig davon, ob eine Videodatei oder ein anderer Dateityp hochgeladen wurde. |
fileDetails.fileSize |
unsigned longDie Größe der hochgeladenen Datei in Byte. Dieses Feld ist vorhanden, unabhängig davon, ob eine Videodatei oder ein anderer Dateityp hochgeladen wurde. |
fileDetails.fileType |
stringDer von der Videoverarbeitungs-Engine von YouTube erkannte Typ der hochgeladenen Datei. Derzeit werden auf YouTube nur Videodateien verarbeitet. 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:
|
fileDetails.container |
stringDas Containerformat der hochgeladenen Videodatei. |
fileDetails.videoStreams[] |
listEine Liste der Videostreams, die in der hochgeladenen Videodatei enthalten sind. Jedes Element in der Liste enthält detaillierte Metadaten zu einem Videostream. |
fileDetails.videoStreams[].widthPixels |
unsigned integerDie Breite des codierten Videoinhalts in Pixeln. Das Seitenverhältnis der Videocodierung lässt sich mit width_pixels / height_pixels berechnen. |
fileDetails.videoStreams[].heightPixels |
unsigned integerDie Höhe des codierten Videoinhalts in Pixeln. |
fileDetails.videoStreams[].frameRateFps |
doubleDie Framerate des Videostreams in Bildern pro Sekunde. |
fileDetails.videoStreams[].aspectRatio |
doubleDas Seitenverhältnis des Videoinhalts, das angibt, in welchem Seitenverhältnis das Video angezeigt werden soll. |
fileDetails.videoStreams[].codec |
stringDer vom Stream verwendete Videocodec. |
fileDetails.videoStreams[].bitrateBps |
unsigned longDie Bitrate des Videostreams in Bit pro Sekunde. |
fileDetails.videoStreams[].rotation |
stringDer Betrag, um den YouTube die ursprünglichen Quellinhalte drehen muss, damit das Video richtig angezeigt wird. Gültige Werte für diese Property sind:
|
fileDetails.videoStreams[].vendor |
stringEin Wert, der einen Videoanbieter eindeutig identifiziert. In der Regel ist der Wert ein vierstelliger Anbietercode. |
fileDetails.audioStreams[] |
listEine Liste der Audiostreams, die in der hochgeladenen Videodatei enthalten sind. Jedes Element in der Liste enthält detaillierte Metadaten zu einem Audiostream. |
fileDetails.audioStreams[].channelCount |
unsigned integerDie Anzahl der Audiokanäle, die der Stream enthält. |
fileDetails.audioStreams[].codec |
stringDer Audiocodec, der für den Stream verwendet wird. |
fileDetails.audioStreams[].bitrateBps |
unsigned longDie Bitrate des Audiostreams in Bit pro Sekunde. |
fileDetails.audioStreams[].vendor |
stringEin Wert, der einen Videoanbieter eindeutig identifiziert. In der Regel ist der Wert ein vierstelliger Anbietercode. |
fileDetails.durationMs |
unsigned longDie Länge des hochgeladenen Videos in Millisekunden. |
fileDetails.bitrateBps |
unsigned longDie kombinierte Bitrate (Video und Audio) der hochgeladenen Videodatei in Bit pro Sekunde. |
fileDetails.creationTime |
stringDas Datum und die Uhrzeit, zu der die hochgeladene Videodatei erstellt wurde. Der Wert wird im ISO 8601-Format angegeben. Derzeit werden die folgenden ISO 8601-Formate unterstützt:
|
processingDetails |
objectDas Objekt processingDetails 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 Teil wird auch angegeben, ob für das Video verschiedene Arten von Daten oder Inhalten verfügbar sind, z. B. Dateidetails oder Thumbnail-Bilder.Das Objekt processingProgress ist so konzipiert, dass es abgefragt werden kann, damit der Video-Uploader den Fortschritt verfolgen kann, den YouTube bei der Verarbeitung der hochgeladenen Videodatei gemacht hat. Diese Daten können nur vom Videoinhaber abgerufen werden. |
processingDetails.processingStatus |
stringDer 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:
|
processingDetails.processingProgress |
objectDas processingProgress-Objekt enthält Informationen zum Fortschritt der Verarbeitung des Videos durch YouTube. Die Werte sind nur relevant, wenn der Verarbeitungsstatus des Videos processing ist. |
processingDetails.processingProgress.partsTotal |
unsigned longEine 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. |
processingDetails.processingProgress.partsProcessed |
unsigned longDie Anzahl der Teile des Videos, die YouTube bereits verarbeitet hat. Du kannst den Prozentsatz des Videos, den YouTube bereits verarbeitet hat, mit folgender Formel schätzen: 100 * parts_processed / parts_totalDa sich die geschätzte Anzahl der Teile erhöhen kann, ohne dass sich die Anzahl der bereits verarbeiteten Teile entsprechend erhöht, kann es vorkommen, dass der berechnete Fortschritt während der Verarbeitung eines Videos durch YouTube zeitweise abnimmt. |
processingDetails.processingProgress.timeLeftMs |
unsigned longEine Schätzung der Zeit in Millisekunden, die YouTube für die Verarbeitung des Videos benötigt. |
processingDetails.processingFailureReason |
stringDer 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:
|
processingDetails.fileDetailsAvailability |
stringDieser Wert gibt an, ob für das hochgeladene Video Dateidetails verfügbar sind. Du kannst die Dateidetails eines Videos abrufen, indem du den fileDetails-Teil in deiner videos.list()-Anfrage anforderst. |
processingDetails.processingIssuesAvailability |
stringDieser 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. Du kannst diese Vorschläge abrufen, indem du den Teil suggestions in deiner videos.list()-Anfrage anforderst. |
processingDetails.tagSuggestionsAvailability |
stringDieser Wert gibt an, ob Keyword- (Tag-)Vorschläge für das Video verfügbar sind. Tags können den Metadaten eines Videos hinzugefügt werden, damit andere Nutzer das Video leichter finden können. Du kannst diese Vorschläge abrufen, indem du den Teil suggestions in deiner videos.list()-Anfrage anforderst. |
processingDetails.editorSuggestionsAvailability |
stringDieser 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. Du kannst diese Vorschläge abrufen, indem du den Teil suggestions in deiner videos.list()-Anfrage anforderst. |
processingDetails.thumbnailsAvailability |
stringDieser Wert gibt an, ob für das Video Miniaturansichten generiert wurden. |
suggestions |
objectDas 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 Videoinhaber abgerufen werden. Das suggestions-Objekt wird nur zurückgegeben, wenn das Attribut processingDetails.tagSuggestionsAvailability oder processingDetails.editorSuggestionsAvailability den Wert available hat. |
suggestions.processingErrors[] |
listEine Liste von Fehlern, die verhindern, dass YouTube das hochgeladene Video verarbeiten kann. Diese Fehler weisen darauf hin, dass der Verarbeitungsstatus des Videos unabhängig vom aktuellen Status mit hoher Wahrscheinlichkeit failed lauten wird.Gültige Werte für diese Eigenschaft sind:
|
suggestions.processingWarnings[] |
listEine Liste mit Gründen, warum YouTube möglicherweise Probleme beim Transcodieren des hochgeladenen Videos hat oder warum die Transcodierung fehlerhaft sein 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:
|
suggestions.processingHints[] |
listEine Liste mit Vorschlägen, die die Verarbeitung des Videos durch YouTube verbessern können. Gültige Werte für diese Property sind:
|
suggestions.tagSuggestions[] |
listEine Liste mit Keyword-Tags, die den Metadaten des Videos hinzugefügt werden können, um die Wahrscheinlichkeit zu erhöhen, dass Nutzer dein Video bei der Suche oder beim Surfen auf YouTube finden. |
suggestions.tagSuggestions[].tag |
stringDas für das Video vorgeschlagene Keyword-Tag. |
suggestions.tagSuggestions[].categoryRestricts[] |
listEine 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[] |
listEine 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:
|
liveStreamingDetails |
objectDas 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 |
datetimeDer Zeitpunkt, zu dem die Übertragung tatsächlich gestartet wurde. Der Wert wird im Format ISO 8601 angegeben. Dieser Wert ist erst verfügbar, wenn die Übertragung beginnt. |
liveStreamingDetails.actualEndTime |
datetimeDer Zeitpunkt, zu dem 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 |
datetimeDie Zeit, zu der die Übertragung beginnen soll. Der Wert wird im Format ISO 8601 angegeben. |
liveStreamingDetails.scheduledEndTime |
datetimeDer Zeitpunkt, zu dem die Übertragung enden soll. Der Wert wird im Format ISO 8601 angegeben. Wenn der Wert leer ist oder die Property nicht vorhanden ist, wird die Übertragung auf unbestimmte Zeit fortgesetzt. |
liveStreamingDetails.concurrentViewers |
unsigned longDie Anzahl der Zuschauer, die sich die Übertragung gerade ansehen. Die Property und ihr Wert sind vorhanden, wenn die Übertragung aktuelle Zuschauer hat und der Inhaber der Übertragung die Anzahl der Aufrufe für das Video nicht ausgeblendet hat. Beachte, dass YouTube die Anzahl der gleichzeitigen Zuschauer für eine Übertragung 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 von der YouTube Data API zurückgegebenen Zahlen zu gleichzeitigen Zuschauern können von den verarbeiteten, von Spam bereinigten Zahlen zu gleichzeitigen Zuschauern abweichen, die über YouTube Analytics verfügbar sind. Weitere Informationen zu Messwerten für Livestreams findest du in der YouTube-Hilfe.
|
liveStreamingDetails.activeLiveChatId |
stringDie ID des derzeit 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 Live-Chat 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 |
objectDas brandPartner-Objekt enthält Details zum Markenpartner, der mit dem Video für den vom Creator initiierten Zugriff für Markenpartner (CI BPA) verknüpft ist. |
brandPartner.channelId |
stringDie 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 |
stringDer 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 |
objectDas localizations-Objekt enthält Übersetzungen der Metadaten des Videos. |
localizations.(key) |
objectDie 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 |
stringDer lokalisierte Videotitel. |
localizations.(key).description |
stringDie lokalisierte Videobeschreibung. |