Go 快速入門導覽課程

快速入門導覽課程說明如何設定及執行會呼叫 Google Workspace API

Google Workspace 快速入門導覽課程會使用 API 用戶端程式庫 驗證和授權流程的詳細資訊建議做法 您為自己的應用程式使用用戶端程式庫本快速入門導覽課程會使用 適合用於測試的簡易驗證方式 環境。在正式環境中，建議您瞭解 驗證與授權 再 選擇存取認證 挑選適合您應用程式的語言版本

建立 Go 指令列應用程式，向 Google Docs API。

目標

• 設定環境。
• 設定範例。
• 執行範例。

必要條件

• 最新版 Go。
• 最新版本的 Git。
• Google Cloud 專案。

• Google 帳戶。

設定環境

如要完成本快速入門導覽課程，請設定環境。

啟用 API

您必須先在 Google Cloud 專案中啟用這些 Google API，才能使用這些 API。 您可以在單一 Google Cloud 專案中啟用一或多個 API。

• 在 Google Cloud 控制台中，啟用 Google Docs API。

  啟用 API

設定 OAuth 同意畫面

如要使用新的 Google Cloud 專案完成本快速入門導覽課程，請設定 將自己新增為測試使用者。如果您已 為 Cloud 專案完成這個步驟，請直接跳到下一節。

1. 在 Google Cloud 控制台中，前往「選單」圖示 > API 與服務 >「OAuth 同意畫面」。

   前往 OAuth 同意畫面

2. 在「使用者類型」部分選取「內部」，然後按一下「建立」。
3. 填寫應用程式註冊表單，然後按一下「Save and Continue」。

4. 您現在可以略過新增範圍的步驟，然後按一下「儲存並繼續」。 日後您可以製作並使用應用程式 Google Workspace 機構，您必須將「使用者類型」變更為「外部」， 新增應用程式所需的授權範圍。

5. 查看應用程式註冊摘要。如要修改資訊，請按一下「編輯」。如果應用程式 註冊看起來沒有問題，請按一下 [返回資訊主頁]。

授權電腦版應用程式憑證

如要驗證使用者，並在應用程式中存取使用者資料，您需要建立一或多個 OAuth 2.0 用戶端 ID。用戶端 ID 可用來識別 單一應用程式傳送至 Google 的 OAuth 伺服器。如果您的應用程式在多個平台上運作 您都必須為每個平台分別建立用戶端 ID。

1. 在 Google Cloud 控制台中，依序點選「選單」圖示 > 「API 與」「服務」 >「憑證」。

   前往「憑證」

2. 依序點選「建立憑證」>「OAuth 用戶端 ID」。
3. 依序點選「應用程式類型」>「桌面應用程式」。
4. 在「名稱」欄位中輸入憑證的名稱。這個名稱只會顯示在 Google Cloud 控制台中。
5. 點選「建立」。系統隨即會顯示已建立 OAuth 用戶端的畫面，並顯示您的新用戶端 ID 和用戶端密鑰。
6. 按一下「OK」(確定)。新建立的憑證會顯示在「OAuth 2.0 用戶端 ID」之下。
7. 將下載的 JSON 檔案儲存為 credentials.json，然後移動 檔案複製到工作目錄

準備工作區

1. 建立工作目錄：

   mkdir quickstart
   

2. 切換至工作目錄：

   cd quickstart
   

3. 初始化新模組：

   go mod init quickstart
   

4. 取得 Google Docs API Go 用戶端程式庫和 OAuth2.0 套件：

   go get google.golang.org/api/docs/v1
   go get golang.org/x/oauth2/google
   

設定範例

1. 在工作目錄中，建立名為 quickstart.go 的檔案。

2. 在檔案中貼上下列程式碼：

   docs/quickstart/quickstart.go

   前往 GitHub 查看
   package main
   
   import (
   	"context"
   	"encoding/json"
   	"fmt"
   	"log"
   	"net/http"
   	"os"
   
   	"golang.org/x/oauth2"
   	"golang.org/x/oauth2/google"
   	"google.golang.org/api/docs/v1"
   	"google.golang.org/api/option"
   )
   
   // Retrieves a token, saves the token, then returns the generated client.
   func getClient(config *oauth2.Config) *http.Client {
   	tokFile := "token.json"
   	tok, err := tokenFromFile(tokFile)
   	if err != nil {
   		tok = getTokenFromWeb(config)
   		saveToken(tokFile, tok)
   	}
   	return config.Client(context.Background(), tok)
   }
   
   // Requests a token from the web, then returns the retrieved token.
   func getTokenFromWeb(config *oauth2.Config) *oauth2.Token {
   	authURL := config.AuthCodeURL("state-token", oauth2.AccessTypeOffline)
   	fmt.Printf("Go to the following link in your browser then type the "+
   		"authorization code: \n%v\n", authURL)
   
   	var authCode string
   	if _, err := fmt.Scan(&authCode); err != nil {
   		log.Fatalf("Unable to read authorization code: %v", err)
   	}
   
   	tok, err := config.Exchange(oauth2.NoContext, authCode)
   	if err != nil {
   		log.Fatalf("Unable to retrieve token from web: %v", err)
   	}
   	return tok
   }
   
   // Retrieves a token from a local file.
   func tokenFromFile(file string) (*oauth2.Token, error) {
   	f, err := os.Open(file)
   	defer f.Close()
   	if err != nil {
   		return nil, err
   	}
   	tok := &oauth2.Token{}
   	err = json.NewDecoder(f).Decode(tok)
   	return tok, err
   }
   
   // Saves a token to a file path.
   func saveToken(path string, token *oauth2.Token) {
   	fmt.Printf("Saving credential file to: %s\n", path)
   	f, err := os.OpenFile(path, os.O_RDWR|os.O_CREATE|os.O_TRUNC, 0600)
   	defer f.Close()
   	if err != nil {
   		log.Fatalf("Unable to cache OAuth token: %v", err)
   	}
   	json.NewEncoder(f).Encode(token)
   }
   
   func main() {
   	ctx := context.Background()
   	b, err := os.ReadFile("credentials.json")
   	if err != nil {
   		log.Fatalf("Unable to read client secret file: %v", err)
   	}
   
   	// If modifying these scopes, delete your previously saved token.json.
   	config, err := google.ConfigFromJSON(b, "https://www.googleapis.com/auth/documents.readonly")
   	if err != nil {
   		log.Fatalf("Unable to parse client secret file to config: %v", err)
   	}
   	client := getClient(config)
   
   	srv, err := docs.NewService(ctx, option.WithHTTPClient(client))
   	if err != nil {
   		log.Fatalf("Unable to retrieve Docs client: %v", err)
   	}
   
   	// Prints the title of the requested doc:
   	// https://docs.google.com/document/d/195j9eDD3ccgjQRttHhJPymLJUCOUjs-jmwTrekvdjFE/edit
   	docId := "195j9eDD3ccgjQRttHhJPymLJUCOUjs-jmwTrekvdjFE"
   	doc, err := srv.Documents.Get(docId).Do()
   	if err != nil {
   		log.Fatalf("Unable to retrieve data from document: %v", err)
   	}
   	fmt.Printf("The title of the doc is: %s\n", doc.Title)
   }

執行範例

1. 在工作目錄中建構並執行範例：

   go run quickstart.go
   

2. 第一次執行範例時，系統會提示您授予存取權：
   1. 如果尚未登入 Google 帳戶，請在系統提示時登入。如果 您已登入多個帳戶，請選取一個用於授權的帳戶。
   2. 然後點選 [Accept]。

   Go 應用程式會執行並呼叫 Google Docs API。

   授權資訊會儲存在檔案系統中，因此下次您執行範例時 這樣系統就不會提示您授權

後續步驟

• 排解驗證和授權問題
• Google 文件 API 參考說明文件
• GitHub 的「google-api-go-client」部分