Google Drive

Google Drive 是一個連接器：它把 MeDo 應用程式連接到一個 Google 帳戶，讓應用程式可以搜尋該雲端硬碟、開啟檔案詳情、建立資料夾與文字檔、從公開 URL 上傳、下載、移動或複製、覆蓋檔案，並在確認後將項目移入回收站。不包含分享與權限變更。

#可以建立什麼

• 私人檔案瀏覽器。 列出指定資料夾、開啟檔案詳情，並按需重新整理。
• 報告備份頁。 把文字備註或公開 URL 存進指定資料夾，再確認已落地。
• 共用資料夾工作區。 把專案檔案放在同一個資料夾，在擁有者指定目標後複製或移動，並顯示更新後的結構。
• 清理看板。 找出資料夾中的檔案，且只在逐項確認後才移入回收站。

當應用程式需要使用擁有者已存放在 Drive 的真實檔案——瀏覽、備份、資料夾工作區——Google Drive 就很合適。它不是分享管理工具，也不能清空回收站，詳見限制。

#建立範例

把以下其中一段複製到提示框中。第一段是最小可用的起點。

Use @Google Drive to build a private file browser that lists a chosen folder and opens file details.

Use @Google Drive to build a report backup page that saves a text note or a public URL into a named folder and confirms it landed.

Use @Google Drive to build a shared-folder workspace that copies or moves a file after I name the target folder.

Use @Google Drive to build a cleanup board that finds files in a folder and trash them only after I confirm each item.

用詞很重要：說明應用程式應使用哪個資料夾。「給團隊報告資料夾用的私人瀏覽器」會做出與「列出檔案的頁面」不同的應用程式。

#準備與連接

你需要一個已經能開啟應用程式所需 Drive 檔案的 Google 帳戶。不必準備 API 金鑰、Google Cloud 專案或額外帳單設定。

1. 在側欄開啟 Skills & Connectors，搜尋 Google Drive。
2. 打開 Google Drive 卡片，點擊 Connect。
3. 登入 Google 帳戶，並核准 MeDo 要求的存取權。
4. 按鈕會變成 Connected。這就是成功狀態；不必再把任何內容複製回應用程式。

若你在連接之前就開始建立，MeDo 會注意到，並在回覆下方顯示 Google Drive 連接按鈕。你也可以在那裡連接。若沒有按鈕，請改用上面的連接器卡片。

#在應用程式中使用

• 應用程式使用擁有者已連接的 Drive，而不是每位訪客自己的 Google 帳戶。 能進入檔案畫面的人都會看到同一個雲端硬碟。請把檔案瀏覽、上傳與回收站放在應用程式自己的登入之後，並限制給應該擁有該權限的人。標題寫「private」本身不是存取控制。
• 在提示中指明資料夾。 盡量貼上資料夾連結或 ID；名稱可能重複。應用程式應顯示它實際開啟的資料夾名稱。
• 讀取需手動重新整理。 與 Drive 沒有即時同步。請提供重新整理控制項，而不是期待新檔案自動出現。
• 移入回收站前會先確認。 MeDo 會在把項目移入回收站前要求確認。永久刪除與清空回收站不可用。
• 應用程式自有資料留在應用程式。 標籤、審核狀態與備註若不是 Drive 欄位，應放在應用程式自己的資料表，並以真實檔案 ID 關聯。

#限制與疑難排解

應用程式顯示「Connection required」。 請應用程式擁有者打開連接器卡片並點擊 Connect，然後重新載入。

搜尋開到錯誤的資料夾。 資料夾名稱可能重複。請使用先前搜尋結果中的資料夾 ID，或貼上資料夾連結，再重新整理。

移入回收站被拒絕。 必須先在應用程式中明確確認。確認步驟完成前請不要重試。

下載連結失效。 下載 URL 有效期很短。請重新索取下載，不要沿用舊連結。

訪客看到不該看到的檔案。 連接是共用的。請為應用程式加上登入與伺服器端限制，見管理存取權與角色。

#相關內容

• 連接器目錄 — 其他連接器及其用途。
• 技能與連接器 — 技能如何被調用、計費與限制。
• 管理存取權與角色 — 限制誰可以讀取與變更已連接的資料。