`Session.Unlink`

検証済み保護者リンクが解除されたときに発行されます。解除はどちらの側からでも行えます。プレイヤーはあなたのプロダクト内のPOST /session/unlink-parentから、保護者はFamily Connectから解除します。保護者による解除はあなたのAPIを経由しないため、このイベントがそれを知る唯一の手段です。

セッションが削除されるわけではありません。セッションはACTIVEのまま残り、プレイヤーの権限と送信済みデータも保持されます。取り除かれるのは保護者リンクだけ、つまりkuid、保護者のメールアドレス、そして保護者が設定したアローワンスとコントロールです。プレイヤーは同じsessionIdのまま利用を続けられ、あとで再び保護者を招待できます。

このイベントを購読してください

ウェブフックのエンドポイントが受け取れるのは、購読しているイベントタイプだけです。Compliance StudioのプロダクトのDeveloper Settingsページで、対象のエンドポイントにSession.Unlinkを選択してください。選択しない限り、k-IDは配信も試みずエラーも返さずにこのイベントを破棄します。この項目は、組織で検証済み保護者リンクが有効になっている場合にのみ一覧に表示されます。

配信とリカバリー

ウェブフックイベントは失敗時に最大2回再送されます。受信できなかった場合は、sessionIdを指定してGET /session/getを呼び出し、hasApproverEmailを確認してください。詳しくは配信、再試行、リカバリーを参照してください。

フィールド

フィールド	タイプ	必須	説明
`eventType`	string	はい	常に`"Session.Unlink"`
`data`	object	はい	リンク解除データ
`data.sessionId`	string (UUID)	はい	保護者リンクが解除されたセッション
`data.productId`	number	はい	プロダクトの`productId`
`data.unlinkedBy`	string	はい	どちらの側が解除したか。`player`または`parent`
`data.unlinkedAt`	string (RFC 3339)	はい	リンクが解除された時刻

`unlinkedBy`

値	意味
`player`	あなたのプロダクトのプレイヤー向け導線である`POST /session/unlink-parent`経由の解除。k-IDはリンクが解除されたことを保護者にメールでも通知します
`parent`	保護者がFamily Connectから解除した

例

player
parent

{
  "eventType": "Session.Unlink",
  "data": {
    "sessionId": "b1a6482d-5242-4b4a-aa88-3fa52595a672",
    "productId": 12345,
    "unlinkedBy": "player",
    "unlinkedAt": "2026-04-20T18:42:11Z"
  }
}

{
  "eventType": "Session.Unlink",
  "data": {
    "sessionId": "b1a6482d-5242-4b4a-aa88-3fa52595a672",
    "productId": 12345,
    "unlinkedBy": "parent",
    "unlinkedAt": "2026-07-23T06:13:07Z"
  }
}

イベントの処理

data.sessionIdを自分が保存しているプレイヤーレコードと突き合わせ、保護者が接続されている表示をやめてください。
保護者が設定していたコントロールの適用をやめてください。k-ID側でもクリアされるため、GET /screentime/get-stateはそのスケジュールを返さなくなります。
セッションはそのまま保持してください。プレイヤーを年齢ゲートに戻す必要はなく、利用データもこれまでどおり送信し続けてください。
ハンドラーは冪等にしてください。配信は少なくとも1回のため、同じイベントが複数回届くことがあります。POST /session/unlink-parentを再度呼び出しても2つ目のイベントは発行されず、元のunlinkedAtが返るだけです。

フィールド​

unlinkedBy​

例​

イベントの処理​

フィールド

`unlinkedBy`

例

イベントの処理