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 |
string API リソースのタイプを指定します。値は youtube#commentThread です。 |
etag |
etag このリソースの ETag。 |
id |
string コメント スレッドを一意に識別するために YouTube によって使用される ID。 |
snippet |
object snippet オブジェクトには、コメント スレッドに関する基本情報が格納されます。また、スレッドの最上位のコメント(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 |
object replies オブジェクトは、コメントに対する返信(存在する場合)のリストを含むコンテナです。replies.comments プロパティは、コメント自体のリストを表します。 |
replies.comments[] |
list 最上位のコメントに対する 1 つ以上の返信のリスト。リスト内の各項目は comment リソースです。リストに含まれる返信の数には限りがあり、リスト内のアイテム数が snippet.totalReplyCount プロパティの値と等しくない限り、返信のリストは最上位のコメントに使用できる返信の総数のサブセットにすぎません。最上位コメントに対するすべての返信を取得するには、comments.list メソッドを呼び出し、parentId リクエスト パラメータを使用して、返信を取得するコメントを指定する必要があります。 |