スクリーンタイムの状態を取得する

`sessionId` に対する現在のスクリーンタイムの状態を返します。保護者が設定したルール、当日の利用状況、そして現時点でプレイを許可してよいかどうかが含まれます。プラットフォームは、セッション開始時と、`Screentime.LimitWarning`、`Screentime.LimitReached`、`Screentime.QuietHoursWarning`、`Screentime.QuietHoursReached` のWebhookを受信した後に、保持している状態を更新するためにこのAPIを呼び出します。保護者がそのセッションのスクリーンタイムを設定していない場合、または設定済みでも制限の適用を無効にしている場合は `{ "enabled": false }` を返します。

Authorization

api-key

AuthorizationBearer <token>

In: header

Query Parameters

sessionId*string

Formatuuid

Response Body

`application/json`

curl -X GET "https://example.com/screentime/get-state?sessionId=497f6eca-6276-4993-bfeb-53cbbbba6f08"

{  "enabled": true,  "access": {    "allowed": true  },  "state": {    "timeUsedTodayMinutes": 75,    "continuousUsageMinutes": 30,    "timeLimitTodayMinutes": 120,    "timeRemainingTodayMinutes": 45,    "dayResetsAt": "2026-06-25T00:00:00Z"  },  "schedule": {    "timezone": "UTC",    "breakReminderIntervalMinutes": 45,    "dailyLimits": [      {        "day": "mon",        "limitMinutes": 120      },      {        "day": "tue",        "limitMinutes": 120      },      {        "day": "wed",        "limitMinutes": 120      },      {        "day": "thu",        "limitMinutes": 120      },      {        "day": "fri",        "limitMinutes": 120      },      {        "day": "sat",        "limitMinutes": 180      },      {        "day": "sun",        "limitMinutes": 180      }    ],    "quietHours": [      {        "name": "Bedtime",        "days": [          "mon",          "tue",          "wed",          "thu",          "fri"        ],        "start": "21:00",        "end": "07:00"      }    ]  }}

{  "error": "INVALID_INPUT",  "errorMessage": "The request was missing a sessionId parameter."}

スクリーンタイムの状態を取得する

Authorization

Query Parameters

Response Body

200application/json

400application/json

`application/json`

`application/json`