保護者管理セッション権限を更新する
セッションのうち、保護者が管理できる権限を更新します。 プロダクトが保護者に公開していない権限は、エラーにはならず無視されます。そのため、リクエストで指定した権限より少ない数だけが変更される場合があります。レスポンスは更新後の権限セットです。リクエストがそのまま適用されたと想定せず、レスポンスを確認してください。
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/session/set-guardian-managed-permissions" \ -H "Content-Type: application/json" \ -d '{ "sessionId": "b1a6482d-5242-4b4a-aa88-3fa52595a672", "enabledPermissions": [ "text-chat-public", "text-chat-private" ] }'{ "status": "PASS", "session": { "sessionId": "b1a6482d-5242-4b4a-aa88-3fa52595a672", "permissions": [ { "name": "text-chat-public", "enabled": false, "managedBy": "GUARDIAN" } ] }}{ "error": "NOT_FOUND", "errorMessage": "Session not found"}セッションを取得する GET
`sessionId`、またはプロダクトとあわせた `kuid` で指定した、既存のセッションを返します。 `etag` を指定すると条件付き取得になります。そのetagの発行後に変更があった場合のみセッションが返され、変更がない場合は `NOT_MODIFIED` が返されます。セッション全体を取得し直すのではなく、etagを使ってポーリングしてください。 `ACTIVE` はプレイヤーがプロダクトの要件を満たしていることを意味し、レスポンスには現在有効な権限が含まれます。 etagはレスポンス全体を対象としており、プロダクトと管轄区域の設定から導出される `permissions`、`ageStatus`、`ageCategory` も含みます。そのため、セッション自体が更新されていなくても、設定を変更するとetagは変わります。
セッションから保護者の連携を解除する POST
`/invite-parent` フローで以前に連携されたプレイヤーセッションから、保護者の連携を解除します。 成功すると、セッション上の保護者が設定した設定値はすべて消去され、`Session.Unlink` Webhookが発火します。権限と既存のプレイヤーデータはそのまま維持されます。 このAPIは `sessionId` に対して冪等です。連携がすでに解除された後に再度呼び出した場合は、元の `unlinkedAt` とともに200を返します。