Die API unterstützt jetzt die Möglichkeit, Kanäle oder 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“ für diesen Kanal oder dieses Video angibt. Die Nutzungsbedingungen und Entwicklerrichtlinien für YouTube API-Dienste wurden am 10. Januar 2020 aktualisiert. Weitere Informationen finden Sie im Überarbeitungsverlauf 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 testen. - Aktualisieren
- Aktualisiert die Metadaten eines Kanals. Diese Methode unterstützt derzeit nur Aktualisierungen der Objekte
brandingSettings
undinvideoPromotion
derchannel
-Ressource und deren 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, "moderateComments": boolean, "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 Objekt snippet enthält grundlegende Details zum Kanal, z. B. Titel, Beschreibung und Miniaturansichten. |
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 wird erläutert, welche Voraussetzungen für das Abrufen einer benutzerdefinierten URL gelten und wie die URL eingerichtet wird. |
snippet.publishedAt |
datetime Das Datum und die Uhrzeit der Erstellung des Kanals. Der Wert wird im ISO 8601-Format angegeben. |
snippet.thumbnails |
object Eine Karte mit Thumbnails, die mit dem Kanal verknüpft sind. Für jedes Objekt auf der Karte ist der Schlüssel der Name des Thumbnail-Bilds. Der Wert ist ein Objekt, das weitere Informationen zur Miniaturansicht enthält. Wenn sich Miniaturansichten in Ihrer App anzeigen lassen, müssen in Ihrem Code die Bild-URLs genau so verwendet werden, wie sie in API-Antworten zurückgegeben werden. Beispielsweise sollte deine App nicht die Domain http anstelle der Domain https in einer URL verwenden, die in einer API-Antwort zurückgegeben wird.URLs von Kanal-Miniaturansichten sind nur in der Domain https verfügbar. So sehen die URLs in den API-Antworten. Wenn Sie versuchen, YouTube-Bilder aus der Domain http zu laden, werden in Ihrer Anwendung möglicherweise fehlerhafte Bilder angezeigt. Bei neu erstellten Kanälen sind die Thumbnails möglicherweise leer. Es kann jedoch bis zu einem Tag dauern, bis sie verfügbar 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 Ihrer App finden Sie in der Definition der Property snippet.thumbnails . |
snippet.thumbnails.(key).width |
unsigned integer Die Breite des Bilds. |
snippet.thumbnails.(key).height |
unsigned integer Bildhöhe |
snippet.defaultLanguage |
string Die Sprache des Textes in den Attributen snippet.title und snippet.description der channel -Ressource. |
snippet.localized |
object Das 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 kannst du lokalisierte Metadaten hinzufügen, aktualisieren oder löschen. |
snippet.localized.title |
string Der lokalisierte Titel des Kanals. |
snippet.localized.description |
string Die lokalisierte Kanalbeschreibung. |
snippet.country |
string Das Land, mit dem der Kanal verknüpft ist. Wenn du den Wert dieser Property festlegen möchtest, aktualisiere den Wert der brandingSettings.channel.country -Property. |
contentDetails |
object Das contentDetails -Objekt enthält Informationen zu den Inhalten des Kanals. |
contentDetails.relatedPlaylists |
object Das relatedPlaylists -Objekt ist eine Karte, über die Playlists identifiziert werden, die mit dem Kanal verknüpft sind. Hierzu zählen beispielsweise hochgeladene Videos und Videos, die du mit „Mag ich“ bewertet hast. Diese Playlists können mit der Methode playlists.list abgerufen werden. |
contentDetails.relatedPlaylists.likes |
string Die ID der Playlist, die die „Mag ich“-Bewertungen des Kanals enthält. Verwenden Sie die Methoden playlistItems.insert und playlistItems.delete , um Elemente aus dieser Liste hinzuzufügen oder zu 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 sie daraus entfernen.Hinweis: YouTube hat eine neue Lieblingsfunktion für Videos eingestellt. Das Attribut statistics.favoriteCount der Ressource video wurde beispielsweise am 28. August 2015 eingestellt. Aus historischen Gründen kann dieser Property-Wert eine Playlist-ID enthalten, die auf eine leere Playlist verweist. Daher kann der Property-Wert nicht abgerufen werden. |
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 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 zum Aufrunden der Abonnentenzahl findest du im Überarbeitungsverlauf oder in der YouTube-Hilfe. |
statistics.videoCount |
unsigned long Die Anzahl der auf dem Kanal hochgeladenen öffentlichen Videos. Der Wert gibt nur die Anzahl der öffentlichen Videos des Kanals an, auch nicht die Rechteinhaber. Dieses Verhalten entspricht den auf der YouTube-Website angezeigten Werten. |
topicDetails |
object Das Objekt topicDetails enthält Informationen zu Themen, die mit dem Kanal verknüpft sind.Wichtig:Weitere Informationen zu Änderungen in Bezug auf Themen-IDs finden Sie in der Definition der Property topicDetails.topicIds[] 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: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 Gruppe ausgewählter Themen-IDs zurückzugeben. |
topicDetails.topicCategories[] |
list Eine Liste mit Wikipedia-URLs, die die Inhalte 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 sind:
|
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 mit einem dieser Links verfügt bereits über eine öffentliche YouTube-Identität, die eine Voraussetzung für verschiedene Aktionen wie das Hochladen von Videos ist. |
status.longUploadsStatus |
string Gibt an, ob der Kanal Videos hochladen kann, 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. Für diese Property sind folgende Werte zulässig:
|
status.madeForKids |
boolean Dieser Wert gibt an, ob der Kanal als auf Kinder ausgerichtet gekennzeichnet ist und den aktuellen Status „Speziell für Kinder“ des Kanals enthält. Der Status kann beispielsweise anhand des Werts der Property selfDeclaredMadeForKids bestimmt 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 In einer channels.update -Anfrage kann der Kanalinhaber den Kanal als „Für Kinder“ festlegen. Der Property-Wert wird nur zurückgegeben, wenn der Kanalinhaber die API-Anfrage autorisiert hat.
|
brandingSettings |
object Das Objekt brandingSettings enthält Informationen zum Branding des Kanals. |
brandingSettings.channel |
object Das channel -Objekt enthält 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 deiner Kanalseite im Feld mit den Kanalinformationen angezeigt wird. Der Wert der Property 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 gekürzt, wenn sie die maximal zulässige Länge von 500 Zeichen überschreiten oder wenn sie keine Anführungszeichen ( " ) ohne Escapezeichen enthalten. |
brandingSettings.channel.trackingAnalyticsAccountId |
string Die ID für ein Google Analytics-Konto, mit dem Sie die Zugriffe auf Ihren Kanal erfassen und analysieren möchten. |
brandingSettings.channel.moderateComments |
boolean Über diese Einstellung wird festgelegt, ob von Nutzern eingereichte Kommentare auf der Kanalseite vom Kanalinhaber genehmigt werden müssen, damit sie öffentlich sichtbar sind. Der Standardwert ist false . |
brandingSettings.channel.unsubscribedTrailer |
string Das Video, das auf der Kanalseite im empfohlenen Videomodul für Zuschauer ohne Abo in der Übersicht angezeigt werden soll. Abonnenten sehen möglicherweise ein anderes Video, in dem aktuelle Aktivitäten des Kanals hervorgehoben werden. Wenn Sie eine Property angeben, muss der Wert der 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 channel -Ressource. |
brandingSettings.channel.country |
string Das Land, mit dem der Kanal verknüpft ist. Aktualisiere diese Property, um den Wert der snippet.country -Property festzulegen. |
brandingSettings.watch |
object Hinweis:Dieses Objekt und alle untergeordneten Properties wurden eingestellt. Das watch -Objekt enthält Branding-Eigenschaften der Videoseiten des Kanals. |
brandingSettings.watch.textColor |
string Hinweis:Diese Property wurde eingestellt. Die Textfarbe für den Markenbereich der Wiedergabeseite. |
brandingSettings.watch.backgroundColor |
string Hinweis:Diese Property wurde eingestellt. Die Hintergrundfarbe für den Brandingbereich der Wiedergabeseite. |
brandingSettings.watch.featuredPlaylistId |
string Hinweis:Diese Property wurde eingestellt. Die API gibt einen Fehler zurück, wenn Sie versuchen, ihren Wert festzulegen. |
brandingSettings.image |
object Diese Property und alle untergeordneten Properties wurden eingestellt. Das image -Objekt enthält Informationen zu Bildern auf der Kanalseite oder auf den Wiedergabeseiten des Kanals. |
brandingSettings.image.bannerImageUrl |
string Diese Property wurde eingestellt. Die URL für das Bannerbild, das auf der Kanalseite auf der YouTube-Website angezeigt wird. Das Bild ist 1.060 x 175 Pixel groß. |
brandingSettings.image.bannerMobileImageUrl |
string Diese Property wurde eingestellt. Die URL für das Bannerbild, das in mobilen Apps auf der Kanalseite 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 zu sehen ist. 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 Ihr Kanalname anstelle eines Bilds 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 erhoben werden können. |
brandingSettings.image.bannerTabletLowImageUrl |
string Diese Property wurde eingestellt. Die URL für ein Bannerbild mit niedriger Auflösung, das in Tablet-Apps auf der Kanalseite 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 in Tablet-Apps auf der Kanalseite angezeigt wird. Das Bild hat die Größe 1.707 x 283 Pixel. |
brandingSettings.image.bannerTabletHdImageUrl |
string Diese Property wurde eingestellt. Die URL für ein Bannerbild mit hoher Auflösung, das in Tablet-Apps auf der Kanalseite angezeigt wird. Die maximale Größe des Bildes beträgt 2276 x 377 Pixel. |
brandingSettings.image.bannerTabletExtraHdImageUrl |
string Diese Property wurde eingestellt. Die URL für ein besonders hochauflösendes Bannerbild, das in Tablet-Apps auf der Kanalseite erscheint. 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 in mobilen Apps auf der Kanalseite 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 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 wurde eingestellt. Die URL für ein hochauflösendes Bannerbild, 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 sehr großes Bannerbild, das in mobilen Apps auf der Kanalseite erscheint. Das Bild darf maximal 1.440 x 395 Pixel groß sein. |
brandingSettings.image.bannerTvImageUrl |
string Diese Property wurde eingestellt. Die URL für ein besonders hohes Bannerbild, das in Fernsehanwendungen auf der Kanalseite erscheint. Die maximale Größe des Bildes beträgt 2120 x 1192 Pixel. |
brandingSettings.image.bannerTvLowImageUrl |
string Diese Property wurde eingestellt. Die URL für ein Bannerbild mit niedriger Auflösung, das in Fernsehanwendungen auf der Kanalseite 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 in Fernsehanwendungen auf der Kanalseite zu sehen ist. Das Bild darf maximal 1.280 x 720 Pixel groß sein. |
brandingSettings.image.bannerTvHighImageUrl |
string Diese Property wurde eingestellt. Die URL für ein hochauflösendes Bannerbild, das in Fernsehanwendungen auf der Kanalseite 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 von YouTube verwendet wird, um die verschiedenen Größen des Bannerbilds für einen Kanal zu generieren. |
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 Objekt auditDetails enthält Kanaldaten, die von einem Multi-Channel-Netzwerk (MCN) ausgewertet und gleichzeitig festgelegt werden, ob ein bestimmter Kanal akzeptiert oder abgelehnt wird. Beachten Sie, dass jede API-Anfrage, die diesen Ressourcenteil abruft, ein Autorisierungstoken angeben muss, das den Bereich https://www.googleapis.com/auth/youtubepartner-channel-audit enthält. Außerdem müssen alle Tokens, für die dieser Bereich genutzt wird, widerrufen werden, wenn das MCN entscheidet, den Kanal anzunehmen oder abzulehnen, oder innerhalb von zwei Wochen ab dem Datum, an dem das Token ausgestellt wurde. |
auditDetails.overallGoodStanding |
boolean Dieses Feld gibt an, ob es Probleme mit dem Kanal gibt. Derzeit enthält dieses Feld das Ergebnis des logischen AND -Vorgangs über die Properties communityGuidelinesGoodStanding , copyrightStrikesGoodStanding und contentIdClaimsGoodStanding . Das bedeutet, dass diese Eigenschaft den Wert true hat, wenn alle anderen Attribute ebenfalls den Wert true haben. Dieses Attribut hat jedoch den Wert false , wenn eine dieser Unterkünfte 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 respektiert. |
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 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 Das Datum und die 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 dem Schlüssel/Wert-Paar zugeordnet sind. Der Wert ist ein String, der einen BCP-47-Sprachcode enthält. |
localizations.(key).title |
string Der lokalisierte Titel des Kanals. |
localizations.(key).description |
string Die lokalisierte Kanalbeschreibung. |