Method: replies.list
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
HTTP 要求
GET https://www.googleapis.com/drive/v3/files/{fileId}/comments/{commentId}/replies
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 |
fileId |
string
檔案的 ID。
|
commentId |
string
留言的 ID。
|
查詢參數
參數 |
includeDeleted |
boolean
是否要納入已刪除的回覆。刪除的回覆不會包含原始內容。
|
pageSize |
integer
每頁要傳回的回覆數量上限。
|
pageToken |
string
這個符記可用於在下一頁接續先前的清單要求。這個值應設為先前回應中的「nextPageToken」值。
|
回應主體
檔案中留言的回覆清單。
如果成功,回應主體會含有以下結構的資料:
JSON 表示法 |
{
"replies": [
{
object (Reply )
}
],
"kind": string,
"nextPageToken": string
} |
欄位 |
replies[] |
object (Reply )
回覆清單。如果已填入 nextPageToken,則這個清單可能不完整,應擷取其他結果頁面。
|
kind |
string
表示資源的種類。值:固定字串 "drive#replyList" 。
|
nextPageToken |
string
下一頁回覆的頁面符記。如果已到達回覆清單結尾,則不會顯示這項資訊。如果系統基於任何原因拒絕符記,就應捨棄該符記,並從第一頁結果重新開始分頁。網頁權杖通常會在數小時內失效。不過,如果新增或移除項目,預期結果可能會有所不同。
|
授權範圍
需要下列其中一種 OAuth 範圍:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/drive.meet.readonly
https://www.googleapis.com/auth/drive.readonly
部分範圍受到限制,應用程式必須通過安全性評估才能使用。詳情請參閱授權指南。
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-07-25 (世界標準時間)。
[null,null,["上次更新時間:2025-07-25 (世界標準時間)。"],[],[],null,["# Method: replies.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ReplyList.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nLists a comment's replies.\n\n### HTTP request\n\n`GET https://www.googleapis.com/drive/v3/files/{fileId}/comments/{commentId}/replies`\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| `commentId` | `string` The ID of the comment. |\n\n### Query parameters\n\n| Parameters ||\n|------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `includeDeleted` | `boolean` Whether to include deleted replies. Deleted replies will not include their original content. |\n| `pageSize` | `integer` The maximum number of replies to return per page. |\n| `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. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nA list of replies to a comment on a file.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"replies\": [ { object (/workspace/drive/api/reference/rest/v3/replies#Reply) } ], \"kind\": string, \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `replies[]` | `object (`[Reply](/workspace/drive/api/reference/rest/v3/replies#Reply)`)` The list of replies. If nextPageToken is populated, then this list may be incomplete and an additional page of results should be fetched. |\n| `kind` | `string` Identifies what kind of resource this is. Value: the fixed string `\"drive#replyList\"`. |\n| `nextPageToken` | `string` The page token for the next page of replies. This will be absent if the end of the replies list has been reached. If the token is rejected for any reason, it should be discarded, and pagination should be restarted from the first page of results. The page token is typically valid for several hours. However, if new items are added or removed, your expected results might differ. |\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- `\n https://www.googleapis.com/auth/drive.meet.readonly`\n- `\n https://www.googleapis.com/auth/drive.readonly`\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)."]]