デスクトップ アプリケーションのアップグレード ブロックの詳細情報の取得

この REST URI を使用して、デスクトップ アプリケーションの特定の実行可能ファイルが Windows 10 または Windows 11 のアップグレードの実行をブロックしている Windows 10 および Windows 11 デバイスの詳細を取得します。 この URI は、Windows デスクトップ アプリケーション プログラムに追加したデスクトップ アプリケーションにのみ使用できます。 この情報は、パートナー センターにあるデスクトップ アプリケーションのアプリケーション ブロック レポートでも確認できます。

この URI は、「デスクトップ アプリケーションのアップグレード ブロックを取得する」に似ていますが、デスクトップ アプリケーションの特定の実行可能ファイルのデバイス ブロック情報を返します。

前提条件

このメソッドを使うには、最初に次の作業を行う必要があります。

• Microsoft Store 分析 API に関するすべての前提条件を満たします (前提条件がまだ満たされていない場合)。
• このメソッドの要求ヘッダーで使う Azure AD アクセス トークンを取得します。 アクセス トークンを取得した後、アクセス トークンを使用できるのは、その有効期限が切れるまでの 60 分間です。 トークンの有効期限が切れたら新しいトークンを取得できます。

要求

要求の構文

要求ヘッダー

要求パラメーター

要求の例

デスクトップ アプリケーションのブロック データを取得するためのいくつかの要求の例を次に示します。 applicationId の値は、デスクトップ アプリケーションの製品 ID に置き換えてください。

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/blockdetails?applicationId=10238467886765136388&fileName=contoso.exe&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/blockdetails?applicationId=10238467886765136388&fileName=contoso.exe&startDate=2018-05-01&endDate=2018-06-07&filter=market eq 'US' and deviceType eq 'PC' HTTP/1.1
Authorization: Bearer <your access token>

回答

応答本文

Value 配列の要素には、次の値が含まれます。

応答の例

この要求の 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/blockdetails?applicationId=123456789&startDate=2018-01-01&endDate=2018-02-01&top=10000&skip=10000&groupby=applicationVersion,deviceType,osVersion,osRelease",
  "TotalCount": 23012
}

関連トピック

• Windows デスクトップ アプリケーション プログラム
• デスクトップ アプリケーションのアップグレード ブロックの取得