Mit der API kannst du jetzt deinen Kanal oder
Videos als „speziell für Kinder“ gekennzeichnet werden. Außerdem
channel
und video
enthalten jetzt auch eine Property, die die Kennzeichnung "Speziell für Kinder"
Status des Kanals oder Videos. Nutzungsbedingungen der YouTube API-Dienste und Richtlinien für Entwickler
wurden ebenfalls am 10. Januar 2020 aktualisiert. Weitere Informationen finden Sie im Überarbeitungsverlauf der
den YouTube Data API-Dienst und die
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 testen - 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 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 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, die YouTube zur eindeutigen Identifizierung des Kanals verwendet. |
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 der Eigenschaft 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 die URL einrichtest. |
snippet.publishedAt |
datetime Datum und Uhrzeit der Kanalerstellung. Der Wert wird im ISO 8601-Format angegeben. |
snippet.thumbnails |
object Eine Übersicht mit Thumbnails, die mit dem Kanal verknüpft sind. Für jedes Objekt in der Karte ist der Schlüssel der Name der Miniaturansicht und der Wert 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. Ihre Anwendung sollte beispielsweise in einer URL, die in einer API-Antwort zurückgegeben wird, nicht die Domain http anstelle der Domain https verwenden.URLs für Kanal-Thumbnails sind nur in der Domain https verfügbar. So werden die URLs in API-Antworten angezeigt. Möglicherweise werden in deiner Anwendung fehlerhafte Bilder angezeigt, wenn versucht wird, YouTube-Bilder aus der Domain http zu laden. Bei neu erstellten Kanälen kann es bis zu einem Tag dauern, bis Thumbnail-Bilder leer sind. |
snippet.thumbnails.(key) |
object Gültige Schlüssel/Wert-Paare sind:
|
snippet.thumbnails.(key).url |
string Die URL des Bilds. Weitere Richtlinien zur Verwendung von Miniaturansicht-URLs in deiner Anwendung findest du in der Definition der snippet.thumbnails -Property. |
snippet.thumbnails.(key).width |
unsigned integer Die Breite des Bilds. |
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 lokalisierte Beschreibung für den Kanal oder den Titel und die Beschreibung des Kanals in der Standardsprache für die Metadaten des Kanals.
localizations 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. Wenn du den Wert dieses Attributs festlegen möchtest, aktualisiere den Wert des Attributs brandingSettings.channel.country . |
contentDetails |
object Das Objekt contentDetails enthält Informationen zum Kanalinhalt. |
contentDetails.relatedPlaylists |
object Das relatedPlaylists -Objekt ist eine Zuordnung, die Playlists identifiziert, die mit dem Kanal verknüpft sind, z. B. hochgeladene Videos oder Videos mit „Mag ich“-Bewertung. Du kannst jede dieser Playlists mithilfe der playlists.list -Methode abrufen. |
contentDetails.relatedPlaylists.likes |
string Die ID der Playlist, die die Videos mit „Mag ich“-Bewertung des Kanals enthält. Verwenden Sie die Methoden playlistItems.insert und playlistItems.delete , um Elemente zur Liste hinzuzufügen oder daraus zu entfernen. |
contentDetails.relatedPlaylists.favorites |
string Diese Eigenschaft wurde eingestellt. Die ID der Playlist, die die Lieblingsvideos des Kanals enthält. Mit den Methoden playlistItems.insert und playlistItems.delete können Sie Elemente zu dieser Liste hinzufügen oder daraus entfernen.Hinweis: YouTube hat die Funktion für Lieblingsvideos eingestellt. Beispielsweise wurde das Attribut statistics.favoriteCount der Ressource video am 28. August 2015 eingestellt. Aus historischen Gründen kann dieser Property-Wert daher 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. Verwenden Sie die Methode videos.insert , um neue Videos hochzuladen, und die Methode videos.delete , um zuvor hochgeladene Videos zu löschen. |
statistics |
object Das Objekt statistics 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 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 abgerundet signifikant sind. In der Überarbeitungsverlauf oder den Weitere Informationen findest du in der YouTube-Hilfe. Details zur gerundeten Abonnentenzahl |
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. Dieses Verhalten entspricht der Anzahl die auf der YouTube-Website angezeigt werden sollen. |
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 Überarbeitungsverlauf. |
topicDetails.topicIds[] |
list Eine Liste der mit dem Kanal verknüpften Themen-IDs. Diese Property wurde am 10. November 2016 eingestellt. Sie wird bis zum 10. November 2017 unterstützt. Wichtig:Da Freebase und die Freebase API eingestellt wurden, funktionieren Themen-IDs seit dem 27. Februar 2017 anders. Zu diesem Zeitpunkt gab YouTube eine kleine Auswahl ausgewählter Themen-IDs zurück. |
topicDetails.topicCategories[] |
list Eine Liste mit Wikipedia-URLs, die den Inhalt des Kanals beschreiben. |
status |
object Das Objekt status enthält Informationen zum Datenschutzstatus des Kanals. |
status.privacyStatus |
string Datenschutzstatus des Kanals. Gültige Werte für diese Property:
|
status.isLinked |
boolean Gibt an, ob die Kanaldaten einen Nutzer identifizieren, der bereits mit einem YouTube-Nutzernamen oder einem Google+ Konto verknüpft ist. Ein Nutzer, der über einen dieser Links verfügt, verfügt bereits über eine öffentliche YouTube-Identität, die für verschiedene Aktionen wie das Hochladen von Videos erforderlich ist. |
status.longUploadsStatus |
string Gibt an, ob auf dem Kanal Videos mit einer Länge von mehr als 15 Minuten hochgeladen werden können. Diese Eigenschaft 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 auf Kinder ausgerichtet gekennzeichnet ist. Er enthält die aktuelle „speziell für Kinder“- Status des Kanals. Der Status kann beispielsweise wird anhand des Werts der selfDeclaredMadeForKids -Eigenschaft festgelegt. Weitere Informationen finden Sie in der
YouTube-Hilfe
Informationen zum Festlegen der Zielgruppe für deinen Kanal, deine Videos oder deine Übertragungen
|
status.selfDeclaredMadeForKids |
boolean In einer channels.update -Anfrage
Mit dieser Property kann der Kanalinhaber festlegen, dass der Kanal auf Kinder ausgerichtet ist. Die
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 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 auf Ihrer Kanalseite im Feld mit den Kanalinformationen angezeigt wird Der Wert der Eigenschaft darf maximal 1.000 Zeichen lang sein. |
brandingSettings.channel.keywords |
string Mit deinem Kanal verknüpfte Keywords. 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. Hinweis: 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 messen möchtest. |
brandingSettings.channel.unsubscribedTrailer |
string Das Video, das im Modul „Vorgestelltes Video“ in der Ansicht „Übersicht“ auf der Kanalseite für Zuschauer ohne Abo abgespielt werden soll. Abonnenten sehen möglicherweise ein anderes Video, das aktuellere Kanalaktivitäten hervorhebt. Falls angegeben, muss der Wert der Property die YouTube-Video-ID eines öffentlichen oder nicht gelisteten Videos sein, das dem Kanalinhaber gehört. |
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 des Attributs snippet.country festzulegen. |
brandingSettings.watch |
object Hinweis:Dieses Objekt und alle untergeordneten Attribute wurden eingestellt. Das watch -Objekt enthält die Markeneigenschaften der Wiedergabeseiten für die Videos des Kanals. |
brandingSettings.watch.textColor |
string Hinweis:Diese Property wurde eingestellt. Die Textfarbe für den Markenbereich der Wiedergabeseite des Videos. |
brandingSettings.watch.backgroundColor |
string Hinweis:Diese Property wurde eingestellt. Die Hintergrundfarbe für den Markenbereich der Wiedergabeseite des 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 des Kanals 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 Sie dieses Bild nicht zur Verfügung stellen, wird anstelle eines Bildes Ihr Kanalname angezeigt. |
brandingSettings.image.trackingImageUrl |
string Diese Property wurde eingestellt. Die URL für ein 1 x 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 Tablet-Apps angezeigt wird Das Bild darf maximal 1.138 x 188 Pixel groß sein. |
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 1.707 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 Tablet-Apps angezeigt wird Das Bild darf maximal 2.276 x 377 Pixel groß sein. |
brandingSettings.image.bannerTabletExtraHdImageUrl |
string Diese Property wurde eingestellt. Die URL für ein Bannerbild mit besonders hoher Auflösung, das auf der Kanalseite in Tablet-Apps angezeigt wird Das Bild darf maximal 2.560 x 424 Pixel groß sein. |
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. Das Bild darf maximal 320 x 88 Pixel groß sein. |
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 Das Bild darf maximal 960 x 263 Pixel groß sein. |
brandingSettings.image.bannerMobileHdImageUrl |
string Diese Property wurde eingestellt. Die URL für ein Bannerbild mit hoher Auflösung, das auf der Kanalseite in mobilen Apps 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. Das Bild darf maximal 1.440 x 395 Pixel groß sein. |
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. Das Bild darf maximal 2.120 x 1.192 Pixel groß sein. |
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. Das Bild darf maximal 1.280 x 720 Pixel groß sein. |
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. Das Bild darf maximal 1.920 x 1.080 Pixel groß sein. |
brandingSettings.image.bannerExternalUrl |
string Diese Eigenschaft gibt den Speicherort des Bannerbilds an, das YouTube zur Generierung des Bannerbilds verwendet. verschiedene Größen von Bannerbildern für einen Kanal auswählen. |
brandingSettings.hints[] |
list Diese Property und alle untergeordneten Properties wurden eingestellt. Das hints -Objekt enthält zusätzliche Markeneigenschaften. |
brandingSettings.hints[].property |
string Diese Property wurde eingestellt. Eine Property. |
brandingSettings.hints[].value |
string Diese Property wurde eingestellt. Der Wert der Eigenschaft. |
auditDetails |
object Das auditDetails -Objekt enthält Kanaldaten, die ein Multi-Channel-Netzwerk (MCN) auswerten würde, um zu entscheiden, ob ein bestimmter Kanal akzeptiert oder abgelehnt wird. Beachten Sie, dass jede API-Anfrage, die diesen Ressourcenteil abruft, ein Autorisierungstoken bereitstellen muss, das den Bereich https://www.googleapis.com/auth/youtubepartner-channel-audit enthält. Außerdem muss jedes Token, das diesen Geltungsbereich nutzt, widerrufen werden, wenn das MCN den Kanal akzeptiert oder ablehnt oder innerhalb von zwei Wochen nach der Ausstellung des Tokens. |
auditDetails.overallGoodStanding |
boolean In diesem Feld wird angegeben, ob es Probleme mit dem Kanal gibt. Derzeit stellt dieses Feld das Ergebnis des logischen AND -Vorgangs über die Eigenschaften communityGuidelinesGoodStanding , copyrightStrikesGoodStanding und contentIdClaimsGoodStanding dar. Das bedeutet, dass diese Eigenschaft den Wert true hat, wenn alle anderen Eigenschaften auch den Wert true haben. Dieses Attribut hat jedoch den Wert false , wenn eine dieser Attribute den Wert false hat. Die Methode zum Festlegen des Werts dieser Eigenschaft 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 für den Kanal Urheberrechtsverwarnungen vorliegen. |
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 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 |