Activities

activity リソースには、特定のチャンネルまたはユーザーが YouTube で行ったアクションに関する情報が含まれています。アクティビティ フィードに表示される操作には、動画の評価、動画の共有、動画をお気に入りに追加、動画のアップロードなどがあります。各 activity リソースは、アクションのタイプ、アクションに関連付けられたチャンネル、アクションに関連付けられたリソース（評価またはアップロードされた動画など）を識別します。

メソッド

この API は、activities リソースに対して次のメソッドをサポートしています。

list
リクエスト条件に一致するチャンネル アクティビティ イベントのリストを返します。たとえば、特定のチャンネルやユーザー自身のチャンネルに関連付けられたイベントを取得できます。今すぐ試す

リソース表現

次の JSON 構造は、activities リソースの形式を示しています。

{
  "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": {
      }
    },
  }
}

プロパティ

次の表は、このリソースで使用されているプロパティの定義を示したものです。

プロパティ
kind string
API リソースのタイプを識別します。値は youtube#activity になります。
etag etag
このリソースの Etag。
id string
YouTube がアクティビティを一意に識別するために使用する ID。
snippet object
snippet オブジェクトには、アクティビティのタイプやグループ ID など、アクティビティに関する基本的な詳細が含まれます。
snippet.publishedAt datetime
アクティビティが発生した日時。値は ISO 8601 形式で指定します。
snippet.channelId string
YouTube がアクティビティに関連付けられたチャンネルを一意に識別するために使用する ID。
snippet.title string
アクティビティに主に関連付けられているリソースのタイトル。
snippet.description string
アクティビティに主に関連付けられているリソースの説明。
snippet.thumbnails object
アクティビティに主に関連付けられているリソースに関連付けられたサムネイル画像のマップ。マップ内の各オブジェクトでは、キーはサムネイル画像の名前で、値はサムネイルに関するその他の情報を含むオブジェクトになります。
snippet.thumbnails.(key) object
有効なキー値は次のとおりです。
  • default - デフォルトのサムネイル画像。動画（または、再生リストのアイテムや検索結果など、動画を参照するリソース）のデフォルト サムネイルは幅 120px、高さ 90px です。チャンネルのデフォルト サムネイルは幅 88px、高さ 88px です。
  • medium - サムネイル画像の高解像度版。動画（または動画を参照するリソース）の場合、この画像は幅 320px、高さ 180px です。チャンネルの場合は、幅 240px、高さ 240px です。
  • high - サムネイル画像の高解像度版。動画（または動画を参照するリソース）の場合、この画像は幅 480px、高さ 360px です。チャンネルの場合、幅 800px、高さ 800px です。
  • standard - high 解像度の画像よりもさらに解像度の高いサムネイル画像。この画像は、一部の動画と、動画を参照する他のリソース（再生リスト アイテムや検索結果など）で利用できます。この画像のサイズは幅 640 ピクセル、高さ 480 ピクセルです。
  • maxres - サムネイル画像の最高解像度バージョン。この画像サイズは、一部の動画や、動画を参照する他のリソース（再生リスト アイテムや検索結果など）で利用できます。この画像のサイズは幅 1,280 ピクセル、高さ 720 ピクセルです。
snippet.thumbnails.(key).url string
画像の URL。
snippet.thumbnails.(key).width unsigned integer
画像の幅。
snippet.thumbnails.(key).height unsigned integer
画像の高さ。
snippet.channelTitle string
このアクティビティを担当するチャンネルのチャンネル タイトル
snippet.type string
リソースが記述するアクティビティのタイプ。

このプロパティの有効な値は次のとおりです。
  • channelItem
  • comment - （現在返されません）
  • favorite
  • like
  • playlistItem
  • promotedItem
  • recommendation
  • social
  • subscription
  • upload
snippet.groupId string
アクティビティに関連付けられているグループ ID。グループ ID は、同じユーザーとリソースに関連付けられているユーザー イベントを特定します。たとえばユーザーが動画を評価し、その動画をお気に入りにした場合、そのユーザーのアクティビティ フィードではこれらのイベントのグループ ID は同じになります。ユーザー インターフェースでは、同じ groupId 値を持つイベントをグループ化することで、繰り返しを回避できます。
contentDetails object
contentDetails オブジェクトには、アクティビティに関連付けられたコンテンツに関する情報が含まれます。たとえば、snippet.type の値が videoRated の場合、contentDetails オブジェクトのコンテンツは評価対象の動画を識別します。
contentDetails.upload object
upload オブジェクトには、アップロードされた動画に関する情報が含まれます。このプロパティは、snippet.type が upload の場合にのみ存在します。
contentDetails.upload.videoId string
YouTube がアップロードされた動画を一意に識別するために使用する ID。
contentDetails.like object
like オブジェクトには、高評価（いいね）を受けたリソースに関する情報が含まれます。このプロパティは、snippet.type が like の場合にのみ存在します。
contentDetails.like.resourceId object
resourceId オブジェクトには、評価対象のリソースを識別する情報が含まれています。
contentDetails.like.resourceId.kind string
API リソースのタイプ。
contentDetails.like.resourceId.videoId string
評価対象のリソースが動画の場合、YouTube が動画を一意に識別するために使用する ID。このプロパティは、resourceId.kind が youtube#video の場合にのみ存在します。
contentDetails.favorite object
favorite オブジェクトには、お気に入り動画としてマークされた動画に関する情報が含まれます。このプロパティは、snippet.type が favorite の場合にのみ存在します。
contentDetails.favorite.resourceId object
resourceId オブジェクトには、お気に入りとしてマークされたリソースを識別する情報が含まれています。
contentDetails.favorite.resourceId.kind string
API リソースのタイプ。
contentDetails.favorite.resourceId.videoId string
YouTube がお気に入りの動画を一意に識別するために使用する ID。このプロパティは、resourceId.kind が youtube#video の場合にのみ存在します。

注: 現在、activities.list メソッドは新しいコメントのリソースを返しません。
contentDetails.comment object
comment オブジェクトには、コメントを受け取ったリソースに関する情報が含まれます。このプロパティは、snippet.type が comment の場合にのみ存在します。
contentDetails.comment.resourceId object
resourceId オブジェクトには、コメントに関連付けられたリソースを識別する情報が含まれています。
contentDetails.comment.resourceId.kind string
API リソースのタイプ。
contentDetails.comment.resourceId.videoId string
コメントに関連付けられている動画を一意に識別するために YouTube が使用する ID。このプロパティは、resourceId.kind が youtube#video の場合にのみ存在します。
contentDetails.comment.resourceId.channelId string
YouTube がコメントに関連付けられたチャンネルを一意に識別するために使用する ID。このプロパティは、resourceId.kind が youtube#channel の場合にのみ存在します。
contentDetails.subscription object
subscription オブジェクトには、ユーザーが登録したチャンネルに関する情報が含まれます。このプロパティは、snippet.type が subscription の場合にのみ存在します。
contentDetails.subscription.resourceId object
resourceId オブジェクトには、ユーザーが登録したリソースを識別する情報が含まれます。
contentDetails.subscription.resourceId.kind string
API リソースのタイプ。
contentDetails.subscription.resourceId.channelId string
ユーザーが登録したチャンネルを一意に識別するために YouTube が使用する ID。このプロパティは、resourceId.kind が youtube#channel の場合にのみ存在します。
contentDetails.playlistItem object
playlistItem オブジェクトには、新しいプレイリスト アイテムに関する情報が含まれます。このプロパティは、snippet.type が playlistItem の場合にのみ存在します。
contentDetails.playlistItem.resourceId object
resourceId オブジェクトには、再生リストに追加されたリソースを識別する情報が含まれています。
contentDetails.playlistItem.resourceId.kind string
API リソースのタイプ。
contentDetails.playlistItem.resourceId.videoId string
再生リストに追加された動画を一意に識別するために YouTube が使用する ID。このプロパティは、resourceId.kind が youtube#video の場合にのみ存在します。
contentDetails.playlistItem.playlistId string
YouTube が再生リストを一意に識別するために使用する値。
contentDetails.playlistItem.playlistItemId string
YouTube が再生リスト内のアイテムを一意に識別するために使用する値。
contentDetails.recommendation object
recommendation オブジェクトには、推奨リソースに関する情報が含まれています。このプロパティは、snippet.type が recommendation の場合にのみ存在します。
contentDetails.recommendation.resourceId object
resourceId オブジェクトには、推奨リソースを識別する情報が含まれています。
contentDetails.recommendation.resourceId.kind string
API リソースのタイプ。
contentDetails.recommendation.resourceId.videoId string
推奨リソースが動画の場合、YouTube が動画を一意に識別するために使用する ID。このプロパティは、resourceId.kind が youtube#video の場合にのみ存在します。
contentDetails.recommendation.resourceId.channelId string
推奨リソースがチャンネルの場合、YouTube がチャンネルを一意に識別するために使用する ID。このプロパティは、resourceId.kind が youtube#channel の場合にのみ存在します。
contentDetails.recommendation.reason string
リソースがユーザーに推奨される理由。

このプロパティの有効な値は次のとおりです。
  • videoFavorited
  • videoLiked
  • videoWatched
contentDetails.recommendation.seedResourceId object
seedResourceId オブジェクトには、推奨事項の原因となったリソースに関する情報が含まれています。
contentDetails.recommendation.seedResourceId.kind string
API リソースのタイプ。
contentDetails.recommendation.seedResourceId.videoId string
特定の動画が原因で推奨事項が表示された場合、YouTube が動画を一意に識別するために使用する ID。このプロパティは、seedResourceId.kind が youtube#video の場合にのみ存在します。
contentDetails.recommendation.seedResourceId.channelId string
特定のチャンネルが原因で推奨事項が表示された場合、YouTube がチャンネルを一意に識別するために使用する ID。このプロパティは、seedResourceId.kind が youtube#channel の場合にのみ存在します。
contentDetails.recommendation.seedResourceId.playlistId string
特定のプレイリストが原因で推奨事項が表示された場合、YouTube がプレイリストを一意に識別するために使用する ID。このプロパティは、seedResourceId.kind が youtube#playlist の場合にのみ存在します。
contentDetails.social object
social オブジェクトには、ソーシャル ネットワークの投稿に関する詳細が含まれます。このプロパティは、snippet.type が social の場合にのみ存在します。
contentDetails.social.type string
ソーシャル ネットワークの名前。

このプロパティの有効な値は次のとおりです。
  • facebook
  • googlePlus
  • twitter
  • unspecified
contentDetails.social.resourceId object
resourceId オブジェクトは、ソーシャル ネットワークの投稿に関連付けられたリソースを識別する情報をカプセル化します。
contentDetails.social.resourceId.kind string
API リソースのタイプ。
contentDetails.social.resourceId.videoId string
投稿が動画を参照している場合、YouTube がソーシャル ネットワークの投稿で紹介されている動画を一意に識別するために使用する ID。このプロパティは、social.resourceId.kind プロパティの値が youtube#video の場合にのみ存在します。
contentDetails.social.resourceId.channelId string
投稿がチャンネルを参照している場合、YouTube がソーシャル ネットワークの投稿で取り上げられているチャンネルを一意に識別するために使用する ID。このプロパティは、social.resourceId.kind プロパティの値が youtube#channel の場合にのみ存在します。
contentDetails.social.resourceId.playlistId string
投稿がプレイリストを参照している場合、YouTube がソーシャル ネットワークの投稿で紹介されているプレイリストを一意に識別するために使用する ID。このプロパティは、social.resourceId.kind プロパティの値が youtube#playlist の場合にのみ存在します。
contentDetails.social.author string
ソーシャル ネットワークの投稿の作成者。
contentDetails.social.referenceUrl string
ソーシャル ネットワークの投稿の URL。
contentDetails.social.imageUrl string
投稿者の画像。
contentDetails.channelItem object
channelItem オブジェクトには、チャンネルに追加されたリソースに関する詳細が含まれています。このプロパティは、snippet.type が channelItem の場合にのみ存在します。
contentDetails.channelItem.resourceId object
resourceId オブジェクトには、チャンネルに追加されたリソースを識別する情報が含まれます。