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

For a list of methods for this resource, see the end of this page.

Resource representations

A comment on a file in Google Drive.

  "kind": "drive#comment",
  "selfLink": string,
  "commentId": string,
  "createdDate": datetime,
  "modifiedDate": datetime,
  "author": {
    "kind": "drive#user",
    "displayName": string,
    "picture": {
      "url": string
    "isAuthenticatedUser": boolean,
    "permissionId": string,
    "emailAddress": string
  "htmlContent": string,
  "content": string,
  "deleted": boolean,
  "status": string,
  "context": {
    "type": string,
    "value": string
  "anchor": string,
  "fileId": string,
  "fileTitle": string,
  "replies": [
    replies Resource
Property name Value Description Notes
kind string This is always drive#comment.
commentId string The ID of the comment.
createdDate datetime The date when this comment was first created.
modifiedDate datetime The date when this comment or any of its replies were last modified.
author nested object The author of the comment. The author's email address and permission ID will not be populated.
author.kind string This is always drive#user.
author.displayName string A plain text displayable name for this user.
author.picture object The user's profile picture.
author.picture.url string A URL that points to a profile picture of this user.
author.isAuthenticatedUser boolean Whether this user is the same as the authenticated user for whom the request was made.
htmlContent string HTML formatted content for this comment.
content string The plain text content used to create this comment. This is not HTML safe and should only be used as a starting point to make edits to a comment's content. writable
deleted boolean Whether this comment has been deleted. If a comment has been deleted the content will be cleared and this will only represent a comment that once existed.
status string The status of this comment. Status can be changed by posting a reply to a comment with the desired status.
  • "open" - The comment is still open.
  • "resolved" - The comment has been resolved by one of its replies.
context object The context of the file which is being commented on.
context.type string The MIME type of the context snippet. writable
context.value string Data representation of the segment of the file being commented on. In the case of a text file for example, this would be the actual text that the comment is about. writable
anchor string A region of the document represented as a JSON string. For details on defining anchor properties, refer to Add comments and replies.
fileId string The file which this comment is addressing.
fileTitle string The title of the file which this comment is addressing.
replies[] list Replies to this post.
author.permissionId string The user's ID as visible in the permissions collection.
author.emailAddress string The email address of the user.


Deletes a comment.
Gets a comment by ID.
Creates a new comment on the given file.
Lists a file's comments.
Updates an existing comment.
Updates an existing comment.