Diese Seite wurde von der Cloud Translation API übersetzt.

Activities

Eine activity-Ressource enthält Informationen zu einer Aktion, die ein bestimmter Kanal oder Nutzer auf YouTube ausgeführt hat. Zu den Aktionen, die in Aktivitätsfeeds gemeldet werden, gehören 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ü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 Channel-Aktivitätsereignissen zurück, die den Anfragekriterien entsprechen. So können Sie beispielsweise Ereignisse abrufen, die einem bestimmten Kanal oder dem eigenen Kanal des Nutzers zugeordnet 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
    },
    "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 enthalten sind:

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 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 der Ressource zugeordnet sind, die hauptsächlich mit der Aktivität verknüpft ist. Für jedes Objekt auf der Karte ist der Schlüssel der Name des Vorschaubilds und der Wert ein Objekt, das weitere Informationen zum Vorschaubild enthält.
`snippet.thumbnails.(key)`	`object` Gültige Schlüsselwerte sind: `default`: Das Standard-Thumbnail-Bild. Die Standard-Miniaturansicht für ein Video oder eine Ressource, die auf ein Video verweist, z. B. ein Playlistenelement oder ein Suchergebnis, ist 120 Pixel breit und 90 Pixel hoch. Das Standard-Thumbnail für einen Channel 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 dieses Bild 320 Pixel breit und 180 Pixel hoch. Für einen Channel ist dieses Bild 240 Pixel breit und 240 Pixel hoch. `high` – Eine Version des Thumbnail-Bilds mit hoher Auflösung. Bei einem Video (oder einer 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 noch höhere Auflösung des Thumbnail-Bilds als das Bild mit `high`-Auflösung. Dieses Bild ist für einige Videos und andere Ressourcen verfügbar, die sich auf Videos beziehen, z. B. Playlist-Elemente oder Suchergebnisse. Dieses Bild ist 640 Pixel breit und 480 Pixel hoch. `maxres`: Die Version des Thumbnail-Bilds mit der höchsten Auflösung. Diese Bildgröße ist für einige Videos und andere Ressourcen verfügbar, die sich auf Videos beziehen, z. B. Playlist-Elemente oder Suchergebnisse. Dieses Bild ist 1.280 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` Kanaltitel 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 diese Property sind: `channelItem` `comment` – (derzeit nicht zurückgegeben) `favorite` `like` `playlistItem` `promotedItem` `recommendation` `social` `subscription` `upload`
`snippet.groupId`	`string` Die Gruppen-ID, die der Aktivität zugeordnet ist. Eine Gruppen-ID identifiziert Nutzerereignisse, 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 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, wird das bewertete Video durch den Inhalt des `contentDetails`-Objekts identifiziert.
`contentDetails.upload`	`object` Das `upload`-Objekt enthält Informationen zum hochgeladenen Video. Diese Property ist nur vorhanden, wenn `snippet.type` `upload` ist.
`contentDetails.upload.videoId`	`string` Die ID, die YouTube zur eindeutigen Identifizierung des hochgeladenen Videos verwendet.
`contentDetails.like`	`object` Das `like`-Objekt enthält Informationen zu einer Ressource, die eine positive Bewertung (Like) erhalten hat. Diese Property ist nur vorhanden, wenn `snippet.type` `like` ist.
`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 zur eindeutigen Identifizierung des Videos verwendet, wenn es sich bei der bewerteten Ressource um ein Video handelt. Diese Property ist nur vorhanden, wenn `resourceId.kind` `youtube#video` ist.
`contentDetails.favorite`	`object` Das `favorite`-Objekt enthält Informationen zu einem Video, das als Lieblingsvideo markiert wurde. Diese Property ist nur vorhanden, wenn `snippet.type` `favorite` ist.
`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, die YouTube verwendet, um das Lieblingsvideo eindeutig zu identifizieren. Dieses Attribut ist nur vorhanden, wenn `resourceId.kind` `youtube#video` ist. Hinweis:Die Methode `activities.list` gibt derzeit keine Ressourcen für neue Kommentare zurück.
`contentDetails.comment`	`object` Das `comment`-Objekt enthält Informationen zu einer Ressource, zu der ein Kommentar abgegeben wurde. Diese Property ist nur vorhanden, wenn `snippet.type` `comment` ist.
`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, die YouTube verwendet, um das mit einem Kommentar verknüpfte Video eindeutig zu identifizieren. Diese Property ist nur vorhanden, wenn `resourceId.kind` `youtube#video` ist.
`contentDetails.comment.resourceId.channelId`	`string` Die ID, die YouTube verwendet, um den mit einem Kommentar verknüpften Kanal eindeutig zu identifizieren. Diese Property ist nur vorhanden, wenn `resourceId.kind` `youtube#channel` ist.
`contentDetails.subscription`	`object` Das `subscription`-Objekt enthält Informationen zu einem Kanal, den ein Nutzer abonniert hat. Diese Property ist nur vorhanden, wenn `snippet.type` `subscription` ist.
`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, die YouTube verwendet, um den Kanal, den der Nutzer abonniert hat, eindeutig zu identifizieren. Diese Property ist nur vorhanden, wenn `resourceId.kind` `youtube#channel` ist.
`contentDetails.playlistItem`	`object` Das `playlistItem`-Objekt enthält Informationen zu einem neuen Playlist-Element. Diese Property ist nur vorhanden, wenn `snippet.type` `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. Diese Property ist nur vorhanden, wenn `resourceId.kind` `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. Diese Property ist nur vorhanden, wenn `snippet.type` `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 es sich bei der empfohlenen Ressource um ein Video handelt. Diese Property ist nur vorhanden, wenn `resourceId.kind` `youtube#video` ist.
`contentDetails.recommendation.resourceId.channelId`	`string` Die ID, die YouTube verwendet, um den Kanal eindeutig zu identifizieren, wenn es sich bei der empfohlenen Ressource um einen Kanal handelt. Diese Property ist nur vorhanden, wenn `resourceId.kind` `youtube#channel` ist.
`contentDetails.recommendation.reason`	`string` Der Grund, warum die Ressource dem Nutzer empfohlen wird. Gültige Werte für diese Eigenschaft sind: `videoFavorited` `videoLiked` `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. Diese Property ist nur vorhanden, wenn `seedResourceId.kind` `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. Diese Property ist nur vorhanden, wenn `seedResourceId.kind` `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. Diese Property ist nur vorhanden, wenn `seedResourceId.kind` `youtube#playlist` ist.
`contentDetails.social`	`object` Das `social`-Objekt enthält Details zu einem Beitrag in einem sozialen Netzwerk. Diese Property ist nur vorhanden, wenn `snippet.type` `social` ist.
`contentDetails.social.type`	`string` Der Name des sozialen Netzwerks. Gültige Werte für diese Eigenschaft 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 verwendet, um das in einem Beitrag in einem sozialen Netzwerk enthaltene Video eindeutig zu identifizieren, sofern sich der Beitrag auf ein Video bezieht. Diese Property ist nur vorhanden, wenn der Wert der Property `social.resourceId.kind` `youtube#video` ist.
`contentDetails.social.resourceId.channelId`	`string` Die ID, die YouTube verwendet, um den in einem Beitrag in einem sozialen Netzwerk erwähnten Kanal eindeutig zu identifizieren, sofern sich der Beitrag auf einen Kanal bezieht. Diese Property ist nur vorhanden, wenn der Wert der Property `social.resourceId.kind` `youtube#channel` ist.
`contentDetails.social.resourceId.playlistId`	`string` Die ID, die YouTube verwendet, um die in einem Beitrag in einem sozialen Netzwerk enthaltene Playlist eindeutig zu identifizieren, wenn sich der Beitrag auf eine Playlist bezieht. Diese Property ist nur vorhanden, wenn der Wert der Property `social.resourceId.kind` `youtube#playlist` ist.
`contentDetails.social.author`	`string` Der Autor des Beitrags in den sozialen Netzwerken.
`contentDetails.social.referenceUrl`	`string` Die URL des Beitrags im sozialen Netzwerk.
`contentDetails.social.imageUrl`	`string` Ein Bild des Verfassers des Beitrags.
`contentDetails.channelItem`	`object` Das `channelItem`-Objekt enthält Details zu einer Ressource, die einem Channel hinzugefügt wurde. Diese Property ist nur vorhanden, wenn `snippet.type` `channelItem` ist.
`contentDetails.channelItem.resourceId`	`object` Das `resourceId`-Objekt enthält Informationen, die die Ressource identifizieren, die dem Channel hinzugefügt wurde.

Activities Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Methoden

Ressourcendarstellung

Attribute

Activities