البدء السريع

أكمل الخطوات الموضحة في باقي هذه الصفحة، وفي غضون خمس دقائق تقريبًا سيكون لديك تطبيق سطر أوامر Go بسيط يقدم طلبات إلى YouTube Data API.

يعمل نموذج الرمز المستخدَم في هذا الدليل على استرداد المورد channel لقناة YouTubeDevelopers على YouTube وطباعة بعض المعلومات الأساسية من هذا المورد.

المتطلبات الأساسية

لتنفيذ هذا التشغيل السريع، ستحتاج إلى:

  • انتقال، يوصى باستخدام أحدث إصدار.
  • Git، أحدث إصدار موصى به.
  • الدخول إلى الإنترنت ومتصفح الويب.
  • حساب Google.

الخطوة 1: تفعيل YouTube Data API

  1. يمكنك استخدام هذا المعالج لإنشاء مشروع أو اختياره في Google Developers Console وتفعيل واجهة برمجة التطبيقات تلقائيًا. انقر على متابعة، ثم الانتقال إلى بيانات الاعتماد.

  2. في الصفحة إنشاء بيانات اعتماد، انقر على الزر إلغاء.

  3. في أعلى الصفحة، اختَر علامة التبويب شاشة موافقة OAuth. اختَر عنوان بريد إلكتروني، وأدخِل اسم المنتج إذا لم يسبق لك إعداده، ثم انقر على الزر حفظ.

  4. حدد علامة التبويب بيانات الاعتماد، وانقر على الزر إنشاء بيانات اعتماد، ثم حدد رقم تعريف عميل OAuth.

  5. اختَر نوع التطبيق غير ذلك، وأدخِل الاسم "البدء السريع لواجهة برمجة التطبيقات لبيانات YouTube"، ثم انقر على الزر إنشاء.

  6. انقر على موافق لتجاهل مربع الحوار الناتج.

  7. انقر على الزر (تنزيل 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

الخطوة الرابعة: تنفيذ النموذج

أنشئ النموذج وشغّله باستخدام الأمر التالي من دليل العمل:

go run quickstart.go

عند تشغيل النموذج لأول مرة، سيطلب منك تفويض الوصول:

  1. تصفّح للوصول إلى عنوان URL المقدّم في متصفح الويب.

    إذا لم تكن قد سجلت الدخول فعلاً إلى حسابك في Google، فستتم مطالبتك بتسجيل الدخول. إذا سجلت الدخول إلى حسابات متعددة في Google، فسيُطلب منك تحديد حساب واحد لاستخدامه للتفويض.

  2. انقر على الزر قبول.
  3. انسخ الرمز الذي تلقّيته، والصقه في موجه سطر الأوامر، واضغط على Enter.

ملاحظات

  • يتم تخزين معلومات التفويض على نظام الملفات، لذا لن تطلب عمليات التنفيذ اللاحقة الحصول على تفويض.
  • تم تصميم تدفق التفويض في هذا المثال مع تطبيق سطر الأوامر. للحصول على معلومات حول كيفية إجراء المصادقة في تطبيق ويب، راجع استخدام OAuth 2.0 لتطبيقات خادم الويب.

قراءات إضافية