Activities

YouTube は、チャンネルのお知らせメッセージ機能のサポートを終了しました。activities.list メソッドは まだチャンネルのお知らせメッセージが返されず、 activities.insert メソッドが no サポートされなくなりました詳しくは、 YouTube ヘルプセンター

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

メソッド

この 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 です。
  • standardhigh 解像度の画像よりもさらに高解像度のサムネイル画像。この画像は、再生リストのアイテムや検索結果など、動画を参照する一部の動画やその他のリソースに表示されます。この画像は、幅 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
リソースが記述するアクティビティのタイプ。

このプロパティの有効な値は次のとおりです。 <ph type="x-smartling-placeholder">
    </ph>
  • 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.typeupload の場合にのみ存在します。
contentDetails.upload.videoId string
アップロードされた動画を一意に識別するために YouTube によって使用される ID。
contentDetails.like object
like オブジェクトには、高評価(高評価)の評価を受けたリソースに関する情報が含まれます。このプロパティは、snippet.typelike の場合にのみ存在します。
contentDetails.like.resourceId object
resourceId オブジェクトには、評価されたリソースを識別する情報が含まれます。
contentDetails.like.resourceId.kind string
API リソースのタイプ。
contentDetails.like.resourceId.videoId string
評価されたリソースが動画の場合に、動画を一意に識別するために YouTube によって使用される ID。このプロパティは、resourceId.kindyoutube#video の場合にのみ存在します。
contentDetails.favorite object
favorite オブジェクトには、お気に入りの動画としてマークされた動画に関する情報が含まれます。このプロパティは、snippet.typefavorite の場合にのみ存在します。
contentDetails.favorite.resourceId object
resourceId オブジェクトには、お気に入りとしてマークされたリソースを識別する情報が含まれます。
contentDetails.favorite.resourceId.kind string
API リソースのタイプ。
contentDetails.favorite.resourceId.videoId string
お気に入りの動画を一意に識別するために YouTube によって使用される ID。このプロパティは、resourceId.kindyoutube#video の場合にのみ存在します。

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

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

このプロパティで有効な値は次のとおりです。 <ph type="x-smartling-placeholder">
    </ph>
  • 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.typechannelItem の場合にのみ存在します。
contentDetails.channelItem.resourceId object
resourceId オブジェクトには、チャンネルに追加されたリソースを識別する情報が含まれます。