GET (/users/xuid({xuid})/scids/{scid}/stats/{statname)/people/{all|favorite})
現在のユーザーの既知のすべての連絡先、またはそのユーザーが「お気に入り」として指定した連絡先のみの統計値 (スコア) をランク付けして、ソーシャル ランキングを返します。 これらの URI のドメインはleaderboards.xboxlive.com です。
- 備考
- URI パラメーター
- クエリ文字列パラメーター
- 認可
- 必須リクエスト ヘッダー
- 任意のリクエスト ヘッダー
- リクエスト本文
- HTTP ステータス コード
- 必須レスポンス ヘッダー
- 任意のレスポンス ヘッダー
- レスポンス本文
備考
ランキング API はすべて読み取り専用であるため、(HTTPS 経由の) GET 動詞のみをサポートします。これらは、Player Data システム経由で書き込まれた個々のユーザー統計から派生した、インデックス付きプレイヤー統計のランク付きかつソート済みの「ページ」を反映します。ランキングのインデックス全体はかなり大きくなる可能性があり、呼び出し元がその全体を要求することは決してありません。そのため、この URI は、呼び出し元がランキングに対してどのようなビューを取得したいかを具体的に指定できるように、複数のクエリ文字列引数をサポートしています。 GET 操作はリソースを変更しないため、1 回実行しても複数回実行しても同じ結果を生成します。URI パラメーター
クエリ文字列パラメーター
認可
XUID による認可が必要です。 コンテンツの分離とアクセス制御のシナリオに対して認可ロジックが実装されています。 ランキングとユーザー統計は、呼び出し元がリクエストに有効な XSTS トークンを提出する限り、任意のプラットフォームのクライアントから読み取ることができます。書き込みは当然、Player Data システムでサポートされているクライアントに限定されます。 タイトル開発者は パートナー センター で統計を open または restricted に指定できます。ランキングは open 統計です。Open 統計は、ユーザーがサンドボックスへのアクセスを認可されている限り、SmartGlass、iOS、Android、Windows、Windows Phone、Web アプリケーションからアクセスできます。ユーザーのサンドボックスへのアクセス認可は パートナー センター を通じて管理されます。必須リクエスト ヘッダー
任意のリクエスト ヘッダー
リクエスト本文
適切に表示するために、呼び出し元が受け取るデータを理解しやすくするため、各ユーザーの各統計値は、表示すべき形式の文字列として返され、リクエストの accept-language ヘッダーで指定されたロケールに合わせて書式設定されます。また、そのランキングの statname に対して、ローカライズされた「表示名」も返されます。必須メンバー
HTTP ステータス コード
サービスは、このリソースに対するこのメソッドでのリクエストに応じて、このセクション内のいずれかのステータス コードを返します。XBOX Live Services で使用される標準的な HTTP ステータス コードの完全な一覧については、標準 HTTP ステータス コード を参照してください。必須レスポンス ヘッダー
任意のレスポンス ヘッダー
レスポンス本文
ソーシャル ランキングのリクエスト (ページングなし):https://leaderboards.xboxlive.com/users/xuid(2533274916402282)/scids/c1ba92a9-0000-0000-0000-000000000000/stats/EnemyDefeats/people/all?sort=descending
