Activities

YouTube hat die Funktion für Kanalbulletins eingestellt. Die Methode activities.list gibt noch keine Kanalbulletins zurück und die Methode activities.insert wird nicht mehr unterstützt. Weitere Informationen finden Sie 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 unter anderem das Bewerten eines Videos, das Teilen eines Videos, das Markieren eines Videos als Favorit und das Hochladen eines Videos. Jede activity-Ressource gibt den Aktionstyp, den mit der Aktion verknüpften Kanal und die mit der Aktion verknüpfte(n) Ressource(n) an, 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. Sie können 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 zur eindeutigen Identifizierung der Aktivität verwendet.
snippet object
Das Objekt snippet 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 primär mit der Aktivität verknüpft ist.
snippet.description string
Die Beschreibung der Ressource, die primär mit der Aktivität verknüpft ist.
snippet.thumbnails object
Eine Karte mit Miniaturansichten, die der Ressource zugeordnet sind, die hauptsächlich der Aktivität zugeordnet ist. Für jedes 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:
  • default: Das Standard-Thumbnail. Das Standard-Thumbnail für ein Video – oder eine Ressource, die auf ein Video verweist, z. B. ein Playlist-Element oder ein Suchergebnis – ist 120 Pixel breit und 90 Pixel hoch. Das Standard-Thumbnail für einen Kanal ist 88 Pixel breit und 88 Pixel hoch.
  • medium: Eine Version des Thumbnails mit höherer Auflösung. Bei einem Video oder einer Ressource, die auf ein Video verweist, ist das Bild 320 Pixel breit und 180 Pixel hoch. Bei einem Kanal ist dieses Bild 240 Pixel breit und 240 Pixel hoch.
  • high: Eine Version des Thumbnails mit hoher Auflösung. Bei einem Video oder einer Ressource, die auf ein Video verweist, ist das Bild 480 Pixel breit und 360 Pixel hoch. Bei einem Kanal ist dieses Bild 800 Pixel breit und 800 Pixel hoch.
  • standard: Eine Version des Thumbnails mit einer höheren Auflösung als das Bild mit high-Auflösung. Dieses Bild ist für einige Videos und andere Ressourcen verfügbar, die sich auf Videos beziehen, wie Playlist-Elemente oder Suchergebnisse. Dieses Bild ist 640 Pixel breit und 480 Pixel hoch.
  • maxres: Das Thumbnail mit der höchsten Auflösung. Diese Bildgröße ist für einige Videos und andere Ressourcen verfügbar, die sich auf Videos beziehen, wie Playlist-Elemente oder Suchergebnisse. Dieses Bild ist 1.280 Pixel breit und 720 Pixel hoch.
snippet.thumbnails.(key).url string
Die URL des Bilds.
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 Kanals, der für diese Aktivität verantwortlich ist
snippet.type string
Der Aktivitätstyp, den die Ressource beschreibt.

Gültige Werte für dieses Attribut sind:
  • channelItem
  • comment – (derzeit nicht zurückgegeben)
  • favorite
  • like
  • playlistItem
  • promotedItem
  • recommendation
  • social
  • subscription
  • upload
  • bulletin (eingestellt)
snippet.groupId string
Die Gruppen-ID, die der Aktivität zugeordnet ist. 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 dieses 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 Objekt contentDetails 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 Objekt upload 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 Objekt resourceId 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 zur eindeutigen Identifizierung des Videos verwendet, 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 Objekt resourceId enthält Informationen, die die Ressource identifizieren, 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 Objekt resourceId 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, die YouTube verwendet, um den mit einem Kommentar verknüpften Kanal eindeutig zu identifizieren. Dieses Attribut ist nur vorhanden, wenn resourceId.kind den Wert youtube#channel hat.
contentDetails.subscription object
Das Objekt subscription 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 Objekt resourceId enthält Informationen, die die Ressource identifizieren, 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 Objekt playlistItem 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 Objekt resourceId enthält Informationen, die die Ressource identifizieren, 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 zur eindeutigen Identifizierung der Playlist verwendet.
contentDetails.playlistItem.playlistItemId string
Der Wert, mit dem YouTube das Element in der Playlist eindeutig identifiziert.
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 Objekt resourceId 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, mit der YouTube das Video eindeutig identifiziert, 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:
  • videoFavorited
  • videoLiked
  • videoWatched
contentDetails.recommendation.seedResourceId object
Das Objekt seedResourceId enthält Informationen zu der Ressource, die die Empfehlung verursacht 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 ausgelöst wurde. Dieses Attribut ist nur vorhanden, wenn seedResourceId.kind den Wert youtube#video hat.
contentDetails.recommendation.seedResourceId.channelId string
Die ID, die YouTube zur eindeutigen Identifizierung des Kanals verwendet, wenn 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 Objekt social enthält Details zu einem Beitrag in sozialen Netzwerken. Dieses Attribut ist nur vorhanden, wenn snippet.type den Wert social hat.
contentDetails.social.type string
Der Name des sozialen Netzwerks.

Gültige Werte für diese Property sind:
  • facebook
  • googlePlus
  • twitter
  • unspecified
contentDetails.social.resourceId object
Das Objekt resourceId enthält Informationen, die die mit einem Beitrag in einem sozialen Netzwerk verknüpfte Ressource identifizieren.
contentDetails.social.resourceId.kind string
Der Typ der API-Ressource.
contentDetails.social.resourceId.videoId string
Die ID, mit der YouTube das Video in einem Beitrag in einem sozialen Netzwerk eindeutig identifiziert, 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, die YouTube verwendet, um den Kanal in einem Beitrag in sozialen Netzwerken eindeutig zu identifizieren, 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, mit der YouTube die Playlist in einem Beitrag in einem sozialen Netzwerk eindeutig identifiziert, wenn sich der Beitrag auf eine Playlist bezieht. 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 Verfassers des Beitrags.
contentDetails.channelItem object
Das Objekt channelItem enthält Details zu einer Ressource, die einem Channel 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.