概要
LisVir.holoで実際に使用しているYouTube Data APIのリクエストとレスポンスのサンプル。
チャンネル情報の取得
- リクエストURL
- パラメータ
- key={APIキー}
- part=snippet,statistics
- id={チャンネルID}
- 公式ドキュメント
- レスポンスのサンプル
{
"kind": "youtube#channelListResponse",
"etag": "BTCTXvS6CNrOIij-n0JDzLVjVGs",
"pageInfo": {
"resultsPerPage": 1
},
"items": [
{
"kind": "youtube#channel",
"etag": "2mQswzIf1B3vV00Vgp4WhFVm0p8",
"id": "UCAWSyEs_Io8MtpY3m-zqILA",
"snippet": {
"title": "Nene Ch.桃鈴ねね",
"description": "ホロライブ所属。\nアイドルにあこがれて、異世界からやってきたチャイナ服の女の子。\n歌って踊ることと餃子が大好き。たくさんの人に愛される存在になるべく、\n日々特訓中。故郷では「タオリン」と呼ばれていた。\n\n\nお問い合わせ\nカバー株式会社：http://cover-corp.com/ \n公式Twitter:https://twitter.com/hololivetv",
"publishedAt": "2020-04-15T10:20:06Z",
"thumbnails": {
"default": {
"url": "https://yt3.ggpht.com/a/AATXAJyy0MDi5ux-dNieMyjSCs4xBUQWHOfkPfsz5Xrw=s88-c-k-c0xffffffff-no-rj-mo",
"width": 88,
"height": 88
},
"medium": {
"url": "https://yt3.ggpht.com/a/AATXAJyy0MDi5ux-dNieMyjSCs4xBUQWHOfkPfsz5Xrw=s240-c-k-c0xffffffff-no-rj-mo",
"width": 240,
"height": 240
},
"high": {
"url": "https://yt3.ggpht.com/a/AATXAJyy0MDi5ux-dNieMyjSCs4xBUQWHOfkPfsz5Xrw=s800-c-k-c0xffffffff-no-rj-mo",
"width": 800,
"height": 800
}
},
"localized": {
"title": "Nene Ch.桃鈴ねね",
"description": "ホロライブ所属。\nアイドルにあこがれて、異世界からやってきたチャイナ服の女の子。\n歌って踊ることと餃子が大好き。たくさんの人に愛される存在になるべく、\n日々特訓中。故郷では「タオリン」と呼ばれていた。\n\n\nお問い合わせ\nカバー株式会社：http://cover-corp.com/ \n公式Twitter:https://twitter.com/hololivetv"
},
"country": "JP"
},
"statistics": {
"viewCount": "5717054",
"commentCount": "0",
"subscriberCount": "215000",
"hiddenSubscriberCount": false,
"videoCount": "50"
}
}
]
}
検索(ライブ放送の情報取得)
- リクエストURL
- パラメータ
- key={APIキー}
- maxResults=50
- part=snippet
- eventType=live
- type=video
- q=ホロライブ|hololive (←実際はURLエンコードした値)
- 備考
- 最大件数の1ページのみの取得としている。
- 取得後に内部で保管しているチャンネルIDで絞り対象の動画情報のみを取り込んでいる。
- 公式ドキュメント
- レスポンスのサンプル(抜粋)
{
"kind": "youtube#searchListResponse",
"etag": "5bCzDt9oALHtzEQxbT2KnsmMHd4",
"nextPageToken": "CDIQAA",
"regionCode": "JP",
"pageInfo": {
"totalResults": 54,
"resultsPerPage": 50
},
"items": [
{
"kind": "youtube#searchResult",
"etag": "IbWazyKyWKFMzlanJeYy2lN0BJM",
"id": {
"kind": "youtube#video",
"videoId": "O8QsddT7IjQ"
},
"snippet": {
"publishedAt": "2020-09-21T03:55:55Z",
"channelId": "UCFKOVgVbGmX65RxO3EtH3iw",
"title": "【#らみらいぶ】火曜日の朝活雑談【9月22日】",
"description": "ホロライブ5期生の雪花ラミィ（Yukihana Lamy）です！ 9月22日（火）の朝定期雑談です⛄✨ 本編終了後に頂いたスーパーチャットのお礼は、 ツイッターにて画像でお礼を ...",
"thumbnails": {
"default": {
"url": "https://i.ytimg.com/vi/O8QsddT7IjQ/default_live.jpg",
"width": 120,
"height": 90
},
"medium": {
"url": "https://i.ytimg.com/vi/O8QsddT7IjQ/mqdefault_live.jpg",
"width": 320,
"height": 180
},
"high": {
"url": "https://i.ytimg.com/vi/O8QsddT7IjQ/hqdefault_live.jpg",
"width": 480,
"height": 360
}
},
"channelTitle": "Lamy Ch. 雪花ラミィ",
"liveBroadcastContent": "live",
"publishTime": "2020-09-21T03:55:55Z"
}
},
(以下、itemが続く)
動画情報の取得
- リクエストURL
- パラメータ
- key={APIキー}
- part=snippet,statistics,liveStreamingDetails
- id={動画ID}
- 公式ドキュメント
- レスポンスのサンプル(抜粋)
{
"kind": "youtube#videoListResponse",
"etag": "fmcyDpMU370BXWfz0BHZIlvTOCw",
"items": [
{
"kind": "youtube#video",
"etag": "wUEe2Sk0J6lou9l85hSn77gqEgM",
"id": "vlugkj33H5g",
"snippet": {
"publishedAt": "2020-09-21T18:53:51Z",
"channelId": "UCvzGlP9oQwU--Y0r9id_jnA",
"title": "【MINECRAFT】ゆる雑談！ダイヤなどをまったりあつめるすばる【ホロラブ/大空スバル】",
"description": "次の作戦の為にあつめます\n\n\n本ゲームは Mojang に確認を得た上、Terms and Conditions (https://account.mojang.com/terms) に基づいて配信・収益化を行なっております\n\n\n＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝\n🍉8/11まで！2020お誕生日限定ボイス&グッズでております！🍉\n→https://hololive.booth.pm/items/2186222\n＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝\n\n🍉メンバーシップあじまりました！\n→登録はこっちから！\nhttps://www.youtube.com/channel/UCvzGlP9oQwU--Y0r9id_jnA/join\n\nメンバー限定絵文字がつかえる！\nスバルの休日（オフショット画像）が見れるように！\nなります！！\n\n🐣twitter\nフォローしてくれるとスバルはうれしい\nhttps://twitter.com/oozorasubaru\n\n🍬ましゅまろ\nしてほしい事や質問とか募集してるッス！！！！\nhttps://marshmallow-qa.com/oozorasubaru?utm_medium=url_text&utm_source=promotion\n\n🐋放送タグ\n#生スバル\n\n＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝\n\nホロライブ公式YouTubeチャンネルでもオリジナルコンテンツ配信中！▷ https://www.youtube.com/channel/UCJFZ...\nホロライブ公式Twitter▷ https://twitter.com/hololivetv\nホロライブ公式サイト▷ https://www.hololive.tv/\n\n＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝\n\n▶ホロライブ公式YouTubeチャンネルでもオリジナルコンテンツ配信中！▷ https://www.youtube.com/channel/UCJFZiqLMntJufDCHc6bQixg\n▶ホロライブ公式Twitter▷ https://twitter.com/hololivetv\n▶ホロライブ公式サイト▷ https://www.hololive.tv/",
"thumbnails": {
"default": {
"url": "https://i.ytimg.com/vi/vlugkj33H5g/default_live.jpg",
"width": 120,
"height": 90
},
"medium": {
"url": "https://i.ytimg.com/vi/vlugkj33H5g/mqdefault_live.jpg",
"width": 320,
"height": 180
},
"high": {
"url": "https://i.ytimg.com/vi/vlugkj33H5g/hqdefault_live.jpg",
"width": 480,
"height": 360
},
"standard": {
"url": "https://i.ytimg.com/vi/vlugkj33H5g/sddefault_live.jpg",
"width": 640,
"height": 480
},
"maxres": {
"url": "https://i.ytimg.com/vi/vlugkj33H5g/maxresdefault_live.jpg",
"width": 1280,
"height": 720
}
},
"channelTitle": "Subaru Ch. 大空スバル",
"categoryId": "20",
"liveBroadcastContent": "live",
"localized": {
"title": "【MINECRAFT】ゆる雑談！ダイヤなどをまったりあつめるすばる【ホロラブ/大空スバル】",
"description": "次の作戦の為にあつめます\n\n\n本ゲームは Mojang に確認を得た上、Terms and Conditions (https://account.mojang.com/terms) に基づいて配信・収益化を行なっております\n\n\n＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝\n🍉8/11まで！2020お誕生日限定ボイス&グッズでております！🍉\n→https://hololive.booth.pm/items/2186222\n＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝\n\n🍉メンバーシップあじまりました！\n→登録はこっちから！\nhttps://www.youtube.com/channel/UCvzGlP9oQwU--Y0r9id_jnA/join\n\nメンバー限定絵文字がつかえる！\nスバルの休日（オフショット画像）が見れるように！\nなります！！\n\n🐣twitter\nフォローしてくれるとスバルはうれしい\nhttps://twitter.com/oozorasubaru\n\n🍬ましゅまろ\nしてほしい事や質問とか募集してるッス！！！！\nhttps://marshmallow-qa.com/oozorasubaru?utm_medium=url_text&utm_source=promotion\n\n🐋放送タグ\n#生スバル\n\n＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝\n\nホロライブ公式YouTubeチャンネルでもオリジナルコンテンツ配信中！▷ https://www.youtube.com/channel/UCJFZ...\nホロライブ公式Twitter▷ https://twitter.com/hololivetv\nホロライブ公式サイト▷ https://www.hololive.tv/\n\n＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝\n\n▶ホロライブ公式YouTubeチャンネルでもオリジナルコンテンツ配信中！▷ https://www.youtube.com/channel/UCJFZiqLMntJufDCHc6bQixg\n▶ホロライブ公式Twitter▷ https://twitter.com/hololivetv\n▶ホロライブ公式サイト▷ https://www.hololive.tv/"
}
},
"statistics": {
"viewCount": "51230",
"likeCount": "5103",
"dislikeCount": "27",
"favoriteCount": "0",
"commentCount": "0"
},
"liveStreamingDetails": {
"actualStartTime": "2020-09-22T01:01:29.625000Z",
"scheduledStartTime": "2020-09-22T01:00:00Z",
"concurrentViewers": "6054",
"activeLiveChatId": "Cg0KC3ZsdWdrajMzSDVnKicKGFVDdnpHbFA5b1F3VS0tWTByOWlkX2puQRILdmx1Z2tqMzNINWc"
}
}
],
"pageInfo": {
"totalResults": 1,
"resultsPerPage": 1
}
}
使用クォータ(Quota)数
- channels = 1
- search = 100
- videos = 1