セッションの完了したスクリーンタイム使用区間の送信
POST/screentime/push
k-IDセッションについて、完了したスクリーンタイム使用区間を1つ以上送信します。各イベントは使用が始まった時刻とその継続時間を記録します。使用量が事後にしか分からない場合にこのエンドポイントを使用します。たとえば、区間をバッファして定期的にアップロードするバックエンドや、シャットダウン時にセッション合計を報告するゲームエンジンです。
受理された各区間のdurationSecondsは、プレイヤーの1日のスクリーンタイム合計に加算されます。区間が親の設定したタイムゾーンで深夜をまたぐ場合は両方の日付に分割され、各日の合計がその日に実際に発生した使用量を反映します。
イベントは個別に処理されます。レスポンスにはイベントごとのステータスが含まれます。
accepted- 区間が記録され、1日の合計に加算されました。すでに受理されたidのイベントを再送信しても安全な無操作です。再びacceptedとして数えられ、二重に加算されないため、ネットワーク障害後の再試行で二重計上されることはありません。rejected- 区間が検証に失敗しました。reasonがどのルールに該当するかを示します。
セッションが存在しないか失効している場合は、バッチ全体が拒否されます。
リアルタイムの制限シグナル（Screentime.LimitWarning、Screentime.LimitReached、Screentime.BreakReminder）はこのエンドポイントからは発火しません。しきい値を超えた瞬間にこれらのWebhookを発火させる必要がある統合では、/screentime/startと/screentime/endを使用してください。
Request
Responses
- 200
- 400
バッチを処理しました。イベントごとのステータスが受理状況を示します。
無効なリクエスト。レスポンスボディのerrorフィールドに具体的なコード（NOT_FOUND、INVALID_INPUT、FEATURE_DISABLEDなど）が含まれます。