[Google Drive API v3] Javaでファイルのコメントの返信(リプライ)を取得する

Google Drive API v3（Java）を使用して、
Driveに置かれているファイルのコメントのリプライを取得する方法
についてご紹介します。

APIを利用する環境の準備から始める場合や、コードを実行する際は、
⧉[Google Drive API v3] JavaでDrive APIを使う
を参照ください。

No		目次
1		リプライリストを取得
	1	スコープ
	2	実行
	3	レスポンスの内容
2		リプライを取得
	1	スコープ
	2	実行
	3	レスポンスの内容

1. リプライリストを取得

1.1. スコープ

このAPIを実行するには、以下のいずれかのスコープを指定してください。

DriveScopes.DRIVE
DriveScopes.DRIVE_FILE
DriveScopes.DRIVE_READONLY

⧉[Google Drive API v3] JavaでDrive APIを使う(2.2 Driveインスタンスを取得)
でスコープを指定してください。

1.2. 実行

リプライを取得したいファイルのファイルIDとコメントIDを指定します。

setFieldsで取得したいフィールド（ReplyList）を指定します。
指定しないとエラーになります。
ここでは「*」(全て取得)を指定しています。

レスポンスのgetNextPageTokenがNULLではない場合、
全てのリストが取得できていません。
クエリパラメータのsetPageTokenに取得できた値を設定し、
再度APIを実行します。

public static void main(String[] args) throws Exception{
    Drive drive = getDrive();
	Drive.Replies replies = drive.replies();
 
    Drive.Replies.List list = replies.list("ファイルID", "コメントID");
    list.setFields("*");

//レスポンスのgetNextPageTokenがNULLではない場合
//list.setPageToken("レスポンスのgetNextPageToken");

    ReplyList res = list.execute();
    System.out.println(res);
}

1.2.1. HTTPリクエスト

GET:　https://www.googleapis.com/drive/v3/files/{ファイルID}/comments/{コメントID}/replies
が実行されます。

1.2.2. クエリパラメータ

Drive.Replies.Listのsetメソッドにより、クエリパラメータを追加できます。

メソッド	引数	説明
setPageSize	Integer	ページごとに返されるコメントの最大数
setPageToken	String	次のページで前のリスト要求を継続するためのトークン レスポンスのgetNextPageTokenで取得が可能
setIncludeDeleted	Boolean	削除された返信を含めるか

1.3. レスポンスの内容

ReplyList

フィールド	メソッド	戻り値	説明
kind	getKind	String	リソースの種類 固定文字列："drive#revisionList"
nextPageToken	getNextPageToken	String	次のページのページトークン リストの最後の場合はNULL
replies	getReplies	List<Reply>	リプライリスト

2. リプライを取得

2.1. スコープ

このAPIを実行するには、以下のいずれかのスコープを指定してください。

DriveScopes.DRIVE
DriveScopes.DRIVE_FILE
DriveScopes.DRIVE_READONLY

⧉[Google Drive API v3] JavaでDrive APIを使う(2.2 Driveインスタンスを取得)
でスコープを指定してください。

2.2. 実行

取得したいリプライのファイルID、コメントID、リプライIDを指定します。

setFieldsで取得したいフィールド（Reply）を指定します。
指定しないとエラーになります。
ここでは「*」(全て取得)を指定しています。

public static void main(String[] args) throws Exception{
    Drive drive = getDrive();
    Drive.Replies replies = drive.replies();
    
    Drive.Replies.Get get = replies.get("ファイルID", "コメントID","リプライID");
    get.setFields("*");
    
    Reply res = get.execute();
    System.out.println(res);
}

2.2.1. HTTPリクエスト

GET：　https://www.googleapis.com/drive/v3/files/{ファイルID}/comments/{コメントID}/replies/{リプライID}
が実行されます。

2.2.2. クエリパラメータ

Drive.Revisions.Getのsetメソッドにより、クエリパラメータを追加できます。

メソッド	引数	説明
setIncludeDeleted	Boolean	削除された返信を含めるか

2.3. レスポンスの内容

Reply

フィールド	メソッド	戻り値	説明
id	getId	String	リプライID
kind	getKind	String	リソースの種類 固定文字列："drive#reply"
createdTime	getCreatedTime	String	応答が作成された時刻
modifiedTime	getModifiedTime	String	応答が最後に変更された時刻
action	getAction	String	返信が親コメントに対して実行したアクション resolve、reopen
author	getAuthor	User	返信の作成者
deleted	getDeleted	Boolean	返信が削除されたか
htmlContent	getHtmlContent	String	HTML形式での返信の内容
content	getContent	String	返信のプレーンテキストの内容

User

メソッド	戻り値	説明
getDisplayName	String	表示名
getEmailAddress	String	ユーザーの電子メールアドレス
getKind	String	リソースの種類 固定文字列："drive#user"
getMe	Boolean	このユーザーが要求ユーザーであるか
getPermissionId	String	権限リソースに表示されるユーザーID
getPhotoLink	String	利用可能な場合、ユーザーのプロフィール写真へのリンク

おしまい。。