channel und video jetzt eine Property, die den Status „speziell für Kinder“ des Kanals oder Videos angibt. Die Nutzungsbedingungen der YouTube API-Dienste und die Richtlinien für Entwickler wurden am 10. Januar 2020 aktualisiert. Weitere Informationen finden Sie im Überarbeitungsverlauf 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 - update
- Aktualisiert die Metadaten eines Kanals. Diese Methode unterstützt derzeit nur Aktualisierungen der Objekte
brandingSettingsundinvideoPromotionder Ressourcechannelund ihrer untergeordneten Properties. 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 enthalten sind:
| Attribute | |
|---|---|
kind |
stringGibt den Typ der API-Ressource an. Der Wert ist youtube#channel. |
etag |
etagDas ETag dieser Ressource. |
id |
stringDie ID, die YouTube zur eindeutigen Identifizierung des Kanals verwendet. |
snippet |
objectDas snippet-Objekt enthält grundlegende Details zum Kanal, z. B. Titel, Beschreibung und Thumbnail-Bilder. |
snippet.title |
stringDer Titel des Kanals. |
snippet.description |
stringDie Beschreibung des Kanals. Der Wert des Attributs darf maximal 1.000 Zeichen lang sein. |
snippet.customUrl |
stringDie benutzerdefinierte URL des Kanals. In der YouTube-Hilfe werden die Teilnahmevoraussetzungen für eine benutzerdefinierte URL sowie die Einrichtung der URL erläutert. |
snippet.publishedAt |
datetimeDatum und Uhrzeit der Erstellung des Kanals. Der Wert wird im ISO 8601-Format angegeben. |
snippet.thumbnails |
objectEine Zuordnung von Thumbnail-Bildern, die mit dem Kanal verknüpft sind. Für jedes Objekt in der Zuordnung ist der Schlüssel der Name des Thumbnail-Bildes und der Wert ein Objekt, das andere Informationen zum Thumbnail enthält. Wenn Sie Thumbnails in Ihrer Anwendung anzeigen, achten Sie 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.Channel-Thumbnail-URLs sind nur in der Domain https verfügbar. So werden die URLs auch in API-Antworten angezeigt. Wenn Ihre Anwendung versucht, YouTube-Bilder aus der Domain http zu laden, werden möglicherweise fehlerhafte Bilder angezeigt. Bei neu erstellten Kanälen sind möglicherweise keine Miniaturansichten vorhanden. Es kann bis zu einem Tag dauern, bis sie angezeigt werden. |
snippet.thumbnails.(key) |
objectGültige Schlüsselwerte sind:
|
snippet.thumbnails.(key).url |
stringDie URL des Bildes. Weitere Richtlinien zur Verwendung von Thumbnail-URLs in Ihrer Anwendung finden Sie in der Definition der Property snippet.thumbnails. |
snippet.thumbnails.(key).width |
unsigned integerDie Breite des Bilds. |
snippet.thumbnails.(key).height |
unsigned integerDie Höhe des Bilds. |
snippet.defaultLanguage |
stringDie Sprache des Texts in den Eigenschaften snippet.title und snippet.description der channel-Ressource. |
snippet.localized |
objectDas Objekt snippet.localized 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-Objekt können Sie lokalisierte Metadaten hinzufügen, aktualisieren oder löschen. |
snippet.localized.title |
stringDer lokalisierte Kanaltitel. |
snippet.localized.description |
stringDie lokalisierte Kanalbeschreibung. |
snippet.country |
stringDas Land, dem der Channel zugeordnet ist. Wenn Sie den Wert dieses Attributs festlegen möchten, aktualisieren Sie den Wert des Attributs brandingSettings.channel.country. |
contentDetails |
objectDas contentDetails-Objekt enthält Informationen zum Inhalt des Kanals. |
contentDetails.relatedPlaylists |
objectDas Objekt relatedPlaylists ist eine Zuordnung, die Playlists identifiziert, die mit dem Kanal verknüpft sind, z. B. die hochgeladenen Videos oder die Videos, die dem Kanalinhaber gefallen. Du kannst jede dieser Playlists mit der Methode playlists.list abrufen. |
contentDetails.relatedPlaylists.likes |
stringDie ID der Playlist, die die Videos enthält, die dem Kanal gefallen. Verwenden Sie die Methoden playlistItems.insert und playlistItems.delete, um Elemente zu dieser Liste hinzuzufügen oder daraus zu entfernen. |
contentDetails.relatedPlaylists.favorites |
stringDiese Eigenschaft ist veraltet. 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: YouTube hat die Funktion für Lieblingsvideos eingestellt. Beispielsweise wurde das Attribut statistics.favoriteCount der Ressource video am 28. August 2015 eingestellt. Aus diesem Grund kann dieser Attributwert aus historischen Gründen eine Playlist-ID enthalten, die sich auf eine leere Playlist bezieht und daher nicht abgerufen werden kann. |
contentDetails.relatedPlaylists.uploads |
stringDie 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 |
objectDas statistics-Objekt kapselt Statistiken für den Channel. |
statistics.viewCount |
unsigned longDie Summe der Aufrufe aller Videos in allen Formaten für einen Kanal. Ab dem 24. August 2026 werden in |
statistics.commentCount |
unsigned longDieses Attribut wird nicht mehr unterstützt. Die Anzahl der Kommentare für den Kanal. |
statistics.subscriberCount |
unsigned longDie Anzahl der Abonnenten des Kanals. Dieser Wert wird auf drei signifikante Stellen abgerundet. Weitere Informationen zur Rundung von Abonnentenzahlen findest du im Überarbeitungsverlauf oder in der YouTube-Hilfe. |
statistics.videoCount |
unsigned longDie Anzahl der öffentlichen Videos, die auf den Kanal hochgeladen wurden. Der Wert spiegelt nur die Anzahl der öffentlichen Videos des Kanals wider, auch für Inhaber. Dieses Verhalten entspricht den Zählungen auf der YouTube-Website. |
topicDetails |
objectDas 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 Definition der Property topicDetails.topicIds[] und im Überarbeitungsverlauf. |
topicDetails.topicIds[] |
listEine 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:Aufgrund der Einstellung von Freebase und der Freebase API funktionieren Themen-IDs seit dem 27. Februar 2017 anders. Zu diesem Zeitpunkt begann YouTube, eine kleine Anzahl kuratierter Themen-IDs zurückzugeben. |
topicDetails.topicCategories[] |
listEine Liste von Wikipedia-URLs, die den Inhalt des Kanals beschreiben. |
status |
objectDas status-Objekt enthält Informationen zum Datenschutzstatus des Kanals. |
status.privacyStatus |
stringDatenschutzstatus des Channels. Gültige Werte für diese Property sind:
|
status.isLinked |
booleanGibt an, ob die Kanaldaten einen Nutzer identifizieren, der bereits mit einem YouTube-Nutzernamen oder einem Google+-Konto verknüpft ist. Nutzer, die einen dieser Links haben, haben bereits eine öffentliche YouTube-Identität. Diese ist Voraussetzung für verschiedene Aktionen, z. B. das Hochladen von Videos. |
status.longUploadsStatus |
stringGibt an, ob der Kanal berechtigt ist, Videos mit einer Länge von mehr als 15 Minuten hochzuladen. 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 |
booleanDieser Wert gibt an, ob der Kanal als „speziell für Kinder“ gekennzeichnet ist, und enthält den aktuellen Status des Kanals in Bezug auf die Ausrichtung auf Kinder. Der Status kann beispielsweise anhand des Werts des Attributs selfDeclaredMadeForKids bestimmt 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 channels.update-Anfrage kann der Kanalinhaber mit dieser Property den Kanal als auf Kinder ausgerichtet kennzeichnen. Der Attributwert wird nur zurückgegeben, wenn der Kanalinhaber die API-Anfrage autorisiert hat.
|
brandingSettings |
objectDas brandingSettings-Objekt enthält Informationen zum Branding des Kanals. |
brandingSettings.channel |
objectDas channel-Objekt kapselt Branding-Eigenschaften der Kanalseite. |
brandingSettings.channel.title |
stringDer Titel des Kanals. Der Titel darf maximal 30 Zeichen lang sein. |
brandingSettings.channel.description |
stringDie Kanalbeschreibung, die im Infofeld auf deiner Kanalseite angezeigt wird. Der Wert des Attributs darf maximal 1.000 Zeichen lang sein. |
brandingSettings.channel.keywords |
stringKeywords, die mit deinem Kanal verknüpft sind. Der Wert ist eine durch Leerzeichen getrennte Liste von Strings. Kanal-Keywords werden möglicherweise gekürzt, wenn sie die maximal zulässige Länge von 500 Zeichen überschreiten oder wenn sie nicht maskierte Anführungszeichen ( ") enthalten. Die Beschränkung auf 500 Zeichen gilt nicht pro Keyword, sondern für die Gesamtlänge aller Keywords. |
brandingSettings.channel.trackingAnalyticsAccountId |
stringDie ID für ein Google Analytics-Konto, mit dem du die Zugriffe auf deinen Kanal erfassen und messen möchtest. |
brandingSettings.channel.unsubscribedTrailer |
stringDas Video, das im Modul für angesagte Videos in der Übersicht der Kanalseite für nicht abonnierte Zuschauer abgespielt werden soll. Abonnenten sehen möglicherweise ein anderes Video, in dem die neuesten Kanalaktivitäten hervorgehoben werden. Wenn 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 |
stringDie Sprache des Texts in den Eigenschaften snippet.title und snippet.description der channel-Ressource. |
brandingSettings.channel.country |
stringDas Land, mit dem der Kanal verknüpft ist. Aktualisieren Sie diese Property, um den Wert der Property snippet.country festzulegen. |
brandingSettings.watch |
objectHinweis:Dieses Objekt und alle untergeordneten Properties werden nicht mehr unterstützt. Das watch-Objekt enthält Branding-Eigenschaften der Wiedergabeseiten für die Videos des Kanals. |
brandingSettings.watch.textColor |
stringHinweis: Diese Property wurde verworfen. Die Textfarbe für den gebrandeten Bereich der Wiedergabeseite. |
brandingSettings.watch.backgroundColor |
stringHinweis: Diese Property wurde verworfen. Die Hintergrundfarbe des gebrandeten Bereichs der Wiedergabeseite. |
brandingSettings.watch.featuredPlaylistId |
stringHinweis:Diese Eigenschaft wurde eingestellt. Die API gibt einen Fehler zurück, wenn Sie versuchen, den Wert festzulegen. |
brandingSettings.image |
objectDiese Property und alle untergeordneten Properties wurden eingestellt. Das image-Objekt enthält Informationen zu Bildern, die auf der Kanalseite oder auf den Wiedergabeseiten von Videos des Kanals angezeigt werden. |
brandingSettings.image.bannerImageUrl |
stringDiese Property wird nicht mehr unterstützt. Die URL des Kanalbanners, das auf der Kanalseite auf der YouTube-Website angezeigt wird. Das Bild hat eine Größe von 1.060 × 175 Pixel. |
brandingSettings.image.bannerMobileImageUrl |
stringDieses Attribut wird nicht mehr unterstützt. Die URL für das Kanalbanner, das auf der Kanalseite in mobilen Apps angezeigt wird. Das Bild hat eine Größe von 640 × 175 Pixel. |
brandingSettings.image.watchIconImageUrl |
stringDieses Attribut wird nicht mehr unterstützt. Die URL für das Bild, das über dem Videoplayer angezeigt wird. Das Bild ist 25 Pixel hoch und hat eine flexible Breite von maximal 170 Pixeln. Wenn Sie kein Bild angeben, wird stattdessen Ihr Kanalname angezeigt. |
brandingSettings.image.trackingImageUrl |
stringDieses Attribut wird nicht mehr unterstützt. Die URL für ein 1 × 1 Pixel großes Tracking-Pixel, mit dem Statistiken zu Aufrufen der Kanal- oder Videoseiten erhoben werden können. |
brandingSettings.image.bannerTabletLowImageUrl |
stringDieses Attribut wird nicht mehr unterstützt. Die URL für ein Kanalbanner mit niedriger Auflösung, das auf der Kanalseite in Tablet-Apps angezeigt wird. Die maximale Größe des Bildes beträgt 1.138 × 188 Pixel. |
brandingSettings.image.bannerTabletImageUrl |
stringDiese Property wird nicht mehr unterstützt. Die URL für ein Kanalbanner, das auf der Kanalseite in Tablet-Anwendungen angezeigt wird. Das Bild ist 1707 × 283 Pixel groß. |
brandingSettings.image.bannerTabletHdImageUrl |
stringDieses Attribut wird nicht mehr unterstützt. Die URL für ein hochauflösendes Kanalbanner, das auf der Kanalseite in Tablet-Anwendungen angezeigt wird. Die maximale Bildgröße beträgt 2.276 × 377 Pixel. |
brandingSettings.image.bannerTabletExtraHdImageUrl |
stringDiese Property wird nicht mehr unterstützt. Die URL für ein Kanalbanner mit besonders hoher Auflösung, das auf der Kanalseite in Tablet-Anwendungen angezeigt wird. Die maximale Bildgröße beträgt 2.560 × 424 Pixel. |
brandingSettings.image.bannerMobileLowImageUrl |
stringDieses Attribut wird nicht mehr unterstützt. Die URL für ein Kanalbanner mit niedriger Auflösung, das auf der Kanalseite in mobilen Apps angezeigt wird. Die maximale Größe des Bildes beträgt 320 × 88 Pixel. |
brandingSettings.image.bannerMobileMediumHdImageUrl |
stringDieses Attribut wird nicht mehr unterstützt. Die URL für ein Kanalbanner mit mittlerer Auflösung, das auf der Kanalseite in mobilen Apps angezeigt wird. Die maximale Bildgröße beträgt 960 × 263 Pixel. |
brandingSettings.image.bannerMobileHdImageUrl |
stringDieses Attribut wird nicht mehr unterstützt. Die URL für ein hochauflösendes Kanalbanner, das auf der Kanalseite in mobilen Apps angezeigt wird. Die maximale Bildgröße beträgt 1.280 × 360 Pixel. |
brandingSettings.image.bannerMobileExtraHdImageUrl |
stringDiese Property wird nicht mehr unterstützt. Die URL für ein Kanalbanner mit sehr hoher Auflösung, das auf der Kanalseite in mobilen Apps angezeigt wird. Die maximale Bildgröße beträgt 1.440 × 395 Pixel. |
brandingSettings.image.bannerTvImageUrl |
stringDiese Property wird nicht mehr unterstützt. Die URL für ein Kanalbanner mit besonders hoher Auflösung, das auf der Kanalseite in TV-Apps angezeigt wird. Die maximale Bildgröße beträgt 2.120 × 1.192 Pixel. |
brandingSettings.image.bannerTvLowImageUrl |
stringDiese Property wird nicht mehr unterstützt. Die URL für ein Kanalbanner mit niedriger Auflösung, das auf der Kanalseite in TV-Apps angezeigt wird. Die maximale Bildgröße beträgt 854 × 480 Pixel. |
brandingSettings.image.bannerTvMediumImageUrl |
stringDiese Property wird nicht mehr unterstützt. Die URL für ein Kanalbanner mit mittlerer Auflösung, das auf der Kanalseite in TV-Anwendungen angezeigt wird. Die maximale Bildgröße beträgt 1280 × 720 Pixel. |
brandingSettings.image.bannerTvHighImageUrl |
stringDieses Attribut wird nicht mehr unterstützt. Die URL für ein hochauflösendes Kanalbanner, das auf der Kanalseite in TV-Anwendungen angezeigt wird. Die maximale Bildgröße beträgt 1.920 × 1.080 Pixel. |
brandingSettings.image.bannerExternalUrl |
stringMit dieser Eigenschaft wird der Speicherort des Kanalbanners angegeben, das YouTube zum Generieren der verschiedenen Bannerbildgrößen für einen Kanal verwendet. |
brandingSettings.hints[] |
listDiese Property und alle untergeordneten Properties wurden eingestellt. Das hints-Objekt enthält zusätzliche Branding-Eigenschaften. |
brandingSettings.hints[].property |
stringDiese Property wird nicht mehr unterstützt. Eine Property. |
brandingSettings.hints[].value |
stringDiese Property wird nicht mehr unterstützt. Der Wert des Attributs. |
auditDetails |
objectDas Objekt auditDetails enthält Kanaldaten, die ein Multi-Channel-Netzwerk (MCN) auswertet, um zu entscheiden, ob ein bestimmter Kanal akzeptiert oder abgelehnt werden soll. Für jede API-Anfrage, mit der dieser Ressourcenteil abgerufen wird, muss ein Autorisierungstoken mit dem Bereich https://www.googleapis.com/auth/youtubepartner-channel-audit angegeben werden. Außerdem muss jedes Token, das diesen Bereich verwendet, widerrufen werden, wenn das MCN den Kanal akzeptiert oder ablehnt, oder innerhalb von zwei Wochen nach dem Ausstellungsdatum des Tokens. |
auditDetails.overallGoodStanding |
booleanDieses Feld gibt an, ob es Probleme mit dem Kanal gibt. Derzeit stellt dieses Feld das Ergebnis der logischen AND-Operation für die Attribute communityGuidelinesGoodStanding, copyrightStrikesGoodStanding und contentIdClaimsGoodStanding dar. Das bedeutet, dass dieses Attribut den Wert true hat, wenn alle anderen Attribute ebenfalls den Wert true haben. Dieses Attribut hat jedoch den Wert false, wenn eines dieser Attribute den Wert false hat. Die Methode, mit der der Wert dieser Property festgelegt wird, kann sich jedoch ändern. |
auditDetails.communityGuidelinesGoodStanding |
booleanGibt an, ob der Kanal die Community-Richtlinien von YouTube einhält. |
auditDetails.copyrightStrikesGoodStanding |
booleanGibt an, ob der Kanal Urheberrechtsverwarnungen hat. |
auditDetails.contentIdClaimsGoodStanding |
booleanGibt an, ob für den Kanal nicht geklärte Ansprüche vorliegen. |
contentOwnerDetails |
objectDas 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 |
stringDie ID des Rechteinhabers, der mit dem Kanal verknüpft ist. |
contentOwnerDetails.timeLinked |
datetimeDas Datum und die Uhrzeit, zu der der Kanal mit dem Rechteinhaber verknüpft wurde. Der Wert wird im Format ISO 8601 angegeben. |
localizations |
objectDas localizations-Objekt kapselt Übersetzungen der Metadaten des Kanals. |
localizations.(key) |
objectDie 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 |
stringDer lokalisierte Kanaltitel. |
localizations.(key).description |
stringDie lokalisierte Kanalbeschreibung. |