次の方法で共有

GET (/users/me)

  • [アーティクル]

ユーザーの XUID を知る必要なく、現在のユーザーの PresenceRecord を取得します。 これらの URI のドメインは userpresence.xboxlive.com です。

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

パラメーター 型 説明
level 文字列 オプション。
  • user: ユーザー ノードのみを返します。
  • device: ユーザー ノードおよびデバイス ノードを返します。
  • title: 既定。 アクティビティ以外のツリー全体を返します。
  • all: アクティビティ レベルのプレゼンスを含む、ツリー全体を返します。

Authorization

種類 必須かどうか 説明 存在しない場合の応答
XUID ○ 呼び出し元の Xbox ユーザー ID (XUID) 403 Forbidden

必須の要求ヘッダー

ヘッダー 型 説明
Authorization 文字列 HTTP 認証用の認証資格情報。 例の値: "XBL3.0 x=<userhash>;<token>"。
x-xbl-contract-version 文字列 この要求の送信先である Xbox LIVE サービスのビルド名/番号。 要求は、ヘッダー、認証トークン内のクレームなどの有効性が確認された後でのみ、そのサービスにルーティングされます。 値の例: 3, vnext。
Accept 文字列 受け入れ可能な Content-Type。 プレゼンスでサポートされるのは application/json のみですが、ヘッダー内で指定する必要があります。
Accept-Language 文字列 応答で受け入れ可能な文字列のロケール。 値の例: en-US。
Host 文字列 サーバーのドメイン名。 値の例: presencebeta.xboxlive.com。

省略可能な要求ヘッダー

ヘッダー 型 説明
X-RequestedServiceVersion この要求の送信先である Xbox LIVE サービスのビルド名/番号。 要求は、ヘッダー、認証トークン内のクレームなどの有効性が確認された後でのみ、そのサービスにルーティングされます。 既定値: 1。

リクエストの本文

この要求の本体で送信されるオブジェクトはありません。

応答の本文

サンプル応答

このメソッドは PresenceRecord を返します。

{
  xuid:"0123456789",
  state:"online",
  devices:
  [{
    type:"D",
    titles:
    [{
      id:"12341234",
      name:"Contoso 5",
      state:"active",
      placement:"fill",
      timestamp:"2012-09-17T07:15:23.4930000",
      activity:
      {
        richPresence:"Team Deathmatch on Nirvana"
      }
    },
    {
      id:"12341235",
      name:"Contoso Waypoint",
      timestamp:"2012-09-17T07:15:23.4930000",
      placement:"snapped",
      state:"active",
      activity:
      {
        richPresence:"Using radar"
      }
    }]
  },
  {
    type:W8,
    titles:
    [{
      id:"23452345",
      name:"Contoso Gamehelp",
      state:"active",
      placement:"full",
      timestamp:"2012-09-17T07:15:23.4930000",
      activity:
      {
        richPresence:"Nirvana page",
      }
    }]
  }]
}

関連項目

親

/users/me