取得應用程式中錯誤的詳細資料

發行項
03/25/2024

在 Microsoft Store 分析 API 中使用此方法，取得應用程式特定錯誤的 JSON 格式詳細資料。此方法只能擷取過去 30 天內發生之錯誤的詳細資料。合作夥伴中心健康情況報告的 [失敗] 區段也提供詳細的錯誤資料。

使用此方法之前，您必須先使用取得錯誤報告資料方法來擷取您想要取得詳細資訊的錯誤識別碼。

必要條件

要使用此方法，您需要先執行以下操作：

如果您尚未執行此操作，請完成 Microsoft Store 分析 API 的所有必要條件。
取得 Azure AD 存取權杖以便用於此方法的要求標頭中。取得存取權杖之後，您在其到期之前有 60 分鐘的時間可以使用。權杖到期之後，您可以取得新的權杖。
取得您想要取得詳細資訊之錯誤的識別碼。若要取得此識別碼，請使用取得錯誤報告資料方法，並在該方法的回應本文中使用 failureHash 值。

Request

要求語法

方法	要求 URI
GET	`https://manage.devcenter.microsoft.com/v1.0/my/analytics/failuredetails`

要求標頭

標題	類型	描述
授權	字串	必要。持有人<權杖>形式的 Azure AD 存取權杖。

要求參數

參數	類型	描述	必要
applicationId	字串	您想要擷取詳細錯誤資料之應用程式 Store ID。 Store ID 可在合作夥伴中心的應用程式識別頁面上取得。範例 Store ID 為 9WZDNCRFJ3Q8。	是
failureHash	字串	取得您想要取得詳細資訊之錯誤的唯一識別碼。若要針對您感興趣的錯誤取得此值，請使用取得錯誤報告資料方法，並在該方法的回應本文中使用 failureHash 值。	是
startDate	date	要擷取詳細錯誤資料之日期範圍的開始日期。預設值為目前日期的前 30 天。：此方法只能擷取過去 30 天內發生之錯誤的詳細資料。	否
endDate	date	要擷取詳細錯誤資料之日期範圍的結束日期。預設值是目前的日期。	否
熱門	int	要求中要傳回的資料列數。如果未指定，則最大值和預設值為 10000。如果查詢中有更多資料列，回應本文會包含下一個連結，您可以用來要求下一頁的資料。	否
skip	int	要在查詢中忽略的列數。使用此參數逐頁瀏覽大型資料集。例如，top=10 和 skip=0 會擷取前 10 列資料，top=10 和 skip=10 會擷取接下來的 10 列資料，依此類推。	否
篩選器	字串	篩選回應中的資料列的一或多個陳述式。每個陳述式都包含回應本文的功能變數名稱，以及與 eq 或 ne 運算子相關聯的值，而且可以使用 and 或 or 結合陳述式。字串值必須以 filter 參數中的單引號括住。您可以從回應本文指定下列功能變數： market date cabId cabExpirationTime deviceType deviceModel osVersion osRelease packageVersion osBuild	否
orderby	字串	排序結果資料值的陳述式。語法為 orderby=field [order],field [order],...。field 參數可以是下列其中一個字串： market date cabId cabExpirationTime deviceType deviceModel osVersion osRelease packageVersion osBuild order 參數是選擇性的，而且可以是 asc 或 desc，以指定每個欄位的遞增或遞減順序。預設為asc。以下是範例 orderby 字串：orderby=date,market	否

要求範例

下列範例示範數個取得詳細錯誤資料的要求。以您應用程式的 Store ID 取代 applicationId 值。

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/failuredetails?applicationId=9NBLGGGZ5QDR&failureHash=00001111-aaaa-2222-bbbb-3333cccc4444&startDate=2016-11-05&endDate=2016-11-06&top=10&skip=0 HTTP/1.1
Authorization: Bearer <your access token>

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/failuredetails?applicationId=9NBLGGGZ5QDR&failureHash=00001111-aaaa-2222-bbbb-3333cccc4444&startDate=2016-11-05&endDate=2016-11-06&top=10&skip=0&filter=market eq 'US' and deviceType eq 'Windows.Desktop' HTTP/1.1
Authorization: Bearer <your access token>

回應

回應本文

值	類型	描述
值	陣列	物件的陣列，其中包含詳細的錯誤資料。如需關於每個物件中的資料的詳細資訊，請參閱下方的錯誤詳細資料值一節。
@nextLink	字串	如果有額外的資料頁面，此字串會包含可用來要求下一頁資料的 URI。例如，如果要求的 top 參數設定為 10，但查詢的錯誤超過 10 個資料列，則會傳回此值。
TotalCount	整數	查詢的資料結果中的總列數。

錯誤詳細資料值

Value 陣列中的元素包含下列值。

值	類型	描述
applicationId	字串	您已擷取詳細錯誤資料之應用程式的 Store ID。
failureHash	字串	錯誤的唯一識別碼。
failureName	字串	失敗的名稱，由四個部分組成：一或多個問題類別、例外狀況/錯誤檢查代碼、發生失敗的映像名稱，以及相關聯的函式名稱。
date	字串	錯誤資料之日期範圍中的第一個日期。如果要求指定了單天，這個值就是該日期。如果要求指定了一週、月或其他日期範圍，這個值就是該日期範圍中的第一個日期。
cabId	字串	與此錯誤相關聯之 CAB 檔案的唯一識別碼。
cabExpirationTime	字串	CAB 檔案過期且無法再下載的日期和時間，格式為 ISO 8601。
market	字串	裝置市場的 ISO 3166 國家/地區代碼。
osBuild	字串	發生錯誤之 OS 的組建編號。
packageVersion	字串	與此錯誤相關聯之應用程式套件的版本。
deviceModel	字串	指定發生錯誤時應用程式執行所在裝置模型的字串。
osVersion	字串	下列其中一個字串，指出發生錯誤的 OS 版本： Windows Phone 7.5 Windows Phone 8 Windows Phone 8.1 Windows Phone 10 Windows 8 Windows 8.1 Windows 10 Windows 11 Unknown
osRelease	字串	下列其中一個字串，指定發生錯誤的 OS 版本或發行小眾測試版通道 (作為 OS 版本內的子群體)。若為 Windows 11：2110 版若為 Windows 10： 1507 版 1511 版 1607 版 1703 版 1709 版 1803 版 Release Preview Insider Fast Insider Slow 若是 Windows Server 1709： RTM 若是 Windows Server 2016： 1607 版若為 Windows 8.1： Update 1 若為 Windows 7： Service Pack 1 如果 OS 版本或發行小眾測試版通道不明，此功能變數的值為 Unknown。
deviceType	字串	下列其中一個字串，指定發生錯誤時應用程式執行所在的裝置類型： PC 手機 Xbox One 主機 Xbox Series X 主機 IoT Holographic Unknown
cabDownloadable	布林值	指出對於此使用者，是否可下載 CAB 檔案。

注意

此方法只能擷取過去 30 天內發生之錯誤的詳細資料。

要求和回應範例

下列程式碼片段示範一些要求的範例要求和 JSON 回應本文。

範例要求

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/failuredetails?applicationId=9NBLGGGZ5QDR&failureHash=012345-5dbc9-b12f-c124-9d9810f05d8b&startDate=2022-06-30&endDate=2022-07-28&top=10&skip=0
HTTP/1.1
Authorization: Bearer <your access token>

範例回應

{
    "Value": [
        {
            "date": "2022-07-12 00:00:00",
            "cabExpirationTime": "2022-08-16 01:37:00",
            "cabDownloadable": false,
            "applicationId": "9NBLGGGZ5QDR",
            "failureHash": "012345-5dbc9-b12f-c124-9d9810f05d8b",
            "failureName": "MOAPPLICATION_HANG_cfffffff_Microsoft.Contoso!HANG_QUIESCE",
            "cabId": "1180087848576586304",
            "market": "MX",
            "osBuild": "10.0.19043",
            "packageVersion": "2.5.2.34894",
            "deviceModel": "Dell Inc.-Inspiron 15-3567",
            "osVersion": "Windows 10",
            "osRelease": "Version 21H1",
            "osArchitecture": "x64",
            "deviceType": "PC",
            "cpuManufacturer": "Intel",
            "cpuFamilyName": "Core i5",
            "cpuName": "Intel Core i5-7200U CPU @ 2.50GHz",
            "praid": "app",
            "flightRing": "",
            "sandboxId": "retail"
        },
        {
            "date": "2022-07-13 00:00:00",
            "cabExpirationTime": "2022-08-17 13:35:53",
            "cabDownloadable": true,
            "applicationId": "9NBLGGGZ5QDR",
            "failureHash": "012345-5dbc9-b12f-c124-9d9810f05d8b",
            "failureName": "MOAPPLICATION_HANG_cfffffff_Microsoft.Contoso!HANG_QUIESCE",
            "cabId": "2058585545558157474",
            "market": "RO",
            "osBuild": "10.0.22622",
            "packageVersion": "2.5.2.34894",
            "deviceModel": "Dell Inc.-Vostro 5502",
            "osVersion": "Windows 11",
            "osRelease": "External",
            "osArchitecture": "x64",
            "deviceType": "PC",
            "cpuManufacturer": "Intel",
            "cpuFamilyName": "Core i5",
            "cpuName": "11th Gen Intel Core i5-1135G7 @ 2.40GHz",
            "praid": "app",
            "flightRing": "external",
            "sandboxId": "retail"
        },
        {
            "date": "2022-07-14 00:00:00",
            "cabExpirationTime": "2022-08-18 07:27:06",
            "cabDownloadable": false,
            "applicationId": "9NBLGGGZ5QDR",
            "failureHash": "012345-5dbc9-b12f-c124-9d9810f05d8b",
            "failureName": "MOAPPLICATION_HANG_cfffffff_Microsoft.Contoso!HANG_QUIESCE",
            "cabId": "1940204079766793391",
            "market": "IN",
            "osBuild": "10.0.19044",
            "packageVersion": "2.5.2.34894",
            "deviceModel": "Generic Desktop",
            "osVersion": "Windows 10",
            "osRelease": "Version 21H2",
            "osArchitecture": "x64",
            "deviceType": "PC",
            "cpuManufacturer": "Intel",
            "cpuFamilyName": "Pentium",
            "cpuName": "Intel Pentium CPU G630 @ 2.70GHz",
            "praid": "app",
            "flightRing": "",
            "sandboxId": "retail"
        },
        {
            "date": "2022-07-17 00:00:00",
            "cabExpirationTime": "2022-08-21 10:04:16",
            "cabDownloadable": true,
            "applicationId": "9NBLGGGZ5QDR",
            "failureHash": "012345-5dbc9-b12f-c124-9d9810f05d8b",
            "failureName": "MOAPPLICATION_HANG_cfffffff_Microsoft.Contoso!HANG_QUIESCE",
            "cabId": "1197051093472061859",
            "market": "ES",
            "osBuild": "10.0.22621",
            "packageVersion": "2.5.2.34894",
            "deviceModel": "Microsoft Corporation-Surface Pro 3",
            "osVersion": "Windows 11",
            "osRelease": "External",
            "osArchitecture": "x64",
            "deviceType": "PC",
            "cpuManufacturer": "Intel",
            "cpuFamilyName": "Core i7",
            "cpuName": "Intel Core i7-4650U CPU @ 1.70GHz",
            "praid": "app",
            "flightRing": "external",
            "sandboxId": "retail"
        },
        {
            "date": "2022-07-20 00:00:00",
            "cabExpirationTime": "2022-08-24 12:40:05",
            "cabDownloadable": false,
            "applicationId": "9NBLGGGZ5QDR",
            "failureHash": "012345-5dbc9-b12f-c124-9d9810f05d8b",
            "failureName": "MOAPPLICATION_HANG_cfffffff_Microsoft.Contoso!HANG_QUIESCE",
            "cabId": "1332886311327579782",
            "market": "RU",
            "osBuild": "6.3.9600",
            "packageVersion": "2.5.2.34894",
            "deviceModel": "ASUSTeK COMPUTER INC.-K75VJ",
            "osVersion": "Windows 8.1",
            "osRelease": "RTM",
            "osArchitecture": "x64",
            "deviceType": "PC",
            "cpuManufacturer": "Intel",
            "cpuFamilyName": "Core i7",
            "cpuName": "Intel Core i7-3630QM CPU @ 2.40GHz",
            "praid": "app",
            "flightRing": "",
            "sandboxId": ""
        }
    ],
    "TotalCount": 5
}

共用方式為

取得應用程式中錯誤的詳細資料

必要條件

Request

要求語法

要求標頭

要求參數

要求範例

回應

回應本文

錯誤詳細資料值

要求和回應範例

範例要求

範例回應

意見反應

其他資源

共用方式為

取得應用程式中錯誤的詳細資料

必要條件

Request

要求語法

要求標頭

要求參數

要求範例

回應

回應本文

錯誤詳細資料值

要求和回應範例

範例要求

範例回應

相關主題

意見反應

其他資源