Die API unterstützt jetzt die Möglichkeit, deinen Kanal oder deine Videos als „speziell für Kinder“ zu kennzeichnen. Außerdem enthalten die Ressourcen
channel
und video
jetzt eine Property, die den Status „speziell für Kinder“ des Kanals oder Videos angibt. Am 10. Januar 2020 wurden auch die Nutzungsbedingungen für die YouTube API-Dienste und die Richtlinien für Entwickler aktualisiert. Weitere Informationen finden Sie in den Änderungsverläufen für den YouTube Data API-Dienst und die Nutzungsbedingungen für die YouTube API-Dienste.
Eine channel
-Ressource enthält Informationen zu einem YouTube-Kanal.
Methoden
Die API unterstützt die folgenden Methoden für channels
-Ressourcen:
- list
- Gibt eine Sammlung von null oder mehr
channel
-Ressourcen zurück, die den Anfragekriterien entsprechen. Jetzt testen - aktualisieren
- Aktualisiert die Metadaten eines Kanals. Diese Methode unterstützt derzeit nur Aktualisierungen der
brandingSettings
- undinvideoPromotion
-Objekte derchannel
-Ressource und ihrer untergeordneten Eigenschaften. Jetzt testen
Ressourcendarstellung
Die folgende JSON-Struktur zeigt das Format einer channels
-Ressource:
{ "kind": "youtube#channel", "etag": etag, "id": string, "snippet": { "title": string, "description": string, "customUrl": string, "publishedAt": datetime, "thumbnails": { (key): { "url": string, "width": unsigned integer, "height": unsigned integer } }, "defaultLanguage": string, "localized": { "title": string, "description": string }, "country": string }, "contentDetails": { "relatedPlaylists": { "likes": string, "favorites": string, "uploads": string } }, "statistics": { "viewCount": unsigned long, "subscriberCount": unsigned long, // this value is rounded to three significant figures "hiddenSubscriberCount": boolean, "videoCount": unsigned long }, "topicDetails": { "topicIds": [ string ], "topicCategories": [ string ] }, "status": { "privacyStatus": string, "isLinked": boolean, "longUploadsStatus": string, "madeForKids": boolean, "selfDeclaredMadeForKids": boolean }, "brandingSettings": { "channel": { "title": string, "description": string, "keywords": string, "trackingAnalyticsAccountId": string, "unsubscribedTrailer": string, "defaultLanguage": string, "country": string }, "watch": { "textColor": string, "backgroundColor": string, "featuredPlaylistId": string } }, "auditDetails": { "overallGoodStanding": boolean, "communityGuidelinesGoodStanding": boolean, "copyrightStrikesGoodStanding": boolean, "contentIdClaimsGoodStanding": boolean }, "contentOwnerDetails": { "contentOwner": string, "timeLinked": datetime }, "localizations": { (key): { "title": string, "description": string } } }
Attribute
In der folgenden Tabelle sind die Eigenschaften aufgeführt, die in dieser Ressource angezeigt werden:
Attribute | |
---|---|
kind |
string Identifiziert den Typ der API-Ressource. Der Wert ist youtube#channel . |
etag |
etag Das Etag dieser Ressource. |
id |
string Die ID, mit der YouTube den Kanal eindeutig identifiziert. |
snippet |
object Das snippet -Objekt enthält grundlegende Details zum Kanal, z. B. seinen Titel, seine Beschreibung und Thumbnail-Bilder. |
snippet.title |
string Der Titel des Kanals. |
snippet.description |
string Die Beschreibung des Kanals. Der Wert der Property darf maximal 1.000 Zeichen lang sein. |
snippet.customUrl |
string Die benutzerdefinierte URL des Kanals. In der YouTube-Hilfe erfährst du, welche Voraussetzungen du erfüllen musst, um eine benutzerdefinierte URL zu erhalten, und wie du sie einrichtest. |
snippet.publishedAt |
datetime Das Datum und die Uhrzeit, an dem der Kanal erstellt wurde. Der Wert wird im ISO 8601-Format angegeben. |
snippet.thumbnails |
object Eine Karte mit Miniaturansichten, die mit dem Kanal verknüpft sind. Für jedes Objekt in der Zuordnung ist der Schlüssel der Name des Thumbnail-Bilds und der Wert ist ein Objekt mit weiteren Informationen zum Thumbnail. Achte beim Darstellen von Thumbnails in deiner App darauf, dass in deinem Code die Bild-URLs genau so verwendet werden, wie sie in API-Antworten zurückgegeben werden. Deine Anwendung sollte beispielsweise nicht die Domain http anstelle der Domain https in einer URL verwenden, die in einer API-Antwort zurückgegeben wird.URLs für Kanal-Thumbnails sind nur in der Domain https verfügbar. So werden die URLs in API-Antworten angezeigt. In deiner Anwendung werden möglicherweise fehlerhafte Bilder angezeigt, wenn versucht wird, YouTube-Bilder aus der Domain http zu laden. Bei neu erstellten Kanälen sind die Thumbnails möglicherweise leer und es kann bis zu einem Tag dauern, bis sie angezeigt werden. |
snippet.thumbnails.(key) |
object Gültige Schlüsselwerte:
|
snippet.thumbnails.(key).url |
string Die URL des Bildes. Weitere Richtlinien zur Verwendung von Thumbnail-URLs in deiner Anwendung findest du in der snippet.thumbnails -Property-Definition. |
snippet.thumbnails.(key).width |
unsigned integer Die Breite des Bilds. |
snippet.thumbnails.(key).height |
unsigned integer Die Höhe des Bilds. |
snippet.defaultLanguage |
string Die Sprache des Texts in den Eigenschaften snippet.title und snippet.description der channel -Ressource. |
snippet.localized |
object Das snippet.localized -Objekt enthält einen lokalisierten Titel und eine lokalisierte Beschreibung für den Kanal oder den Titel und die Beschreibung des Kanals in der Standardsprache der Metadaten des Kanals.
localizations können Sie lokalisierte Metadaten hinzufügen, aktualisieren oder löschen. |
snippet.localized.title |
string Der lokalisierte Kanaltitel. |
snippet.localized.description |
string Die lokalisierte Kanalbeschreibung. |
snippet.country |
string Das Land, mit dem der Kanal verknüpft ist. Wenn Sie den Wert für diese Property festlegen möchten, aktualisieren Sie den Wert der Property brandingSettings.channel.country . |
contentDetails |
object Das contentDetails -Objekt enthält Informationen zu den Inhalten des Kanals. |
contentDetails.relatedPlaylists |
object Das relatedPlaylists -Objekt ist eine Map, die Playlists identifiziert, die mit dem Kanal verknüpft sind, z. B. die hochgeladenen Videos oder die Videos mit „Mag ich“-Bewertungen des Kanals. Du kannst jede dieser Playlists mit der playlists.list -Methode abrufen. |
contentDetails.relatedPlaylists.likes |
string Die ID der Playlist, die die Videos enthält, die dem Kanal „Mag ich“ gegeben wurden. Mit den Methoden playlistItems.insert und playlistItems.delete können Sie Elemente dieser Liste hinzufügen oder daraus entfernen. |
contentDetails.relatedPlaylists.favorites |
string Diese Property wurde eingestellt. Die ID der Playlist, die die Lieblingsvideos des Kanals enthält. Mit den Methoden playlistItems.insert und playlistItems.delete kannst du Elemente zu dieser Liste hinzufügen oder daraus entfernen.Hinweis: Die Funktion „Lieblingsvideos“ wurde auf YouTube eingestellt. Die Property statistics.favoriteCount der Ressource video wurde beispielsweise am 28. August 2015 eingestellt. Aus diesem Grund kann dieser Property-Wert aus historischen Gründen eine Playlist-ID enthalten, die auf eine leere Playlist verweist und daher nicht abgerufen werden kann. |
contentDetails.relatedPlaylists.uploads |
string Die ID der Playlist, die die hochgeladenen Videos des Kanals enthält. Verwende die Methode videos.insert , um neue Videos hochzuladen, und die Methode videos.delete , um zuvor hochgeladene Videos zu löschen. |
statistics |
object Das statistics -Objekt enthält Statistiken für den Kanal. |
statistics.viewCount |
unsigned long Gibt an, wie oft der Kanal aufgerufen wurde. |
statistics.commentCount |
unsigned long Diese Property wird nicht mehr unterstützt. Die Anzahl der Kommentare zum Kanal. |
statistics.subscriberCount |
unsigned long Die Anzahl der Abonnenten des Kanals. Dieser Wert wird auf drei signifikante Stellen abgerundet. Weitere Informationen dazu, wie die Anzahl der Abonnenten gerundet wird, findest du in der Versionsgeschichte oder in der YouTube-Hilfe. |
statistics.videoCount |
unsigned long Die Anzahl der öffentlichen Videos, die auf den Kanal hochgeladen wurden. Hinweis: Der Wert gibt nur die Anzahl der öffentlichen Videos des Kanals an, auch für die Kanalinhaber. Dieser Wert stimmt mit den Angaben auf der YouTube-Website überein. |
topicDetails |
object Das topicDetails -Objekt enthält Informationen zu Themen, die mit dem Kanal verknüpft sind.Wichtig:Weitere Informationen zu Änderungen im Zusammenhang mit Themen-IDs finden Sie in der topicDetails.topicIds[] -Property-Definition und im Versionsverlauf. |
topicDetails.topicIds[] |
list Eine Liste der Themen-IDs, die mit dem Kanal verknüpft 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. Zu dieser Zeit gab YouTube eine kleine Auswahl an ausgewählten Themen-IDs zurück. |
topicDetails.topicCategories[] |
list Eine Liste von Wikipedia-URLs, die die Inhalte des Kanals beschreiben. |
status |
object Das status -Objekt enthält Informationen zum Datenschutzstatus des Kanals. |
status.privacyStatus |
string Datenschutzstatus des Kanals. Gültige Werte für dieses Attribut sind:
|
status.isLinked |
boolean Gibt an, ob in den Kanaldaten ein Nutzer angegeben ist, der bereits mit einem YouTube-Nutzernamen oder einem Google+-Konto verknüpft ist. Nutzer mit einer solchen Verknüpfung haben bereits eine öffentliche YouTube-Identität, die Voraussetzung für verschiedene Aktionen wie das Hochladen von Videos ist. |
status.longUploadsStatus |
string Gibt an, ob der Kanal Videos mit einer Länge von mehr als 15 Minuten hochladen kann. Diese Property wird nur zurückgegeben, wenn der Kanalinhaber die API-Anfrage autorisiert hat. Weitere Informationen zu dieser Funktion findest du in der YouTube-Hilfe. Gültige Werte für diese Property sind:
|
status.madeForKids |
boolean Dieser Wert gibt an, ob der Kanal als für Kinder geeignet gekennzeichnet ist. Außerdem enthält er den aktuellen Status „speziell für Kinder“ des Kanals. Der Status kann beispielsweise anhand des Werts der Property selfDeclaredMadeForKids ermittelt werden. Weitere Informationen dazu, wie du die Zielgruppe für deinen Kanal, deine Videos oder deine Übertragungen festlegst, findest du in der YouTube-Hilfe .
|
status.selfDeclaredMadeForKids |
boolean Mit dieser Property kann der Kanalinhaber in einer channels.update -Anfrage angeben, dass der Kanal auf Kinder ausgerichtet ist. Der Property-Wert wird nur zurückgegeben, wenn der Kanalinhaber die API-Anfrage autorisiert hat.
|
brandingSettings |
object Das brandingSettings -Objekt enthält Informationen zum Branding des Kanals. |
brandingSettings.channel |
object Das channel -Objekt umschließt Branding-Eigenschaften der Kanalseite. |
brandingSettings.channel.title |
string Der Titel des Kanals. Der Titel darf maximal 30 Zeichen lang sein. |
brandingSettings.channel.description |
string Die Kanalbeschreibung, die im Feld mit den Kanalinformationen auf deiner Kanalseite angezeigt wird. Der Wert der Property darf maximal 1.000 Zeichen lang sein. |
brandingSettings.channel.keywords |
string Keywords, die mit deinem Kanal verknüpft sind. Der Wert ist eine durch Leerzeichen getrennte Liste von Strings. Kanal-Keywords werden möglicherweise abgeschnitten, wenn sie die maximal zulässige Länge von 500 Zeichen überschreiten oder unescaped Anführungszeichen ( " ) enthalten. Das Limit von 500 Zeichen gilt nicht pro Keyword, sondern für die Gesamtlänge aller Keywords. |
brandingSettings.channel.trackingAnalyticsAccountId |
string Die ID eines Google Analytics-Kontos, mit dem du die Zugriffe auf deinen Kanal erfassen und analysieren möchtest. |
brandingSettings.channel.unsubscribedTrailer |
string Das Video, das in der Ansicht „Suchen“ auf der Kanalseite im Modul „Empfohlene Videos“ für Zuschauer ohne Abo wiedergegeben werden soll. Abonnenten sehen möglicherweise ein anderes Video, in dem aktuellere Kanalaktivitäten hervorgehoben werden. Wenn angegeben, muss der Wert der Property die YouTube-Video-ID eines öffentlichen oder nicht gelisteten Videos sein, dessen Inhaber der Kanalinhaber ist. |
brandingSettings.channel.defaultLanguage |
string Die Sprache des Texts in den Eigenschaften snippet.title und snippet.description der channel -Ressource. |
brandingSettings.channel.country |
string Das Land, mit dem der Kanal verknüpft ist. Aktualisieren Sie diese Property, um den Wert der Property snippet.country festzulegen. |
brandingSettings.watch |
object Hinweis:Dieses Objekt und alle untergeordneten Attribute wurden eingestellt. Das watch -Objekt umschließt Branding-Eigenschaften der Wiedergabeseiten für die Videos des Kanals. |
brandingSettings.watch.textColor |
string Hinweis:Dieses Attribut wird nicht mehr unterstützt. Die Textfarbe für den Markenbereich der Wiedergabeseite des Videos. |
brandingSettings.watch.backgroundColor |
string Hinweis:Dieses Attribut wird nicht mehr unterstützt. Die Hintergrundfarbe für den Markenbereich der Wiedergabeseite des Videos. |
brandingSettings.watch.featuredPlaylistId |
string Hinweis:Dieses Attribut wird nicht mehr unterstützt. Die API gibt einen Fehler zurück, wenn Sie versuchen, den Wert festzulegen. |
brandingSettings.image |
object Diese Property und alle untergeordneten Properties wurden eingestellt. Das image -Objekt enthält Informationen zu Bildern, die auf der Kanalseite oder auf Wiedergabeseiten von Videos angezeigt werden. |
brandingSettings.image.bannerImageUrl |
string Diese Property wird nicht mehr unterstützt. Die URL für das Bannerbild, das auf der Kanalseite auf der YouTube-Website angezeigt wird. Das Bild hat eine Größe von 1.060 x 175 Pixeln. |
brandingSettings.image.bannerMobileImageUrl |
string Diese Property wird nicht mehr unterstützt. Die URL für das Bannerbild, das in mobilen Apps auf der Kanalseite angezeigt wird. Das Bild hat eine Größe von 640 x 175 Pixeln. |
brandingSettings.image.watchIconImageUrl |
string Diese Property wird nicht mehr unterstützt. Die URL für das Bild, das über dem Videoplayer angezeigt wird. Das Bild ist 25 Pixel hoch und kann eine flexible Breite von maximal 170 Pixeln haben. Wenn Sie kein Bild hochladen, wird stattdessen Ihr Kanalname angezeigt. |
brandingSettings.image.trackingImageUrl |
string Diese Property wird nicht mehr unterstützt. Die URL eines 1 × 1 Pixel großen Tracking-Pixels, mit dem Statistiken zu Aufrufen der Kanal- oder Videoseite erfasst werden können. |
brandingSettings.image.bannerTabletLowImageUrl |
string Diese Property wird nicht mehr unterstützt. Die URL für ein Bannerbild mit niedriger Auflösung, das in Tablet-Apps auf der Kanalseite angezeigt wird. Die maximale Größe des Bildes beträgt 1.138 x 188 Pixel. |
brandingSettings.image.bannerTabletImageUrl |
string Diese Property wird nicht mehr unterstützt. Die URL für ein Bannerbild, das in Tablet-Apps auf der Kanalseite angezeigt wird. Das Bild hat eine Größe von 1.707 × 283 Pixeln. |
brandingSettings.image.bannerTabletHdImageUrl |
string Diese Property wird nicht mehr unterstützt. Die URL für ein hochauflösendes Bannerbild, das in Tablet-Apps auf der Kanalseite angezeigt wird. Die maximale Größe des Bildes beträgt 2.276 × 377 Pixel. |
brandingSettings.image.bannerTabletExtraHdImageUrl |
string Diese Property wird nicht mehr unterstützt. Die URL für ein Bannerbild mit besonders hoher Auflösung, das in Tablet-Apps auf der Kanalseite angezeigt wird. Die maximale Größe des Bildes beträgt 2.560 x 424 Pixel. |
brandingSettings.image.bannerMobileLowImageUrl |
string Diese Property wird nicht mehr unterstützt. Die URL für ein Bannerbild mit niedriger Auflösung, das in mobilen Apps auf der Kanalseite angezeigt wird. Die maximale Größe des Bildes beträgt 320 x 88 Pixel. |
brandingSettings.image.bannerMobileMediumHdImageUrl |
string Diese Property wird nicht mehr unterstützt. Die URL für ein Bannerbild in mittlerer Auflösung, das in mobilen Apps auf der Kanalseite angezeigt wird. Die maximale Größe des Bildes beträgt 960 x 263 Pixel. |
brandingSettings.image.bannerMobileHdImageUrl |
string Diese Property wird nicht mehr unterstützt. Die URL für ein hochauflösendes Bannerbild, das in mobilen Apps auf der Kanalseite angezeigt wird. Die maximale Größe des Bildes beträgt 1.280 x 360 Pixel. |
brandingSettings.image.bannerMobileExtraHdImageUrl |
string Diese Property wird nicht mehr unterstützt. Die URL für ein Bannerbild mit sehr hoher Auflösung, das in mobilen Apps auf der Kanalseite angezeigt wird. Die maximale Größe des Bildes beträgt 1.440 x 395 Pixel. |
brandingSettings.image.bannerTvImageUrl |
string Diese Property wird nicht mehr unterstützt. Die URL für ein Bannerbild mit besonders hoher Auflösung, das in Fernsehanwendungen auf der Kanalseite angezeigt wird. Die maximale Größe des Bildes beträgt 2.120 x 1.192 Pixel. |
brandingSettings.image.bannerTvLowImageUrl |
string Diese Property wird nicht mehr unterstützt. Die URL für ein Bannerbild mit niedriger Auflösung, das in Fernsehanwendungen auf der Kanalseite angezeigt wird. Die maximale Größe des Bildes beträgt 854 × 480 Pixel. |
brandingSettings.image.bannerTvMediumImageUrl |
string Diese Property wird nicht mehr unterstützt. Die URL für ein Bannerbild in mittlerer Auflösung, das in Fernsehanwendungen auf der Kanalseite angezeigt wird. Die maximale Größe des Bildes beträgt 1.280 × 720 Pixel. |
brandingSettings.image.bannerTvHighImageUrl |
string Diese Property wird nicht mehr unterstützt. Die URL für ein hochauflösendes Bannerbild, das in Fernsehanwendungen auf der Kanalseite angezeigt wird. Die maximale Größe des Bildes beträgt 1.920 x 1.080 Pixel. |
brandingSettings.image.bannerExternalUrl |
string Mit dieser Property wird der Speicherort des Bannerbilds angegeben, das YouTube verwendet, um die verschiedenen Bannerbildgrößen für einen Kanal zu generieren. |
brandingSettings.hints[] |
list Diese Property und alle untergeordneten Properties wurden eingestellt. Das hints -Objekt umschließt zusätzliche Branding-Eigenschaften. |
brandingSettings.hints[].property |
string Diese Property wird nicht mehr unterstützt. Eine Property. |
brandingSettings.hints[].value |
string Diese Property wird nicht mehr unterstützt. Der Wert der Property. |
auditDetails |
object Das auditDetails -Objekt umschließt Kanaldaten, die ein Multi-Channel-Netzwerk (MCN) bei der Entscheidung, ob ein bestimmter Kanal akzeptiert oder abgelehnt werden soll, auswerten würde. Jede API-Anfrage, mit der dieser Ressourcenteil abgerufen wird, muss ein Autorisierungstoken mit dem Bereich https://www.googleapis.com/auth/youtubepartner-channel-audit enthalten. Außerdem muss jedes Token, das diesen Umfang verwendet, widerrufen werden, wenn das MCN den Kanal akzeptiert oder ablehnt, oder innerhalb von zwei Wochen nach dem Datum, an dem das Token ausgestellt wurde. |
auditDetails.overallGoodStanding |
boolean Dieses Feld gibt an, ob Probleme mit dem Kanal vorliegen. Derzeit stellt dieses Feld das Ergebnis der logischen AND -Operation auf die Eigenschaften communityGuidelinesGoodStanding , copyrightStrikesGoodStanding und contentIdClaimsGoodStanding dar. Das bedeutet, dass diese Eigenschaft den Wert true hat, wenn alle anderen Eigenschaften ebenfalls den Wert true haben. Diese Eigenschaft hat jedoch den Wert false , wenn eine dieser Eigenschaften den Wert false hat. Die Methode, mit der der Wert dieser Property festgelegt wird, kann sich jedoch ändern. |
auditDetails.communityGuidelinesGoodStanding |
boolean Gibt an, ob der Kanal die Community-Richtlinien von YouTube einhält. |
auditDetails.copyrightStrikesGoodStanding |
boolean Gibt an, ob der Kanal Urheberrechtsverwarnungen hat. |
auditDetails.contentIdClaimsGoodStanding |
boolean Gibt an, ob für den Kanal noch nicht behobene Ansprüche vorliegen. |
contentOwnerDetails |
object Das Objekt contentOwnerDetails enthält Kanaldaten, die nur für den YouTube-Partner sichtbar sind, der den Kanal mit seinem Content-Manager verknüpft hat. |
contentOwnerDetails.contentOwner |
string Die ID des Rechteinhabers, der mit dem Kanal verknüpft ist. |
contentOwnerDetails.timeLinked |
datetime Datum und Uhrzeit, an dem der Kanal mit dem Rechteinhaber verknüpft wurde. Der Wert wird im ISO 8601-Format angegeben. |
localizations |
object Das localizations -Objekt umschließt Übersetzungen der Metadaten des Kanals. |
localizations.(key) |
object Die Sprache der lokalisierten Metadaten, die mit dem Schlüsselwert verknüpft sind. Der Wert ist ein String, der einen BCP-47-Sprachcode enthält. |
localizations.(key).title |
string Der lokalisierte Kanaltitel. |
localizations.(key).description |
string Die lokalisierte Kanalbeschreibung. |