このページは Cloud Translation API によって翻訳されました。

コメントと返信を管理する

コメントとは、ファイルに対するユーザーが提供するフィードバックです。たとえば、ファイルの閲覧者などがコメントとして文章の言い換え方を提案するワープロ文書。2 つのモデルコメントの種類: アンカーコメントとアンカーなしコメント。アンカー型コメントが特定の場所に関連付けられている場合（例: 特定のバージョンの文書に保持される文書です。逆にアンカーのないコメントは、ドキュメントにのみ関連付けられます。

返信はコメントに添付され、コメントに対するユーザーの返信を表します。あります。Drive API を使用すると、ユーザーは Google ドライブにコメントや作成することもできます。コメントに対する返信の総称は、 ディスカッションを行います。

固定されていないコメントを追加する

固定されていないコメントをドキュメントに追加するには、 comments.create メソッドを fileId パラメータとコメントを含む comments リソース。

コメントは書式なしテキストとして挿入されますが、レスポンスの本文には表示用にフォーマットされたコンテンツを含む htmlContent フィールド。

コメントに返信を追加する

コメントに返信を追加するには、 replies.create メソッド fileId パラメータ、replies リソース返されます。

返信は書式なしテキストとして挿入されますが、レスポンスの本文には表示用にフォーマットされたコンテンツを含む htmlContent フィールド。

ドキュメントの最新の版に固定されたコメントを追加する

コメントを追加するときは、ファイル内の領域にコメントを固定することをおすすめします。「 anchor は、コメントを追加するファイルのリビジョンとファイル内の領域を定義します。参照します。comments リソースは、 JSON 文字列としての anchor フィールド。

固定コメントを追加するには:

（省略可）revisions.list を呼び出すメソッドを使用して、ドキュメントのすべての revisionID を一覧表示します。次の場合にのみ、この手順を実施してください。最新の版以外の版にコメントを固定する。最新のリビジョンを使用する場合は、revisionID に head を使用します。
comments.create メソッドを呼び出す fileID パラメータ（comments）コメントを含むリソースと、コメントを含む JSON アンカー文字列が revisionID（r）とリージョン（a）です。

地域を定義する方法は、作業するドキュメントのコンテンツの種類によって異なりますできます。詳細については、リージョンを定義するをご覧ください。

リージョンを定義する

前述のように、JSON アンカー文字列には revisionID（r）とリージョン（a）。地域（a）は、地域分類器を含む JSON 配列です。コメントをアンカーする形式と場所を指定します。分類器画像の場合は 2 次元の長方形、ドキュメント内の 1 行、動画の長さを指定しますリージョンを定義するには、リージョン分類器を見つけます。対象たとえば、コンテンツがテキストの場合、txt または line リージョン分類器を使用します。

Drive API で使用される地域分類の一覧については、地域分類をご覧ください。分類器です。

次の例は、コメントを行に固定する JSON アンカー文字列を示しています。ドキュメントの 2 つの領域に分けて表示します。

最初の領域は 12 行目（'n':12）から始まり、3 行にわたって続きます。（'l':3）。
2 つ目の領域は 18 行目（'n':18, 'l':1）のみをカバーします。

    {
      'r': 'REVISION_ID',
      'a': [
      {
        'line':
        {
          'n': 12,
          'l': 3,
        }
      },
      {
        'line':
        {
          'n': 18,
          'l': 1,
        }
      }]
    }

REVISION_ID は、head または特定のオブジェクトの ID に置き換えます。できます。

コメントを解決する

comment.update メソッドを使用して以下を設定します。 comments の resolved プロパティコメントに対処したら、true にリソースを追加します。

アプリで resolved プロパティを true に設定すると、UI に対処したことを示します。たとえば、アプリは次のようになります。

それ以降の返信を禁止し、以前の返信と元の返信をすべて暗くしますあります。
解決済みのコメントを非表示にする。

コメントを削除する

comments.delete メソッドを使用して、以下を行います。コメントを削除できます。コメントが削除されると、ドライブではコメントに "deleted": "true" としてのコメントリソース。

コメントの一覧表示

comments.list メソッドを使用して、リストを取得します。できます。削除済みのコメントを結果に含める場合は、 includedDeleted フィールドを true に設定。