التشغيل السريع للغة Ruby

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

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

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

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

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

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

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

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

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

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

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

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

  7. انقر على الزر (تنزيل JSON) على يسار معرِّف العميل.

  8. انقل الملف الذي تم تنزيله إلى دليل العمل وأعد تسميته client_secret.json.

الخطوة 2: تثبيت مكتبة عملاء Google

شغّل الأمر التالي لتثبيت المكتبة:

gem install google-api-client

اطلع على صفحة تثبيت المكتبة للحصول على خيارات التثبيت البديلة.

الخطوة 3: إعداد النموذج

أنشئ ملفًا باسم quickstart.rb في دليل العمل وانسخ الرمز التالي:

# Sample Ruby code for user authorization

require 'rubygems'
gem 'google-api-client', '>0.7'
require 'google/apis'
require 'google/apis/youtube_v3'
require 'googleauth'
require 'googleauth/stores/file_token_store'

require 'fileutils'
require 'json'

# REPLACE WITH VALID REDIRECT_URI FOR YOUR CLIENT
REDIRECT_URI = 'http://localhost'
APPLICATION_NAME = 'YouTube Data API Ruby Tests'

# REPLACE WITH NAME/LOCATION OF YOUR client_secrets.json FILE
CLIENT_SECRETS_PATH = 'client_secret.json'

# REPLACE FINAL ARGUMENT WITH FILE WHERE CREDENTIALS WILL BE STORED
CREDENTIALS_PATH = File.join(Dir.home, '.credentials',
                             "youtube-quickstart-ruby-credentials.yaml")

# SCOPE FOR WHICH THIS SCRIPT REQUESTS AUTHORIZATION
SCOPE = Google::Apis::YoutubeV3::AUTH_YOUTUBE_READONLY

def authorize
  FileUtils.mkdir_p(File.dirname(CREDENTIALS_PATH))

  client_id = Google::Auth::ClientId.from_file(CLIENT_SECRETS_PATH)
  token_store = Google::Auth::Stores::FileTokenStore.new(file: CREDENTIALS_PATH)
  authorizer = Google::Auth::UserAuthorizer.new(
    client_id, SCOPE, token_store)
  user_id = 'default'
  credentials = authorizer.get_credentials(user_id)
  if credentials.nil?
    url = authorizer.get_authorization_url(base_url: REDIRECT_URI)
    puts "Open the following URL in the browser and enter the " +
         "resulting code after authorization"
    puts url
    code = gets
    credentials = authorizer.get_and_store_credentials_from_code(
      user_id: user_id, code: code, base_url: REDIRECT_URI)
  end
  credentials
end

# Initialize the API
service = Google::Apis::YoutubeV3::YouTubeService.new
service.client_options.application_name = APPLICATION_NAME
service.authorization = authorize

# Sample ruby code for channels.list

def channels_list_by_username(service, part, **params)
  response = service.list_channels(part, params).to_json
  item = JSON.parse(response).fetch("items")[0]

  puts ("This channel's ID is #{item.fetch("id")}. " +
        "Its title is '#{item.fetch("snippet").fetch("title")}', and it has " +
        "#{item.fetch("statistics").fetch("viewCount")} views.")
end

channels_list_by_username(service, 'snippet,contentDetails,statistics', for_username: 'GoogleDevelopers')

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

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

ruby quickstart.rb

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

  1. يحاول النموذج فتح نافذة أو علامة تبويب جديدة في المتصفِّح التلقائي. إذا أخفق ذلك، فانسخ عنوان URL من وحدة التحكم وافتحه يدويًا في المتصفح.

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

  2. انقر على الزر قبول.
  3. انسخ الرمز الذي تلقّيته، والصقه في موجه سطر الأوامر، واضغط على Enter. قد تظهر الشفرة في عنوان URL للصفحة التي تتم إعادة توجيهك إليها بعد منح التفويض:

    http://localhost/?code=4/nr_1TspmmQPFyifh7nz...OFo#

ملاحظات

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

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