Comments:create

Function

Creates a comment.

Scenario

By calling the Comments.create API, your app can create file comments.

Restrictions

• Only the writer, commenter, or owner role can create file comments.
• If fields is set to *, replies in drive#comments is not returned.
• The value of scope must be one of the following:
  • https://www.huawei.com/auth/drive.file
  • https://www.huawei.com/auth/drive

Prototype

Path Parameters

Query Parameters

Request Parameters

Request Header

Request Body

Request Example

POST https://driveapis.cloud.huawei.com.cn/drive/v1/files/AADUyBNACuoBSKfx8gh50-ASp_fyGgrsA/comments?fields=*? HTTP/1.1 
Accept: application/json 
Cache-Control: no-cache 
Authorization: Bearer CF3NTYZSs7MRmxWyj8ssonQQxDgSPAjnDvrf+91NrpN22LdUrMA30A5Kzz0mf55sWao7e7VeLrmjQ0z2OmwPWlt3S00/L1BJppbTFhIgWb74ZBK8CFImUA==

Response Parameters

When the status code is 200:

Response Example

{
      "category": "drive#comment",
      "id": "string",
      "createdTime": "2020-02-19T14:44:40.660Z",
      "editedTime": "2020-02-19T14:44:40.661Z",
      "creator": {
        "category": "drive#user",
        "displayName": "string",
        "profilePhotoLink": "string",
        "me": true,
        "permissionId": "string",
        "userAccount": "string"
      },
      "description": "string",
      "htmlDescription": "string",
      "deleted": true,
      "resolved": true,
      "quotedContent": {
        "mimeType": "string",
        "content": "string"
      },
      "position": "string",
      "replies": [
      {
        "category": "drive#reply",
        "id": "string",
        "createdTime": "2020-02-19T14:44:40.661Z",
        "editedTime": "2020-02-19T14:44:40.661Z",
        "creator": {
          "category": "drive#user",
          "displayName": "string",
          "profilePhotoLink": "string",
          "me": true,
          "permissionId": "string",
          "userAccount": "string"
        },
        "htmlDescription": "string",
        "description": "string",
        "deleted": true,
        "operate": "string"
      }
      ]
}

Result Code

For details about other result codes, please refer to Status Codes.

Call Example

    public static void main(String[] args) throws IOException {
        // Set the request URL, file ID, and access token.
        String url = "https://driveapis.cloud.huawei.com.cn/drive/v1/files/";
        String fileId = "AB0tr6O8DTQAguUs3yPFt3wQ5SDfLg04A";
        String access_token = "CV5T547SEXpRlyuxqvz+PnRCtnVu784+OEIXmXAafKC+ifA3eJRnM0Ttsv20bJCkrcA+FNi4bU4nKcbERpQxlkMLQ6/Xt1iEQJYrFMyamnnI9JUV+jz4cQ==";
        // Create a file comment.
        JSONObject commentInfo = commentCreateContent(url, access_token, fileId);
        System.out.println(commentInfo.toJSONString());
    }

    private static JSONObject commentCreateContent(String url, String access_token, String fileId) throws IOException {
        StringBuilder stringBuilder = new StringBuilder("");
        stringBuilder.append(fileId).append("/").append("comments");
        stringBuilder.append("?").append("fields=*");
        HttpPost httpPost = new HttpPost(url + stringBuilder);
        httpPost.setHeader("Authorization", "Bearer " + access_token);
        httpPost.setHeader("Content-Type", "application/x-www-form-urlencoded");
        httpPost.setHeader("Accept", "application/json");

        JSONObject jsonParam = new JSONObject();
        jsonParam.put("description", "2020/02/23 11:20");
        JSONObject jsonObject = new JSONObject();
        jsonObject.put("mimeType", "text/html");
        jsonObject.put("content", "2222");
        jsonParam.put("quotedContent", jsonObject);

        StringEntity entity = new StringEntity(jsonParam.toString());
        httpPost.setEntity(entity);

        CloseableHttpResponse response = HttpClientUtil.getClient().execute(httpPost);

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