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 のほうは公式と実測が一致していたので、信頼度が高そうですね。
- はう
- 日次の自動化スクリプトを設定するときは、こういった実測の記録が参考になると思います。