Bắt đầu nhanh với Ruby

Hoàn tất các bước được mô tả trong phần còn lại của trang này và trong khoảng 5 phút, bạn sẽ có một ứng dụng dòng lệnh Ruby đơn giản gửi yêu cầu đến YouTube Data API.

Mã mẫu được sử dụng trong hướng dẫn này truy xuất tài nguyên channel cho kênh YouTube GoogleDevelopers và in một số thông tin cơ bản từ tài nguyên đó.

Điều kiện tiên quyết

Để chạy hướng dẫn bắt đầu nhanh này, bạn cần có:

  • Ruby 2.0 trở lên.
  • Có quyền truy cập vào Internet và trình duyệt web.
  • Tài khoản Google.

Bước 1: Bật YouTube Data API

  1. Sử dụng trình hướng dẫn này để tạo hoặc chọn một dự án trong Google Developers Console và tự động bật API. Nhấp vào Continue (Tiếp tục), sau đó nhấp vào Go to credentials (Chuyển đến thông tin xác thực).

  2. Trên trang Tạo thông tin xác thực, hãy nhấp vào nút Huỷ.

  3. Ở đầu trang, hãy chọn thẻ Màn hình xin phép bằng OAuth. Chọn một Địa chỉ email, nhập Tên sản phẩm nếu chưa đặt, rồi nhấp vào nút Lưu.

  4. Chọn thẻ Credentials (Thông tin xác thực), nhấp vào nút Create credentials (Tạo thông tin xác thực) rồi chọn OAuth client ID (Mã ứng dụng OAuth).

  5. Chọn loại ứng dụng Khác, nhập tên "YouTube Data API Quickstart" rồi nhấp vào nút Tạo.

  6. Nhấp vào OK để đóng hộp thoại kết quả.

  7. Nhấp vào nút (Tải JSON xuống) ở bên phải mã nhận dạng ứng dụng.

  8. Di chuyển tệp đã tải xuống vào thư mục đang hoạt động và đổi tên tệp thành client_secret.json.

Bước 2: Cài đặt Thư viện ứng dụng Google

Chạy lệnh sau để cài đặt thư viện:

gem install google-api-client

Hãy xem trang cài đặt của thư viện để biết các lựa chọn cài đặt thay thế.

Bước 3: Thiết lập mẫu

Tạo một tệp có tên là quickstart.rb trong thư mục đang hoạt động và sao chép vào đoạn mã sau:

# 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')

Bước 4: Chạy mẫu

Chạy mẫu bằng lệnh sau:

ruby quickstart.rb

Trong lần đầu tiên bạn chạy mẫu, mẫu này sẽ nhắc bạn uỷ quyền truy cập:

  1. Mẫu này sẽ cố gắng mở một cửa sổ hoặc thẻ mới trong trình duyệt mặc định của bạn. Nếu không được, hãy sao chép URL từ bảng điều khiển rồi mở URL đó theo cách thủ công trong trình duyệt.

    Nếu chưa đăng nhập vào Tài khoản Google, bạn sẽ được nhắc đăng nhập. Nếu đã đăng nhập vào nhiều Tài khoản Google, bạn sẽ được yêu cầu chọn một tài khoản để sử dụng cho việc uỷ quyền.

  2. Nhấp vào nút Chấp nhận.

  3. Sao chép mã bạn nhận được, dán mã đó vào dấu nhắc dòng lệnh rồi nhấn phím Enter. Mã này có thể xuất hiện trong URL của trang mà bạn được chuyển hướng đến sau khi cấp quyền uỷ quyền:

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

Ghi chú

  • Thông tin uỷ quyền được lưu trữ trên hệ thống tệp, vì vậy, các lần thực thi tiếp theo sẽ không nhắc uỷ quyền.
  • Quy trình uỷ quyền trong ví dụ này được thiết kế cho một ứng dụng dòng lệnh. Để biết thông tin về cách thực hiện uỷ quyền trong ứng dụng web, hãy xem bài viết Sử dụng OAuth 2.0 cho ứng dụng máy chủ web.

Tài liệu đọc thêm