はじめに

YouTubeDataAPIのVideos::listを使って特定のアーカイブの配信開始日時を取得しようとしたところ、想定と違う値（配信開始日時の前日）が取れてしまいました。
これまでにも想定と違う値が取れるケースがたまにあったため、改めて配信開始日時の取得方法を調べました。

前提

APIキーの取得など、APIを使う準備ができていること。

liveStreamingDetails.actualStartTimeを取得する。

snippet.publishedAtを取得する。

parameter

"part": "snippet"
"fields": "snippet/publishedAt"

上記の場合、配信枠を取った日時が取得されてしまいます。
時間を空けて再度実行すると日時が配信終了の数時間後になっていることも確認したので、配信終了後にエンコードが完了した場合にも更新されるのかもしれません。

liveStreamingDetails.actualStartTimeを取得する。

parameter

"part": "liveStreamingDetails"
"fields": "liveStreamingDetails/actualStartTime"

上記の場合、配信開始日時が取得されます。
liveStreamingDetailsの子要素には他にも便利な情報が格納されています。

今回調べてわかったことですが、公式ドキュメントでも日本語は英語に比べてかなり情報が古いです。
試しにそれぞれのページに記載されているvideosリソースの表現をWinMergeで比較してみた画像を以下に掲載します。
（左：日本語ページ　右：英語ページ）

正直なところ、誤訳程度ならともかくここまで違いがあるとは思ってもみませんでした。
公式ドキュメントでも油断せず原典をあたるようにしようと改めて思いました。