Die API unterstützt jetzt die Möglichkeit, deinen Kanal oder deine Videos als „speziell für Kinder“ zu kennzeichnen. Außerdem enthalten
channel
- und video
-Ressourcen jetzt eine Property, die den Status „Speziell für Kinder“ dieses Kanals oder Videos angibt. Die Nutzungsbedingungen und Richtlinien für Entwickler der 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 ausprobieren. - Aktualisieren
- Aktualisiert die Metadaten eines Kanals. Diese Methode unterstützt derzeit nur Aktualisierungen der
brandingSettings
- undinvideoPromotion
-Objekte der Ressourcechannel
und ihrer untergeordneten Properties. 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, "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 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 Unterkunft darf maximal 1.000 Zeichen lang sein. |
snippet.customUrl |
string Die benutzerdefinierte URL des Kanals. In der YouTube-Hilfe werden die Voraussetzungen für das Erstellen einer benutzerdefinierten URL sowie die Einrichtung der URL erläutert. |
snippet.publishedAt |
datetime Datum und Uhrzeit der Erstellung des Kanals. Der Wert wird im ISO 8601-Format angegeben. |
snippet.thumbnails |
object Eine Karte mit Miniaturansichten, die mit dem Kanal verknüpft sind Für jedes Objekt auf der Karte ist der Schlüssel der Name des Miniaturbilds. Der Wert ist ein Objekt, das andere Informationen zum Thumbnail enthält. Wenn Sie Miniaturansichten in Ihrer Anwendung verwenden, muss der Code die Bild-URLs genau so verwenden, wie sie in den 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-Thumbnails sind nur in der Domain https verfügbar. So werden die URLs in API-Antworten angezeigt. In deiner Anwendung werden möglicherweise fehlerhafte Bilder angezeigt, wenn versucht wird, YouTube-Bilder aus der Domain http zu laden. Thumbnails können bei neu erstellten Kanälen leer sein und es kann bis zu einem Tag dauern, bis sie angezeigt werden. |
snippet.thumbnails.(key) |
object Gültige Schlüssel/Wert-Paare sind:
|
snippet.thumbnails.(key).url |
string Die Bild-URL. Weitere Richtlinien zur Verwendung von Miniaturansicht-URLs in deiner App findest du in der Definition der Property 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 den Titel und die Beschreibung des Kanals in der Standardsprache für die Metadaten des Kanals.
localizations können Sie 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 Sie den Wert dieses Attributs festlegen möchten, aktualisieren Sie 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 Karte, über die Playlists identifiziert werden, die mit dem Kanal verknüpft sind, z. B. hochgeladene Videos oder mit „Mag ich“ bewertete Videos. Sie können jede dieser Playlists mithilfe der Methode playlists.list abrufen. |
contentDetails.relatedPlaylists.likes |
string Die ID der Playlist, die Videos mit „Mag ich“-Bewertungen enthält. Verwenden Sie die Methoden playlistItems.insert und playlistItems.delete , um Elemente zu dieser Liste hinzuzufügen oder daraus zu entfernen. |
contentDetails.relatedPlaylists.favorites |
string Diese Property wurde eingestellt. Die ID der Playlist mit den Lieblingsvideos des Kanals. Verwende die Methoden playlistItems.insert und playlistItems.delete , um Elemente zu dieser Liste hinzuzufügen oder daraus zu entfernen.Hinweis: YouTube-Funktionen für deine Lieblingsvideos wurden 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. Sie kann daher nicht abgerufen werden. |
contentDetails.relatedPlaylists.uploads |
string Die ID der Playlist, die die hochgeladenen Videos des Kanals enthält. Mit der Methode videos.insert kannst du neue Videos hochladen. Mit der Methode videos.delete kannst du zuvor hochgeladene Videos löschen. |
statistics |
object Das statistics -Objekt 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 Zahlen abgerundet. Weitere Informationen dazu, wie Abonnenten gerundet werden, finden Sie im Überarbeitungsverlauf oder in der YouTube-Hilfe. |
statistics.videoCount |
unsigned long Die Anzahl der auf dem Kanal hochgeladenen öffentlichen Videos. Beachte, dass der Wert nur die Anzahl der öffentlichen Videos des Kanals widerspiegelt, auch für Rechteinhaber. Dieses Verhalten entspricht der auf der YouTube-Website angezeigten Anzahl. |
topicDetails |
object Das Objekt topicDetails enthält Informationen zu Themen, die mit dem Kanal verknüpft sind.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 mit dem Kanal verknüpften Themen-IDs. Diese Property wurde am 10. November 2016 eingestellt. Sie wird noch bis zum 10. November 2017 unterstützt. Wichtig: Aufgrund der Einstellung von Freebase und der Freebase API funktionieren Themen-IDs ab dem 27. Februar 2017 anders. Zu diesem Zeitpunkt gab YouTube eine kleine Gruppe von ausgewählten Themen-IDs zurück. |
topicDetails.topicCategories[] |
list Eine Liste von Wikipedia-URLs, die den Inhalt 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 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 als Voraussetzung für verschiedene Aktionen wie das Hochladen von Videos gilt. |
status.longUploadsStatus |
string Gibt an, ob der Kanal Videos mit einer Länge von mehr als 15 Minuten hochladen kann. 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 |
boolean Dieser Wert gibt an, ob der Kanal als auf Kinder ausgerichtet ausgewiesen ist. Er enthält den aktuellen Status „Speziell für Kinder“. Der Status kann beispielsweise anhand des Werts der Property selfDeclaredMadeForKids bestimmt werden. In der YouTube-Hilfe findest du weitere Informationen dazu, wie du die Zielgruppe für deinen Kanal, deine Videos oder deine Übertragungen festlegst.
|
status.selfDeclaredMadeForKids |
boolean In einer channels.update -Anfrage kann der Kanalinhaber mit dieser Property den Kanal als auf Kinder ausgerichtet kennzeichnen. Der 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 Branding-Eigenschaften auf 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 mit den Kanalinformationen auf deiner Kanalseite angezeigt wird. Der Wert der Unterkunft 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. Kanal-Keywords werden möglicherweise abgeschnitten, wenn sie die maximal zulässige Länge von 500 Zeichen überschreiten oder wenn sie nicht mit Anführungszeichen versehene Anführungszeichen ( " ) enthalten. Die Beschränkung auf 500 Zeichen ist keine Begrenzung pro Keyword, sondern eine Beschränkung der Gesamtlänge aller Keywords. |
brandingSettings.channel.trackingAnalyticsAccountId |
string Die ID für ein Google Analytics-Konto, mit dem Sie die Zugriffe auf Ihren Kanal erfassen und messen möchten. |
brandingSettings.channel.moderateComments |
boolean Mit dieser 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 im Modul „Vorgestelltes Video“ in der Übersicht der Kanalseite für Zuschauer ohne Abo wiedergegeben werden sollte Abonnenten sehen möglicherweise 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, 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 seine untergeordneten Properties wurden eingestellt. Das watch -Objekt enthält Branding-Eigenschaften auf den 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 für den Markenbereich der Videowiedergabeseite. |
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 Objekt image 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 auf 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 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 angezeigt wird. Dies ist ein 25 Pixel hohes Bild mit einer flexiblen Breite von maximal 170 Pixeln. Wenn du dieses Bild nicht angibst, wird dein 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 1138 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 ist 1.707 x 283 Pixel groß. |
brandingSettings.image.bannerTabletHdImageUrl |
string Diese Property wurde eingestellt. Die URL für ein hochauflösendes Bannerbild, das in Tablet-Apps auf der Kanalseite 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 hochauflösendes Bannerbild, das in Tablet-Apps auf der Kanalseite angezeigt wird. Das Bild darf maximal 2560 x 424 Pixel groß sein. |
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 mittlerer Auflösung, das in mobilen Apps auf der Kanalseite 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 hochauflösendes Bannerbild, das in mobilen Apps auf der Kanalseite angezeigt wird. Das Bild darf maximal 1280 x 360 Pixel groß sein. |
brandingSettings.image.bannerMobileExtraHdImageUrl |
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 1440 x 395 Pixel groß sein. |
brandingSettings.image.bannerTvImageUrl |
string Diese Property wurde eingestellt. Die URL für ein hochauflösendes Bannerbild, das in TV-Apps auf der Kanalseite angezeigt wird. Das Bild darf maximal 2120 x 1192 Pixel groß sein. |
brandingSettings.image.bannerTvLowImageUrl |
string Diese Property wurde eingestellt. Die URL für ein Bannerbild mit niedriger Auflösung, das in TV-Apps 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 mittlerer Auflösung, das in TV-Apps auf der Kanalseite angezeigt wird. Das Bild darf maximal 1280 x 720 Pixel groß sein. |
brandingSettings.image.bannerTvHighImageUrl |
string Diese Property wurde eingestellt. Die URL für ein hochauflösendes Bannerbild, das in TV-Apps auf der Kanalseite angezeigt wird. Das Bild darf maximal 1920 x 1080 Pixel groß sein. |
brandingSettings.image.bannerExternalUrl |
string Diese Eigenschaft gibt den Speicherort des Bannerbilds an, das YouTube zum Generieren der verschiedenen Bannerbildgrößen für einen Kanal verwendet. |
brandingSettings.hints[] |
list Diese Property und alle untergeordneten Properties wurden eingestellt. Das Objekt hints enthält zusätzliche Branding-Properties. |
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 würden, während es entscheidet, 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 muss jedes Token, das diesen Bereich verwendet, widerrufen werden, wenn das MCN den Kanal akzeptiert oder ablehnt oder innerhalb von zwei Wochen nach der Ausstellung des Tokens. |
auditDetails.overallGoodStanding |
boolean Dieses 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 auch den Wert true haben. Diese Property hat jedoch den Wert false , wenn eine dieser Properties 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 der Kanal Urheberrechtsverwarnungen erhalten hat |
auditDetails.contentIdClaimsGoodStanding |
boolean Gibt an, ob für den Kanal ungelöste Ansprüche vorliegen |
contentOwnerDetails |
object Das contentOwnerDetails -Objekt enthält Kanaldaten, die für YouTube-Partner relevant sind, die mit dem Kanal verknüpft sind. |
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 dem Schlüssel/Wert-Paar zugeordnet sind. Der Wert ist ein String mit einem BCP-47-Sprachcode. |
localizations.(key).title |
string Der lokalisierte Titel des Kanals. |
localizations.(key).description |
string Die lokalisierte Kanalbeschreibung |