Activities

チャンネルのお知らせメッセージ機能は、YouTube でサポートを終了しました。activities.list メソッドはまだチャンネルのお知らせを返しません。activities.insert メソッドのサポートも終了しました。詳しくは、YouTube ヘルプセンターをご覧ください。

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

Methods

この API では、activities リソースについて次のメソッドがサポートされています。

list

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

activities.insert メソッドはサポートされなくなりました。

リソース表現

次の 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 有効な Key-Value は次のとおりです。 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 bulletin（非推奨）
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 オブジェクトには、チャンネルに追加されたリソースを識別する情報が格納されます。