Krótkie wprowadzenie do Ruby

Wykonaj czynności opisane na pozostałych stronach, a w ciągu około 5 minut uzyskasz prostą aplikację wiersza poleceń w języku Ruby, która wysyła żądania do interfejsu YouTube Data API.

Przykładowy kod użyty w tym przewodniku pobiera channel zasób dla kanału GoogleDevelopers w YouTube i wyświetla podstawowe informacje z tego zasobu.

Wymagania wstępne

Aby uruchomić ten przewodnik, musisz mieć:

  • Ruby w wersji 2.0 lub nowszej.
  • Dostęp do internetu i przeglądarki.
  • konto Google;

Krok 1. Włącz interfejs YouTube Data API

  1. Użyj tego kreatora, aby utworzyć lub wybrać projekt w Google Developers Console i automatycznie włączyć interfejs API. Kliknij Dalej, a potem Przejdź do danych logowania.

  2. Na stronie Utwórz dane logowania kliknij przycisk Anuluj.

  3. U góry strony wybierz kartę Ekran zgody OAuth. Wybierz adres e-mail, wpisz nazwę produktu, jeśli nie została jeszcze ustawiona, i kliknij przycisk Zapisz.

  4. Wybierz kartę Dane logowania, kliknij przycisk Utwórz dane logowania i wybierz Identyfikator klienta OAuth.

  5. Wybierz typ aplikacji Inne, wpisz nazwę „YouTube Data API Quickstart” i kliknij przycisk Utwórz.

  6. Aby zamknąć okno, kliknij OK.

  7. Kliknij przycisk (Pobierz JSON) po prawej stronie identyfikatora klienta.

  8. Przenieś pobrany plik do katalogu roboczego i zmień jego nazwę na client_secret.json.

Krok 2. Zainstaluj bibliotekę klienta Google

Aby zainstalować bibliotekę, uruchom to polecenie:

gem install google-api-client

Alternatywne opcje instalacji znajdziesz na stronie instalacji biblioteki.

Krok 3. Skonfiguruj próbkę

Utwórz w katalogu roboczym plik o nazwie quickstart.rb i skopiuj do niego ten kod:

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

quickstart.rb

Krok 4. Uruchom przykład

Uruchom przykład za pomocą tego polecenia:

ruby quickstart.rb

Przy pierwszym uruchomieniu próbki pojawi się prośba o autoryzację dostępu:

  1. Przykładowy kod próbuje otworzyć nowe okno lub kartę w przeglądarce domyślnej. Jeśli to się nie uda, skopiuj adres URL z konsoli i otwórz go ręcznie w przeglądarce.

    Jeśli nie zalogujesz się na konto Google, poprosimy Cię o to. Jeśli logujesz się na kilka kont Google, pojawi się prośba o wybranie jednego konta do autoryzacji.

  2. Kliknij przycisk Akceptuję.

  3. Skopiuj otrzymany kod, wklej go w wierszu poleceń i naciśnij Enter. Kod może pojawić się w adresie URL strony, na którą przekierujemy Cię po przyznaniu autoryzacji:

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

Uwagi

  • Informacje o autoryzacji są przechowywane w systemie plików, więc kolejne wykonania nie będą wymagać autoryzacji.
  • Proces autoryzacji w tym przykładzie jest przeznaczony dla aplikacji wiersza poleceń. Informacje o tym, jak przeprowadzić autoryzację w aplikacji internetowej, znajdziesz w artykule Używanie OAuth 2.0 w aplikacjach udostępnianych przez serwer WWW.

Więcej informacji