Mit der API kannst du jetzt deinen Kanal oder deine Videos als „speziell für Kinder“ kennzeichnen. Darüber hinaus enthalten die Ressourcen von
channel
und video
jetzt ebenfalls eine Property, die den Status „Speziell für Kinder“ des Kanals oder Videos identifiziert. Die Nutzungsbedingungen für die YouTube API-Dienste und die Richtlinien für Entwickler wurden ebenfalls am 10. Januar 2020 aktualisiert. Weitere Informationen finden Sie im Überarbeitungsverlauf für den YouTube Data API-Dienst und in den Nutzungsbedingungen der 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 ausprobieren - Update
- Aktualisiert die Metadaten eines Kanals. Beachten Sie, dass diese Methode derzeit nur Aktualisierungen der
brandingSettings
- undinvideoPromotion
-Objekte derchannel
-Ressource und ihrer untergeordneten Attribute unterstützt. Jetzt ausprobieren
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 werden die Attribute definiert, 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. Titel, Beschreibung und Thumbnails. |
snippet.title |
string Der Titel des Kanals. |
snippet.description |
string Die Beschreibung des Kanals. Der Wert des Attributs darf maximal 1.000 Zeichen lang sein. |
snippet.customUrl |
string Die benutzerdefinierte URL des Kanals. In der YouTube-Hilfe wird erklärt, welche Voraussetzungen du erfüllen musst, um eine benutzerdefinierte URL zu erhalten. Außerdem erfährst du, wie du die URL einrichtest. |
snippet.publishedAt |
datetime Datum und Uhrzeit der Kanalerstellung. Der Wert wird im ISO 8601-Format angegeben. |
snippet.thumbnails |
object Eine Karte mit Thumbnail-Bildern, die mit dem Kanal verknüpft sind. Bei jedem Objekt auf der Karte ist der Schlüssel der Name der Miniaturansicht. Der Wert ist ein Objekt, das weitere Informationen zur Miniaturansicht enthält. Achten Sie beim Anzeigen von Miniaturansichten in Ihrer Anwendung darauf, dass Ihr Code die Bild-URLs genau so verwendet, wie sie in API-Antworten zurückgegeben werden. In Ihrer Anwendung sollte beispielsweise in einer URL, die in einer API-Antwort zurückgegeben wird, nicht die Domain http anstelle der Domain https verwendet werden.URLs der Kanalminiaturansicht sind nur in der Domain https verfügbar. So werden die URLs in API-Antworten angezeigt. Wenn versucht wird, YouTube-Bilder aus der Domain http zu laden, werden in deiner Anwendung möglicherweise fehlerhafte Bilder angezeigt. Bei neu erstellten Kanälen kann es bis zu einem Tag dauern, bis Thumbnail-Bilder angezeigt werden. |
snippet.thumbnails.(key) |
object Gültige Schlüssel/Wert-Paare sind:
|
snippet.thumbnails.(key).url |
string Die URL des Bildes. Weitere Richtlinien zur Verwendung von Miniaturansicht-URLs in deiner App findest du in der Attributdefinition snippet.thumbnails . |
snippet.thumbnails.(key).width |
unsigned integer Die Breite des Bildes. |
snippet.thumbnails.(key).height |
unsigned integer Die Höhe des Bildes. |
snippet.defaultLanguage |
string Die Sprache des Textes in den Attributen snippet.title und snippet.description der Ressource channel . |
snippet.localized |
object Das snippet.localized -Objekt enthält einen lokalisierten Titel und eine Beschreibung für den Kanal oder es enthält den Titel und die Beschreibung des Kanals in der Standardsprache für die Metadaten des Kanals.
localizations -Objekt kannst du 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. Aktualisieren Sie den Wert des Attributs brandingSettings.channel.country , um den Wert dieses Attributs festzulegen. |
contentDetails |
object Das contentDetails -Objekt enthält Informationen über die Inhalte des Kanals. |
contentDetails.relatedPlaylists |
object Das relatedPlaylists -Objekt ist eine Karte, die Playlists identifiziert, die mit dem Kanal verknüpft sind, z. B. hochgeladene oder mit „Mag ich“ bewertete Videos. Du kannst jede dieser Playlists mit der Methode playlists.list abrufen. |
contentDetails.relatedPlaylists.likes |
string Die ID der Playlist, die Videos mit „Mag ich“-Bewertungen für den Kanal enthält. Mit den Methoden playlistItems.insert und playlistItems.delete können Sie der Liste Einträge hinzufügen oder sie 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 zur Liste hinzufügen oder sie daraus entfernen.Hinweis: YouTube hat die beliebtesten Videofunktionen eingestellt. Beispiel: Das Attribut statistics.favoriteCount der Ressource video wurde am 28. August 2015 eingestellt. Aus historischen Gründen enthält dieser Property-Wert möglicherweise eine Playlist-ID, die auf eine leere Playlist verweist. Er kann daher nicht abgerufen werden. |
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 Channel. |
statistics.viewCount |
unsigned long Gibt an, wie oft der Kanal aufgerufen wurde. |
statistics.commentCount |
unsigned long Diese Property wurde eingestellt. Die Anzahl der Kommentare für den Kanal. |
statistics.subscriberCount |
unsigned long Die Anzahl der Abonnenten des Kanals. Dieser Wert wird auf drei signifikante Stellen abgerundet. Weitere Informationen dazu, wie Abonnentenzahlen gerundet werden, findest du im Überarbeitungsverlauf oder in der YouTube-Hilfe. |
statistics.videoCount |
unsigned long Die Anzahl an öffentlichen Videos, die auf den Kanal hochgeladen wurden. Der Wert spiegelt nur die Anzahl der öffentlichen Videos des Kanals wider, auch für die Inhaber. Dieses Verhalten entspricht der Anzahl, die auf der YouTube-Website angezeigt wird. |
topicDetails |
object Das topicDetails -Objekt enthält Informationen zu den mit dem Kanal verknüpften Themen.Wichtig:Weitere Informationen zu Änderungen an Themen-IDs finden Sie in der Property-Definition topicDetails.topicIds[] und im Überarbeitungsverlauf. |
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. Früher gab YouTube einige ausgewählte Themen-IDs zurück. |
topicDetails.topicCategories[] |
list Eine Liste mit 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 diese Property sind:
|
status.isLinked |
boolean Gibt an, ob in den Kanaldaten ein Nutzer identifiziert wird, der bereits mit einem YouTube-Nutzernamen oder einem Google+ Konto verknüpft ist. Ein Nutzer mit einem dieser Links hat bereits eine öffentliche YouTube-Identität, die Voraussetzung für verschiedene Aktionen, z. B. das Hochladen von Videos, ist. |
status.longUploadsStatus |
string Gibt an, ob der Kanal die Voraussetzungen für den Upload von Videos erfüllt, die länger als 15 Minuten sind. Diese Eigenschaft wird nur zurückgegeben, wenn der Kanalinhaber die API-Anfrage autorisiert hat. Weitere Informationen zu dieser Funktion finden Sie in der YouTube-Hilfe. Gültige Werte für diese Eigenschaft sind:
|
status.madeForKids |
boolean Dieser Wert gibt an, ob der Kanal als „Für Kinder“ 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 Sendungen festlegst, findest du in der YouTube-Hilfe.
|
status.selfDeclaredMadeForKids |
boolean Bei einer channels.update -Anfrage kann der Kanalinhaber den Kanal mit dieser Eigenschaft als auf Kinder ausgerichtet kennzeichnen. Der Attributwert 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 enthält die 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 „Kanalinformationen“ auf Ihrer Kanalseite angezeigt wird. Der Wert des Attributs darf maximal 1.000 Zeichen lang sein. |
brandingSettings.channel.keywords |
string Mit Ihrem Kanal verknüpfte Keywords. Der Wert ist eine durch Leerzeichen getrennte Liste von Strings. Keywords für Kanäle werden möglicherweise abgeschnitten, wenn sie die maximal zulässige Länge von 500 Zeichen überschreiten oder Anführungszeichen ohne Escape-Zeichen ( " ) enthalten sind. Die Beschränkung auf 500 Zeichen ist keine Beschränkung pro Keyword, sondern eine Begrenzung der Gesamtlänge aller Keywords. |
brandingSettings.channel.trackingAnalyticsAccountId |
string Die ID für ein Google Analytics-Konto, mit dem du die Zugriffe auf deinen Kanal erfassen und messen möchtest. |
brandingSettings.channel.unsubscribedTrailer |
string Das Video, das für Zuschauer ohne Abo im Modul „Angesagtes Video“ in der Übersichtsansicht der Kanalseite abgespielt werden soll. Zuschauer mit Abo sehen unter Umständen ein anderes Video, in dem aktuellere Kanalaktivitäten hervorgehoben werden. Der Wert der Property muss die YouTube-Video-ID eines öffentlichen oder nicht gelisteten Videos sein, dessen Inhaber der Kanalinhaber ist. |
brandingSettings.channel.defaultLanguage |
string Die Sprache des Textes in den Attributen snippet.title und snippet.description der Ressource channel . |
brandingSettings.channel.country |
string Das Land, mit dem der Kanal verknüpft ist. Aktualisieren Sie dieses Attribut, um den Wert der Eigenschaft snippet.country festzulegen. |
brandingSettings.watch |
object Hinweis:Dieses Objekt und alle untergeordneten Eigenschaften wurden verworfen. Das watch -Objekt enthält die Branding-Eigenschaften der Wiedergabeseiten für die Videos des Kanals. |
brandingSettings.watch.textColor |
string Hinweis:Diese Property wurde eingestellt. Die Textfarbe für den Markenbereich der Videowiedergabeseite. |
brandingSettings.watch.backgroundColor |
string Hinweis:Diese Property wurde eingestellt. Die Hintergrundfarbe des Markenbereichs auf der Wiedergabeseite eines Videos. |
brandingSettings.watch.featuredPlaylistId |
string Hinweis:Diese Property wurde eingestellt. 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 den Videowiedergabeseiten angezeigt werden. |
brandingSettings.image.bannerImageUrl |
string Diese Property wurde eingestellt. Die URL für das Bannerbild, das auf der Kanalseite der YouTube-Website angezeigt wird. Das Bild ist 1060 x 175 Pixel groß. |
brandingSettings.image.bannerMobileImageUrl |
string Diese Property wurde eingestellt. Die URL für das Bannerbild, das auf der Kanalseite in mobilen Apps angezeigt wird. Das Bild ist 640 x 175 Pixel groß. |
brandingSettings.image.watchIconImageUrl |
string Diese Property wurde eingestellt. Die URL für das Bild, das über dem Videoplayer angezeigt wird. Dies ist ein 25 Pixel hohes Bild mit einer flexiblen Breite von maximal 170 Pixeln. Wenn du dieses Bild nicht zur Verfügung stellst, wird anstelle eines Bildes dein Kanalname angezeigt. |
brandingSettings.image.trackingImageUrl |
string Diese Property wurde eingestellt. Die URL für ein 1 × 1 Pixel großes Tracking-Pixel, mit dem Statistiken zu Aufrufen des Kanals oder der Videoseiten erfasst werden können. |
brandingSettings.image.bannerTabletLowImageUrl |
string Diese Property wurde eingestellt. Die URL für ein Bannerbild mit niedriger Auflösung, das auf der Kanalseite in Apps für Tablets angezeigt wird. Die maximale Größe des Bildes beträgt 1138 x 188 Pixel. |
brandingSettings.image.bannerTabletImageUrl |
string Diese Property wurde eingestellt. Die URL für ein Bannerbild, das auf der Kanalseite in Tablet-Apps angezeigt wird. Das Bild ist 1707 x 283 Pixel groß. |
brandingSettings.image.bannerTabletHdImageUrl |
string Diese Property wurde eingestellt. Die URL für ein Bannerbild mit hoher Auflösung, das auf der Kanalseite in Apps für Tablets angezeigt wird. Die maximale Größe des Bildes beträgt 2.276 x 377 Pixel. |
brandingSettings.image.bannerTabletExtraHdImageUrl |
string Diese Property wurde eingestellt. Die URL für ein Bannerbild mit besonders hoher Auflösung, das auf der Kanalseite in Apps für Tablets angezeigt wird. Die maximale Größe des Bildes beträgt 2560 x 424 Pixel. |
brandingSettings.image.bannerMobileLowImageUrl |
string Diese Property wurde eingestellt. Die URL für ein Bannerbild mit niedriger Auflösung, das auf der Kanalseite in mobilen Apps angezeigt wird. Die maximale Größe des Bildes beträgt 320 x 88 Pixel. |
brandingSettings.image.bannerMobileMediumHdImageUrl |
string Diese Property wurde eingestellt. Die URL für ein Bannerbild mit mittlerer Auflösung, das auf der Kanalseite in mobilen Apps angezeigt wird. Die maximale Größe des Bildes beträgt 960 x 263 Pixel. |
brandingSettings.image.bannerMobileHdImageUrl |
string Diese Property wurde eingestellt. Die URL für ein Bannerbild mit hoher Auflösung, das in mobilen Apps auf der Kanalseite angezeigt wird. Das Bild darf maximal 1.280 x 360 Pixel groß sein. |
brandingSettings.image.bannerMobileExtraHdImageUrl |
string Diese Property wurde eingestellt. Die URL für ein Bannerbild mit sehr hoher Auflösung, das auf der Kanalseite in mobilen Apps angezeigt wird. Die maximale Größe des Bildes beträgt 1440 x 395 Pixel. |
brandingSettings.image.bannerTvImageUrl |
string Diese Property wurde eingestellt. Die URL für ein Bannerbild mit besonders hoher Auflösung, das auf der Kanalseite in Fernsehanwendungen angezeigt wird. Die maximale Größe des Bildes beträgt 2.120 x 1.192 Pixel. |
brandingSettings.image.bannerTvLowImageUrl |
string Diese Property wurde eingestellt. Die URL für ein Bannerbild mit niedriger Auflösung, das auf der Kanalseite in Fernsehanwendungen angezeigt wird. Das Bild darf maximal 854 x 480 Pixel groß sein. |
brandingSettings.image.bannerTvMediumImageUrl |
string Diese Property wurde eingestellt. Die URL für ein Bannerbild mit mittlerer Auflösung, das auf der Kanalseite in Fernsehanwendungen angezeigt wird. Die maximale Größe des Bildes beträgt 1.280 x 720 Pixel. |
brandingSettings.image.bannerTvHighImageUrl |
string Diese Property wurde eingestellt. Die URL für ein Bannerbild mit hoher Auflösung, das auf der Kanalseite in Fernsehanwendungen angezeigt wird. Die maximale Größe des Bildes beträgt 1.920 x 1.080 Pixel. |
brandingSettings.image.bannerExternalUrl |
string Diese Property gibt den Speicherort des Bannerbilds an, anhand dessen YouTube die verschiedenen Größen des Bannerbilds für einen Kanal generiert. |
brandingSettings.hints[] |
list Diese Property und alle untergeordneten Properties wurden eingestellt. Das hints -Objekt enthält zusätzliche Branding-Eigenschaften. |
brandingSettings.hints[].property |
string Diese Property wurde eingestellt. Eine Property. |
brandingSettings.hints[].value |
string Diese Property wurde eingestellt. Der Wert der Property. |
auditDetails |
object Das auditDetails -Objekt enthält Kanaldaten, die von einem Multi-Channel-Netzwerk (MCN) ausgewertet werden, um zu ermitteln, ob ein bestimmter Kanal akzeptiert oder abgelehnt wird. Beachten Sie, dass jede API-Anfrage, mit der dieser Ressourcenteil abgerufen wird, ein Autorisierungstoken mit dem Bereich https://www.googleapis.com/auth/youtubepartner-channel-audit enthalten muss. Darüber hinaus muss jedes Token, das diesen Geltungsbereich verwendet, widerrufen werden, wenn das MCN den Kanal akzeptiert oder ablehnt oder innerhalb von zwei Wochen nach Ausstellung des Tokens. |
auditDetails.overallGoodStanding |
boolean In diesem Feld wird angegeben, ob Probleme mit dem Kanal vorliegen. Derzeit stellt dieses Feld das Ergebnis des logischen AND -Vorgangs für die Attribute communityGuidelinesGoodStanding , copyrightStrikesGoodStanding und contentIdClaimsGoodStanding dar. Das bedeutet, dass dieses Attribut den Wert true hat, wenn alle anderen Eigenschaften auch den Wert true haben. Diese Property hat jedoch den Wert false , wenn eine dieser Properties den Wert false hat. Die Methode, die zum Festlegen des Werts dieser Eigenschaft verwendet wird, kann sich jedoch ändern. |
auditDetails.communityGuidelinesGoodStanding |
boolean Gibt an, ob der Kanal die Community-Richtlinien von YouTube erfüllt. |
auditDetails.copyrightStrikesGoodStanding |
boolean Gibt an, ob der Kanal Urheberrechtsverwarnungen erhalten hat. |
auditDetails.contentIdClaimsGoodStanding |
boolean Gibt an, ob für den Kanal noch nicht geklärte Ansprüche vorliegen. |
contentOwnerDetails |
object Das contentOwnerDetails -Objekt 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 der Verknüpfung des Kanals mit dem Rechteinhaber. Der Wert wird im ISO 8601-Format angegeben. |
localizations |
object Das localizations -Objekt enthält Übersetzungen der Metadaten des Kanals. |
localizations.(key) |
object Die Sprache der lokalisierten Metadaten, die mit dem Schlüssel/Wert-Paar 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. |