CommentThreads

commentThread リソースには、YouTube コメント スレッドに関する情報が含まれます。コメント スレッドは、トップレベルのコメントと、そのコメントに対する返信（存在する場合）で構成されます。commentThread リソースは、動画に対するコメントを表します。

最上位のコメントと返信は、実際には commentThread リソース内にネストされた comment リソースです。commentThread リソースには、必ずしもコメントに対するすべての返信が含まれているわけではありません。また、特定のコメントに対するすべての返信を取得するには、comments.list メソッドを使用する必要があります。一部のコメントには返信がありません。

Methods

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 リクエスト パラメータを使用して、返信を取得するコメントを指定する必要があります。