FAILステータスのWebhookイベントにageCategoryが含まれるようになりました
年齢データが利用可能な場合、Verification.Result WebhookイベントのFAILステータスイベントにageCategoryフィールドが含まれるように更新しました。
新機能
FAILステータスイベントでのageCategory
ageCategoryフィールドは、次の条件を満たす場合、Verification.Result WebhookイベントのFAILステータスに含まれるようになりました:
failureReasonがage-criteria-not-met- 年齢データが利用可能（
age.lowとage.highの両方が存在）
これにより、年齢基準を満たさないために検証が失敗した場合でも、ユーザーの年齢カテゴリに関するより完全な情報が提供され、明確なアクセス制御の境界を維持しながら、より優れた分析とログ記録が可能になります。
ドキュメントの更新
Verification.Resultドキュメントがこの変更を反映するように更新されました:
- フィールドテーブル: FAILステータスで
ageCategoryが存在するタイミングを明確にするために説明を更新 - 主な違いテーブル: WebhookイベントとAPIエンドポイントで
ageCategoryが存在するタイミングを明確化 - FAILステータスのフィールド存在ルール: 特定の条件で
ageCategoryを「場合によって含まれる」として表示するように更新 - 完全なフィールドマトリックス: WebhookのFAILステータスで
ageCategoryを「sometimes²」として表示するように更新 - ペイロードの例: 新しい動作を示すためにFAILステータスの例に
ageCategoryを追加 - 実装チェックリスト: FAILステータスで
ageCategoryを処理するためのガイダンスを更新 - 実装ノート: PASSとFAILの両方のステータスでの
ageCategoryの動作を明確化
重要な注意事項
- アクセス制御: FAILステータスイベントで
ageCategoryが存在する場合でも、アクセス制御の決定に決して使用しないでください。アクセスを決定するには、常にstatusフィールドを使用してください。 - 一貫性: この更新はWebhookイベントとAPIエンドポイントの応答の両方に適用されます
- 言語サポート: すべての言語バージョン（英語、日本語、簡体字中国語、韓国語）が更新されました
次のステップ
- 更新されたVerification.Resultドキュメントを確認してください
- 必要に応じて、FAILステータスイベントで
ageCategoryを処理するように統合を更新してください - 覚えておいてください: ステータスがFAILの場合、フィールドが存在する場合でも、アクセス制御に
ageCategoryを使用しないでください。分析、ログ記録、または情報提供の目的でのみ使用してください。