BatchRequest (JSON)

用於篩選線上狀態資訊的屬性陣列，例如使用者、裝置和遊戲。

BatchRequest

BatchRequest 物件具有下列規格。

成員	類型	描述
users	string 陣列	列出您想要了解其線上狀態之使用者的 XUID，一次最多 1100 個 XUID。
deviceTypes	string 陣列	您想要了解之使用者所使用的裝置類型清單。如果陣列保留空白，預設為所有可能的裝置類型 (也就是不篩選掉任何類型)。
titles	32 位元不帶正負號整數陣列	您想要了解其使用者的裝置類型清單。如果陣列保留空白，預設為所有可能的遊戲 (也就是不篩選掉任何遊戲)。
level	string	可能的值： user - 取得使用者節點 device - 取得使用者和裝置節點 title - 取得基本遊戲層級資訊 all - 取得 Rich Presence 資訊、媒體資訊或兩者預設值為 “title”。
onlineOnly	布林值	如果此屬性為 true，批次作業會篩選掉離線使用者 (包括隱身使用者) 的記錄。如果未提供，則會同時傳回線上和離線使用者。

{
  users:
  [
    "1234567890",
    "4567890123",
    "7890123456"
  ]
}