Skip to main content

POST (/users//permission/validate)

ユーザーが対象ユーザーのセットに対して指定されたアクションを実行できるかどうかを、yes または no の回答セットで取得します。

備考

リクエスト本文にはユーザーのリストと設定のリストを指定し、その結果は各ユーザー/設定のペアに対する allowed/blocked の結果です。 クロス ネットワーク マルチプレイヤー シナリオ (XBOX User ID (XUID) を持つユーザーと XUID を持たないネットワーク外のユーザー間でプライバシー コミュニケーション チェックを実行する必要がある場合) では、User タイプについて「PermissionCheckBatchRequest (JSON)」を参照してください。

URI パラメーター

認可

使用される認可クレーム | Claim| Type| Required?| Example value| | --- | --- | --- | --- | --- | --- | --- | | Xuid| 64-bit signed integer| yes| 1234567890|

必須リクエスト ヘッダー

| Header| Type| Description| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | Authorization| string| HTTP 認証用の認証資格情報。値の例: XBL3.0 x=<userhash>;<token>| | X-RequestedServiceVersion| string| リクエストのルーティング先となる XBOX LIVE サービスのビルド名/番号。ヘッダーの有効性、認証トークン内のクレームなどを検証した後にのみ、リクエストはそのサービスにルーティングされます。値の例: 1。|

リクエスト本文

必須メンバー

「PermissionCheckBatchRequest (JSON)」を参照してください。

HTTP ステータス コード

このリソースに対して、このメソッドで行われたリクエストに応じて、サービスはこのセクションのステータス コードのいずれかを返します。XBOX Live Services で使用される標準の HTTP ステータス コードの完全な一覧については、「標準 HTTP ステータス コード」を参照してください。 | Code| Reason phrase| Description| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 200| OK| セッションが正常に取得されました。| | 400| リクエストが無効です。| 例: 不正な設定 ID、不正な URI など。| | 404| URI で指定されたユーザーは存在しません。| 指定されたリソースが見つかりませんでした。|

必須レスポンス ヘッダー

| Header| Type| Description| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | Content-Type| string| リクエスト本文の MIME タイプ。値の例: application/json| | Content-Length| string| レスポンスで送信されるバイト数。値の例: 34| | Cache-Control| string| キャッシュ動作を指定するサーバーからの丁重な要求。例: no-cache, no-store|

レスポンス本文

「PermissionCheckBatchResponse (JSON)」を参照してください。

レスポンス例

関連項目

親
/users//permission/validate PermissionId 列挙型
Last modified on October 19, 2026