このページは Cloud Translation API によって翻訳されました。

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 です。 `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` リソースが記述するアクティビティのタイプ。このプロパティの有効な値は次のとおりです。 <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.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` リソースがユーザーに推奨される理由。このプロパティの有効な値は次のとおりです。 <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.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` ソーシャルネットワークの名前。このプロパティで有効な値は次のとおりです。 <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.type` が `channelItem` の場合にのみ存在します。
`contentDetails.channelItem.resourceId`	`object` `resourceId` オブジェクトには、チャンネルに追加されたリソースを識別する情報が含まれます。