Youtube API 視聴回数の取得

Question

Youtube公式サイトをいじり、Rubyで動画情報の取得を試みています。
以下がコードです。

class Youtube < ApplicationRecord

  require 'rubygems'
  gem 'google-api-client', '>0.7'
  require 'google/api_client'
  require 'trollop'

  DEVELOPER_KEY = #########################
  YOUTUBE_API_SERVICE_NAME = 'youtube'
  YOUTUBE_API_VERSION = 'v3'

  def self.get_service
    client = Google::APIClient.new(
      :key => DEVELOPER_KEY,
      :authorization => nil,
      :application_name => $PROGRAM_NAME,
      :application_version => '1.0.0'
    )
    youtube = client.discovered_api(YOUTUBE_API_SERVICE_NAME, YOUTUBE_API_VERSION)

    return client, youtube
  end

  def self.main
    opts = Trollop::options do
      opt :q, 'Search term', :type => String, :default => 'アウディ'
      opt :max_results, 'Max results', :type => :int, :default => 5
    end

    client, youtube = get_service

    begin
      # Call the search.list method to retrieve results matching the specified
      # query term.
      search_response = client.execute!(
        :api_method => youtube.search.list,
        :parameters => {
          :part => 'snippet',
          :q => opts[:q],
          :maxResults => opts[:max_results]
        }
      )

      urls = []
      titles = []
      descriptions = []
      channels = []
      thumbnails = []
      views = []

      # Add each result to the appropriate list, and then display the lists of
      # matching videos, channels, and playlists.
      search_response.data.items.each do |search_result|
        case search_result.id.kind
          when 'youtube#video'
            urls << "http://www.youtube.com/watch?v=#{search_result.id.videoId}"
            titles << "#{search_result.snippet.title}"
            descriptions << "#{search_result.snippet.description}"
            channels << "#{search_result.snippet.channelTitle}"
            thumbnails << "#{search_result.snippet.thumbnails.default.url}"
            views << "#{search_result.statistics.viewCount}"
          end
        end

      puts "Urls:\n", urls, "\n"
      puts "Titles:\n", titles, "\n"
      puts "Descriotions:\n", descriptions, "\n"
      puts "Channels:\n", channels, "\n"
      puts "Thumbnials:\n", thumbnails, "\n"
      puts "Views:\n", views, "\n"

      rescue Google::APIClient::TransmissionError => e
        puts e.result.body
      end

    end

end

視聴回数を取得するために、下記の:partの部分を　「:part => 'snippet, statistics'」としているのですが、エラーが出ます。

search_response = client.execute!(
        :api_method => youtube.search.list,
        :parameters => {
          :part => 'snippet',
          :q => opts[:q],
          :maxResults => opts[:max_results]
        }
      )

####エラー画面

{
 "error": {
  "errors": [
   {
    "domain": "youtube.part",
    "reason": "unknownPart",
    "message": "statistics",
    "locationType": "parameter",
    "location": "part"
   }
  ],
  "code": 400,
  "message": "statistics"
 }
}

statisticsは視聴回数を取得するためのプロパティだと認識しています。
どこが間違っているのでしょうか。ご教授お願いいたします。

Answer 1

どこが間違っているのでしょうか。

何らかのエラーが発生した時は
0. エラーメッセージでキーワード検索を行う。
0. 公式ドキュメントを参照する

この2点を行うと解決することが多いです。

質問文のソースコードで指定しているapi_method がyoutube.search.listなため
公式ドキュメント
リクエスト：YouTube Data API (v3)Search: list
レスポンス(検索リソース)：Search
を参照します。

リクエストのドキュメントより引用(太文字部分は回答者強調)。

part
string
part パラメータには、API レスポンスに含める 1 つまたは複数の search リソースのプロパティをカンマ区切りリストの形式で指定します。このパラメータに指定できる part 名は id と snippet です。

エラーメッセージ(unknownPart)が示す通りpartにstatisticsは指定できません。
上記リクエストのリンク先のTry this APIでYouTube Data APIの動作テストを行うことができます。

視聴回数を取得したいという要件から推測で回答するとYouTube Data API (v3)videos: listこのAPIが使用できます。
「youtube.video.list ruby statistics」のキーワードで検索するとサンプルコードがヒットするかと。
videos listのパラメータ:idにYouTube 動画 ID をカンマ区切りリストで渡せば、複数件の取得が可能です。

Comments

[isumidaichi]

ありがとうございます！
ご指導いただいた通りに公式ページを読み無事解決できました。