提交评价回复

  • 项目

重要

本主题中所述的 Microsoft Store 评价 API 当前未处于工作状态。 可以使用合作伙伴中心来实现相同的任务，而不是使用 API。

在 Microsoft Store 评价 API 中使用此方法，以编程方式回复应用评价。 调用此方法时，必须指定要回复的评价 ID。 评价 ID 位于 Microsoft Store 分析 API 中的获取应用评价方法的回复数据中，以及评价报告的脱机下载中。

当客户提交评价时，他们可以选择不接收对其评价的回复。 如果你尝试回复客户已选择不接收回复的评价，此方法的回复正文将显示回复尝试未成功。 调用此方法前，你可以选择使用获取应用评价的回复信息方法确定是否可以回复给定评价。

注意

除了使用此方法以编程方式回复评价以外，还可以使用合作伙伴中心回复评价。

必备条件

若要使用此方法，首先需要执行以下操作：

  • 如果尚未开始操作，请先完成 Microsoft Store 评价 API 的所有先决条件。
  • 获取 Azure AD 访问令牌，以供在此方法的请求标头中使用。 获取访问令牌后，在它到期前，你有 60 分钟的使用时间。 该令牌到期后，可以获取新的令牌。
  • 获取要回复的评价的 ID。 评价 ID 位于 Microsoft Store 分析 API 中的获取应用评价方法的回复数据中，以及评价报告的脱机下载中。

请求

请求语法

方法 请求 URI
POST https://manage.devcenter.microsoft.com/v1.0/my/reviews/responses

请求头

标头 类型 说明
授权 字符串 必需。 Azure AD 访问令牌的格式为 Bearertoken<>。

请求参数

此方法没有请求参数。

请求正文

请求正文具有以下值。

Value 类型 说明
响应 array 包含要提交的回复数据的对象数组。 有关每个对象中的数据的详细信息，请参阅下表。

Responses 数组中的每个对象包含以下值。

Value 类型 说明 必须
ApplicationId string 要回复评价的应用的应用商店 ID。 存储 ID 在合作伙伴中心的应用标识页上提供。 Store ID 示例：9WZDNCRFJ3Q8。 是
ReviewId string 要回复的评价 ID（这是一个 GUID）。 评价 ID 位于 Microsoft Store 分析 API 中的获取应用评价方法的回复数据中，以及评价报告的脱机下载中。 是
ResponseText string 要提交的回复。 你的回复必须遵循以下准则。 是
SupportEmail string 应用的支持电子邮件地址，客户可以用它来直接与你联系。 必须为有效的电子邮件地址。 是
IsPublic 布尔 如果指定 true，你的回复将显示于应用的应用商店一览中，客户评价的正下方，而且所有客户都可以看到回复。 如果指定 false ，并且用户未选择不接收电子邮件响应，你的响应将通过电子邮件发送给客户，而你的应用商店列表中的其他客户将看不到此响应。 如果指定 false ，并且用户已选择不接收电子邮件响应，则将返回错误。 是

请求示例

以下示例演示了如何使用此方法提交多个评价的回复。

POST https://manage.devcenter.microsoft.com/v1.0/my/reviews/responses HTTP/1.1
Authorization: Bearer <your access token>
Content-Type: application/json
{
  "Responses": [
    {
      "ApplicationId": "9WZDNCRFJ3Q8",
      "ReviewId": "6be543ff-1c9c-4534-aced-af8b4fbe0316",
      "ResponseText": "Thank you for pointing out this bug. I fixed it and published an update, you should have the fix soon",
      "SupportEmail": "support@contoso.com",
      "IsPublic": true
    },
    {
      "ApplicationId": "9NBLGGH1RP08",
      "ReviewId": "80c9671a-96c2-4278-bcbc-be0ce5a32a7c",
      "ResponseText": "Thank you for submitting your review. Can you tell more about what you were doing in the app when it froze? Thanks very much for your help.",
      "SupportEmail": "support@contoso.com",
      "IsPublic": false
    }
  ]
}

响应

响应正文

值 类型 说明
结果 array 包含每个已提交回复的相关数据的对象数组。 有关每个对象中的数据的详细信息，请参阅下表。

Result 数组中的每个对象包含以下值。

Value 类型 说明
ApplicationId string 已回复评价的应用的应用商店 ID。 Store ID 示例：9WZDNCRFJ3Q8。
ReviewId string 已回复评价的 ID。 这是一个 GUID。
成功 string 值 true 表示你的回复已发送成功。 值 false 表示你的回复失败。
FailureReason string 如果 Successful 为 false，此值包含失败的原因。 如果 Successful 为 true，此值为空。

响应示例

以下示例举例说明此请求的 JSON 响应正文。

{
  "Result": [
    {
      "ApplicationId": "9WZDNCRFJ3Q8",
      "ReviewId": "6be543ff-1c9c-4534-aced-af8b4fbe0316",
      "Successful": "true",
      "FailureReason": ""
    },
    {
      "ApplicationId": "9NBLGGH1RP08",
      "ReviewId": "80c9671a-96c2-4278-bcbc-be0ce5a32a7c",
      "Successful": "false",
      "FailureReason": "No Permission"
    }
  ]
}