LisVir.holo 使用的 YouTube Data API 请求和响应样例
基本内容
以下是使用LisVir.holo实际进行的YouTube Data API请求和响应的示例。
获取频道信息
-
- リクエストURL
https://www.googleapis.com/youtube/v3/channels
パラメータ
key={APIキー}
part=snippet,statistics
id={チャンネルID}
公式ドキュメント
https://developers.google.com/youtube/v3/docs/channels
レスポンスのサンプル
{
"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
https://www.googleapis.com/youtube/v3/search
パラメータ
key={APIキー}
maxResults=50
part=snippet
eventType=live
type=video
q=ホロライブ|hololive (←実際はURLエンコードした値)
備考
最大件数の1ページのみの取得としている。
取得後に内部で保管しているチャンネルIDで絞り対象の動画情報のみを取り込んでいる。
公式ドキュメント
https://developers.google.com/youtube/v3/docs/search
レスポンスのサンプル(抜粋)
{
"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
https://www.googleapis.com/youtube/v3/videos
パラメータ
key={APIキー}
part=snippet,statistics,liveStreamingDetails
id={動画ID}
公式ドキュメント
https://developers.google.com/youtube/v3/docs/videos
レスポンスのサンプル(抜粋)
{
"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
}
}
使用配额数
-
- 频道 = 1
-
- 搜索 = 100
- 视频 = 1
