使用此 REST URI 來取得資訊，了解哪些 Windows 10 和 Windows 11 裝置因桌面應用程式的阻擋而無法進行 Windows 10 或 Windows 11 升級。 您只能將此 URI 用於已新增至 Windows 桌面應用程式計畫的桌面應用程式。 此資訊也可以在合作夥伴中心的桌面應用程式報表應用程式區塊報告 中找到。
若要取得桌面應用程式中特定可執行檔案的裝置區塊詳細資料，請參閱 桌面應用程式的升級區塊詳細資料。
先決條件
若要使用此方法，您必須先執行下列動作：
- 如果您尚未執行此操作，請完成 Microsoft Store 分析 API 的所有必要條件。
- 取得 Azure AD 存取權杖以便用於此方法的要求標頭中。 取得存取令牌之後，您必須在 60 分鐘内使用它，否則將會失效。 令牌到期之後，您可以取得新的令牌。
請求
請求語法
| 方法 | 請求網址識別碼 (URI) |
|---|---|
| 獲取 | https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/blockhits |
請求標頭
| 頁首 | 類型 | 說明 |
|---|---|---|
| 授權 | 字符串 | 必須的。 Azure AD 存取令牌的形式為 Bearer<token>。 |
要求參數
| 參數 | 類型 | 說明 | 為必填項目 |
|---|---|---|---|
| 應用程式ID | 字符串 | 您想要取得封鎖資料的桌面應用程式的產品標識碼。 若要取得桌面應用程式的產品標識符，請在合作夥伴中心 中開啟桌面應用程式的任何 |
是的 |
| 開始日期 | 日期 | 要擷取之區塊數據之日期範圍的開始日期。 預設值為目前日期之前的 90 天。 | 否 |
| 結束日期 | 日期 | 要擷取之區塊數據之日期範圍的結束日期。 預設值為目前的日期。 | 否 |
| 返回頁首 | 整數 (int) | 要求中要傳回的數據列數。 如果未指定，則最大值和預設值為10000。 如果查詢中有更多資料列，回應內容會包含下一個連結，您可以使用該連結來請求下一頁的資料。 | 否 |
| 略過 | 整數 (int) | 查詢中要略過的行數目。 使用此參數逐頁流覽大型數據集。 例如，top=10000 和 skip=0 會擷取前 10000 個數據列、top=10000 和 skip=10000 會擷取接下來的 10000 個數據列等等。 | 否 |
| 篩選器 | 字符串 | 一或多個語句用於篩選回應中的數據列。 每個敘述都包含回應主體中的欄位名稱及與 eq 或 ne 運算子相關的值，而且敘述可以使用 和 或 或 結合。 字串值必須以 篩選 參數中的單引弧括住。 您可以從回應正文指定下列欄位：
|
否 |
| 排序 | 字符串 | 排序每個區塊結果數據值的語句。 語法 orderby=欄位 [順序]，欄位 [順序],...。欄位 參數可以是回應本文中的下列欄位之一：
order 參數是選擇性的，而且可以是 asc 或 desc，以指定每個欄位的遞增或遞減順序。 預設為asc。 以下是 orderby 字串範例： orderby=date，market |
否 |
| 按群組分類 | 字符串 | 僅將資料彙總套用至指定欄位的陳述式。 您可以從回應正文指定下列欄位：
傳回的數據列將包含 groupby 參數中指定的欄位，以及以下內容：
|
否 |
範例請求
以下範例展示幾個取得桌面應用程式區塊數據的請求。 將 applicationId 值替換為桌面應用程式的產品識別符。
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/blockhits?applicationId=5126873772241846776&startDate=2018-05-01&endDate=2018-06-07&skip=0 HTTP/1.1
Authorization: Bearer <your access token>
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/blockhits?applicationId=5126873772241846776&startDate=2018-05-01&endDate=2018-06-07&filter=market eq 'US' and deviceType eq 'PC' HTTP/1.1
Authorization: Bearer <your access token>
回應
回應主體
| 價值觀 | 類型 | 說明 |
|---|---|---|
| 價值觀 | 陣列 | 包含匯總區塊數據的物件陣列。 如需每個物件中數據的詳細資訊，請參閱下表。 |
| @nextLink | 字符串 | 如果有額外的數據頁面，此字串會包含可用來要求下一頁數據的 URI。 例如，如果要求 top 參數設定為 10000，但查詢的區塊數據列超過 10000 個數據列，則會傳回這個值。 |
| 總計數 | 整數 (int) | 查詢的資料結果中的總列數。 |
Value 陣列中的元素包含下列值。
| 價值觀 | 類型 | 說明 |
|---|---|---|
| 應用程式ID | 字符串 | 您擷取區塊數據的桌面應用程式之產品識別碼。 |
| 日期 | 字符串 | 與區塊點擊值相關聯的日期。 |
| 產品名稱 | 字符串 | 桌面應用程式的顯示名稱，衍生自其相關聯可執行檔的元數據。 |
| 檔名 | 字符串 | 已封鎖的可執行檔。 |
| 應用程式版本 | 字符串 | 封鎖的應用程式可執行檔版本。 |
| 作業系統版本 | 字符串 | 下列其中一個字串，指定桌面應用程式目前正在執行的OS版本：
|
| osRelease作系統 | 字符串 | 下列其中一個字串，指定桌面應用程式目前執行所在的作業系統版本或分階段發佈環（作為作業系統版本內的一個子群）。 針對 Windows 11： 版本 2110 針對 Windows 10：
適用於 Windows Server 1709：
適用於 Windows Server 2016：
若為 Windows 8.1：
針對 Windows 7：
如果作業系統的發行版本或測試環未知，這個欄位的值將為 未知。 |
| 市場 | 字符串 | 阻擋桌面應用程式的市場之 ISO 3166 國家/地區代碼。 |
| 裝置類型 | 字符串 | 以下字串之一，指定封鎖桌面應用程式的裝置類型：
|
| blockType（區塊類型） | 字符串 | 下列其中一個字串，指定裝置上找到的區塊類型：
|
| 建築 | 字符串 | 區塊所在的裝置架構：
|
| targetOs | 字符串 | 下列其中一個字串，指定桌面應用程式無法執行所在的 Windows 10 或 Windows 11 OS 版本：
|
| 裝置數量 | 數字 | 擁有指定聚合層級區塊的獨特裝置數目。 |
回應範例
下列範例顯示這個請求的 JSON 回應示例內容。
{
"Value": [
{
"applicationId": "10238467886765136388",
"date": "2018-06-03",
"productName": "Contoso Demo",
"fileName": "contosodemo.exe",
"applicationVersion": "2.2.2.0",
"osVersion": "Windows 8.1",
"osRelease": "Update 1",
"market": "ZA",
"deviceType": "All",
"blockType": "Runtime Notification",
"architecture": "X86",
"targetOs": "RS4",
"deviceCount": 120
}
],
"@nextLink": "desktop/blockhits?applicationId=123456789&startDate=2018-01-01&endDate=2018-02-01&top=10000&skip=10000&groupby=applicationVersion,deviceType,osVersion,osRelease",
"TotalCount": 23012
}