Files:update.patchmultipart

功能介绍

修改并上传文件（multipart方式）。

场景描述

Files.update.multipart接口实现更新文件元数据（元数据全量更新）、缩略图、文件内容的功能，用户可以通过fileId指定要更新的文件。

使用约束

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

• mimeType采用通用格式规范。
• 0bit文件（空文件），不允许带缩略图上传。
• fields填*时，drive#file 结构中sharer、sharedWithMeTime、hasShared、capabilities、permissions、permissionIds不返回。

接口原型

路径参数

查询参数

请求参数

Request Header

Request Body

加文件实体

请求示例

PATCH https://driveapis.cloud.huawei.com.cn/upload/drive/v1/files/AB9FPewYCuoCKgA0li1P43gSADKWIArsA?uploadType=multipart&fields=* HTTP/1.1 
Content-Type: multipart/related;boundary=OP8XTaXZ0UZs-Sjlefcj2OWskqXWwVQO
Authorization: Bearer CV3PnPLZXyr9K2GV7RYZkF962JZvoEkMQhTho3QHQAPQUyma/lEyZskP/IMWrc7FvaeHivO7y0lyibI/fQvulBnTgtXArSVPsjaLKvYNkDsJSaIR2/sx+K40bYDWWpKFvJNKg2U47jRwz2mfiF3ortNk 
Cache-Control: no-cache
--OP8XTaXZ0UZs-Sjlefcj2OWskqXWwVQO
Content-Type: application/json
// 换行必填
{
    "fileName":"zztest0014",
    "contentExtras": {
        "thumbnail":{
            "content":"dGVzdDAwMw==",
            "mimeType":"image/jpeg"
        }
    },
    "parentFolder":["applicationData"]
}
--OP8XTaXZ0UZs-Sjlefcj2OWskqXWwVQO
Content-Type: application/octet-stream
//换行必填
[imageData]
--OP8XTaXZ0UZs-Sjlefcj2OWskqXWwVQO--

响应参数

状态码为200时:

响应示例

{
    "fileName":"hwe003",
    "sha256":"59f29d7b3a84482f3ae641d1d490210c589440c6e5104e9ab9574c4aeb40550e",
    "owners":[
        {
            "permissionId":"239046878371512704",
            "displayName":"*******3121@**3.com",
            "me":true,
            "category":"drive#user"
        }
    ],
    "hasShared":false,
    "mimeType":"application/octet-stream",
    "permissionIds":[
        "239046878371512704"
    ],
    "lastHistoryVersionId":"ABgL5WYKCuoCLU7sHD9P43gVTuocMgrsA",
    "parentFolder":[
        "AgFovWXIAIYANC20H_1Fj3oMLbIf8ACAA"
    ],
    "recycled":false,
    "directlyRecycled":false,
    "permissions":[
        {
            "role":"owner",
            "deleted":false,
            "displayName":"*******3121@**3.com",
            "id":"239046878371512704",
            "category":"drive#permission",
            "type":"user",
            "allowFileDiscovery":true
        }
    ],
    "occupiedSpace":11198,
    "createdTime":"2020-06-13T06:52:19.000Z",
    "id":"ABgL5WYKCuoCLU7sHD9P43gVTuocMgrsA",
    "contentDownloadLink":"https://driveapis.cloud.huawei.com.cn/drive/v1/files/ABgL5WYKCuoCLU7sHD9P43gVTuocMgrsA?form=content",
    "capabilities":{
        "downloadPermission":true,
        "renameFilePermission":true,
        "commentPermission":true,
        "deletePermission":true,
        "readHistoryVersionPermission":true,
        "recyclePermission":true,
        "addChildNodePermission":false,
        "unrecyclePermission":true,
        "writerHasChangeCopyPermission":false,
        "copyPermission":true,
        "editContentPermission":true,
        "removeChildNodePermission":false,
        "editPermission":true,
        "listChildNodePermission":false,
        "shareFilePermission":true
    },
    "ownedByMe":true,
    "version":1592031003000,
    "writersHasSharePermission":true,
    "iconDownloadLink":"https://event-dre.dbankcdn.com/filemanagerpic/201911140913476Sc7.png",
    "editedTime":"2020-06-13T06:52:19.000Z",
    "size":11198,
    "thumbnailVersion":0,
    "lastEditor":{
        "permissionId":"239046878371512704",
        "displayName":"*******3121@**3.com",
        "me":true,
        "category":"drive#user"
    },
    "existThumbnail":true,
    "containers":[
        "drive"
    ],
    "category":"drive#file",
    "contentVersion":"4ed95d13-d9e4-334f-aab7-ef49c21d78b6"
}

常见错误码

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

调用示例

public static void main(String[] args) throws Exception {
        // 设置请求地址和用户认证令牌
        String url = "https://driveapis.cloud.huawei.com.cn/upload/drive/v1/files";
        String fileId = "Bkw3QjQolVUoYQdEk13lFX5BekY2GJVTK";
        String access_token = "DAEAANApuUTBWbVKLu7HkNytlhHg+naBsKszPZ6V/uY7wIaHReDtI3sgUNmcJ1D/wcgkW6yGl5ht6fxcW3+olmgMgkS/ypJxkw89icLwzxXBbX2h3ochRK8=";
             // 修改并上传文件（multipart方式）
        JSONObject fileInfo = filesUpdatePatchMultipart(url, access_token, fileId);
        System.out.println(fileInfo.toJSONString());
    }

    private static JSONObject filesUpdatePatchMultipart(String url, String access_token, String fileId)
        throws Exception {
        StringBuilder stringBuilder = new StringBuilder("");
        stringBuilder.append("/").append(fileId);
        stringBuilder.append("?").append("fields=*").append("&").append("uploadType=multipart");
        HttpPatch httpPatch = new HttpPatch(url + stringBuilder);
        httpPatch.setHeader("Authorization", "Bearer " + access_token);
        httpPatch.setHeader("Content-Type", "multipart/related;boundary=OP8XTaXZ0UZs-Sjlefcj2OWskqXWwVQO");
        httpPatch.setHeader("Accept", "application/json");

        FileInputStream fis = new FileInputStream("D:\\5555555.PNG");// The path of your local file
        ByteArrayOutputStream fos = new ByteArrayOutputStream();
        byte[] tempData = new byte[1024];
        int count = 0;

        // 第一部分 元数据
        byte[] multipartContentPart1 = ("--OP8XTaXZ0UZs-Sjlefcj2OWskqXWwVQO" + System.lineSeparator()
            + "Content-Type: application/json" + System.lineSeparator() + System.lineSeparator() + "{"
            + System.lineSeparator() + "\"fileName\":\"hw001.jpg\"," + System.lineSeparator() + "\"contentExtras\": {"
            + System.lineSeparator() + "\"thumbnail\":{\"content\":\"dGVzdDAwMw==\",\"mimeType\":\"image/png\"}},"
            + System.lineSeparator() + "\"parents\":[\"applicationData\"]" + System.lineSeparator() + "}"
            + System.lineSeparator() + "--OP8XTaXZ0UZs-Sjlefcj2OWskqXWwVQO" + System.lineSeparator()
            + "Content-Type: application/octet-stream" + System.lineSeparator() + System.lineSeparator()).getBytes();
        fos.write(multipartContentPart1);

        // 第二部分文件内容
        while ((count = fis.read(tempData)) != -1) {
            fos.write(tempData, 0, count);
        }

        // 第三部分文件尾分隔符
        byte[] multipartContentPart3 = (System.lineSeparator() + "--OP8XTaXZ0UZs-Sjlefcj2OWskqXWwVQO--").getBytes();
        fos.write(multipartContentPart3);

        ByteArrayEntity entity = new ByteArrayEntity(fos.toByteArray());
        entity.setContentType("multipart/related;boundary=OP8XTaXZ0UZs-Sjlefcj2OWskqXWwVQO");
        httpPatch.setEntity(entity);
        CloseableHttpClient client = HttpClients.createDefault();
        CloseableHttpResponse response = client.execute(httpPatch);
        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();
        }
    }