activities.list
gibt noch keine Kanalbulletins zurück und die Methode activities.insert
wird nicht mehr unterstützt. Weitere Informationen findest du in der YouTube-Hilfe.
Eine activity
-Ressource enthält Informationen zu einer Aktion, die ein bestimmter Kanal oder Nutzer auf YouTube ausgeführt hat. Zu den in Aktivitätsfeeds gemeldeten Aktionen gehören die Bewertung eines Videos, das Teilen eines Videos, das Markieren eines Videos als Favorit, das Hochladen eines Videos usw. Jede activity
-Ressource identifiziert den Aktionstyp, den mit der Aktion verknüpften Kanal und die mit der Aktion verknüpfte(n) Ressource(n), z. B. das Video, das bewertet oder hochgeladen wurde.
Methoden
Die API unterstützt die folgenden Methoden für activities
-Ressourcen:
- list
- Gibt eine Liste der Kanalaktivitätsereignisse zurück, die den Anfragekriterien entsprechen. So können Sie beispielsweise Ereignisse abrufen, die mit einem bestimmten Kanal oder mit dem eigenen Kanal des Nutzers verknüpft sind. Hier kannst du die Funktion ausprobieren.
Die Methode activities.insert
wird nicht mehr unterstützt.
Ressourcendarstellung
Die folgende JSON-Struktur zeigt das Format einer activities
-Ressource:
{ "kind": "youtube#activity", "etag": etag, "id": string, "snippet": { "publishedAt": datetime, "channelId": string, "title": string, "description": string, "thumbnails": { (key): { "url": string, "width": unsigned integer, "height": unsigned integer } }, "channelTitle": string, "type": string, "groupId": string }, "contentDetails": { "upload": { "videoId": string }, "like": { "resourceId": { "kind": string, "videoId": string, } }, "favorite": { "resourceId": { "kind": string, "videoId": string, } }, "comment": { "resourceId": { "kind": string, "videoId": string, "channelId": string, } }, "subscription": { "resourceId": { "kind": string, "channelId": string, } }, "playlistItem": { "resourceId": { "kind": string, "videoId": string, }, "playlistId": string, "playlistItemId": string }, "recommendation": { "resourceId": { "kind": string, "videoId": string, "channelId": string, }, "reason": string, "seedResourceId": { "kind": string, "videoId": string, "channelId": string, "playlistId": string } }, "social": { "type": string, "resourceId": { "kind": string, "videoId": string, "channelId": string, "playlistId": string }, "author": string, "referenceUrl": string, "imageUrl": string }, "channelItem": { "resourceId": { } }, } }
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#activity . |
etag |
etag Das ETag dieser Ressource. |
id |
string Die ID, die YouTube verwendet, um die Aktivität eindeutig zu identifizieren. |
snippet |
object Das snippet -Objekt enthält grundlegende Details zur Aktivität, einschließlich des Aktivitätstyps und der Gruppen-ID. |
snippet.publishedAt |
datetime Datum und Uhrzeit der Aktivität Der Wert wird im ISO 8601-Format angegeben. |
snippet.channelId |
string Die ID, die YouTube verwendet, um den mit der Aktivität verknüpften Kanal eindeutig zu identifizieren. |
snippet.title |
string Der Titel der Ressource, die hauptsächlich mit der Aktivität verknüpft ist. |
snippet.description |
string Die Beschreibung der Ressource, die hauptsächlich mit der Aktivität verknüpft ist. |
snippet.thumbnails |
object Eine Karte mit Miniaturansichten, die mit der Ressource verknüpft sind, die hauptsächlich mit der Aktivität verknüpft ist. Bei jedem Objekt auf der Karte ist der Schlüssel der Name der Miniaturansicht. Der Wert ist ein Objekt, das weitere Informationen zur Miniaturansicht enthält. |
snippet.thumbnails.(key) |
object Gültige Schlüssel/Wert-Paare sind:
|
snippet.thumbnails.(key).url |
string Die URL des Bildes. |
snippet.thumbnails.(key).width |
unsigned integer Die Breite des Bildes. |
snippet.thumbnails.(key).height |
unsigned integer Die Höhe des Bildes. |
snippet.channelTitle |
string Kanaltitel des für diese Aktivität verantwortlichen Kanals |
snippet.type |
string Der Aktivitätstyp, den die Ressource beschreibt. Gültige Werte für dieses Attribut sind:
|
snippet.groupId |
string Die mit der Aktivität verknüpfte Gruppen-ID. Mit einer Gruppen-ID werden Nutzerereignisse identifiziert, die mit demselben Nutzer und derselben Ressource verknüpft sind. Wenn ein Nutzer beispielsweise ein Video bewertet und dasselbe Video als Favorit markiert, haben die Einträge für diese Ereignisse dieselbe Gruppen-ID im Aktivitätsfeed des Nutzers. Sie können Wiederholungen auf der Benutzeroberfläche vermeiden, indem Sie Ereignisse mit demselben groupId -Wert gruppieren. |
contentDetails |
object Das contentDetails -Objekt enthält Informationen zu den mit der Aktivität verknüpften Inhalten. Wenn der Wert für snippet.type beispielsweise videoRated ist, identifiziert der Inhalt des contentDetails -Objekts das bewertete Video. |
contentDetails.upload |
object Das upload -Objekt enthält Informationen zum hochgeladenen Video. Dieses Attribut ist nur vorhanden, wenn snippet.type den Wert upload hat. |
contentDetails.upload.videoId |
string Die ID, mit der YouTube das hochgeladene Video eindeutig identifiziert. |
contentDetails.like |
object Das Objekt like enthält Informationen zu einer Ressource, die eine positive Bewertung (Gefällt mir) erhalten hat. Dieses Attribut ist nur vorhanden, wenn snippet.type den Wert like hat. |
contentDetails.like.resourceId |
object Das resourceId -Objekt enthält Informationen, die die bewertete Ressource identifizieren. |
contentDetails.like.resourceId.kind |
string Der Typ der API-Ressource. |
contentDetails.like.resourceId.videoId |
string Die ID, die YouTube verwendet, um das Video eindeutig zu identifizieren, wenn die bewertete Ressource ein Video ist. Dieses Attribut ist nur vorhanden, wenn resourceId.kind den Wert youtube#video hat. |
contentDetails.favorite |
object Das favorite -Objekt enthält Informationen zu einem Video, das als Favorit markiert wurde. Dieses Attribut ist nur vorhanden, wenn snippet.type den Wert favorite hat. |
contentDetails.favorite.resourceId |
object Das resourceId -Objekt enthält Informationen zur Identifizierung der Ressource, die als Favorit markiert wurde. |
contentDetails.favorite.resourceId.kind |
string Der Typ der API-Ressource. |
contentDetails.favorite.resourceId.videoId |
string Die ID, mit der YouTube das Lieblingsvideo eindeutig identifiziert. Dieses Attribut ist nur vorhanden, wenn resourceId.kind den Wert youtube#video hat.Hinweis:Die Methode activities.list gibt derzeit keine Ressourcen für neue Kommentare zurück. |
contentDetails.comment |
object Das Objekt comment enthält Informationen zu einer Ressource, die einen Kommentar erhalten hat. Dieses Attribut ist nur vorhanden, wenn snippet.type den Wert comment hat. |
contentDetails.comment.resourceId |
object Das resourceId -Objekt enthält Informationen, die die mit dem Kommentar verknüpfte Ressource identifizieren. |
contentDetails.comment.resourceId.kind |
string Der Typ der API-Ressource. |
contentDetails.comment.resourceId.videoId |
string Die ID, mit der YouTube das mit einem Kommentar verknüpfte Video eindeutig identifiziert. Dieses Attribut ist nur vorhanden, wenn resourceId.kind den Wert youtube#video hat. |
contentDetails.comment.resourceId.channelId |
string Die ID, mit der YouTube den Kanal eindeutig identifiziert, der mit einem Kommentar verknüpft ist. Dieses Attribut ist nur vorhanden, wenn resourceId.kind den Wert youtube#channel hat. |
contentDetails.subscription |
object Das subscription -Objekt enthält Informationen zu einem Kanal, den ein Nutzer abonniert hat. Dieses Attribut ist nur vorhanden, wenn snippet.type den Wert subscription hat. |
contentDetails.subscription.resourceId |
object Das resourceId -Objekt enthält Informationen zur Identifizierung der Ressource, die der Nutzer abonniert hat. |
contentDetails.subscription.resourceId.kind |
string Der Typ der API-Ressource. |
contentDetails.subscription.resourceId.channelId |
string Die ID, mit der YouTube den Kanal eindeutig identifiziert, den der Nutzer abonniert hat. Dieses Attribut ist nur vorhanden, wenn resourceId.kind den Wert youtube#channel hat. |
contentDetails.playlistItem |
object Das playlistItem -Objekt enthält Informationen zu einem neuen Playlist-Element. Dieses Attribut ist nur vorhanden, wenn snippet.type den Wert playlistItem hat. |
contentDetails.playlistItem.resourceId |
object Das resourceId -Objekt enthält Informationen zur Identifizierung der Ressource, die der Playlist hinzugefügt wurde. |
contentDetails.playlistItem.resourceId.kind |
string Der Typ der API-Ressource. |
contentDetails.playlistItem.resourceId.videoId |
string Die ID, mit der YouTube das Video eindeutig identifiziert, das der Playlist hinzugefügt wurde. Dieses Attribut ist nur vorhanden, wenn resourceId.kind den Wert youtube#video hat. |
contentDetails.playlistItem.playlistId |
string Der Wert, den YouTube verwendet, um die Playlist eindeutig zu identifizieren. |
contentDetails.playlistItem.playlistItemId |
string Der Wert, den YouTube verwendet, um das Element in der Playlist eindeutig zu identifizieren. |
contentDetails.recommendation |
object Das Objekt recommendation enthält Informationen zu einer empfohlenen Ressource. Dieses Attribut ist nur vorhanden, wenn snippet.type den Wert recommendation hat. |
contentDetails.recommendation.resourceId |
object Das resourceId -Objekt enthält Informationen, die die empfohlene Ressource identifizieren. |
contentDetails.recommendation.resourceId.kind |
string Der Typ der API-Ressource. |
contentDetails.recommendation.resourceId.videoId |
string Die ID, die YouTube verwendet, um das Video eindeutig zu identifizieren, wenn die empfohlene Ressource ein Video ist. Dieses Attribut ist nur vorhanden, wenn resourceId.kind den Wert youtube#video hat. |
contentDetails.recommendation.resourceId.channelId |
string Die ID, mit der YouTube den Kanal eindeutig identifiziert, wenn die empfohlene Ressource ein Kanal ist. Dieses Attribut ist nur vorhanden, wenn resourceId.kind den Wert youtube#channel hat. |
contentDetails.recommendation.reason |
string Der Grund, warum die Ressource dem Nutzer empfohlen wird. Gültige Werte für dieses Attribut sind:
|
contentDetails.recommendation.seedResourceId |
object Das Objekt seedResourceId enthält Informationen zu der Ressource, die zur Empfehlung geführt hat. |
contentDetails.recommendation.seedResourceId.kind |
string Der Typ der API-Ressource. |
contentDetails.recommendation.seedResourceId.videoId |
string Die ID, mit der YouTube das Video eindeutig identifiziert, wenn die Empfehlung durch ein bestimmtes Video verursacht wurde. Dieses Attribut ist nur vorhanden, wenn seedResourceId.kind den Wert youtube#video hat. |
contentDetails.recommendation.seedResourceId.channelId |
string Die ID, mit der YouTube den Kanal eindeutig identifiziert, falls die Empfehlung von einem bestimmten Kanal stammt. Dieses Attribut ist nur vorhanden, wenn seedResourceId.kind den Wert youtube#channel hat. |
contentDetails.recommendation.seedResourceId.playlistId |
string Die ID, mit der YouTube die Playlist eindeutig identifiziert, wenn die Empfehlung durch eine bestimmte Playlist verursacht wurde. Dieses Attribut ist nur vorhanden, wenn seedResourceId.kind den Wert youtube#playlist hat. |
contentDetails.social |
object Das social -Objekt enthält Details zu einem Beitrag in einem sozialen Netzwerk. Dieses Attribut ist nur vorhanden, wenn snippet.type den Wert social hat. |
contentDetails.social.type |
string Name des sozialen Netzwerks. Gültige Werte für diese Property sind:
|
contentDetails.social.resourceId |
object Das resourceId -Objekt enthält Informationen, die die Ressource identifizieren, die mit einem Beitrag in einem sozialen Netzwerk verknüpft ist. |
contentDetails.social.resourceId.kind |
string Der Typ der API-Ressource. |
contentDetails.social.resourceId.videoId |
string Die ID, die YouTube verwendet, um das Video in einem Beitrag in einem sozialen Netzwerk eindeutig zu identifizieren, wenn sich der Beitrag auf ein Video bezieht. Dieses Attribut ist nur vorhanden, wenn der Wert des Attributs social.resourceId.kind youtube#video ist. |
contentDetails.social.resourceId.channelId |
string Die ID, mit der YouTube den Kanal in einem Beitrag in einem sozialen Netzwerk eindeutig identifiziert, wenn sich der Beitrag auf einen Kanal bezieht. Dieses Attribut ist nur vorhanden, wenn der Wert des Attributs social.resourceId.kind youtube#channel ist. |
contentDetails.social.resourceId.playlistId |
string Die ID, die YouTube verwendet, um die Playlist in einem Beitrag in einem sozialen Netzwerk eindeutig zu identifizieren, wenn der Beitrag auf eine Playlist verweist. Dieses Attribut ist nur vorhanden, wenn der Wert des Attributs social.resourceId.kind youtube#playlist ist. |
contentDetails.social.author |
string Der Autor des Beitrags in einem sozialen Netzwerk |
contentDetails.social.referenceUrl |
string Die URL des Beitrags in einem sozialen Netzwerk. |
contentDetails.social.imageUrl |
string Ein Bild des Beitragsautors. |
contentDetails.channelItem |
object Das Objekt channelItem enthält Details zu einer Ressource, die einem Kanal hinzugefügt wurde. Dieses Attribut ist nur vorhanden, wenn snippet.type den Wert channelItem hat. |
contentDetails.channelItem.resourceId |
object Das Objekt resourceId enthält Informationen zur Identifizierung der Ressource, die dem Kanal hinzugefügt wurde. |