次の方法で共有


レビューへの返信情報の取得

重要

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"
}