提交对评论的回复

2025-06-10

重要

Microsoft Store 评论 API，如本主题所述，当前无法正常工作。与其使用 API，不如通过使用合作伙伴中心来实现相同的任务。

在 Microsoft 应用商店评论 API 中使用此方法以编程方式响应应用的评论。调用此方法时，必须指定要响应的评论的 ID。在 Microsoft Store 分析 API 中的获取应用评审方法的响应数据，以及评审报告的脱机下载中，可以找到评审 ID。

当客户提交评审时，他们可以选择不接收评审的回复。如果尝试回复客户选择不接收回复的评论，此方法的响应正文将指示回复尝试未成功。在调用此方法之前，可以选择性地确定是否允许使用获取应用评审方法的响应信息来响应给定的评审。

注释

除了可以使用这种方法以编程方式响应评审之外，您还可以借助合作伙伴中心回复评审。

先决条件

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

如果尚未这样做，请完成 Microsoft Store 审查 API 的所有先决条件。
获取 Azure AD 访问令牌，以供在此方法的请求标头中使用。获取访问令牌后，在它到期前，你有 60 分钟的使用时间。令牌过期后，可以获取一个新令牌。
获取要回复的评论的 ID。在 Microsoft Store 分析 API 中的获取应用评审方法的响应数据，以及评审报告的脱机下载中，可以找到评审 ID。

请求

请求语法

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

请求标头

标题	类型	DESCRIPTION
授权	字符串	必填。 Azure AD 访问令牌，形式为Bearer<token>。

请求参数

此方法没有请求参数。

请求主体

请求正文具有以下值。

价值	类型	DESCRIPTION
反应	数组	包含要提交的响应数据的对象的数组。有关每个对象中的数据的详细信息，请参阅下表。

响应数组中的每个对象都包含以下值。

价值	类型	DESCRIPTION	必选
ApplicationId	字符串	您想要回应评论的应用的商店 ID。 Microsoft Store ID 在合作伙伴中心的 “应用标识”页上可用。应用商店 ID 示例为 9WZDNCRFJ3Q8。	是的
ReviewId	字符串	要响应的评论的 ID（这是 GUID）。在 Microsoft Store 分析 API 中的获取应用评审方法的响应数据，以及评审报告的脱机下载中，可以找到评审 ID。	是的
响应文本	字符串	要提交的响应。响应必须遵循这些准则。	是的
支持电子邮件	字符串	你的应用的支持电子邮件地址，客户可以使用该电子邮件地址直接与你联系。这必须是有效的电子邮件地址。	是的
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
    }
  ]
}

响应

响应体

价值	类型	DESCRIPTION
结果	数组	一个对象数组，其中包含有关你提交的每个响应的数据。有关每个对象中的数据的详细信息，请参阅下表。

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

价值	类型	DESCRIPTION
ApplicationId	字符串	你回应评论的应用的商店 ID。应用商店 ID 示例为 9WZDNCRFJ3Q8。
ReviewId	字符串	你所回应的评审 ID。这是 GUID。
成功	字符串	true 的值指示已成功发送响应。值 false 指示响应失败。
故障原因	字符串	如果成功的值是 false，那么此值包含失败的原因。如果成功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"
    }
  ]
}