Youtube API


<p>YouTube APIを利用して様々なデータを集めるのが楽しくて、<strong>気づいたら1日あたりの割り当て上限数に達している</strong>ことがよくあります。</p>



<p>そこで改めて各リソースやメソッドが、どのくらいクエリを使用するのか調べてみました。</p>



<div id="toc_container" class="no_bullets"><p class="toc_title">目次</p><ul class="toc_list"><li><a href="#i">クエリの計算方法</a></li><li><a href="#i-2">よく使うリソース・メソッドのコスト</a></li><li><a href="#Queries_per_minute8230">「Queries per minute」って&#8230;？</a></li><li><a href="#i-3">まとめ</a></li></ul></div>
<h2><span id="i">クエリの計算方法</span></h2>



<p>YouTube APIは<strong>リソースやメソッドごとにクエリの使用量が異なります</strong>。つまり<strong>必ずしも10,000回APIリクエストができるわけではありません</strong>。</p>



<p>使用量の計算方法は下の式です。クエリ使用量を事前に予測するために、リソースやメソッドごとのコストを確認しておきましょう。</p>



<p>（「queries(クエリ)」は、「units」や「points」と記載されたりしてる）</p>



<figure class="wp-block-table"><table><thead><tr><th>YouTube APIのクエリ計算式</th></tr></thead><tbody><tr><td><strong>「クエリ」</strong> = 「APIのリクエスト回数」 × 「利用したリソース/メソッドのcost」</td></tr></tbody></table></figure>



<h2><span id="i-2">よく使うリソース・メソッドのコスト</span></h2>



<figure class="wp-block-table"><table><thead><tr><th>リソース</th><th>メソッド</th><th>cost</th><th>1日あたり最大回数<br>（10000 queries）</th></tr></thead><tbody><tr><td><strong>search</strong></td><td>list</td><td>100</td><td>100回</td></tr><tr><td><strong>channels</strong></td><td>list</td><td>1</td><td>10,000回</td></tr><tr><td><strong>videos</strong></td><td>list</td><td>1</td><td>10,000回</td></tr></tbody></table></figure>



<figure class="wp-block-table"><table><thead><tr><th>リソース</th><th>メソッド</th><th>cost</th><th>1日あたり最大回数<br>（10000 queries）</th></tr></thead><tbody><tr><td><strong>playlists</strong></td><td>insert</td><td>50</td><td>200回</td></tr><tr><td><strong>playlists</strong></td><td>update</td><td>50</td><td>200回</td></tr><tr><td><strong>playlistItems</strong></td><td>insert</td><td>50</td><td>200回</td></tr><tr><td><strong>playlistItems</strong></td><td>update</td><td>50</td><td>200回</td></tr></tbody></table></figure>



<ul>
<li><a href="https://developers.google.com/youtube/v3/determine_quota_cost">YouTube Data API (v3) &#8211; Quota Calculator | Google Developers</a></li>
</ul>



<h2><span id="Queries_per_minute8230">「Queries per minute」って&#8230;？</span></h2>



<figure class="wp-block-image size-large is-resized"><img decoding="async" loading="lazy" src="https://craft-time.jp/wp-content/uploads/2023/01/image-1024x214.png" alt="" class="wp-image-2484" width="768" height="161" srcset="https://craft-time.jp/wp-content/uploads/2023/01/image-1024x214.png 1024w, https://craft-time.jp/wp-content/uploads/2023/01/image-300x63.png 300w, https://craft-time.jp/wp-content/uploads/2023/01/image-768x161.png 768w, https://craft-time.jp/wp-content/uploads/2023/01/image-304x64.png 304w, https://craft-time.jp/wp-content/uploads/2023/01/image-282x59.png 282w, https://craft-time.jp/wp-content/uploads/2023/01/image.png 1200w" sizes="(max-width: 768px) 100vw, 768px" /></figure>



<p>Queries per dayは「10,000」だけど、Queries per minuteは「1,800,000」っていうことは、<strong>どうにかすれば「1,800,000」使えるのでは？</strong>と考えていました。</p>



<p>ですが、結論としては無理そうでした。</p>



<p>これは過去の基準がそのまま残ってしまっているようで、<strong>Queries per minuteは今では何も関係ないデータ</strong>みたいです。悲しい。（以前は50,000,000 Queries per dayだったようです）</p>



<ul>
<li><a href="https://teratail.com/questions/259315">参考: Youtube Data APIの割り当てについて知りたい</a></li>



<li><a href="https://stackoverflow.com/questions/41835710/understanding-youtube-quota-limits-total-per-day-vs-per-100-seconds">参考:  Understanding YouTube quota limits: total per day vs. per 100 seconds? &#8211; Stack Overflow</a></li>
</ul>



<h2><span id="i-3">まとめ</span></h2>



<p>どうしても使いたい時に上限に達していて使えないとかは困るので、あらかじめチェックしておこうと思います。</p>



<ul class="references">
<li><a href="https://developers.google.com/youtube/v3/determine_quota_cost"> YouTube Data API (v3) &#8211; Quota Calculator  |  Google Developers</a></li>



<li><a href="https://ichiro-kun.com/post/2452/">【GCP】Youtube APIの「Queries」「Quota」「割り当て」の意味をやっと理解できたかもしれない</a></li>



<li><a href="https://teratail.com/questions/259315">Youtube Data APIの割り当てについて知りたい</a></li>



<li><a href="https://stackoverflow.com/questions/41835710/understanding-youtube-quota-limits-total-per-day-vs-per-100-seconds"> Understanding YouTube quota limits: total per day vs. per 100 seconds? &#8211; Stack Overflow</a></li>
</ul>


【YouTube API】すぐ割り当て上限に達するので、内訳を調べてみる。


<p>Google ColaboratoryでYouTube APIを利用して「再生リストを作成したい」と思ったので、少し調べてまとめてみました。</p>



<p>Google ColaboratoryでOAuth認証を通す方法がなかなかわからなかったので、メモしておきたいと思います。</p>



<ul>
<li><a href="https://developers.google.com/youtube/v3/docs/playlists?hl=ja">Playlists  |  YouTube Data API  |  Google Developers</a></li>



<li><a href="https://developers.google.com/youtube/v3/docs/playlistItems?hl=ja">PlaylistItems  |  YouTube Data API  |  Google Developers</a></li>
</ul>



<div id="toc_container" class="no_bullets"><p class="toc_title">目次</p><ul class="toc_list"><li><a href="#Google_Cloud_Platform">Google Cloud Platformの設定</a><ul><li><a href="#i">プロジェクトを作成する</a></li><li><a href="#YouTube_Data_API_v3">「YouTube Data API v3」を有効化する</a></li><li><a href="#OAuth_20_ID">「OAuth 2.0 クライアント ID」を作成する</a></li><li><a href="#OAuthjson">OAuthクライアントのjsonファイルを取得する</a></li></ul></li><li><a href="#i-2">コード全文</a><ul><li><a href="#Google_OAuth_20">コード：Google OAuth 2.0の認証設定</a></li><li><a href="#i-3">コード：再生リストを作成する</a></li><li><a href="#i-4">コード：再生リストに動画を追加する</a></li></ul></li><li><a href="#i-5">エラーで詰まったところ</a><ul><li><a href="#_GCPOAuthID">⑴ GCPのOAuthクライアントIDの設定ミス</a></li><li><a href="#_YouTube">⑵ YouTubeチャンネルを作成していない</a></li></ul></li></ul></div>
<h2><span id="Google_Cloud_Platform">Google Cloud Platformの設定</span></h2>



<p><a href="https://code.google.com/apis/console/?hl=ja">Google Cloud Platform</a>へアクセスして、APIを利用するための設定をしていきます。</p>



<h3><span id="i">プロジェクトを作成する</span></h3>



<p>まずはAPIを利用するためにプロジェクトを作成します。</p>



<h3><span id="YouTube_Data_API_v3">「YouTube Data API v3」を有効化する</span></h3>



<p>メニューから「API とサービス」→「ライブラリ」を開きます。<strong>「YouTube Data API v3」</strong>を検索して「有効にする」を押します。</p>



<h3><span id="OAuth_20_ID">「OAuth 2.0 クライアント ID」を作成する</span></h3>



<p>メニューから「API とサービス」→「認証情報」を開きます。「+認証情報を作成」を押して、「OAuth クライアント ID」を選択します。</p>



<p>アプリケーションの種類を「デスクトップ アプリ」を選択して、名前を設定し作成します。（名前はなんでもOK）</p>



<h3><span id="OAuthjson">OAuthクライアントのjsonファイルを取得する</span></h3>



<p>OAuth 2.0 クライアント IDを作成すると出てくる「JSONをダウンロード」または「OAuthクライアントをダウンロード」を押してjsonをダウンロードします。</p>



<p>ダウンロードした<strong>ファイル名を「client_secret.json」に変更</strong>してください。</p>



<h2><span id="i-2">コード全文</span></h2>



<p>あらかじめGoogle Colaboratoryにダウンロードした「client_secret.json」をアップロードしておきます。（左側に表示されているフォルダのタブにドラックアンドドロップなどでアップロード）</p>



<div class="hcb_wrap"><pre class="prism line-numbers lang-python" data-lang="Python"><code>import argparse
import os

import google.oauth2.credentials
import google_auth_oauthlib.flow
from googleapiclient.discovery import build
from googleapiclient.errors import HttpError
from google_auth_oauthlib.flow import InstalledAppFlow


# ==================================================
# Google OAuth 2.0の認証設定
# ==================================================
CLIENT_SECRETS_FILE = &#39;client_secret.json&#39;

SCOPES = [&#39;https://www.googleapis.com/auth/youtube&#39;]
API_SERVICE_NAME = &#39;youtube&#39;
API_VERSION = &#39;v3&#39;
    
# Authorize the request and store authorization credentials.
def get_authenticated_service():
  flow = InstalledAppFlow.from_client_secrets_file(CLIENT_SECRETS_FILE, SCOPES)
  credentials = flow.run_console()
  return build(API_SERVICE_NAME, API_VERSION, credentials = credentials)

youtube = get_authenticated_service()


# ==================================================
# 再生リストを作成する
# ==================================================
TITLE = &quot;Youtube APIに関する動画たち&quot;
DESCTIPTION = &quot;Youtube APIに関する動画をまとめています。&quot;

playlist = youtube.playlists().insert(
    part=&quot;snippet,status&quot;,
    body={
        &quot;snippet&quot;: {
            &quot;title&quot;: TITLE,              # プレイリストのタイトル
            &quot;description&quot;: DESCTIPTION   # プレイリストの説明文
        },
        &quot;status&quot;: {
            &quot;privacyStatus&quot;: &quot;private&quot;   # プレイリストの公開ステータス
        }
    }
).execute()


# ==================================================
# 再生リストに動画を追加する
# ==================================================
playlist_id = playlist[&#39;id&#39;]
video_ids = [&quot;xxx&quot;, &quot;yyy&quot;]

for video_id in video_ids:
    playlist_item = youtube.playlistItems().insert(
        part=&quot;snippet,status&quot;,
        body={
            &quot;snippet&quot;: {
                &quot;playlistId&quot;: playlist_id,
                &quot;resourceId&quot;: {
                    &quot;kind&quot;: &quot;youtube#video&quot;,
                    &quot;videoId&quot;: video_id,
                },
                &quot;position&quot;: 
            },
            &quot;status&quot;: {
                &quot;privacyStatus&quot;: &quot;private&quot;
            },
        }
    ).execute()
</code></pre></div>



<h3><span id="Google_OAuth_20">コード：Google OAuth 2.0の認証設定</span></h3>



<div class="hcb_wrap"><pre class="prism line-numbers lang-python" data-lang="Python"><code>import argparse
import os

import google.oauth2.credentials
import google_auth_oauthlib.flow
from googleapiclient.discovery import build
from googleapiclient.errors import HttpError
from google_auth_oauthlib.flow import InstalledAppFlow


# ==================================================
# Google OAuth 2.0の認証設定
# ==================================================
CLIENT_SECRETS_FILE = &#39;client_secret.json&#39;

SCOPES = [&#39;https://www.googleapis.com/auth/youtube&#39;]
API_SERVICE_NAME = &#39;youtube&#39;
API_VERSION = &#39;v3&#39;
    
# Authorize the request and store authorization credentials.
def get_authenticated_service():
  flow = InstalledAppFlow.from_client_secrets_file(CLIENT_SECRETS_FILE, SCOPES)
  credentials = flow.run_console()
  return build(API_SERVICE_NAME, API_VERSION, credentials = credentials)

youtube = get_authenticated_service()</code></pre></div>



<h3><span id="i-3">コード：再生リストを作成する</span></h3>



<ul>
<li><a href="https://developers.google.com/youtube/v3/docs/playlists?hl=ja">Playlists  |  YouTube Data API  |  Google Developers</a></li>
</ul>



<div class="hcb_wrap"><pre class="prism line-numbers lang-python" data-lang="Python"><code># ==================================================
# 再生リストを作成する
# ==================================================
TITLE = &quot;Youtube APIに関する動画たち&quot;
DESCTIPTION = &quot;Youtube APIに関する動画をまとめています。&quot;

playlist = youtube.playlists().insert(
    part=&quot;snippet,status&quot;,
    body={
        &quot;snippet&quot;: {
            &quot;title&quot;: TITLE,              # プレイリストのタイトル
            &quot;description&quot;: DESCTIPTION   # プレイリストの説明文
        },
        &quot;status&quot;: {
            &quot;privacyStatus&quot;: &quot;private&quot;   # プレイリストの公開ステータス
        }
    }
).execute()</code></pre></div>



<h3><span id="i-4">コード：再生リストに動画を追加する</span></h3>



<ul>
<li><a href="https://developers.google.com/youtube/v3/docs/playlistItems?hl=ja">PlaylistItems  |  YouTube Data API  |  Google Developers</a></li>
</ul>



<div class="hcb_wrap"><pre class="prism line-numbers lang-python" data-lang="Python"><code># ==================================================
# 再生リストに動画を追加する
# ==================================================
playlist_id = playlist[&#39;id&#39;]
video_ids = [&quot;xxx&quot;, &quot;yyy&quot;]

for video_id in video_ids:
    playlist_item = youtube.playlistItems().insert(
        part=&quot;snippet,status&quot;,
        body={
            &quot;snippet&quot;: {
                &quot;playlistId&quot;: playlist_id,
                &quot;resourceId&quot;: {
                    &quot;kind&quot;: &quot;youtube#video&quot;,
                    &quot;videoId&quot;: video_id,
                },
                &quot;position&quot;: 
            },
            &quot;status&quot;: {
                &quot;privacyStatus&quot;: &quot;private&quot;
            },
        }
    ).execute()
</code></pre></div>



<h2><span id="i-5">エラーで詰まったところ</span></h2>



<h3><span id="_GCPOAuthID">⑴ GCPのOAuthクライアントIDの設定ミス</span></h3>



<p>OAuth 2.0 クライアント IDの<strong>アプリケーションの種類を「ウェブアプリ」で作成</strong>していて、「エラー 400: redirect_uri_mismatch」のエラーが出ました。</p>



<p>「デスクトップアプリ」で作成すると解消されました。</p>



<h3><span id="_YouTube">⑵ YouTubeチャンネルを作成していない</span></h3>



<p><strong>認証を通したGoogleアカウントのYouTubeチャンネルがない</strong>場合、401エラーが返ってきます。Youtubeを開いてチャンネルを作成しましょう。</p>



<p>（Googleアカウントを作成したら自動でチャンネルも作成されると思ってた&#8230;）</p>



<ul class="references">
<li><a href="https://awesome03.com/2021/01/10/pydrive%E3%81%A7%E3%80%8C%E3%82%A8%E3%83%A9%E3%83%BC-400-redirect_uri_mismatch%E3%80%8D/">pydriveで「エラー 400: redirect_uri_mismatch」</a></li>



<li><a href="https://stackoverflow.com/questions/19883882/youtube-api-v3-return-401-when-i-try-to-upload-video">Youtube API v3 return 401 when i try to upload video &#8211; Stack Overflow</a></li>
</ul>


【Google Colaboratory】YouTube APIを使って再生リストを作る方法


<p>「Youtube API」を使って<strong>Youtubeの動画一覧を取得したかった</strong>ので調べてみました。今回はPythonによるコード例をまとめています。</p>



<p>また今回は<strong>Youtube APIをある程度利用できる簡単なコード</strong>を紹介しています。他にも記載していないパラメータなどはたくさんあるのでドキュメントを確認して条件追加したり、取得後のデータ加工なども試してみてください！</p>



<ul>
<li><a href="https://developers.google.com/youtube/v3/getting-started?hl=ja">YouTube Data API の概要 | Google Developers</a></li>
</ul>



<div id="toc_container" class="no_bullets"><p class="toc_title">目次</p><ul class="toc_list"><li><a href="#API">APIの設定</a></li><li><a href="#i">⑴「動画一覧」を取得する</a><ul><li><a href="#i-2">「特定チャンネル」から</a></li><li><a href="#i-3">「検索キーワード」から</a></li></ul></li><li><a href="#i-4">⑵「動画詳細データ」を取得する</a></li><li><a href="#i-5">⑶「チャンネル一覧」を取得する</a><ul><li><a href="#i-6">「検索キーワード」で検索</a></li></ul></li><li><a href="#i-7">⑷「チャンネル詳細データ」を取得する</a></li><li><a href="#i-8">まとめ</a></li></ul></div>
<h2><span id="API">APIの設定</span></h2>



<div class="hcb_wrap"><pre class="prism line-numbers lang-python" data-lang="Python"><code>from googleapiclient.discovery import build


# ===============================================
# API設定
# ===============================================
api_key = &quot;YOUR_API_KEY&quot;       # APIキー
api_service_name = &#39;youtube&#39;   # APIの指定
api_version = &#39;v3&#39;             # APIのバージョン
youtube = build(api_service_name, api_version, developerKey=api_key)</code></pre></div>



<h2><span id="i">⑴「動画一覧」を取得する</span></h2>



<h3><span id="i-2">「特定チャンネル」から</span></h3>



<div class="hcb_wrap"><pre class="prism line-numbers lang-python" data-lang="Python"><code>CHANNEL_ID = &quot;&quot;

res = youtube.search().list(
  part=&#39;snippet&#39;,                   # 取得項目
  maxResults=5,                     # 取得数（上限50件）
  type=&quot;video&quot;,                     # 検索条件__Videoのみを取得
  regionCode=&quot;jp&quot;,                  # 検索条件__国（米国:us, 日本:jp）
  channelId=CHANNEL_ID,             # 検索条件__Channel ID
).execute()</code></pre></div>



<h3><span id="i-3">「検索キーワード」から</span></h3>



<div class="hcb_wrap"><pre class="prism line-numbers lang-python" data-lang="Python"><code>KEYWORD = &quot;&quot;

res = youtube.search().list(
  part=&#39;snippet&#39;,                   # 取得項目
  maxResults=5,                     # 取得数（上限50件）
  type=&quot;video&quot;,                     # 検索条件__Videoのみを取得
  regionCode=&quot;jp&quot;,                  # 検索条件__国（米国:us, 日本:jp）
  q=KEYWORD,                        # 検索条件__検索キーワード
).execute()</code></pre></div>



<h2><span id="i-4">⑵「動画詳細データ」を取得する</span></h2>



<div class="hcb_wrap"><pre class="prism line-numbers lang-python" data-lang="Python"><code>VIDEO_ID = &quot;

res = youtube.videos().list(
  id=VIDEO_ID,                                  # 取得対象__動画ID
  part=&#39;id,snippet,contentDetails,statistics&#39;,  # 取得項目
).execute()</code></pre></div>



<h2><span id="i-5">⑶「チャンネル一覧」を取得する</span></h2>



<h3><span id="i-6">「検索キーワード」で検索</span></h3>



<div class="hcb_wrap"><pre class="prism line-numbers lang-python" data-lang="Python"><code>KEYWORD = &quot;&quot;

res = youtube.search().list(
  part=&#39;snippet&#39;,                   # 取得項目
  maxResults=5,                     # 取得数（上限50件）
  type=&quot;channel&quot;,                   # 検索条件__Channelのみ
  regionCode=region,                # 検索条件__国（米国:us, 日本:jp）
  q=KEYWORD,                        # 検索条件__検索キーワード
).execute()</code></pre></div>



<h2><span id="i-7">⑷「チャンネル詳細データ」を取得する</span></h2>



<div class="hcb_wrap"><pre class="prism line-numbers lang-python" data-lang="Python"><code>CHANNEL_ID = &quot;&quot;

res = youtube.channels().list(
  id=CHANNEL_ID                                               # 取得対象__チャンネルID
  part=&#39;id,snippet,statistics,brandingSettings,topicDetails&#39;, # 取得項目
).execute()</code></pre></div>



<h2><span id="i-8">まとめ</span></h2>



<p>「それぞれ取得できるデータ」や「取得結果の例」、「取得したデータの加工方法」などは今後追記していこうと思います。</p>


「Youtube API」の記事一覧