メインコンテンツに移動

年齢ゲート

年齢ゲートは、年齢制限のあるコンテンツ、機能、またはサービスへのアクセスを許可する前に、ユーザーの年齢を収集および確認するために使用されるメカニズムです。k-ID APIは、年齢ゲートを管理し、プレイヤーの年齢と管轄区域に基づいて必要なアクションを決定するエンドポイントを提供します。

カスタム年齢ゲートUIを構築していますか？

年齢スライダー、日付ピッカー、同意フロー、アクセシビリティに関するデザイン推奨事項については、UXガイドラインを参照してください。

年齢ゲート要件の取得​

プレイヤーの管轄区域で/age-gate/get-requirementsを呼び出して、以下を決定します：

  • 年齢ゲートを表示する必要があるかどうか（shouldDisplay）
  • 承認されている年齢収集方法（approvedAgeCollectionMethods）
  • 年齢閾値：
    • digitalConsentAge: プレイヤーがデジタル同意を提供できる最小年齢
    • civilAge: プレイヤーが法的成人と見なされる法的/契約年齢
    • minimumAge: プラットフォーム/ゲームにアクセスするために必要な最小年齢
  • 年齢保証が必要かどうか（ageAssuranceRequired）

リクエストの例​

GET /api/v1/age-gate/get-requirements?jurisdiction=US-CA
Authorization: Bearer your-api-key

レスポンスの例​

{
  "shouldDisplay": true,
  "ageAssuranceRequired": true,
  "digitalConsentAge": 13,
  "civilAge": 18,
  "minimumAge": 0,
  "approvedAgeCollectionMethods": [
    "date-of-birth",
    "age-slider",
    "platform-account"
  ]
}

アクセスのための年齢チェック​

プレイヤーの年齢を収集した後、生年月日と管轄区域で/age-gate/checkを呼び出して、次のステップを決定します：

  • PROHIBITED: プレイヤーの年齢がゲームの最小年齢未満です。プレイヤーは続行をブロックされる必要があります。
  • CHALLENGE: プレイヤーの年齢が検証可能な親の同意を必要とします。チャレンジが作成され、信頼できる大人によって承認される必要があります。
  • PASS: プレイヤーはゲームに続行できます。セッションが作成または返されます。

リクエストの例​

POST /api/v1/age-gate/check
Content-Type: application/json
Authorization: Bearer your-api-key

{
  "jurisdiction": "US-CA",
  "dateOfBirth": "2015-04-15"
}

CHALLENGEレスポンスの例​

{
  "status": "CHALLENGE",
  "challenge": {
    "challengeId": "683409f1-2930-4132-89ad-827462eed9af",
    "oneTimePassword": "ABC123",
    "type": "CHALLENGE_PARENTAL_CONSENT",
    "url": "https://family.k-id.com/authorize?otp=ABC123"
  }
}

PASSレスポンスの例​

{
  "status": "PASS",
  "session": {
    "sessionId": "608616da-4fd2-4742-82bf-ec1d4ffd8187",
    "ageStatus": "LEGAL_ADULT",
    "dateOfBirth": "2005-04-15",
    "jurisdiction": "US-CA",
    "permissions": [...],
    "status": "ACTIVE"
  }
}

プラットフォーム年齢カテゴリAPIの使用​

一部のプラットフォームは、特定の年齢や生年月日ではなく、年齢カテゴリを返すAPIを提供しています。たとえば、Meta HorizonはGetAgeCategory APIを提供しており、CH（子供、10-12歳）、TN（ティーン、13-17歳）、またはAD（成人、18歳以上）などのカテゴリを返します。

プラットフォームの年齢カテゴリAPIを使用する場合、カテゴリをプレイヤーの管轄区域の年齢範囲に変換し、その年齢範囲をk-IDの年齢ゲートシステムで使用する必要があります。

例：Meta HorizonのGetAgeCategory APIの使用​

以下は、Meta Horizonの年齢カテゴリAPIをk-IDと統合する方法の完全な例です：

  1. Meta Horizonから年齢カテゴリを取得
// Meta Horizon Unity SDKの例
var ageCategory = PlatformService.GetAgeCategory();
// 戻り値: "CH"（子供、10-12歳）、"TN"（ティーン、13-17歳）、または"AD"（成人、18歳以上）
  1. カテゴリを年齢範囲に変換
POST /api/v1/age-gate/get-platform-age-range
Content-Type: application/json
Authorization: Bearer your-api-key

{
  "jurisdiction": "US-CA",
  "platform": {
    "name": "meta-horizon",
    "category": "TN"
  }
}

レスポンス:

{
  "ageLow": 13,
  "ageHigh": 17
}
  1. 最低年齢を年齢ゲートチェックで使用

ageLow値（この例では13）をageパラメータとして使用して/age-gate/checkを呼び出します：

POST /api/v1/age-gate/check
Content-Type: application/json
Authorization: Bearer your-api-key

{
  "jurisdiction": "US-CA",
  "age": 13
}

これにより、プラットフォームの確認済み年齢カテゴリが、管轄区域固有の要件を維持しながら、k-IDの年齢ゲートシステムで使用できる特定の年齢値に適切に変換されます。

生年月日の形式​

生年月日の形式と要件の情報については、コアコンセプトセクションの年齢ゲートを参照してください。

デフォルト権限​

/age-gate/get-requirementsがshouldDisplay = falseで応答する場合、年齢ゲートを表示する必要はなく、プレイヤーの生年月日は定義されません。この場合、ゲームは/age-gate/get-default-permissionsを呼び出して管轄区域のデフォルト権限を取得することでSessionを作成します。これは、この管轄区域では年齢に基づいて権限が変わらないことを意味します。ゲーム内の一部の機能は、管轄区域に基づいてすべての年齢層に対して禁止される可能性があるため、ゲームは機能を有効にできるかどうかを確認するためにSession権限を参照する必要があります。