[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-04-18 UTC."],[],[],null,["# Method: comments.create\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nCreates a comment on a file. For more information, see [Manage comments and replies](https://developers.google.com/workspace/drive/api/guides/manage-comments).\n\nRequired: The `fields` parameter must be set. To return the exact fields you need, see [Return specific fields](https://developers.google.com/workspace/drive/api/guides/fields-parameter).\n\n### HTTP request\n\n`POST https://www.googleapis.com/drive/v3/files/{fileId}/comments`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|------------------------------|\n| `fileId` | `string` The ID of the file. |\n\n### Request body\n\nThe request body contains an instance of [Comment](/workspace/drive/api/reference/rest/v3/comments#Comment).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Comment](/workspace/drive/api/reference/rest/v3/comments#Comment).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/drive`\n- `\n https://www.googleapis.com/auth/drive.file`\n\nSome scopes are restricted and require a security assessment for your app to use them. For more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
Creates a comment on a file. For more information, see Manage comments and replies .
Required: The
fieldsparameter must be set. To return the exact fields you need, see Return specific fields .HTTP request
POST https://www.googleapis.com/drive/v3/files/{fileId}/commentsThe URL uses gRPC Transcoding syntax.
Path parameters
fileIdstringThe ID of the file.
Request body
The request body contains an instance of
Comment.Response body
If successful, the response body contains a newly created instance of
Comment.Authorization scopes
Requires one of the following OAuth scopes:
https://www.googleapis.com/auth/drivehttps://www.googleapis.com/auth/drive.fileSome scopes are restricted and require a security assessment for your app to use them. For more information, see the Authorization guide .