メインコンテンツへスキップ

GET (/users/xuid()/groups/ )

グループの PresenceRecord を取得します。 これらの URI のドメインは userpresence.xboxlive.com です。

備考

URI 内のユーザーに関連するモニカーで指定されたグループ内のユーザーを取得し、それらのユーザーの PresenceRecord を返します。プライバシーまたはコンテンツ分離によって制御されているデータは、単に返されません。

URI パラメーター

クエリ文字列パラメーター

| Parameter| Type| Description| | --- | --- | --- | --- | --- | --- | | level| string| このクエリ文字列で指定された詳細レベルを返します。有効なオプションは、“user”、“device”、“title”、および “all” です。レベル “user” は、DeviceRecord のネストされたオブジェクトを含まない PresenceRecord オブジェクトです。レベル “device” は、TitleRecord のネストされたオブジェクトを含まない PresenceRecord および DeviceRecord オブジェクトです。レベル “title” は、ActivityRecord のネストされたオブジェクトを含まない PresenceRecord、DeviceRecord、および TitleRecord オブジェクトです。レベル “all” は、すべてのネストされたオブジェクトを含む完全なレコードです。このパラメーターが指定されない場合、サービスは既定でタイトル レベル (つまり、タイトルの詳細までこのユーザーのプレゼンスを返す) になります。|

認可

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

プライバシー設定がリソースに及ぼす影響

リクエスト自体が適切な形式であれば、サービスは常に 200 OK を返します。ただし、プライバシー チェックに合格しない場合、レスポンスから情報がフィルタリングされます。 プライバシー設定がリソースに及ぼす影響 | Requesting User| Target User’s Privacy Setting| Behavior| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | me| -| 記載のとおり。| | friend| everyone| 記載のとおり。| | friend| friends only| 記載のとおり。| | friend| blocked| 記載のとおり - サービスはデータをフィルタリングして除外します。| | non-friend user| everyone| 記載のとおり。| | non-friend user| friends only| 記載のとおり - サービスはデータをフィルタリングして除外します。| | non-friend user| blocked| 記載のとおり - サービスはデータをフィルタリングして除外します。| | third-party site| everyone| 記載のとおり - サービスはデータをフィルタリングして除外します。| | third-party site| friends only| 記載のとおり - サービスはデータをフィルタリングして除外します。| | third-party site| blocked| 記載のとおり - サービスはデータをフィルタリングして除外します。|

必須リクエスト ヘッダー

| Header| Type| Description| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | Authorization| string| HTTP 認証用の認証資格情報。値の例: “XBL3.0 x=<userhash>;<token>”。| | x-xbl-contract-version| string| リクエストのルーティング先となる XBOX LIVE サービスのビルド名/番号。ヘッダーの有効性、認証トークン内のクレームなどを検証した後にのみ、リクエストはそのサービスにルーティングされます。値の例: 3、vnext。| | Accept| string| 受け入れ可能な Content-Type。Presence がサポートするのは application/json のみですが、ヘッダーで指定する必要があります。| | Accept-Language| string| レスポンスの文字列に対して受け入れ可能なロケール。値の例: en-US。| | Host| string| サーバーのドメイン名。値の例: userpresence.xboxlive.com。|

オプションのリクエスト ヘッダー

| Header| Type| Description| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | X-RequestedServiceVersion| | リクエストのルーティング先となる XBOX LIVE サービスのビルド名/番号。ヘッダーの有効性、認証トークン内のクレームなどを検証した後にのみ、リクエストはそのサービスにルーティングされます。既定値: 1。|

リクエスト本文

このリクエストの本文にはオブジェクトは送信されません。

HTTP ステータス コード

このリソースに対して、このメソッドで行われたリクエストに応じて、サービスはこのセクションのステータス コードのいずれかを返します。XBOX Live Services で使用される標準の HTTP ステータス コードの完全な一覧については、「標準 HTTP ステータス コード」を参照してください。 | Code| Reason phrase| Description| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 200| OK| セッションが正常に取得されました。| | 400| Bad Request| サービスは不正な形式のリクエストを理解できませんでした。通常は無効なパラメーターです。| | 401| Unauthorized| リクエストにはユーザー認証が必要です。| | 403| Forbidden| このリクエストはユーザーまたはサービスに許可されていません。| | 404| Not Found| 指定されたリソースが見つかりませんでした。| | 405| Method Not Allowed| サポートされていないコンテンツ タイプに対して HTTP メソッドが使用されました。| | 406| Not Acceptable| リソース バージョンがサポートされていません。| | 500| Request Timeout| サービスは不正な形式のリクエストを理解できませんでした。通常は無効なパラメーターです。| | 503| Request Timeout| サービスは不正な形式のリクエストを理解できませんでした。通常は無効なパラメーターです。|

必須レスポンス ヘッダー

| Header| Type| Description| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | x-xbl-contract-version| string| リクエストのルーティング先となる XBOX LIVE サービスのビルド名/番号。ヘッダーの有効性、認証トークン内のクレームなどを検証した後にのみ、リクエストはそのサービスにルーティングされます。値の例: 1、vnext。| | Content-Type| string| リクエスト本文の MIME タイプ。値の例: application/json。| | Cache-Control| string| キャッシュ動作を指定する丁重な要求。値の例: “no-cache”。| | X-XblCorrelationId| string| サーバーが返したものとクライアントが受信したものを関連付けるためにサービスが生成した値。値の例: “4106d0bc-1cb3-47bd-83fd-57d041c6febe”。| | X-Content-Type-Option| string| SDL 準拠の値を返します。値の例: “nosniff”。| | Date| string| メッセージが送信された日時。値の例: “Tue, 17 Nov 2012 10:33:31 GMT”。|

オプションのレスポンス ヘッダー

| Header| Type| Description| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | Retry-After| string| HTTP エラー 503 で返されます。呼び出しを再試行するまで待機する時間をクライアントに通知します。値の例: “120”。| | Content-Length| string| レスポンス本文の長さ。値の例: “527”。| | Content-Encoding| string| レスポンスのエンコーディング タイプ。値の例: “gzip”。|

レスポンス本文

この API は、リクエストの各 XUID に対応する PresenceRecord オブジェクトの配列を返します。

レスポンス例

関連項目

親
/users/xuid()/groups/
最終更新日 2026年10月19日