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

プロパティ

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

プロパティ
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 – サムネイル画像の最高解像度版。この画像サイズは、一部の動画や、再生リストのアイテムや検索結果など、動画を参照する他のリソースで利用できます。この画像の幅は 1280 ピクセル、高さは 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 – （現時点では返されません） playlistItem promotedItem recommendation social 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.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.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 The resourceId object contains information that identifies the recommended resource.
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 リソースがユーザーにおすすめされる理由。 このプロパティで指定可能な値は次のとおりです。 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 `socialsocial` オブジェクトには、ソーシャル ネットワークの投稿に関する詳細が含まれます。このプロパティは、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 The channelItem オブジェクトには、チャンネルに追加されたリソースに関する詳細が含まれます。このプロパティは、snippet.type が channelItem の場合にのみ存在します。
contentDetails.channelItem.resourceId	object The resourceId オブジェクトには、チャンネルに追加されたリソースを識別する情報が含まれます。