使用 Microsoft Store 分析 API 中的方法，下載與您已加入 Windows 桌面應用程式計劃的桌面應用程式特定錯誤相關的 CAB 檔案。 此方法僅能下載與過去 30 天內發生的應用程式錯誤相關的 CAB 檔案。 合作夥伴中心的桌面應用程式 健康報告 也提供 CAB 檔案下載。
在使用此方法前，您必須先使用 桌面應用程式中的錯誤詳細資訊 方法，來擷取您要下載的 CAB 檔案的 ID 雜湊值。
先決條件
若要使用此方法，您必須先執行下列動作：
- 如果您尚未執行此操作，請完成 Microsoft Store 分析 API 的所有必要條件。
- 取得 Azure AD 存取權杖以便用於此方法的要求標頭中。 取得存取令牌之後，您必須在 60 分鐘内使用它，否則將會失效。 令牌到期之後，您可以取得新的令牌。
- 取得您要下載之 CAB 檔案的標識碼哈希。 若要取得此值，請使用您的桌面應用程式中的獲取錯誤詳情的方法來擷取特定錯誤的詳細資料，並在該方法的回應主體中使用cabIdHash值。
請求
請求語法
| 方法 | 請求網址識別碼 (URI) |
|---|---|
| 獲取 | https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/cabdownload |
請求標頭
| 頁首 | 類型 | 說明 |
|---|---|---|
| 授權 | 字符串 | 必須的。 Azure AD 存取令牌的形式為 Bearer<token>。 |
要求參數
| 參數 | 類型 | 說明 | 為必填項目 |
|---|---|---|---|
| 應用程式ID | 字符串 | 您想要下載 CAB 檔案的桌面應用程式產品識別碼。 若要取得傳統型應用程式的產品標識碼，請 開啟傳統型應用程式的任何合作夥伴中心分析報告 （例如 健康情況報告），並從 URL 擷取產品標識碼。 | 是的 |
| cabIdHash（計程車識別代碼哈希值） | 字符串 | 您要下載之 CAB 檔案的唯一標識碼哈希。 若要取得此值，請使用「桌面應用程式中錯誤詳細資訊檢索方法」來獲取應用程式中特定錯誤的詳細資訊，並在該方法的回應內容中使用 cabIdHash 值。 | 是的 |
範例請求
下列範例示範如何使用此方法下載 CAB 檔案。 將 applicationId 和 cabIdHash 參數替換為您桌面應用程式的適當值。
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/cabdownload?applicationId=10238467886765136388&cabIdHash=00001111-aaaa-2222-bbbb-3333cccc4444 HTTP/1.1
Authorization: Bearer <your access token>
回應
這個方法會傳回 302（重定向）回應碼，而回應中的 Location 標頭會被指派為 CAB 檔案的共用存取簽章（SAS） URI。 呼叫端會重新導向至此 URI，以自動下載 CAB 檔案。