英語で読む

次の方法で共有


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

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

デスクトップ アプリケーション内の特定の実行可能ファイルのデバイス ブロックの詳細については、「デスクトップ アプリケーションのアップグレード ブロックの詳細情報の取得」を参照してください。

前提条件

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

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

要求

要求の構文

認証方法 要求 URI
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/blockhits

要求ヘッダー

Header 説明
承認 string 必須。 Bearer<トークン> という形式の Azure AD アクセス トークン。

要求パラメーター

パラメーター 内容 必須
applicationId string ブロック データを取得するデスクトップ アプリケーションの製品 ID です。 デスクトップ アプリケーションの製品 ID を取得するには、パートナー センターでデスクトップ アプリケーションの分析レポートのいずれか (ブロック レポートなど) を開き、URL から製品 ID を取得します。 はい
startDate 日付 取得するブロック データの日付範囲の開始日です。 既定値は、現在の日付の 90 日前です。 いいえ
endDate 日付 取得するブロック データの日付範囲の終了日です。 既定値は現在の日付です。 いいえ
top int 要求で返すデータの行数です。 最大値および指定しない場合の既定値は 10000 です。 クエリにこれを上回る行がある場合は、応答本文に次リンクが含まれ、そのリンクを使ってデータの次のページを要求できます。 いいえ
skip int クエリでスキップする行数です。 大きなデータ セットを操作するには、このパラメーターを使用します。 たとえば、top=10000 と skip=0 を指定すると、データの最初の 10,000 行が取得され、top=10000 と skip=10000 を指定すると、データの次の 10,000 行が取得されます。 No
filter string 応答内の行をフィルター処理する 1 つまたは複数のステートメントです。 各ステートメントでは応答本文のフィールド名と値が eq 演算子または ne 演算子で関連付けられ、ステートメントは and または or を使用して組み合わせることができます。 filter パラメーターでは、文字列値を単一引用符で囲む必要があります。 応答本文から次のフィールドを指定できます。

  • applicationVersion
  • アーキテクチャ
  • blockType
  • deviceType
  • fileName
  • market
  • osRelease
  • osVersion
  • productName
  • targetOs
いいえ
orderby string 各ブロックの結果データ値の順序を指定するステートメントです。 構文は orderby=field [order],field [order],...です。 field パラメーターには、応答本文から次のいずれかのフィールドを指定できます。

  • applicationVersion
  • アーキテクチャ
  • blockType
  • date
  • deviceType
  • fileName
  • market
  • osRelease
  • osVersion
  • productName
  • targetOs
  • deviceCount

order パラメーターは省略可能であり、asc または desc を指定して、各フィールドを昇順または降順にすることができます。 既定値は asc です。

orderby 文字列の例: orderby=date,market

No
groupby string 指定したフィールドのみにデータ集計を適用するステートメントです。 応答本文から次のフィールドを指定できます。

  • applicationVersion
  • アーキテクチャ
  • blockType
  • deviceType
  • fileName
  • market
  • osRelease
  • osVersion
  • targetOs

返されるデータ行には、groupby パラメーターで指定されたフィールドと、次のものが含まれます。

  • applicationId
  • date
  • productName
  • deviceCount

いいえ

要求の例

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

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 string データの追加ページがある場合、この文字列には、データの次のページを要求するために使用できる URI が含まれます。 たとえば、要求の top パラメーターが 10,000 に設定されていた場合、クエリのブロック データが 10,000 行を超えると、この値が返されます。
TotalCount int クエリの結果データ内の行の総数です。

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

種類 内容
applicationId string ブロック データを取得したデスクトップ アプリケーションの製品 ID です。
日付 string ブロック ヒット値に関連付けられている日付です。
productName string 関連付けられている実行可能ファイルのメタデータから派生した、デスクトップ アプリケーションの表示名です。
fileName string ブロックされた実行可能ファイルです。
applicationVersion string ブロックされたアプリケーション実行可能ファイルのバージョンです。
osVersion string デスクトップ アプリケーションが現在実行されている OS のバージョンを示す、以下のいずれかの文字列です。

  • Windows 7
  • Windows 8.1
  • Windows 10
  • Windows 11
  • Windows Server 2016
  • Windows Server 1709
  • 不明
osRelease string デスクトップ アプリケーションが現在実行されている OS のリリースまたはフライティング リングを (OS バージョン内のサブグループとして) 示す、以下のいずれかの文字列です。

Windows 11 の場合: Version 2110

Windows 10 の場合:

  • Version 1507
  • Version 1511
  • Version 1607
  • Version 1703
  • バージョン 1709
  • Release Preview
  • Insider Fast
  • Insider Slow

Windows Server 1709 の場合:

  • RTM

Windows Server 2016 の場合:

  • Version 1607

Windows 8.1 の場合:

  • Update 1

Windows 7 の場合:

  • Service Pack 1

OS リリースまたはフライティング リングが不明な場合、このフィールドの値は [Unknown] (不明) になります。

market string デスクトップ アプリケーションがブロックされている市場の ISO 3166 国番号です。
deviceType string デスクトップ アプリケーションがブロックされているデバイスの種類を示す、以下のいずれかの文字列です。

  • PC
  • [サーバー]
  • タブレット PC
  • 不明
blockType string デバイスで見つかったブロックの型を示す、次のいずれかの文字列です。

  • Potential Sediment
  • Temporary Sediment
  • Runtime Notification

これらのブロックの種類と、開発者およびユーザーにとってのこれらの意味の詳細については、「アプリケーション ブロック レポート」のセクションの説明を参照してください。
アーキテクチャ string ブロックが存在するデバイスのアーキテクチャ:

  • ARM64
  • X86
targetOs string デスクトップ アプリケーションの実行がブロックされている Windows 10 または Windows 11 OS リリースを指定する次のいずれかの文字列。

  • バージョン 1709
  • Version 1803
deviceCount 数値 指定した集計レベルのブロックがある個々のデバイスの数です。

応答の例

この要求の 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
}