C# 學習筆記(一): Google Drive API 串接(GCP 專案申請篇)

Tom
appxtech
5 min readApr 9, 2024

--

嗨嗨,最近工作上接觸了 Google Drive 和 OneDrive 的 API 串接,所以打算把過程記錄下來分享給大家順便幫自己留個筆記。

Google Drive 的串接預計會分成三篇,分別是這一篇的專案申請、第二篇的 OAuth 流程串接與第三篇的雲端常用 API 串接。

Google Cloud Platform 專案建立 — GCP 連結

首先照著以下的步驟建立 GCP 專案。

新增專案

  1. 首先登入 Google Cloud Console 畫面。
  2. 登入成功後選擇新增專案、填寫專案名稱並按下建立。
(圖左) 選擇新增專案,(圖右)填寫專案名稱

啟用 Google Drive API

專案新增成功後,開啟左方選單 -> 其他產品 -> API 和服務選擇 -> 程式庫中 選擇 “Google Drive API” 並啟用。

(圖左) 進入程式庫選單,(圖右)進入啟用 Google Drive API

設定 OAuth 同意畫面

  1. 設定基本資料
    首先將 User Type 設為 “外部”,這樣任何帳號皆可使用此 API,接著將”應用程式資訊”頁面中的必填欄位填入即可。
    *註 : 應用程式名稱的顯示規則請看 -> 連結
(圖左) OAuth User Type 選擇”外部”,(圖右) 填寫基本應用程式資訊

2. 選擇 API 範圍

「API 範圍是用於表示您要求使用者為應用程式授予的權限,並可讓您的專案存取使用者 Google 帳戶中特定類型的私人使用者資料」 — Google

我們這邊就簡單的選幾個會用到的 Google Drive API 範圍。

(圖左)新增範圍按鈕,(圖右) 過濾 Google Drive API 範圍並選取必要值。

3. 添加測試人員
因為此 Project 尚未通過驗證,所以要使用此 Project 的功能需要將使用者的 emial 添加到測試使用者中才能正常存取功能,這邊就加上要使用的 email 帳號吧。

啟用 OAuth 用戶端憑證

OAuth 同意畫面設定完成後,需要建立 OAuth Client 憑證,提供一個端口讓使用者可以將授權過的 Token 交給我們使用,以下是設定流程。

  1. 在憑證頁面選擇建立 “OAuth 用戶端 ID” (憑證的類型說明請看這裡)
    - 使用 OAuth 用戶端的憑證,可直接操作個別使用者的帳號。

2. 應用程式類型選擇 “網頁應用程式”並填入名稱 。

3. Redirect URI 填入接收 OAuth 回傳的 API 路徑,可以使用 ngrok 的代理網址,或直接使用 localhost 的端口,擇一即可。

3. 建立成功後會彈出此視窗,其中分別是 ClientId 與 ClientSecret,這兩個值非常重要,請注意保存的方法( Google 的 secret 不會消失,隨時點進憑證頁面都可以取得。

到這一步,GCP Project 的建立就完成了,下一篇會進行 Google OAuth 流程的串接。

--

--

Tom
appxtech
Writer for

Major in Computer Science, Web Backend Engineer