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 ebenfalls aktualisiert. Weitere Informationen findest du in den Überarbeitungsverläufen für den YouTube Data API-Dienst und die Nutzungsbedingungen für 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. Diese Methode unterstützt derzeit nur Aktualisierungen der Objekte
brandingSettingsundinvideoPromotionder Ressourcechannelund ihrer untergeordneten Attribute. 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 |
stringGibt den Typ der API-Ressource an. Der Wert ist youtube#channel. |
etag |
etagDas ETag dieser Ressource. |
id |
stringDie ID, mit der YouTube den Kanal eindeutig identifiziert. |
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 und 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 Miniaturansichten, die mit dem Kanal verknüpft sind. Bei jedem Objekt in der Zuordnung ist der Schlüssel der Name des Thumbnail-Bildes und der Wert ein Objekt, das weitere 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 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. Wenn deine Anwendung versucht, YouTube-Bilder von der Domain http zu laden, werden diese möglicherweise nicht richtig angezeigt. Bei neu erstellten Kanälen sind die Miniaturansichten möglicherweise leer. 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 Bildes. |
snippet.thumbnails.(key).height |
unsigned integerDie Höhe des Bildes. |
snippet.defaultLanguage |
stringDie Sprache des Texts in den Attributen snippet.title und snippet.description der Ressource channel. |
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, um lokalisierte Metadaten hinzuzufügen, zu aktualisieren oder zu löschen. |
snippet.localized.title |
stringDer lokalisierte Kanaltitel. |
snippet.localized.description |
stringDie lokalisierte Kanalbeschreibung. |
snippet.country |
stringDas Land, mit dem der Kanal verknüpft 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 zu den Inhalten 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 mit „Mag ich“ bewerteten Videos des Kanals. 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 Kanalinhaber 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 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 für Lieblingsvideos wurde von YouTube eingestellt. Beispielsweise wurde das Attribut statistics.favoriteCount der Ressource video am 28. August 2015 verworfen. 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. Verwende die Methode videos.insert, um neue Videos hochzuladen, und die Methode videos.delete, um zuvor hochgeladene Videos zu löschen. |
statistics |
objectDas statistics-Objekt enthält Statistiken für den Kanal. |
statistics.viewCount |
unsigned longDie Summe der Aufrufe aller Videos in allen Formaten für einen Kanal. Bei allen Videoformaten (Langformat, Live und Shorts) auf einem Kanal zählt Bei allen Videoformaten (Videos im Langformat, Livestreams und Shorts) auf einem Kanal werden bei |
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 dazu, wie Abonnentenzahlen gerundet werden, 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 auf der YouTube-Website angezeigten Zahlen. |
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. Damals begann YouTube, eine kleine Auswahl an ausgewählten 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 Kanals. 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. Das ist eine Voraussetzung für verschiedene Aktionen, z. B. das Hochladen von Videos. |
status.longUploadsStatus |
stringGibt an, ob der Kanal Videos mit einer Länge von mehr als 15 Minuten hochladen darf. 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 „speziell für Kinder“ 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 die 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 neuere 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 Attributen snippet.title und snippet.description der Ressource channel. |
brandingSettings.channel.country |
stringDas Land, mit dem der Kanal verknüpft ist. Aktualisieren Sie dieses Attribut, um den Wert des Attributs snippet.country festzulegen. |
brandingSettings.watch |
objectHinweis: Dieses Objekt und alle untergeordneten Properties wurden verworfen. 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 Markenbereich der Wiedergabeseite. |
brandingSettings.watch.backgroundColor |
stringHinweis: Diese Property wurde verworfen. Die Hintergrundfarbe für den Bereich mit Branding auf der Wiedergabeseite des Videos. |
brandingSettings.watch.featuredPlaylistId |
stringHinweis: Diese Property wurde verworfen. Die API gibt einen Fehler zurück, wenn Sie versuchen, den Wert festzulegen. |
brandingSettings.image |
objectDiese Property und alle untergeordneten Properties wurden eingestellt. Das Objekt image enthält Informationen zu Bildern, die auf der Kanalseite oder auf den Wiedergabeseiten des Kanals angezeigt werden. |
brandingSettings.image.bannerImageUrl |
stringDieses Attribut wird nicht mehr unterstützt. Die URL für das Kanalbanner, das auf der Kanalseite auf der YouTube-Website angezeigt wird. Das Bild ist 1060 × 175 Pixel groß. |
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 ist 640 × 175 Pixel groß. |
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 du kein Bild bereitstellst, wird stattdessen dein 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-Anwendungen angezeigt wird. Die maximale Bildgröße beträgt 1138 × 188 Pixel. |
brandingSettings.image.bannerTabletImageUrl |
stringDieses Attribut 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 |
stringDieses Attribut 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 Bildgröße beträgt 320 × 88 Pixel. |
brandingSettings.image.bannerMobileMediumHdImageUrl |
stringDieses Attribut wird nicht mehr unterstützt. Die URL für ein Bannerbild 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 1280 × 360 Pixel. |
brandingSettings.image.bannerMobileExtraHdImageUrl |
stringDieses Attribut 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 |
stringDieses Attribut wird nicht mehr unterstützt. Die URL für ein Kanalbanner mit besonders hoher Auflösung, das auf der Kanalseite in TV-Anwendungen angezeigt wird. Die maximale Bildgröße beträgt 2.120 × 1.192 Pixel. |
brandingSettings.image.bannerTvLowImageUrl |
stringDieses Attribut wird nicht mehr unterstützt. Die URL für ein Kanalbanner mit niedriger Auflösung, das auf der Kanalseite in TV-Anwendungen angezeigt wird. Die maximale Bildgröße beträgt 854 × 480 Pixel. |
brandingSettings.image.bannerTvMediumImageUrl |
stringDieses Attribut 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 |
stringDieses Attribut gibt den Speicherort des Kanalbanners an, das YouTube verwendet, um die verschiedenen Bannerbildgrößen für einen Kanal zu generieren. |
brandingSettings.hints[] |
listDiese Property und alle untergeordneten Properties wurden eingestellt. Das hints-Objekt enthält zusätzliche Branding-Eigenschaften. |
brandingSettings.hints[].property |
stringDieses Attribut wird nicht mehr unterstützt. Eine Property. |
brandingSettings.hints[].value |
stringDieses Attribut 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. Beachte, dass jede API-Anfrage, die diesen Ressourcenteil abruft, ein Autorisierungstoken mit dem Bereich https://www.googleapis.com/auth/youtubepartner-channel-audit enthalten muss. Außerdem muss jedes Token, das diesen Bereich verwendet, widerrufen werden, wenn das MCN entscheidet, den Kanal zu akzeptieren oder abzulehnen, oder innerhalb von zwei Wochen nach dem Datum, an dem das Token ausgestellt wurde. |
auditDetails.overallGoodStanding |
booleanDieses Feld gibt an, ob es Probleme mit dem Kanal gibt. 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 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 |
datetimeDatum und Uhrzeit der Verknüpfung des Kanals mit dem Rechteinhaber. Der Wert wird im ISO 8601-Format angegeben. |
localizations |
objectDas Objekt localizations 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. |