Apple Sales Reports APIのデータ反映時刻とYouTube APIのクォータリセットを実測した

App Store Connect Sales Reports APIの日次レポート反映時刻とYouTube Data API v3のクォータリセット時刻を実際に観測した記録です。

appstoreconnectapiyoutubepythonautomation

台本(フルテキスト)

動画の掛け合いを書き起こしたものです。音声を再生しづらい場合はこちらをお読みください。

オープニング

  • Apple Sales Reports API と YouTube API のタイミング実測
  • 日本時間を基準にスケジューリングを最適化
はう
こんにちは。今日は外部 API のデータ反映時刻とクォータリセット時刻を実際に観測した記録を紹介します。
めたん
外部 API を自動化するとき、データがいつ取れるかって重要ですよね。
はう
そうです。対象は Apple の App Store Connect Sales Reports API と YouTube Data API v3 の二つです。
めたん
それぞれ何を知りたかったんですか?
はう
App Store Connect は前日のデータがいつ取れるようになるか、YouTube はクォータがいつリセットされるかです。
めたん
公式ドキュメントに記載があっても、実態と違うことがありますよね。

App Store Connect の公式記載

  • 公式: 翌日 8:00 AM PT まで
  • ドキュメントの by 8:00 AM は上限の意味
めたん
App Store Connect の日次売上レポートについて、公式ドキュメントにはどう書いてあるんですか?
はう
翌日の太平洋時間 午前8時まで、つまり by 8:00 AM Pacific Time に利用可能になると記載されています。
めたん
日本時間だと何時になりますか?
はう
太平洋時間の午前8時は、日本時間の翌日午前1時になります。サマータイム時は少し変わりますが。
めたん
by という表現は、その時刻までに利用可能になるという意味ですね。
はう
そうです。上限として8時を指定しているだけで、早まる可能性があるわけです。実際に観測してみることにしました。

App Store Connect の実測結果

  • 1時間ごとに取得可能か確認
  • 21:09 JST(5:09 AM PT)に利用可能に
めたん
実際にどうやって観測したんですか?
はう
2026年3月22日に、前日分のデータを1時間ごとに取得できるか確認しました。
めたん
何時頃から取れるようになりましたか?
はう
日本時間の16時から確認し始めて、21時9分に取得可能になりました。太平洋時間だと午前5時9分です。
めたん
公式に書かれた8時より3時間も早かったんですね。
はう
ただ、これは1日分の観測です。日によって変わる可能性があるので、安全にスケジューリングするなら日本時間の翌1時以降が無難です。

YouTube Data API のクォータリセット

  • 公式: 太平洋時間 0:00(日本時間 16:00〜17:00)にリセット
  • 実測で公式記載と一致
めたん
YouTube Data API のクォータリセットはどうでしたか?
はう
公式ドキュメントでは、太平洋時間の午前0時にリセットされると記載されています。
めたん
日本時間だと何時になりますか?
はう
標準時で日本時間の16時、夏時間時は17時になります。
めたん
実測では合っていましたか?
はう
はい。日本時間の16時から17時頃にリセットされることを確認しました。こちらは公式の記載と一致しています。

まとめと実用的なスケジューリング

  • App Store Connect: 21時以降(安全には翌1時以降)
  • YouTube API: 16時以降にクォータ回復
めたん
日本時間を基準にまとめるとどうなりますか?
はう
App Store Connect のデータ取得は21時以降、YouTube API のクォータリセット後の処理は16時以降です。
めたん
App Store Connect は今回の観測が1日分だけなので、注意が必要ですね。
はう
そうです。安全にスケジューリングするなら、公式の8時 PT を考慮して翌1時以降に設定するのが一つの選択肢です。
めたん
YouTube のほうは公式と実測が一致していたので、信頼度が高そうですね。
はう
日次の自動化スクリプトを設定するときは、こういった実測の記録が参考になると思います。