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

この 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 デスクトップ アプリケーション プログラム