アプリ レビューを取得する

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

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

[前提条件]

このメソッドを使用するには、まず次の操作を行う必要があります。

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

リクエスト

リクエスト構文

リクエストヘッダー

要求パラメーター

フィールドをフィルターする

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

これはフィルター 文字列 の例です。filter=contains(reviewText,'great') and contains(reviewText,'ads') and deviceRAM lt 2048 and market eq 'US'

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

要求の例

次の例では、レビュー データを取得するためのいくつかの要求を示します。 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 サービス を使用して分析データにアクセスする
• アプリ レビューの応答情報を取得する
• アプリ レビューに返信を送信する
• アプリの買収
• アドオンを取得する
• エラー報告データを取得する
• アプリの評価 を取得する