Activities

Eine activity-Ressource enthält Informationen zu einer Aktion, die von einem bestimmten Kanal oder Nutzer auf YouTube ausgeführt wurde. Zu den Aktionen, die in Aktivitätsfeeds gemeldet werden, gehören das Teilen und Hochladen von Videos. Jede activity-Ressource gibt den Aktionstyp, den mit der Aktion verknüpften Kanal und die mit der Aktion verknüpften Ressourcen 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 von Kanalaktivitätsereignissen 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.

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
    },
    "comment": {
      "resourceId": {
        "kind": string,
        "videoId": 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 vorkommen:

Attribute
kind string
Gibt den Typ der API-Ressource an. 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 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 zur eindeutigen Identifizierung des mit der Aktivität verknüpften Kanals verwendet.
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 Map von Miniaturansichten, die mit der Ressource verknüpft sind, die hauptsächlich mit der Aktivität verknüpft ist. Für jedes Objekt in der Map ist der Schlüssel der Name der Miniaturansicht und der Wert ein Objekt, das weitere Informationen zur Miniaturansicht enthält.
snippet.thumbnails.(key) object
Gültige Schlüsselwerte sind:
  • default – Die Standardminiaturansicht. Die Standardminiaturansicht 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. Die Standardminiaturansicht für einen Kanal ist 88 Pixel breit und 88 Pixel hoch.
  • medium – Eine Version der Miniaturansicht mit höherer Auflösung. Für ein Video (oder eine Ressource, die auf ein Video verweist) ist dieses Bild 320 Pixel breit und 180 Pixel hoch. Für einen Kanal ist dieses Bild 240 Pixel breit und 240 Pixel hoch.
  • high – Eine Version der Miniaturansicht mit hoher Auflösung. Für ein Video (oder eine Ressource, die auf ein Video verweist) ist dieses Bild 480 Pixel breit und 360 Pixel hoch. Für einen Kanal ist dieses Bild 800 Pixel breit und 800 Pixel hoch.
  • standard – Eine Version der Miniaturansicht mit noch höherer Auflösung als das Bild mit high-Auflösung. Dieses Bild ist für einige Videos und andere Ressourcen verfügbar, die auf Videos verweisen, z. B. Playlist-Elemente oder Suchergebnisse. Dieses Bild ist 640 Pixel breit und 480 Pixel hoch.
  • maxres – Die Version der Miniaturansicht mit der höchsten Auflösung. Diese Bildgröße ist für einige Videos und andere Ressourcen verfügbar, die auf Videos verweisen, z. B. Playlist-Elemente oder Suchergebnisse. Dieses Bild ist 1280 Pixel breit und 720 Pixel hoch.
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
Der Titel des Kanals, der für diese Aktivität verantwortlich ist.
snippet.type string
Der Typ der Aktivität, die von der Ressource beschrieben wird.

Gültige Werte für dieses Attribut sind:
  • channelItem
  • comment – (wird derzeit nicht zurückgegeben)
  • playlistItem
  • promotedItem
  • recommendation
  • social
  • upload
snippet.groupId string
Die Gruppen-ID, die mit der Aktivität verknüpft ist. Eine Gruppen-ID identifiziert Nutzerereignisse, die mit demselben Nutzer und derselben Ressource verknüpft sind. Wenn ein Nutzer beispielsweise ein Video hochlädt und sich dasselbe Video ansieht, haben die Einträge für diese Ereignisse im Aktivitätsfeed des Nutzers dieselbe Gruppen-ID. In der Benutzeroberfläche können Sie Wiederholungen vermeiden, indem Sie Ereignisse mit demselben groupId-Wert gruppieren.
contentDetails object
Das contentDetails-Objekt enthält Informationen zu den Inhalten, die mit der Aktivität verknüpft sind. Wenn der Wert von 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 gleich upload ist.
contentDetails.upload.videoId string
Die ID, die YouTube zur eindeutigen Identifizierung des hochgeladenen Videos verwendet.
contentDetails.comment object
Das comment-Objekt enthält Informationen zu einer Ressource, zu der ein Kommentar abgegeben wurde. Dieses Attribut ist nur vorhanden, wenn snippet.type gleich comment ist.
contentDetails.comment.resourceId object
Das resourceId-Objekt enthält Informationen, die die Ressource identifizieren, die mit dem Kommentar verknüpft ist.
contentDetails.comment.resourceId.kind string
Der Typ der API-Ressource.
contentDetails.comment.resourceId.videoId string
Die ID, die YouTube zur eindeutigen Identifizierung des Videos verwendet, das mit einem Kommentar verknüpft ist. Dieses Attribut ist nur vorhanden, wenn resourceId.kind gleich youtube#video ist.
contentDetails.comment.resourceId.channelId string
Die ID, die YouTube zur eindeutigen Identifizierung des Kanals verwendet, der mit einem Kommentar verknüpft ist. Dieses Attribut ist nur vorhanden, wenn resourceId.kind gleich youtube#channel ist.
contentDetails.playlistItem object
Das playlistItem-Objekt enthält Informationen zu einem neuen Playlist-Element. Dieses Attribut ist nur vorhanden, wenn snippet.type gleich playlistItem ist.
contentDetails.playlistItem.resourceId object
Das resourceId-Objekt 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, die YouTube zur eindeutigen Identifizierung des Videos verwendet, das der Playlist hinzugefügt wurde. Dieses Attribut ist nur vorhanden, wenn resourceId.kind gleich youtube#video ist.
contentDetails.playlistItem.playlistId string
Der Wert, den YouTube zur eindeutigen Identifizierung der Playlist verwendet.
contentDetails.playlistItem.playlistItemId string
Der Wert, den YouTube zur eindeutigen Identifizierung des Elements in der Playlist verwendet.
contentDetails.recommendation object
Das recommendation-Objekt enthält Informationen zu einer empfohlenen Ressource. Dieses Attribut ist nur vorhanden, wenn snippet.type gleich recommendation ist.
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 zur eindeutigen Identifizierung des Videos verwendet, wenn die empfohlene Ressource ein Video ist. Dieses Attribut ist nur vorhanden, wenn resourceId.kind gleich youtube#video ist.
contentDetails.recommendation.resourceId.channelId string
Die ID, die YouTube zur eindeutigen Identifizierung des Kanals verwendet, wenn die empfohlene Ressource ein Kanal ist. Dieses Attribut ist nur vorhanden, wenn resourceId.kind gleich youtube#channel ist.
contentDetails.recommendation.reason string
Der Grund, warum die Ressource dem Nutzer empfohlen wird.

Gültige Werte für dieses Attribut sind:
  • videoWatched
contentDetails.recommendation.seedResourceId object
Das seedResourceId-Objekt enthält Informationen zur Ressource, die die Empfehlung ausgelöst hat.
contentDetails.recommendation.seedResourceId.kind string
Der Typ der API-Ressource.
contentDetails.recommendation.seedResourceId.videoId string
Die ID, die YouTube zur eindeutigen Identifizierung des Videos verwendet, wenn die Empfehlung durch ein bestimmtes Video ausgelöst wurde. Dieses Attribut ist nur vorhanden, wenn seedResourceId.kind gleich youtube#video ist.
contentDetails.recommendation.seedResourceId.channelId string
Die ID, die YouTube zur eindeutigen Identifizierung des Kanals verwendet, wenn die Empfehlung durch einen bestimmten Kanal ausgelöst wurde. Dieses Attribut ist nur vorhanden, wenn seedResourceId.kind gleich youtube#channel ist.
contentDetails.recommendation.seedResourceId.playlistId string
Die ID, die YouTube zur eindeutigen Identifizierung der Playlist verwendet, wenn die Empfehlung durch eine bestimmte Playlist ausgelöst wurde. Dieses Attribut ist nur vorhanden, wenn seedResourceId.kind gleich youtube#playlist ist.
contentDetails.social object
Das social-Objekt enthält Details zu einem Beitrag in einem sozialen Netzwerk. Dieses Attribut ist nur vorhanden, wenn snippet.type gleich social ist.
contentDetails.social.type string
Der Name des sozialen Netzwerks.

Gültige Werte für dieses Attribut sind:
  • facebook
  • googlePlus
  • twitter
  • unspecified
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 zur eindeutigen Identifizierung des Videos verwendet, das in einem Beitrag in einem sozialen Netzwerk enthalten ist, wenn sich der Beitrag auf ein Video bezieht. Dieses Attribut ist nur vorhanden, wenn der Wert des Attributs social.resourceId.kind gleich youtube#video ist.
contentDetails.social.resourceId.channelId string
Die ID, die YouTube zur eindeutigen Identifizierung des Kanals verwendet, der in einem Beitrag in einem sozialen Netzwerk enthalten ist, wenn sich der Beitrag auf einen Kanal bezieht. Dieses Attribut ist nur vorhanden, wenn der Wert des Attributs social.resourceId.kind gleich youtube#channel ist.
contentDetails.social.resourceId.playlistId string
Die ID, die YouTube zur eindeutigen Identifizierung der Playlist verwendet, die in einem Beitrag in einem sozialen Netzwerk enthalten ist, wenn sich der Beitrag auf eine Playlist bezieht. Dieses Attribut ist nur vorhanden, wenn der Wert des Attributs social.resourceId.kind gleich 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 Autors des Beitrags.
contentDetails.channelItem object
Das channelItem-Objekt enthält Details zu einer Ressource, die einem Kanal hinzugefügt wurde. Dieses Attribut ist nur vorhanden, wenn snippet.type gleich channelItem ist.
contentDetails.channelItem.resourceId object
Das resourceId-Objekt enthält Informationen, die die Ressource identifizieren, die dem Kanal hinzugefügt wurde.