このページの残りの部分で説明する手順を完了すると、約 5 分で YouTube Data API にリクエストを送信する簡単な Go コマンドライン アプリケーションが作成されます。
このガイドで使用するサンプルコードでは、GoogleDevelopers の YouTube チャンネルのchannel
リソースを取得し、そのリソースから基本情報を出力します。
Prerequisites
このクイックスタートを実行するには、以下が必要です。
ステップ 1: YouTube Data API を有効にする
-
このウィザードを使用して、Google Developers Console でプロジェクトを作成または選択すると、API が自動的に有効になります。[続行]、[認証情報に移動] の順にクリックします。
-
[認証情報を作成] ページで、[キャンセル] ボタンをクリックします。
-
ページ上部の [OAuth 同意画面] タブを選択します。[メールアドレス] を選択し、まだ設定していない場合はプロダクト名を入力して、[保存] ボタンをクリックします。
-
[認証情報] タブを選択し、[認証情報を作成] ボタンをクリックして、[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
サンプルを初めて実行すると、アクセスを承認するように求められます。
指定された URL をウェブブラウザで表示します。
まだ Google アカウントにログインしていない場合は、ログインするように求められます。複数の Google アカウントにログインしている場合は、承認に使用するアカウントを 1 つ選択するよう求められます。
- [同意する] ボタンをクリックします。
- 指定されたコードをコピーして、コマンドライン プロンプトに貼り付け、Enter キーを押します。
備考
- 認可情報はファイル システムに保存されるため、後続の実行で承認を求められません。
- この例の承認フローは、コマンドライン アプリケーション向けに設計されています。ウェブ アプリケーションで認可を行う方法については、ウェブサーバー アプリケーションに OAuth 2.0 を使用するをご覧ください。