Youtube Data API(v3) で言語を指定して動画情報を取得したい

Question

前提・実現したいこと

初めての質問なのでわかりにくいところがあるかもしれません。

Youtube Data API(v3)を使って多言語対応の動画の場合、日本語以外の動画情報（タイトルや説明文など）を取得したいです。

通常だと日本語表示ですが、ユーザの言語や国によってタイトル等が英語に切り替わる設定がされた動画があります。
その英語版の動画情報を取得したいのですが、現状日本語の方しか取得できていない状況です。

https://www.googleapis.com/youtube/v3/videos?id=[動画のid]&key=[api key]&part=snippet,contentDetails,statistics,status

試したこと

youtubeの方で英語表記にしてから取得する→動画Idは同じなので変化なし
言語指定に関係しそうなパラメーター?をapiに追加する（&regionCode=US, &gl=US, &hl=enなど）
→いくつか組み合わせたりしましたが変化なし

何度か調べてみましたが解決方法が見つからず困っています。他にも言語を指定する方法があるのでしょうか？

Answer 1

以下の 2 通りの方法があるかと存じます。

a) hl パラメータを使用する

Videos: list メソッドのパラメータ一覧 に記載が御座いますが、 hl パラメータで "ja" や "en" 等の適切な言語コードを渡した場合、その言語にローカライズされた結果を snippet.localized プロパティとして受け取ることが可能 です。

御質問の内容では、 hl パラメータを指定しても機能しなかったとの事ですが、 snippet.title プロパティ等を御覧になってはおりませんでしょうか。こちらは デフォルトの言語向けの値であり、 hl パラメータを指定しても変化することは御座いません 。

b) localizations プロパティを要求する

この video リソースのプロパティ一覧 に記載のある通り、各動画は snippet とは別に、 各言語向けのローカライズデータを localizations という独立したプロパティで持ってます 。

ですから、この localizations プロパティを明示的に part パラメータに含めて要求 すれば、設定されているローカライズデータをまとめて取得することが可能です。

余談

尚、上記どちらの内容も、現時点では 日本語訳版のドキュメントには一切の記載がありません でした。未翻訳であれば原文がそのまま記載されるように思うので、もしかすると内容が古いのかもしれません。

何れにせよ、「こういった機能の説明が無いのはおかしい」「この部分がどうしても事実と合わない」といった場合は、原文の (多くの場合は英語版の) ドキュメントを御参照頂くのが宜しいかと存じます。もし今後も YouTube API について似通った状況に遭遇した場合には御検討下さい。

Comments

[nishiym]

無事取得出来ました！ありがとうございます！
localizationsというものがあるのですね
英語版の方は詳しく見ていなかったので気づきませんでした・・・

丁寧な回答ありがとうございます