HistoryVersions:list

功能介绍

列举文件历史记录。

场景描述

您的应用可以通过HistoryVersions.list接口获取到文件历史记录列表。

使用约束

• Scope至少包含下面其中一个：
  • https://www.huawei.com/auth/drive.file
  • https://www.huawei.com/auth/drive
  • https://www.huawei.com/auth/drive.readonly
  • https://www.huawei.com/auth/drive.metadata
  • https://www.huawei.com/auth/drive.metadata.readonly
  • https://www.huawei.com/auth/drive.appdata

接口原型

路径参数

查询参数

请求参数

Request Header

请求示例

GET 
https://driveapis.cloud.huawei.com.cn/drive/v1/files/BjYqWC-dH6-gcN6p5zxhI4I7Z1wtrR-po/historyVersions?fields=* HTTP/1.1
Accept: application/json
Authorization: Bearer
CgB6e3x9Bjh6m9tm8OB0GXjeMWk0m4pVnLmwteDNWXOKPhh0/tjwtIy6Q+OscvD7zhdrElYD0Rak6xA7dI4BM3GSQTuUgFK6ZwFk7K/fjJS5vB7JFmV3
Cache-Control: no-cache

响应参数

状态码为200时:

响应示例

HTTP/1.1 200 OK 
{
   "historyVersions": [
      {
   "editedTime": "2020-05-15T06:21:11Z",
   "size": 1,
   "sha256": "4dcdc56b396adb1b68ad3257f2f9679f0b289ff003bbf3251bc7c8956c731849",
   "lastEditor": {
  "permissionId": "239606675785384320",
  "displayName": "*******3121@**3.com",
  "me": true,
  "category": "drive#user"
     },
   "id": "362821313154268928.362821313154268929",
   "mimeType": "text/plain",
   "category": "drive#historyVersion",
   "keepPermanent": false
      }
     ],
    "category": "drive#historyVersionList"
}

常见错误码

错误码后4位为业务错误码，用于区分错误场景，其他业务错误码见状态码章节。

调用示例

	public static void main(String[] args) throws IOException {
        // 设置请求地址,文件ID,权限ID和用户认证令牌
        String url = "https://driveapis.cloud.huawei.com.cn/drive/v1/files";
        String fileId = "AB0tr6O8DTQAguUs3yPFt3wQ5SDfLg04A";//Your own fileId
        String access_token = "CV5T547SEXpRlyuxqvz+PnRCtnVu784+OEIXmXAafKC+ifA3eJRnM0Ttsv20bJCkrcA+FNi4bU4nKcbERpQxlkMLQ6/Xt1iEQJYrFMyamnnI9JUV+jz4cQ==";
        // 列举文件历史信息
        JSONObject historyVersionsInfo = historyVersionsList(url, access_token, fileId);
        System.out.println(historyVersionsInfo.toJSONString());
    }

    private static JSONObject historyVersionsList(String url, String access_token, String fileId) throws IOException {
        StringBuilder stringBuilder = new StringBuilder("");
        stringBuilder.append("/").append(fileId).append("/").append("historyVersions");
        stringBuilder.append("?").append("fields=*");
        HttpGet httpGet = new HttpGet(url + stringBuilder);
        httpGet.setHeader("Authorization","Bearer " + access_token);
        CloseableHttpResponse response = HttpClientUtil.getClient().execute(httpGet);

        try {
            HttpEntity responseEntity = response.getEntity();
            String ret = responseEntity != null ? EntityUtils.toString(responseEntity) : null;
            JSONObject jsonObject = (JSONObject) JSON.parse(ret);
            EntityUtils.consume(responseEntity);
            return jsonObject;
        }finally {
            response.close();
        }
    }