MCP Tools Reference: drivemcp.googleapis.com

工具：list_recent_files

呼叫這項工具，即可找出特定使用者的近期檔案，並指定排序順序。預設排序順序為 recency。

支援的排序順序如下：

  • recency：檔案日期時間欄位的最新時間戳記。
  • lastModified：上次任何人修改檔案的時間。
  • lastModifiedByMe：使用者上次修改檔案的時間。

預設頁面大小為 10。使用 next_page_token 分頁瀏覽結果。

以下範例示範如何使用 curl 叫用 list_recent_files MCP 工具。

Curl 要求 
curl --location 'https://drivemcp.googleapis.com/mcp/v1' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "list_recent_files",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

輸入內容的結構定義

要求列出檔案。

ListFilesRequest

JSON 表示法 
{

  "orderBy": string

  "pageToken": string

  "pageSize": integer

  "excludeContentSnippets": boolean
}
欄位

聯集欄位 _order_by。

_order_by 只能是下列其中一項：
orderBy

string

檔案的排序順序。

聯集欄位 _page_token。

_page_token 只能是下列其中一項：
pageToken

string

用於分頁的頁面符記。

聯集欄位 _page_size。

_page_size 只能是下列其中一項：
pageSize

integer

要傳回的檔案數量上限。

聯集欄位 _exclude_content_snippets。

_exclude_content_snippets 只能是下列其中一項：
excludeContentSnippets

boolean

如果為 true，回應中就不會包含內容摘要。

輸出內容的結構定義

列出檔案的回應。

ListFilesResponse

JSON 表示法 
{
  "files": [
    {
      object (File)
    }
  ],

  "nextPageToken": string
}
欄位
files[]

object (File)

檔案清單。

聯集欄位 _next_page_token。

_next_page_token 只能是下列其中一項：
nextPageToken

string

下一頁符記。

檔案

JSON 表示法 
{
  "id": string,
  "title": string,
  "parentId": string,

  "mimeType": string

  "fileSize": string

  "description": string

  "fileExtension": string

  "contentSnippet": string

  "viewUrl": string

  "sharedWithMeTime": string

  "createdTime": string

  "modifiedTime": string

  "viewedByMeTime": string

  "owner": string

  "canAddChildren": boolean
}
欄位
id

string

擷取檔案的 ID。
title

string

檔案標題。
parentId

string

檔案父項的 ID (選用)。

聯集欄位 _mime_type。

_mime_type 只能是下列其中一項：
mimeType

string

檔案的 MIME 類型。

聯集欄位 _file_size。

_file_size 只能是下列其中一項：
fileSize

string (int64 format)

檔案大小 (以位元組為單位)。

聯集欄位 _description。

_description 只能是下列其中一項：
description

string

檔案說明。

聯集欄位 _file_extension。

_file_extension 只能是下列其中一項：
fileExtension

string

檔案的原始副檔名，只有儲存在雲端硬碟中的檔案才會填入這項資訊。

聯集欄位 _content_snippet。

_content_snippet 只能是下列其中一項：
contentSnippet

string

系統根據檔案內容生成的摘要。

聯集欄位 _view_url。

_view_url 只能是下列其中一項：
viewUrl

string

查看檔案的網址。

聯集欄位 _shared_with_me_time。

_shared_with_me_time 只能是下列其中一項：
sharedWithMeTime

string (Timestamp format)

檔案與要求者共用的時間。

使用 RFC 3339，產生的輸出內容一律會經過 Z 正規化，並使用 0、3、6 或 9 個小數位數，也接受「Z」以外的偏移量。範例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。

聯集欄位 _created_time。

_created_time 只能是下列其中一項：
createdTime

string (Timestamp format)

檔案建立時間。

使用 RFC 3339，產生的輸出內容一律會經過 Z 正規化，並使用 0、3、6 或 9 個小數位數，也接受「Z」以外的偏移量。範例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。

聯集欄位 _modified_time。

_modified_time 只能是下列其中一項：
modifiedTime

string (Timestamp format)

檔案最近一次修改的時間。

使用 RFC 3339，產生的輸出內容一律會經過 Z 正規化，並使用 0、3、6 或 9 個小數位數，也接受「Z」以外的偏移量。範例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。

聯集欄位 _viewed_by_me_time。

_viewed_by_me_time 只能是下列其中一項：
viewedByMeTime

string (Timestamp format)

要求者最近一次查看檔案的時間。

使用 RFC 3339，產生的輸出內容一律會經過 Z 正規化，並使用 0、3、6 或 9 個小數位數，也接受「Z」以外的偏移量。範例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。

聯集欄位 _owner。

_owner 只能是下列其中一項：
owner

string

檔案擁有者的電子郵件地址。

聯集欄位 _can_add_children。

_can_add_children 只能是下列其中一項：
canAddChildren

boolean

要求者是否能將孩子新增至這個資料夾。如果不是資料夾類型，這個值一律為 false。

時間戳記

JSON 表示法 
{
  "seconds": string,
  "nanos": integer
}
欄位
seconds

string (int64 format)

代表自 Unix 紀元 1970-01-01T00:00:00Z 起算的世界標準時間秒數。必須介於 -62135596800 和 253402300799 之間 (含)，對應至 0001-01-01T00:00:00Z 至 9999-12-31T23:59:59Z。
nanos

integer

以奈秒為單位的非負秒數小數。這個欄位是時間長度的奈秒部分，並非秒數的替代值。如果秒數值為負數，且包含小數，奈秒值仍須為非負數，且會向前計時。必須介於 0 至 999,999,999 之間 (含)。

工具註解

破壞性提示：❌ | 等冪提示：✅ | 唯讀提示：✅ | 開放世界提示：❌