メインコンテンツに移動

Google Play Age Signals v0.0.4 の `ageRangeSource` に対応

k-IDは、Google Play Age Signals v0.0.4 の ageRangeSource の値を、google-play プラットフォーム年齢シグナルの declarationType として受け入れるようになりました。

新機能

  • google-play シグナルの ageRangeSource Google Play Age Signals v0.0.4 では、userStatusageRangeSource に置き換えられました。年齢ゲートおよびセッションのエンドポイントを呼び出す際は、Google Play age signals responsesageRangeSource の値を PlatformAgeSignaldeclarationType として指定してください。
  • 非推奨の userStatus の値も引き続き機能します。 k-IDは、従来のスキーマを使用するストアのために従来の userStatus の値を引き続き受け入れるため、まだ移行していないアプリからのシグナルにも影響はありません。

ドキュメント

メール年齢推定専用の年齢確認エンドポイント

メール年齢推定のみを方式として年齢確認を実行するための専用エンドポイント /age-verification/perform-email-age-estimation が追加されました。これは、既存の単一方式エンドポイント(ID、AgeKey、ConnectID)と並ぶものです。

新機能

  • POST /age-verification/perform-email-age-estimation 自動的な方式選択をバイパスし、メール年齢推定のみでユーザーを確認します。他の単一方式エンドポイントと同じリクエスト形式(jurisdictionsubjectcriteria、および任意の options.redirectUrl / options.locale)を受け取り、idurlshortUrl を返します。subject.email フィールドは任意です。省略した場合、ユーザーはホストされた確認ページでメールアドレスを入力します。
  • 18歳以上のシグナル。 メール年齢推定は、正確な年齢推定ではなく18歳以上のシグナルです。対象者が18歳以上であることのみを確認でき、それより若い年齢帯を区別することはできないため、リクエストの基準をこの能力に合わせることはお客様の責任です。
  • ステータスと結果は変更なし。 これまでどおり /age-verification/get-status をポーリングするか、Verification.Result webhook を処理してください。

ドキュメント

Apple iOSの「confirmed」年齢シグナルに対応

k-IDは、iOS 26.5以降のプレイヤーについて、Appleの confirmed 宣言タイプを確認済みのプラットフォーム年齢シグナルとして受け入れるようになりました。

新機能

  • confirmed は確認済みのApple宣言タイプです。 iOS 26.5以降、AppleのAge Range Serviceは selfDeclaredguardianDeclaredconfirmed のみを返します。confirmed は、クレジットカードや政府発行IDなど、精査された方法で年齢範囲が設定されたことを示します。k-IDは confirmed を確認済みとして扱うため、年齢ゲートの抑制、確認閾値の充足、および ageVerification の記録が可能です。
  • 非推奨のタイプも引き続き機能します。 Appleは paymentCheckedgovernmentIDCheckedguardianPaymentCheckedguardianGovernmentIDChecked を非推奨としました。k-IDは後方互換性のためこれらを引き続き受け入れるため、以前のiOSバージョンからのシグナルにも影響はありません。
  • selfDeclaredguardianDeclared は未確認のままです。 これらは年齢確認の要件をバイパスしません。

ドキュメント

ウィジェットと年齢確認に関するモバイル統合ガイダンス

モバイルでk-IDをどのように統合するのが最適かを明確にするため、ドキュメントを更新しました。年齢ゲートと同意ステップについては、ネイティブに構築したUXがプレイヤーに最もシームレスなエクスペリエンスを提供し、年齢確認URLや年齢保証URLなどのWeb埋め込みはシステムブラウザサーフェスを通じて表示されます。

新機能

年齢ゲートとエンドツーエンドウィジェットに関するモバイルガイダンス

年齢ゲートウィジェットとエンドツーエンドウィジェットは、モバイルで完全にサポートされています。年齢ゲートと同意ステップについては、最もブランドに統合されたエクスペリエンスを実現するために、カスタムワークフローを使用し、CDK UXガイドラインに従ってUXをネイティブに構築することを推奨します。

k-ID APIから返される年齢確認URLと年齢保証URLも同じ方法で表示されます。具体的なエンドポイントとチャレンジタイプについては、モバイルアプリガイドを参照してください。

モバイルアプリガイドの刷新

モバイルアプリガイドは、モバイルで最も一般的なWeb埋め込みである年齢確認を中心に再構成されました:

デフォルトブラウザ方法

モバイル実装方法として、デフォルトの外部ブラウザ方法が新たに文書化されました。これはAndroid(Intent.ACTION_VIEW)とiOS(UIApplication.open)の両方で機能し、AgeKeysを完全にサポートし、redirectUrlコールバックを通じてアプリにフォーカスを戻します。

デバイスの向きに関するガイダンス

年齢確認はポートレート(縦向き)で最も効果的に機能します。アプリ内ブラウザサーフェスはアプリの向きのロックを継承するため、横向きにロックされたアプリでは、確認URLをデフォルトの外部ブラウザで開いてください。ブラウザは独自の向きを管理するため、ユーザーはポートレートに回転でき、フロー完了時にはredirectUrlコールバックがアプリに戻します。

更新されたドキュメント

  • モバイルアプリ: 年齢確認を中心に再構成し、デフォルトブラウザとデバイスの向きのセクションを新設
  • CDK 埋め込みフロー: エンドツーエンドウィジェットと年齢ゲートウィジェットのモバイルでの表示ガイダンスを追加
  • CDK 概要: 統合アプローチの比較にモバイルガイダンスを追加
  • CDK カスタムワークフロー: カスタムワークフローがモバイルアプリに推奨されるアプローチである旨を記載
  • 検証可能な保護者の同意(VPC): このウィジェットベースのガイドのモバイルでの利用に関する注記を追加

次のステップ

  • モバイルで統合する場合は、最もシームレスなエクスペリエンスを実現するために、カスタムワークフローCDK UXガイドラインを使用して、年齢ゲートと同意のUXをネイティブに構築することを検討してください
  • 確認URLを表示する際、横向きロックされたアプリにはデフォルトブラウザ方法を使用してください

Permanently erase a session with a new flag on /session/delete

/session/delete can now permanently erase a session instead of only revoking it.

What's new

  • hardDelete on POST /session/delete. Set to true to permanently delete a player session and its embedded consent, scoped to the calling product. Unlike the default revoke (which is internally retained), this physically removes the record and can't be undone.
  • Opt-in per developer. Available only to developers explicitly enabled for hard delete. Setting hardDelete: true without enablement returns FEATURE_DISABLED.
  • Every existing call is unaffected. Omitting hardDelete, or setting it to false, behaves exactly as /session/delete always has: a reversible revoke.
  • In-flight challenges are failed too. Any pending challenge tied to that exact session is set to FAIL, scoped to that session only (other sessions for the same player are untouched).

Documentation

クレジットカード専用の年齢確認エンドポイント

クレジットカードのみを方式として年齢確認を実行するための専用エンドポイント /age-verification/perform-credit-card-verification が追加されました。これは、既存の単一方式エンドポイント(ID、AgeKey、ConnectID)と並ぶものです。

新機能

  • POST /age-verification/perform-credit-card-verification 自動的な方式選択をバイパスし、クレジットカードのみでユーザーを確認します。他の単一方式エンドポイントと同じリクエスト形式(jurisdictionsubjectcriteria、および任意の options.redirectUrl / options.locale)を受け取り、idurlshortUrl を返します。
  • 成人(18歳以上)の保証。 クレジットカード確認は、正確な年齢推定ではなく成人であることの保証シグナルです。カードの所有が成人に限定されている法域に最も適しています。
  • ステータスと結果は変更なし。 これまでどおり /age-verification/get-status をポーリングするか、Verification.Result webhook を処理してください。結果は確認 method として credit-card を報告します。

ドキュメント

自動年齢保証フロー向けのリダイレクトURL

/age-gate/check が、自動年齢保証チャレンジの完了後にk-IDが遷移するリダイレクトURLを受け入れるようになりました。これは、iframeベースの結果ハンドラーを使用できないトップレベルのブラウザハンドオフ(k-IDへ遷移して戻るモバイルwebviewなど)を想定したものです。

新機能

  • options.playerAgeAssurance.redirectUrl /age-gate/checkhttp(s) URLまたはカスタムスキームのモバイルディープリンク(例:myapp://age-gate/return)を渡します。プレイヤーが CHALLENGE_AGE_GATE_AGE_ASSURANCE フローを完了または閉じると、k-IDはそのURLに challengeIdproductIdsessionIdPASS の場合)、statusPASS または FAIL)をクエリパラメータとして付加してリダイレクトします。URL上の既存のクエリパラメータは保持されます。
  • スコープ。 このオプションは CHALLENGE_AGE_GATE_AGE_ASSURANCE に対してのみ有効です。CHALLENGE_PARENTAL_CONSENT は影響を受けず、引き続き信頼できる大人のフローを通じて返されます。
  • 結果はサーバー側で確認してください。 リダイレクトのクエリパラメータはUXのヒントです。アクセスを許可する前に、Challenge.StateChange webhook または /challenge/get-status を信頼できる情報源として扱ってください。

ドキュメント

AIコーディングエージェント向け公式 k-ID Agent Skills バンドル

k-IDは、Agent Skillsの公式バンドルを公開しました — k-IDがサポートするすべての法域要件(米国のCOPPA、EUのGDPR-Kids、英国AADC、英国オンライン安全法、ブラジルECA Digital、オーストラリアのオンライン安全法 / ソーシャルメディア最低年齢など)に対して、AIコーディングエージェントにk-IDを正しく統合する方法を教える、小さく組み合わせ可能な命令パックです。Claude Code、Cursor、OpenAI Codex、GitHub Copilot、Gemini CLIをはじめ、35以上のAIコーディングツールで動作します。

新機能

  • 8つの焦点を絞ったスキルがk-ID統合の全領域をカバーします:年齢ゲート、親の同意、年齢確認および年齢保証(高リスク権限向けのverifiedAgeThresholdフローを含む)、セッションと権限、webhook、さらにサーバ信頼境界とモバイル/ネイティブの横断的補助スキル。
  • 設計上、法域横断的。同じスキルでCOPPA、GDPR-Kids、英国AADC、英国OSA、ブラジルECA Digital、オーストラリアのオンライン安全法への統合を実現します — 法域ごとの挙動はクライアントコードで分岐させるのではなく、Compliance Studioでサーバ側から構成されます。
  • ワンコマンドインストール:Claude Codeではプラグインマーケットプレイスから、その他の互換ツールではワンラインのgit cloneで導入できます。
  • オープンな標準 — スキルはAgent Skills仕様に準拠し、特定のベンダーに依存せず任意の互換エージェントで動作します。
  • ドキュメント優先の契約 — スキルは統合パターンと既知の落とし穴をエンコードし、APIの形式についてはこのドキュメントサイトにリンクするため、APIと不整合になることがありません。

試す

詳しく見る

AIプロダクトクイックスタートガイド

AI特化型プロダクト向けの新しいクイックスタートガイドが追加され、Compliance StudioのリファレンスにAI権限カテゴリも掲載されました。

新機能

  • AIプロダクトクイックスタート。 AIプロダクトのエンドツーエンド統合手順を説明します:Compliance StudioでのAI権限の設定、保護者の同意の収集、AI機能の制御、権限変更への対応。
  • AI権限カテゴリ。 権限リファレンスにAIカテゴリと7つの権限が掲載されました:ai-chatai-media-generationai-voice-modeai-memoryai-companion-chatbotai-media-uploadai-model-training

ドキュメント

レート制限のドキュメント

k-ID APIおよびユーザー向けの年齢確認・保護者同意フローのデフォルトレート制限を、専用ページに掲載しました。

新機能

  • APIレート制限。 k-ID APIへの呼び出しはプロダクト単位で制限されます:ライブモードでは500 RPS、テストモードでは10 RPS。制限を超えたリクエストはHTTP 429 Too Many Requestsを返します。
  • 年齢確認および保護者同意フローのレート制限。 ユーザー向けフローはプロダクト単位で制限されます:ライブモードでは100 RPS、テストモードでは20 RPS。制限に達すると、ユーザーには「しばらく待ってから再試行してください」というインフロー上のエラーが表示されます(429はサーバーには通知されません)。
  • 引き上げのリクエスト。 これらはデフォルトです。プロダクトでより高い容量が必要な場合は、k-IDの担当者にご連絡ください。
  • ローンチ前チェックリストを更新。 ライブモードの上限値はテストモードと比べて大幅に高くなるため、CDKおよびAgeKit+のローンチ前チェックリストの両方で、レート制限を明示的に取り上げ、新しいページへリンクするようにしました。

ドキュメント