commentThread リソースには、YouTube のコメント スレッドに関する情報が含まれます。コメント スレッドは、トップレベルのコメントと、そのコメントに対する返信(存在する場合)で構成されます。commentThread リソースは動画に対するコメントを表します。
トップレベルのコメントと返信は、どちらも commentThread リソース内にネストされた comment リソースです。commentThread リソースには、コメントに対するすべての返信が含まれているとは限りません。特定のコメントに対するすべての返信を取得するには、comments.list メソッドを使用する必要があります。一部のコメントには返信がありません。
メソッド
この API では、commentThreads リソースについて次のメソッドがサポートされています。
- list
- API リクエスト パラメータに一致するコメント スレッドのリストを返します。 今すぐ試す
- insert
- 新しいトップレベル コメントを作成します。既存のコメントに返信を追加するには、代わりに
comments.insertメソッドを使用します。 こちらから今すぐお試しください。
リソース表現
JSON 構造は、commentThreads リソースの形式を示しています。
{
"kind": "youtube#commentThread",
"etag": etag,
"id": string,
"snippet": {
"channelId": string,
"videoId": string,
"topLevelComment": comments Resource,
"canReply": boolean,
"totalReplyCount": unsigned integer,
"isPublic": boolean
},
"replies": {
"comments": [
comments Resource
]
}
}プロパティ
次の表は、このリソースで使用されているプロパティの定義を示したものです。
| プロパティ | |
|---|---|
kind |
stringAPI リソースのタイプを指定します。値は youtube#commentThread です。 |
etag |
etagこのリソースの ETag。 |
id |
stringコメント スレッドを一意に識別するために YouTube によって使用される ID。 |
snippet |
objectsnippet オブジェクトには、コメント スレッドに関する基本情報が格納されます。また、スレッドの最上位のコメント(comment リソース)も含まれます。 |
snippet.channelId |
stringスレッド内のコメントに関連付けられている YouTube チャンネル。 snippet.videoId プロパティは動画を識別します。 |
snippet.videoId |
stringコメントが参照する動画の ID。 |
snippet.topLevelComment |
objectスレッドの最上位コメント。このプロパティの値は comment リソースです。 |
snippet.canReply |
booleanこの設定は、現在の閲覧者がスレッドに返信できるかどうかを示します。 |
snippet.totalReplyCount |
unsigned integer最上位のコメントに対して送信された返信の合計数。 |
snippet.isPublic |
booleanこの設定は、スレッド(すべてのコメントとコメント返信を含む)をすべての YouTube ユーザーに表示するかどうかを指定します。 |
replies |
objectreplies オブジェクトは、コメントに対する返信(存在する場合)のリストを含むコンテナです。replies.comments プロパティは、コメント自体のリストを表します。 |
replies.comments[] |
list最上位のコメントに対する 1 つ以上の返信のリスト。リスト内の各項目は comment リソースです。リストに含まれる返信の数には限りがあり、リスト内のアイテム数が snippet.totalReplyCount プロパティの値と等しくない限り、返信のリストは最上位のコメントに使用できる返信の総数のサブセットにすぎません。最上位コメントに対するすべての返信を取得するには、comments.list メソッドを呼び出し、parentId リクエスト パラメータを使用して、返信を取得するコメントを指定する必要があります。 |