スクリーンタイムの延長リクエスト

POST 
/screentime/request-override

お子様が本日さらに時間を求める場合、またはアクティブな静かな時間を回避したい場合に、お子様に代わって延長リクエストを送信します。k-IDはリクエストを記録し、承認または拒否するよう親に通知します。お子様ごとに冪等です。同じお子様からの別のリクエストが保留中の間に呼び出すと、2つ目を作成せず、その保留中のリクエストをそのまま返します。

結果はstatus: "granted" | "denied" | "expired"を含む1件のScreentime.OverrideResult Webhookとして非同期に届きます。WebhookボディのstateはGET /screentime/get-stateと同じ形状を持つため、プラットフォームは追加の取得なしに保持している状態を直接更新できます。24時間以内に解決されなかったリクエストは、status: "expired"でWebhookを発火します。

Request

Responses

200

延長リクエストが受理されました。

400

無効なリクエスト。レスポンスボディのerrorフィールドに具体的なコード（INVALID_INPUT、NOT_FOUND、FEATURE_DISABLEDなど）が含まれます。