レビューへの返信情報の取得
重要
Microsoft Store レビュー APIは、このトピックに記載されているように、現在動作状態ではありません。 API を使用する代わりに、パートナー センターをして同じタスクを実行できます。
アプリのユーザー レビューにプログラムで返信する場合は、Microsoft Store レビュー API の以下のメソッドを使って、まずレビューに返信する権限があるかどうかを確認します。 レビューの返信を受け取らないことを選択している顧客が送信したレビューに返信することはできません。 レビューに返信できることを確認した後、アプリのレビューに返信を送信するメソッドを使って、プログラムでレビューに返信します。
前提条件
このメソッドを使うには、最初に次の作業を行う必要があります。
- Microsoft Store 分析 API に関するすべての前提条件を満たします (前提条件がまだ満たされていない場合)。
- このメソッドの要求ヘッダーで使う Azure AD アクセス トークンを取得します。 アクセス トークンを取得した後、アクセス トークンを使用できるのは、その有効期限が切れるまでの 60 分間です。 トークンの有効期限が切れたら新しいトークンを取得できます。
- 返信できるかどうかを確認するために、対象となるレビューの ID を取得します。 レビュー ID は、Microsoft Store 分析 API のアプリのレビューの取得メソッドの応答データ、およびレビュー レポートのオフライン ダウンロードで取得できます。
要求
要求の構文
認証方法 | 要求 URI |
---|---|
GET | https://manage.devcenter.microsoft.com/v1.0/my/reviews/{reviewId}/apps/{applicationId}/responses/info |
要求ヘッダー
Header | 型 | 説明 |
---|---|---|
承認 | string | 必須。 Bearer<トークン> という形式の Azure AD アクセス トークン。 |
要求パラメーター
パラメーター | 型 | 内容 | 必須 |
---|---|---|---|
applicationId | string | 返信できるかどうかを確認するレビューを含むアプリのストア ID です。 ストア ID は、パートナー センターのアプリ ID ページで確認できます。 ストア ID は、たとえば 9WZDNCRFJ3Q8 のような文字列です。 | はい |
reviewId | string | 返信するレビューの ID です (これは GUID です)。 レビュー ID は、Microsoft Store 分析 API のアプリのレビューの取得メソッドの応答データ、およびレビュー レポートのオフライン ダウンロードで取得できます。 このパラメーターを省略すると、このメソッドの応答の本文は、指定されたアプリの任意のレビューに返信する権限があるかどうかを示します。 |
いいえ |
要求の例
次の例では、このメソッドを使って、特定のレビューに返信できるかどうかを判断する方法を示します。
GET https://manage.devcenter.microsoft.com/v1.0/my/reviews/6be543ff-1c9c-4534-aced-af8b4fbe0316/apps/9WZDNCRFJ3Q8/responses/info HTTP/1.1
Authorization: Bearer <your access token>
[応答]
応答の本文
|値 |型 |説明 |
|------------|--------|-----------------------| |CanRespond |Boolean |値 true は、指定したレビューに応答できること、または指定したアプリのレビューに応答するアクセス許可があることを示します。 それ以外の場合、この値は false です。 | |DefaultSupportEmail |string |アプリのストア登録情報で指定されているアプリのサポートメール アドレス。 サポート メール アドレスを指定しなかった場合、このフィールドは空です。 |
応答の例
この要求の JSON 返信の本文の例を次に示します。
{
"CanRespond": true,
"DefaultSupportEmail": "support@contoso.com"
}