REST Resource: comments

リソース: コメント

Google ドライブ内のファイルへのコメント。

一部のリソース メソッド(comments.update など)には commentId が必要です。ファイル内のコメントの ID を取得するには、comments.list メソッドを使用します。

JSON 表現
{
  "commentId": string,
  "kind": string,
  "createdDate": string,
  "modifiedDate": string,
  "fileId": string,
  "status": string,
  "anchor": string,
  "replies": [
    {
      object (CommentReply)
    }
  ],
  "author": {
    object (User)
  },
  "deleted": boolean,
  "selfLink": string,
  "htmlContent": string,
  "content": string,
  "context": {
    "type": string,
    "value": string
  },
  "fileTitle": string
}
フィールド
commentId

string

出力のみ。コメントの ID。

kind

string

出力のみ。これは常に drive#comment です。

createdDate

string

出力のみ。このコメントが最初に作成された日付。

modifiedDate

string

出力のみ。このコメントまたはその返信が最後に変更された日付。

fileId

string

出力のみ。このコメントが対応しているファイル。

status

string

出力のみ。このコメントのステータス。ステータスを変更するには、希望するステータスのコメントに返信してください。

  • open - コメントはまだオープンです。
  • resolved - コメントはいずれかの返信によって解決されました。
anchor

string

JSON 文字列として表されるドキュメントのリージョン。アンカー プロパティの定義について詳しくは、コメントと返信を追加するをご覧ください。

replies[]

object (CommentReply)

出力のみ。この投稿への返信です。

author

object (User)

出力のみ。コメントの作成者。作成者のメールアドレスと権限 ID は入力されません。

deleted

boolean

出力のみ。このコメントが削除されたかどうか。コメントを削除するとコンテンツは消去され、過去に存在したコメントのみが表示されるようになります。

htmlContent

string

出力のみ。このコメントの HTML 形式のコンテンツ。

content

string

このコメントの作成に使用された書式なしテキストのコンテンツ。これは HTML セーフではないので、コメントのコンテンツを編集するための出発点としてのみ使用してください。

context

object

コメントが付けられているファイルのコンテキスト。

context.type

string

コンテキスト スニペットの MIME タイプ。

context.value

string

コメントが付けられたファイルのセグメントのデータ表現。たとえばテキスト ファイルの場合は、コメントで使われている実際のテキストです。

fileTitle

string

出力のみ。このコメントの対象となるファイルのタイトル。

Methods

delete

コメントを削除します。

get

ID によりコメントを取得します。

insert

指定されたファイルに新しいコメントを作成します。

list

ファイルのコメントを一覧表示します。

patch

既存のコメントを更新します。

update

既存のコメントを更新します。