完成本页面其余部分介绍的步骤,大约 5 分钟后,您会获得一个简单的 Go 命令行应用,该应用会向 YouTube Data API 发出请求。
本指南中使用的示例代码会检索 Google Developers 的 YouTube 频道channel
资源,并输出该资源的一些基本信息。
前提条件
如需运行本快速入门,您需要:
第 1 步:启用 YouTube Data API
-
您可以使用此向导在 Google Developers Console 中创建或选择项目,并自动启用 API。点击继续,然后点击转到凭据。
-
在创建凭据页面上,点击取消按钮。
-
在页面顶部,选择 OAuth 同意屏幕标签页。选择一个 Email address(电子邮件地址),输入产品名称(如果尚未设置),然后点击 Save(保存)按钮。
-
选择凭据标签页,点击创建凭据按钮,然后选择 OAuth 客户端 ID。
-
选择其他应用类型,输入名称“YouTube Data API 快速入门”,然后点击创建按钮。
-
点击 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 键。
备注
- 授权信息存储在文件系统中,因此后续执行将不会提示用户授权。
- 此示例中的授权流程专为命令行应用而设计。如需了解如何在 Web 应用中执行授权,请参阅为 Web 服务器应用使用 OAuth 2.0。