Go 版快速入门

完成本页其余部分中所述的步骤后，您将在大约 5 分钟内获得一个简单的 Go 命令行应用，该应用可向 YouTube Data API 发出请求。

本指南中使用的示例代码会检索 GoogleDevelopers YouTube 频道的 channel 资源，并输出该资源中的一些基本信息。

前提条件

如需运行本快速入门，您需要满足以下条件：

  • Go，建议使用最新版本。
  • Git，建议使用最新版本。
  • 可连接到互联网并使用网络浏览器。
  • Google 账号。

第 1 步：开启 YouTube Data API

  1. 使用此向导在 Google Developers 控制台中创建或选择项目，并自动开启 API。依次点击继续和前往凭据。

  2. 在创建凭据页面上，点击取消按钮。

  3. 在页面顶部，选择 OAuth 权限请求页面标签页。 选择一个电子邮件地址，输入商品名称（如果尚未设置），然后点击保存按钮。

  4. 选择凭据标签页，点击创建凭据按钮，然后选择 OAuth 客户端 ID。

  5. 选择应用类型其他，输入名称“YouTube Data API 快速入门”，然后点击创建按钮。

  6. 点击确定以关闭生成的对话框。

  7. 点击客户端 ID 右侧的 （下载 JSON）按钮。

  8. 将下载的文件移至工作目录，并将其重命名为 client_secret.json。

第 2 步：准备工作区

  1. 将 GOPATH 环境变量设置为您的工作目录。
  2. 使用以下命令获取 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")
}

quickstart.go

第 4 步：运行示例代码

使用以下命令从工作目录构建并运行示例：

go run quickstart.go

首次运行示例时，系统会提示您授权访问：

  1. 在网络浏览器中前往提供的网址。

    如果您尚未登录 Google 账号，系统会提示您登录。如果您登录了多个 Google 账号，系统会要求您选择一个账号用于授权。

  2. 点击接受按钮。
  3. 复制您获得的代码，将其粘贴到命令行提示符中，然后按 Enter 键。

备注

  • 授权信息存储在文件系统中，因此后续执行不会提示进行授权。
  • 此示例中的授权流程是为命令行应用设计的。如需了解如何在 Web 应用中执行授权，请参阅为网络服务器应用使用 OAuth 2.0。

深入阅读