> ## Documentation Index
> Fetch the complete documentation index at: https://docs.r28.ai/charter/llms.txt
> Use this file to discover all available pages before exploring further.

# comments_list

> List a file's comments. The `fields` parameter is required — for example `comments(id,content,author,createdTime,resolved)`.

<div className="tool-route"><span className="tool-row-method" data-method="GET">GET</span><code>{"https://www.googleapis.com/drive/v3/files/{fileId}/comments"}</code></div>

```python gdrive_comments_list.py theme={null}
from charter.packs import gdrive

result = await gdrive.comments_list.ainvoke({"fileId": ..., "fields": ...})
```

<Note>
  Requires `https://www.googleapis.com/auth/drive`. Pages by cursor: `nextPageToken` is sent back as `pageToken`. Costs 1 against the provider's own quota.
</Note>

## Path parameters

<div className="reference-table">
  | Field                                                          | Type     | Description         |
  | -------------------------------------------------------------- | -------- | ------------------- |
  | `fileId` <span className="required" title="required">\*</span> | `string` | The ID of the file. |
</div>

## Query parameters

<div className="reference-table">
  | Field                                                          | Type      | Description                                                                                                                                                                                                                                                            |
  | -------------------------------------------------------------- | --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | `fields` <span className="required" title="required">\*</span> | `string`  | Required. The `fields` parameter must be set. To return the exact fields you need, see Return specific fields. Example: `comments(id,content,author,createdTime,modifiedTime,resolved,replies(id,content,author,createdTime,action))`.                                 |
  | `includeDeleted`                                               | `boolean` | Whether to include deleted comments. Deleted comments will not include their original content.                                                                                                                                                                         |
  | `pageSize`                                                     | `integer` | The maximum number of comments to return. The service may return fewer than this value. If unspecified, at most 20 comments will be returned. The maximum value is 100; values above 100 will be coerced to 100. <span className="field-constraints">≥ 1; ≤ 100</span> |
  | `pageToken`                                                    | `string`  | The token for continuing a previous list request on the next page. This should be set to the value of `nextPageToken` from the previous response.                                                                                                                      |
  | `startModifiedTime`                                            | `string`  | The minimum value of 'modifiedTime' for the result comments (RFC 3339 date-time).                                                                                                                                                                                      |
</div>