デスクトップ アプリケーションのインストール数の取得

この REST URI を使用して、Windows デスクトップ アプリケーション プログラムに追加したデスクトップ アプリケーションの集計インストール データを JSON 形式で取得します。 この URI を使用すると、指定された日付範囲および他のオプション フィルター中にインストール データを取得できます。 この情報は、パートナー センターにあるデスクトップ アプリケーションのインストール レポートでも確認できます。

前提条件

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

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

要求

要求の構文

要求ヘッダー

要求パラメーター

要求の例

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

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/installbasedaily?applicationId=1234567890&startDate=2018-01-01&endDate=2018-02-01&top=10&skip=0 HTTP/1.1
Authorization: Bearer <your access token>

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/installbasedaily?applicationId=1234567890&startDate=2018-01-01&endDate=2018-02-01&filter=market eq 'US' and deviceType eq 'PC' HTTP/1.1
Authorization: Bearer <your access token>

回答

応答本文

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

応答の例

この要求の JSON 返信の本文の例を次に示します。

{
  "Value": [
    {
      "date": "2018-01-24",
      "applicationId": "123456789",
      "productName": "Contoso Demo",
      "applicationVersion": "1.0.0.0",
      "deviceType": "PC",
      "market": "All",
      "osVersion": "Windows 10",
      "osRelease": "Version 1709",
      "installBase": 348218.0
    }
  ],
  "@nextLink": "desktop/installbasedaily?applicationId=123456789&startDate=2018-01-01&endDate=2018-02-01&top=10000&skip=10000&groupby=applicationVersion,deviceType,osVersion,osRelease",
  "TotalCount": 23012
}

関連トピック

• Windows デスクトップ アプリケーション プログラム