完成本頁其餘步驟,您將在大約五分鐘內取得一個簡單的 Go 指令列應用程式,向 YouTube Data API 發出要求。
本指南中使用的程式碼範例會擷取 Google 開發人員 YouTube 頻道的channel
資源,並列印該資源中的一些基本資訊。
必要條件
如要執行本快速入門導覽課程,您必須符合以下條件:
步驟 1:啟用 YouTube Data API
-
請使用這個精靈在 Google Developers Console 中建立或選取專案,並自動啟用這個 API。按一下 [繼續],然後點選 [前往憑證]。
-
在「Create credentials」(建立憑證) 頁面中,按一下 [Cancel] (取消) 按鈕。
-
選取頁面頂端的 [OAuth 同意畫面] 分頁標籤。 選取「Email address」(電子郵件地址),輸入「Product name」(產品名稱) (如果尚未設定的話),然後按一下「Save」(儲存) 按鈕。
-
選取 [憑證] 分頁標籤,按一下 [建立憑證] 按鈕並選取 [OAuth 用戶端 ID]。
-
選取「Other」(其他) 應用程式類型,輸入「YouTube Data API 快速入門」名稱,然後按一下 [Create] (建立) 按鈕。
-
按一下「OK」,關閉產生的對話方塊。
-
按一下用戶端 ID 右側的
(下載 JSON) 按鈕。 -
將下載的檔案移至工作目錄,並重新命名為
client_secret.json
。
步驟 2:準備工作區
- 將
GOPATH
環境變數設為工作目錄。 - 使用下列指令取得 YouTube Data API Go 用戶端程式庫和 OAuth2 套件:
go get -u google.golang.org/api/youtube/v3
go get -u golang.org/x/oauth2/...
步驟 3:設定範例
在工作目錄中建立名為 quickstart.go
的檔案,然後複製下列程式碼:
// Sample Go code for user authorization package main import ( "encoding/json" "fmt" "log" "io/ioutil" "net/http" "net/url" "os" "os/user" "path/filepath" "golang.org/x/net/context" "golang.org/x/oauth2" "golang.org/x/oauth2/google" "google.golang.org/api/youtube/v3" ) const missingClientSecretsMessage = ` Please configure OAuth 2.0 ` // getClient uses a Context and Config to retrieve a Token // then generate a Client. It returns the generated Client. func getClient(ctx context.Context, config *oauth2.Config) *http.Client { cacheFile, err := tokenCacheFile() if err != nil { log.Fatalf("Unable to get path to cached credential file. %v", err) } tok, err := tokenFromFile(cacheFile) if err != nil { tok = getTokenFromWeb(config) saveToken(cacheFile, tok) } return config.Client(ctx, tok) } // getTokenFromWeb uses Config to request a Token. // It 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 code string if _, err := fmt.Scan(&code); err != nil { log.Fatalf("Unable to read authorization code %v", err) } tok, err := config.Exchange(oauth2.NoContext, code) if err != nil { log.Fatalf("Unable to retrieve token from web %v", err) } return tok } // tokenCacheFile generates credential file path/filename. // It returns the generated credential path/filename. func tokenCacheFile() (string, error) { usr, err := user.Current() if err != nil { return "", err } tokenCacheDir := filepath.Join(usr.HomeDir, ".credentials") os.MkdirAll(tokenCacheDir, 0700) return filepath.Join(tokenCacheDir, url.QueryEscape("youtube-go-quickstart.json")), err } // tokenFromFile retrieves a Token from a given file path. // It returns the retrieved Token and any read error encountered. func tokenFromFile(file string) (*oauth2.Token, error) { f, err := os.Open(file) if err != nil { return nil, err } t := &oauth2.Token{} err = json.NewDecoder(f).Decode(t) defer f.Close() return t, err } // saveToken uses a file path to create a file and store the // token in it. func saveToken(file string, token *oauth2.Token) { fmt.Printf("Saving credential file to: %s\n", file) f, err := os.OpenFile(file, os.O_RDWR|os.O_CREATE|os.O_TRUNC, 0600) if err != nil { log.Fatalf("Unable to cache oauth token: %v", err) } defer f.Close() json.NewEncoder(f).Encode(token) } func handleError(err error, message string) { if message == "" { message = "Error making API call" } if err != nil { log.Fatalf(message + ": %v", err.Error()) } } func channelsListByUsername(service *youtube.Service, part string, forUsername string) { call := service.Channels.List(part) call = call.ForUsername(forUsername) response, err := call.Do() handleError(err, "") fmt.Println(fmt.Sprintf("This channel's ID is %s. Its title is '%s', " + "and it has %d views.", response.Items[0].Id, response.Items[0].Snippet.Title, response.Items[0].Statistics.ViewCount)) } func main() { ctx := context.Background() b, err := ioutil.ReadFile("client_secret.json") if err != nil { log.Fatalf("Unable to read client secret file: %v", err) } // If modifying these scopes, delete your previously saved credentials // at ~/.credentials/youtube-go-quickstart.json config, err := google.ConfigFromJSON(b, youtube.YoutubeReadonlyScope) if err != nil { log.Fatalf("Unable to parse client secret file to config: %v", err) } client := getClient(ctx, config) service, err := youtube.New(client) handleError(err, "Error creating YouTube client") channelsListByUsername(service, "snippet,contentDetails,statistics", "GoogleDevelopers") }
步驟 4:執行範例
使用工作目錄中的下列指令,建構並執行範例:
go run quickstart.go
第一次執行範例時,系統會提示您授予存取權。
透過網路瀏覽器前往您提供的網址。
如果您尚未登入 Google 帳戶,系統會提示您登入。如果您登入多個 Google 帳戶,系統會要求您選取一個授權帳戶。
- 按一下 [接受] 按鈕。
- 複製您提供的程式碼,然後貼到指令列提示中,然後按下 Enter 鍵。
Notes
- 授權資訊會儲存在檔案系統中,因此後續執行作業不會提示執行授權。
- 這個範例中的授權流程適用於指令列應用程式。如要瞭解如何在網路應用程式中執行授權,請參閱使用 OAuth 2.0 處理網路伺服器應用程式。