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

CreateFile

PDS にファイルをアップロードしてファイルを作成すると、ファイルには 1 つのバージョンしかありません。 既存のファイルを上書きするために PDS にファイルをアップロードすると、ファイルの新しいバージョンが生成されます。

PDS にファイルをアップロードして既存のファイルを上書きする方法については、「ファイルをアップロードする」トピックの「上書きモードでのファイルのアップロード」セクションを参照してください。 既存のファイルを上書きするには、CreateFile 操作を呼び出すときに、file_id パラメータを上書きするファイルの ID に設定します。 その他の構成は、ファイルをアップロードしてファイルを作成する場合と同じです。

ListRevision

ListRevision 操作を呼び出して、ファイルの履歴バージョンをページごとにクエリできます。 返される結果は、逆時系列順にソートされます。 ファイルの履歴バージョンが生成された時刻に基づいて、ファイルの履歴バージョンは最新のものから最も古いものの順にソートされます。

サンプルリクエスト

{
	"drive_id":"testDriveId", // ドライブID
	"file_id": "testFileId" // ファイルID
}

サンプルレスポンス

{
	"items": [{ // 履歴バージョン情報のリスト
		"domain_id": "testDomainId", // ドメインID
		"drive_id": "testDriveId", // ドライブID
		"file_id": "testFileId", // ファイルID
		"revision_id": "testRevisionId", // リビジョンID
		"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", // CRC64ハッシュ値
		"created_at": "2022-09-05T04:00:09.017Z", // 作成日時
		"updated_at": "2022-09-05T04:00:09.017Z", // 更新日時
		"creator_type": "User", // 作成者タイプ
		"creator_id": "testCreatorId", // 作成者ID
		"is_latest_version": true // 最新バージョンフラグ
	}],
	"next_marker": "" // 次のページのトークン
}

パラメータの説明

• drive_id リクエストパラメーターは、クエリ対象の履歴バージョンを持つファイルが存在する個人ドライブまたはエンタープライズドライブの ID を指定します。

• file_id リクエストパラメーターは、履歴バージョンをクエリするファイルの ID を指定します。 このパラメーターにはフォルダ ID を指定できません。

• 結果がページごとに返される場合、next_marker レスポンスパラメーターは、新しいページの結果を取得するための次のリクエストで使用されるページネーショントークンを示します。 前のリクエストから取得したトークンを、次のリクエストの marker パラメーターの値として指定する必要があります。 next_marker レスポンスパラメーターに値が返されない場合、最後のページの結果が返されます。

• revision_version レスポンスパラメーターは、バージョン番号を示します。 数値が小さいほど、バージョンが古いことを示します。

• revision_create_reason レスポンスパラメータは、バージョンが生成された理由を示します。 有効な値：

  • 空の文字列: ファイルが作成されます。

  • overwrite: 既存のファイルが上書きされます。

  • restore_rev: 履歴バージョンが復元されます。

• is_latest_version レスポンスパラメーターは、ファイルが最新バージョンであるかどうかを示します。

• revision_name レスポンスパラメーターは、ファイルの最新バージョンの名前を示します。 ファイルの最新バージョンの名前は、ファイルの名前と同じです。 履歴バージョンの名前は、履歴バージョンが生成されたときに固定されます。

GetRevision

GetRevision 操作を呼び出して、履歴バージョンの詳細をクエリできます。 ListRevision 操作と比較して、download_url パラメータが GetRevision 操作のレスポンスに追加されます。

サンプルリクエスト

{
	"drive_id":"testDriveId", // ドライブID
	"file_id": "testFileId", // ファイルID
	"revision_id": "testRevisionId" // リビジョンID
}

サンプルレスポンス

{
	"domain_id": "testDomainId", // ドメインID
	"drive_id": "testDriveId", // ドライブID
	"file_id": "testFileId", // ファイルID
	"revision_id": "testRevisionId", // リビジョンID
	"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", // CRC64ハッシュ値
	"created_at": "2022-09-05T04:00:09.017Z", // 作成日時
	"updated_at": "2022-09-05T04:00:09.017Z", // 更新日時
	"creator_type": "User", // 作成者タイプ
	"creator_id": "testCreatorId", // 作成者ID
	"is_latest_version": true, // 最新バージョンフラグ
	"download_url": "testDownloadUrl" // ダウンロードURL
}

UpdateRevision

UpdateRevision 操作を呼び出して、ファイルバージョンのプロパティを構成できます。

{
	"drive_id": "testDriveId", // ドライブID
	"file_id": "testFileId", // ファイルID
	"revision_id": "testRevisionId", // リビジョンID
	"keep_forever": true // 永久保存フラグ
}

{
	"drive_id": "testDriveId", // ドライブID
	"file_id": "testFileId", // ファイルID
	"revision_id": "testRevisionId", // リビジョンID
	"keep_forever": false // 永久保存フラグ
}

{
	"drive_id": "testDriveId", // ドライブID
	"file_id": "testFileId", // ファイルID
	"revision_id": "testRevisionId", // リビジョンID
	"revision_description": "this is a revision" // リビジョン説明
}

RestoreRevision

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

サンプルリクエスト

{
	"drive_id": "testDriveId", // ドライブID
	"file_id": "testFileId", // ファイルID
	"revision_id": "testRevisionId" // リビジョンID
}

DeleteRevision

DeleteRevision 操作を呼び出して、履歴バージョンを削除し、履歴バージョンによって占有されているストレージスペースを解放できます。

サンプルリクエスト

{
	"drive_id": "testDriveId", // ドライブID
	"file_id": "testFileId", // ファイルID
	"revision_id": "testRevisionId" // リビジョンID
}