YouTube は、チャンネルのお知らせメッセージ機能のサポートを終了しました。
activities.list
メソッドは
まだチャンネルのお知らせメッセージが返されず、
activities.insert
メソッドが no
サポートされなくなりました詳しくは、
YouTube ヘルプセンター
activity
リソースには、特定のチャンネルまたはユーザーが YouTube で行った操作に関する情報が含まれます。アクティビティ フィードで報告される操作には、動画の評価、動画の共有、お気に入りへの動画のマーク付け、動画のアップロードなどがあります。各 activity
リソースは、アクションのタイプ、アクションに関連付けられたチャンネル、アクションに関連付けられたリソース(評価やアップロードされた動画など)を識別します。
メソッド
この API では、activities
リソースについて次のメソッドがサポートされています。
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 は次のとおりです。
|
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">
|
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">
|
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">
|
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 オブジェクトには、チャンネルに追加されたリソースを識別する情報が含まれます。 |