アプリのレビューの取得

Microsoft Store 分析 API のこのメソッドを使用して、特定の日付範囲やその他のオプション フィルターの JSON 形式のレビュー データを取得します。 この情報は、パートナー センターのレビュー レポートでも確認できます。

レビューを取得した後は、アプリ レビューの取得応答情報を使用し Microsoft Store レビュー API のアプリ レビューメソッドに応答を送信プログラムでレビューに応答できます。

前提条件

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

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

要求

要求の構文

要求ヘッダー

要求パラメーター

フィルター フィールド

要求の filter パラメーターには、応答内の行をフィルター処理する 1 つまたは複数のステートメントが含まれます。 各ステートメントには、 eq または ne 演算子に関連付けられたフィールドと値が含まれており、一部のフィールドでは、 contains、 gt、 lt、 ge、および le 演算子もサポートされます。 ステートメントは、 and または or を使用して結合できます。

filter 文字列の例を次に示します。filter=contains(reviewText,'great') and contains(reviewText,'ads') and deviceRAM lt 2048 and market eq 'US'

各フィールドでサポートされているフィールドとサポート演算子の一覧については、次の表を参照してください。 filter パラメーターでは、文字列値を単一引用符で囲む必要があります。

要求の例

次の例では、レビュー データを取得するためのいくつかの要求を示します。 applicationId 値を、目的のアプリのストア ID に置き換えてください。

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/reviews?applicationId=9NBLGGGZ5QDR&startDate=1/1/2015&endDate=2/1/2015&top=10&skip=0 HTTP/1.1
Authorization: Bearer <your access token>

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/reviews?applicationId=9NBLGGGZ5QDR&startDate=8/1/2015&endDate=8/31/2015&skip=0&filter=contains(reviewText,'great') and contains(reviewText,'ads') and deviceRAM lt 2048 and market eq 'US' HTTP/1.1
Authorization: Bearer <your access token>

[応答]

応答本文

値を確認する

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

要求と応答の例

次のコード スニペットは、これらの要求についての要求と JSON 応答本文の例を示しています。

サンプル要求

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/reviews?applicationId=9WZDNCRFJB4P&top=10&skip=0
HTTP/1.1
Authorization: Bearer <your access token>

サンプル応答

{
    "Value": [
        {
            "date": "3/5/2021 12:48:33 PM",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "market": "ES",
            "osVersion": "Windows 10",
            "deviceType": "PC",
            "isRevised": false,
            "packageVersion": "2.5.2.34894",
            "reviewerName": "Jose Antonio",
            "rating": 5,
            "reviewTitle": "Contoso Demo",
            "reviewText": "Un juego fantastico",
            "helpfulCount": 3,
            "notHelpfulCount": 0,
            "id": "b5e27de9-2334-4849-d17d-4eae3e1e7aa9"
        },
        {
            "date": "1/6/2021 8:41:42 AM",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "market": "TR",
            "osVersion": "Windows 10",
            "deviceType": "PC",
            "isRevised": false,
            "packageVersion": "2.5.2.34894",
            "reviewerName": "fef",
            "rating": 5,
            "helpfulCount": 0,
            "notHelpfulCount": 0,
            "id": "f5d2510a-9796-45ee-01e5-6d5cc4550b09"
        }
    ],
    "TotalCount": 2
}

関連トピック

• レビュー レポート
• Microsoft Store サービスを使った分析データへのアクセス
• アプリのレビューへの返信情報の取得
• アプリ レビューに返信を送信する
• アプリの入手数の取得
• アドオンの入手数の取得
• エラー報告データの取得
• アプリの評価の取得