Diese Seite wurde von der Cloud Translation API übersetzt.

Activities

YouTube hat das Kanalbulletin eingestellt. Die Methode activities.list keine Kanalbulletins mehr zurückgeben und die Methode activities.insert ist nicht 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 den Aktivitätsfeeds gemeldeten Aktionen gehören unter anderem die Bewertung eines Videos, das Teilen eines Videos, das Markieren eines Videos als Favorit und das Hochladen eines Videos. Jede activity-Ressource identifiziert den Aktionstyp, den mit der Aktion verknüpften Kanal und die mit der Aktion verknüpften Ressourcen, z. B. das bewertete oder hochgeladene Video.

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 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 `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 und hauptsächlich mit der Aktivität verknüpft sind. Für jedes Objekt in der Karte ist der Schlüssel der Name der Miniaturansicht und der Wert ein Objekt, das weitere Informationen über die Miniaturansicht enthält.
`snippet.thumbnails.(key)`	`object` Gültige Schlüssel/Wert-Paare sind: `default`: Das Standardbild für die Miniaturansicht. Das Standard-Thumbnail für ein Video oder eine Ressource, die sich auf ein Video bezieht, z. B. einen Playlist-Eintrag 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 der Miniaturansicht 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. Bei einem Kanal ist dieses Bild 240 Pixel breit und 240 Pixel hoch. `high`: Eine Version der Miniaturansicht 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. Bei einem Kanal ist dieses Bild 800 Pixel breit und 800 Pixel hoch. `standard`: Eine Version der Miniaturansicht mit einer noch höheren Auflösung als die Auflösung `high`. 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 der Miniaturansicht 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 Bilds.
`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` Die Art der Aktivität, die in der Ressource beschrieben wird. Gültige Werte für diese Eigenschaft sind: <ph type="x-smartling-placeholder"> </ph> `channelItem` `comment` – (derzeit nicht zurückgegeben) `favorite` `like` `playlistItem` `promotedItem` `recommendation` `social` `subscription` `upload` `bulletin` (eingestellt)
`snippet.groupId`	`string` Die mit der Aktivität verknüpfte Gruppen-ID. 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. Auf der Benutzeroberfläche können Sie Wiederholungen 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 von `snippet.type` beispielsweise `videoRated` ist, wird das bewertete Video durch den Inhalt des `contentDetails`-Objekts identifiziert.
`contentDetails.upload`	`object` Das Objekt `upload` enthält Informationen zum hochgeladenen Video. Dieses Attribut 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 Objekt `like` enthält Informationen zu einer Ressource, die eine positive Bewertung erhalten hat. Dieses Attribut ist nur vorhanden, wenn `snippet.type` `like` ist.
`contentDetails.like.resourceId`	`object` Das Objekt `resourceId` enthält Informationen zur Identifizierung der bewerteten Ressource.
`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. Dieses Attribut ist nur vorhanden, wenn `resourceId.kind` `youtube#video` ist.
`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` `favorite` ist.
`contentDetails.favorite.resourceId`	`object` Das Objekt `resourceId` 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 Objekt `comment` enthält Informationen zu einer Ressource, die einen Kommentar erhalten hat. Dieses Attribut ist nur vorhanden, wenn `snippet.type` `comment` ist.
`contentDetails.comment.resourceId`	`object` Das Objekt `resourceId` enthält Informationen zur Identifizierung der mit dem Kommentar verknüpften Ressource.
`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. Dieses Attribut 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. Dieses Attribut ist nur vorhanden, wenn `resourceId.kind` `youtube#channel` ist.
`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` `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. Dieses Attribut ist nur vorhanden, wenn `resourceId.kind` `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` `playlistItem` ist.
`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, die YouTube verwendet, um das zur Playlist hinzugefügte Video eindeutig zu identifizieren. Dieses Attribut 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 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` `recommendation` ist.
`contentDetails.recommendation.resourceId`	`object` Das Objekt `resourceId` enthält Informationen zur Identifizierung der empfohlenen Ressource.
`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` `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` `youtube#channel` ist.
`contentDetails.recommendation.reason`	`string` Der Grund, warum die Ressource dem Nutzer empfohlen wird. Gültige Werte für diese Eigenschaft sind: <ph type="x-smartling-placeholder"> </ph> `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, die YouTube zur eindeutigen Identifizierung des Videos verwendet, wenn die Empfehlung durch ein bestimmtes Video verursacht wurde. Dieses Attribut ist nur vorhanden, wenn `seedResourceId.kind` `youtube#video` ist.
`contentDetails.recommendation.seedResourceId.channelId`	`string` Die ID, mit der YouTube den Kanal eindeutig identifiziert, wenn die Empfehlung von einem bestimmten Kanal stammt. Dieses Attribut 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. Dieses Attribut ist nur vorhanden, wenn `seedResourceId.kind` `youtube#playlist` ist.
`contentDetails.social`	`object` Das Objekt `social` enthält Details zu einem Beitrag in einem sozialen Netzwerk. Dieses Attribut ist nur vorhanden, wenn `snippet.type` `social` ist.
`contentDetails.social.type`	`string` Der Name des sozialen Netzwerks. Gültige Werte für diese Property: <ph type="x-smartling-placeholder"> </ph> `facebook` `googlePlus` `twitter` `unspecified`
`contentDetails.social.resourceId`	`object` Das `resourceId`-Objekt 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, sofern sich der Beitrag auf ein Video bezieht. Dieses Attribut ist nur vorhanden, wenn der Wert der Eigenschaft `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 der Eigenschaft `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 der Eigenschaft `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 im 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 Kanal hinzugefügt wurde. Dieses Attribut ist nur vorhanden, wenn `snippet.type` `channelItem` ist.
`contentDetails.channelItem.resourceId`	`object` Das Objekt `resourceId` enthält Informationen zur Identifizierung der Ressource, die dem Kanal hinzugefügt wurde.