Comments: create

Stay organized with collections Save and categorize content based on your preferences.

Creates a comment on a file. Try it now.

Request

HTTP request

POST https://www.googleapis.com/drive/v3/files/fileId/comments

Parameters

Parameter name Value Description
Path parameters
fileId string The ID of the file.
Required query parameters
fields string The paths of the fields you want included in the response. For development you can use the special value * to return all fields, but you'll achieve greater performance by only selecting the fields you need. For more information, see Return specific fields for a file.

Authorization

This request allows authorization with at least one of the following scopes:

Scope
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file

Some scopes are restricted and require a security assessment for your app to use them. For more information, see the authentication and authorization page.

Request body

In the request body, supply a Comments resource with the following properties:

Property name Value Description Notes
Required Properties
content string The plain text content of the comment. This field is used for setting the content, while htmlContent should be displayed. writable
Optional Properties
anchor string A region of the document represented as a JSON string. For details on defining anchor properties, refer to Add comments and replies. writable
quotedFileContent.value string The quoted content itself. This is interpreted as plain text if set through the API. writable

Response

If successful, this method returns a Comments resource in the response body.

Try it!

Use the APIs Explorer below to call this method on live data and see the response.