快速入門說明如何設定及執行呼叫 Google Workspace API 的應用程式。
Google Workspace 快速入門會使用 API 用戶端程式庫處理驗證和授權流程的部分細節。建議您為自家應用程式使用用戶端程式庫。本快速入門導覽課程會使用簡化的驗證方法,適合測試環境使用。如要使用正式環境,建議您先瞭解驗證和授權,再選擇適合應用程式的存取憑證。
建立 Java 指令列應用程式,向 Google Drive Activity API 提出要求。
目標
- 設定環境。
- 設定範例。
- 執行範例。
必要條件
- Java 1.8 以上版本。
- Gradle 7.0 以上版本。
- Google Cloud 專案。
- Google 帳戶。
設定環境
如要完成本快速入門課程,請設定環境。
啟用 API
使用 Google API 前,您必須先在 Google Cloud 專案中啟用這些 API。您可以在單一 Google Cloud 專案中啟用一或多個 API。在 Google Cloud 控制台中啟用 Google Drive Activity API。
設定 OAuth 同意畫面
如果您使用新的 Google Cloud 專案完成本快速入門課程,請設定 OAuth 同意畫面,並將自己新增為測試使用者。如果您已為 Cloud 專案完成這個步驟,請跳至下一節。
- 在 Google Cloud 控制台中,依序前往「選單」>「API 和服務」 >「OAuth 同意畫面」。
- 在「使用者類型」部分,選取「內部」,然後按一下「建立」。
- 填寫應用程式註冊表單,然後按一下「儲存並繼續」。
目前您可以略過新增範圍,直接按一下「儲存並繼續」。日後,如果您建立的應用程式是用於 Google Workspace 機構以外的環境,就必須將使用者類型變更為外部,然後新增應用程式所需的授權範圍。
- 查看應用程式註冊摘要。如要修改資訊,請按一下「編輯」。如果應用程式註冊看起來沒問題,請按一下「返回資訊主頁」。
授權電腦版應用程式的憑證
如要驗證使用者,並在應用程式中存取使用者資料,您需要建立一或多個 OAuth 2.0 用戶端 ID。用戶端 ID 可讓 Google 的 OAuth 伺服器識別單一應用程式。如果您的應用程式在多個平台上執行,則必須為每個平台建立專屬的用戶端 ID。- 在 Google Cloud 控制台中,依序前往「Menu」>「APIs & Services」>「Credentials」。
- 依序按一下「建立憑證」>「OAuth 用戶端 ID」。
- 依序點選「應用程式類型」>「桌面應用程式」。
- 在「Name」欄位中輸入憑證名稱。這個名稱只會顯示在 Google Cloud 控制台中。
- 按一下「建立」,系統會顯示「OAuth client created」(已建立 OAuth 用戶端) 畫面,其中顯示新的用戶端 ID 和用戶端密碼。
- 按一下「確定」。新建立的憑證會顯示在「OAuth 2.0 Client IDs」下方。
- 將下載的 JSON 檔案儲存為
credentials.json
,然後將檔案移至工作目錄。
準備工作區
在工作目錄中建立新的專案結構:
gradle init --type basic mkdir -p src/main/java src/main/resources
在
src/main/resources/
目錄中,複製先前下載的credentials.json
檔案。開啟預設的
build.gradle
檔案,然後將內容替換為下列程式碼:
設定範例
在
src/main/java/
目錄中,建立新的 Java 檔案,檔案名稱必須與build.gradle
檔案中的mainClassName
值相符。在新 Java 檔案中加入下列程式碼:
執行範例
執行範例:
gradle run
-
第一次執行範例時,系統會提示您授權存取權:
- 如果尚未登入 Google 帳戶,請在系統提示時登入。如果您登入了多個帳戶,請選取要用於授權的帳戶。
- 然後點選 [Accept]。
Java 應用程式會執行並呼叫 Google Drive Activity API。
授權資訊會儲存在檔案系統中,因此下次執行範例程式碼時,系統不會提示您授權。
後續步驟
- 排解驗證和授權問題
- Drive Activity API 參考文件
- Java 適用的 Google API 用戶端程式庫說明文件
- Google Drive Activity API Javadoc 說明文件