メインコンテンツに移動

4件の投稿件のタグ「api」を含む

すべてのタグを見る

Account System Product

Account System Product をリリースしました。組織の中央アカウントまたはプラットフォームプロダクトが、1 つの API キーとオプションのヘッダーを使用して、組織内の他のプロダクトに代わって認証チャレンジとセッションを作成できる機能です。

新機能​

Account System Product​

Compliance Studio でプロダクトを Account System Product として有効にすると、Kid-Target-Product-Id ヘッダーにターゲットプロダクトの ID を付けて、同じ組織内の他の（Account System Product 以外の）プロダクトに代わって特定の k-ID API を呼び出せます。Account System Product の API キーを使用するため、ターゲットごとのキー管理やローテーションは不要です。

対応エンドポイント:

保護者はターゲットプロダクトの設定（通知、権限、ブランディング）のみを確認します。Account System Product とターゲットプロダクトの両方に、各イベントの Webhook が送信され、onBehalfOfProductId と initiatedByProductId でクロスプロダクトのフローを識別できます。

Account System Product は マルチプロダクト承認 と連携します。Account System Product をターゲットの必須プロダクトに設定すると、保護者が 1 回のフローで両方を承認できます。

ドキュメント​

追加の法的リンクと Check age gate の options

追加の法的リンク（Developer Details）と Check age gate API の options パラメータについてドキュメントを追加しました。同意フローでプラットフォーム別の法的文書（Xbox、PlayStation、Steam など）を表示できるようになります。

新機能​

追加の法的リンク（Developer Details）​

Compliance Studio のプロダクト 開発者の詳細 タブで、同意フローに表示される任意の 追加の法的リンク を追加できます。

  • タイトルとリンク: ローカライズされた表示タイトルと URL（メインの法的文書と同じ言語オプション）。
  • バリアント ID: Check age gate API 呼び出し時に使用する識別子（例: xbox-tos、playstation-privacy-policy）。常に表示がオフの場合は必須です。
  • 常に表示: オン（デフォルト）の場合、同意フローで常にリンクが表示されます。オフの場合、ゲームが options で一致するバリアント ID を指定して年齢ゲート API を呼び出したときのみ表示されます。

ゲームが複数プラットフォームで配信され、プラットフォームごとに異なる法的文書 URL が必要な場合にご利用ください。

Check age gate API — options パラメータ​

POST /api/v1/age-gate/check のリクエストボディで、任意の options オブジェクトを指定できます。

  • termsOfServiceDocument: 利用規約のバリアント ID（設定した追加の法的リンクと一致すること）。
  • privacyPolicyDocument: プライバシーポリシーのバリアント ID（設定した追加の法的リンクと一致すること）。

チャレンジが作成されると、同意画面ではプロダクトのデフォルトのプライバシーポリシー・利用規約ではなく、リクエストされた法的リンクが表示されます。

ドキュメント​

Age Gate Widget Redirect URL サポート

Age Gate WidgetエンドポイントにredirectUrlをオプションパラメータとして追加しました。

新機能​

Age Gate Widget API の更新​

/widget/generate-age-gate-urlエンドポイントは、optionsオブジェクト内にオプションのredirectUrlパラメータをサポートするようになりました。これにより、Age Gate Widget完了後にリダイレクトするURLを指定できます。これは、エンドツーエンドウィジェットエンドポイントと同様です。

redirectUrlパラメータは、HTTP/HTTPS URLまたはカスタムプロトコルスキームを使用したモバイルディープリンクをサポートします。

更新されたAPI​

Widget.ExitReviewの明確化とAPIの更新

年齢確認とVPCフローのウィジェットUIをいつ閉じるかを明確にし、MegaWidgetOptionsスキーマにredirectUrlサポートを追加しました。

新機能​

Widget.ExitReviewの明確化​

年齢確認とVPCフローのUIをいつ閉じるかを判断するシグナルとして、Widget.ExitReviewを使用することを明確にするためにドキュメントを更新しました。

更新されたドキュメント:

  • 年齢確認ガイド - 確認UIを閉じるためにWidget.ExitReviewをリッスンするガイダンスを追加
  • VPCガイド - VPCウィジェットUIを閉じるためにWidget.ExitReviewをリッスンするガイダンスを追加
  • CDK埋め込みフロー - ウィジェットUIを閉じるためにWidget.ExitReviewをリッスンするガイダンスを追加

すべての言語バージョン（英語、日本語、簡体字中国語、韓国語）がこの明確化で更新されました。

APIの更新​

MegaWidgetOptionsでのredirectUrl​

MegaWidgetOptionsスキーマに、年齢確認リクエストスキーマと一貫性のあるredirectUrlサポートが含まれるようになりました。これにより、エンドツーエンドウィジェットを使用する際にリダイレクトURLを指定できます。

更新されたスキーマ:

  • MegaWidgetOptionsに#/components/schemas/RedirectUrlへの参照を持つredirectUrlフィールドが含まれるようになりました

この変更は、すべてのOpenAPI仕様ファイル（英語、日本語、簡体字中国語、韓国語）で利用できます。

ドキュメントの改善​

プロダクト画像の仕様​

Compliance Studioのプロダクト画像の推奨アスペクト比と解像度を追加しました:

  • ロゴ: 1:1（正方形）、512×512px
  • バナー: 3:1（横長）、2430×810px