スクリーンタイムを終了する
`/screentime/start` で開始したアクティブなスクリーンタイムを終了します。その時間は当日のスクリーンタイム利用時間に加算され、現地の深夜0時をまたぐ場合はスケジュールのタイムゾーンに従って日付ごとに分割されます。 ステータスの意味: * `accepted` - `id` に一致するスクリーンタイムが終了したか、すでに終了済みのスクリーンタイムに対する再試行が冪等に処理されました。 `sessionId` に対してアクティブなスクリーンタイムが存在しない場合、またはこのリクエストの `id` がアクティブなスクリーンタイムを開始した `id` と一致しない場合は、`NOT_FOUND` コードが返されます。
Authorization
api-key In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
curl -X POST "https://example.com/screentime/end" \ -H "Content-Type: application/json" \ -d '{ "sessionId": "b1a6482d-5242-4b4a-aa88-3fa52595a672", "id": "3f8c1d24-6b5e-4a07-9c2f-8d1e7a4b6c90", "timestamp": "2026-06-24T16:30:00Z" }'{ "sessionId": "b1a6482d-5242-4b4a-aa88-3fa52595a672", "id": "3f8c1d24-6b5e-4a07-9c2f-8d1e7a4b6c90", "status": "accepted", "screentime": { "counter": { "timeUsedTodayMinutes": 75, "timeLimitTodayMinutes": 120, "timeRemainingTodayMinutes": 45, "dayResetsAt": "2026-06-25T00:00:00Z" } }}{ "error": "INVALID_INPUT", "errorMessage": "The request was missing a sessionId parameter."}セッションのアクティビティ記録を送信する POST
プロダクトで宣言したアクティビティタイプに対して、アクティビティ記録をまとめて送信します。記録は1件ごとに検証され、レスポンスには記録ごとのステータス（`accepted`、または理由付きの `rejected`）が含まれます。すでに受理済みの `id` を持つ記録を再送しても安全な無操作となり、再び `accepted` として数えられ、二重に保存されることはありません。セッションが存在しない場合や無効化されている場合は、バッチ全体が拒否されます。
スクリーンタイムの状態を取得する GET
`sessionId` に対する現在のスクリーンタイムの状態を返します。保護者が設定したルール、当日の利用状況、そして現時点でプレイを許可してよいかどうかが含まれます。プラットフォームは、セッション開始時と、`Screentime.LimitWarning`、`Screentime.LimitReached`、`Screentime.QuietHoursWarning`、`Screentime.QuietHoursReached` のWebhookを受信した後に、保持している状態を更新するためにこのAPIを呼び出します。 保護者がそのセッションのスクリーンタイムを設定していない場合、または設定済みでも制限の適用を無効にしている場合は `{ "enabled": false }` を返します。