Drive and Photo Service:ファイルの履歴バージョン

新しいバージョンの生成

ファイルを最初にアップロードした時点では、バージョンは 1 つだけです。ファイルを上書きすると、新しいバージョンが作成されます。

ファイルを上書きするには、file_id をターゲットファイルの ID に設定して CreateFile 操作を呼び出します。残りのアップロードプロセスは、「ファイルアップロード」で説明されている内容と同じです。

履歴バージョンの一覧表示

ListRevision 操作を呼び出して、ファイルのバージョン一覧をページ分割して取得します。バージョンは逆時系列順で返されます。

リクエストの例：

{
	"drive_id":"testDriveId",
	"file_id": "testFileId"
}

レスポンスの例：

{
	"items": [{
		"domain_id": "testDomainId",
		"drive_id": "testDriveId",
		"file_id": "testFileId",
		"revision_id": "testRevisionId",
		"revision_name": "history_version.xlsx",
		"file_extension": "xlsx",
		"size": 8493,
		"revision_version": 2,
		"keep_forever": false,
		"revision_description": "",
		"revision_create_reason": "overwrite",
		"content_hash_name": "sha1",
		"content_hash": "xxxxxx",
		"crc64_hash": "xxxxxx",
		"created_at": "2022-09-05T04:00:09.017Z",
		"updated_at": "2022-09-05T04:00:09.017Z",
		"creator_type": "User",
		"creator_id": "testCreatorId",
		"is_latest_version": true
	}],
	"next_marker": ""
}

フィールドの説明：

• drive_id：個人用スペースまたはエンタープライズドライブの ID。

• file_id：ファイルの ID。フォルダー ID は指定できません。

• next_marker：ページネーショントークン。次のリクエストでこの値を marker パラメーターとして渡します。空の値は最後のページを示します。

• revision_version：バージョン番号。数値が小さいほど古いバージョンを示します。

• revision_create_reason：バージョンが作成された理由。有効な値：

  • "" (空文字列)：ファイルが作成された。

  • "overwrite"：ファイルが上書きされた。

  • "restore_rev"：履歴バージョンが復元された。

• is_latest_version：これがファイルの最新バージョンであるかどうかを示します。

• revision_name：バージョンの名前。最新バージョンはファイルの名前を共有します。履歴バージョンの名前は作成時に固定されます。

バージョン詳細の取得

GetRevision 操作を呼び出して、単一バージョンの詳細を取得します。ListRevision のレスポンスとは異なり、GetRevision のレスポンスにはダウンロード URL が含まれます。

リクエストの例：

{
	"drive_id":"testDriveId",
	"file_id": "testFileId",
	"revision_id": "testRevisionId"
}

レスポンスの例：

{
	"domain_id": "testDomainId",
	"drive_id": "testDriveId",
	"file_id": "testFileId",
	"revision_id": "testRevisionId",
	"revision_name": "history_version.xlsx",
	"file_extension": "xlsx",
	"size": 8493,
	"revision_version": 2,
	"keep_forever": false,
	"revision_description": "",
	"revision_create_reason": "overwrite",
	"content_hash_name": "sha1",
	"content_hash": "xxxxxx",
	"crc64_hash": "xxxxxx",
	"created_at": "2022-09-05T04:00:09.017Z",
	"updated_at": "2022-09-05T04:00:09.017Z",
	"creator_type": "User",
	"creator_id": "testCreatorId",
	"is_latest_version": true,
	"download_url": "testDownloadUrl"
}

バージョンプロパティの更新

UpdateRevision 操作を呼び出して、バージョンのプロパティを更新します。

{
	"drive_id": "testDriveId",
	"file_id": "testFileId",
	"revision_id": "testRevisionId",
	"keep_forever": true
}

{
	"drive_id": "testDriveId",
	"file_id": "testFileId",
	"revision_id": "testRevisionId",
	"keep_forever": false
}

{
	"drive_id": "testDriveId",
	"file_id": "testFileId",
	"revision_id": "testRevisionId",
	"revision_description": "this is a revision"
}

履歴バージョンの復元

RestoreRevision 操作を呼び出して履歴バージョンを復元し、それをファイルの最新バージョンにします。

リクエストの例：

{
	"drive_id": "testDriveId",
	"file_id": "testFileId",
	"revision_id": "testRevisionId"
}

履歴バージョンの削除

DeleteRevision 操作を呼び出して履歴バージョンを削除し、それが占有していたストレージ容量を解放します。

リクエストの例：

{
	"drive_id": "testDriveId",
	"file_id": "testFileId",
	"revision_id": "testRevisionId"
}