通过

使用应用商店服务响应评论

  • 项目

重要

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

使用 Microsoft Store 评价 API 可以编程方式在 Microsoft Store 中提交对你的应用评价的回复。 对于想在不使用合作伙伴中心的情况下批量回复多条评价的开发人员来说，此 API 特别有用。 此 API 使用 Azure Active Directory (Azure AD) 验证来自应用或服务的调用。

以下步骤介绍端到端过程：

  1. 确保已完成所有先决条件。
  2. 在Microsoft应用商店评审 API 中调用方法之前， 请获取 Azure AD 访问令牌。 获取令牌后，在令牌过期之前，在调用 Microsoft 应用商店评审 API 时，需要 60 分钟才能使用此令牌。 该令牌到期后，可以重新生成一个。
  3. 调用Microsoft应用商店评审 API。

注意

除了使用 Microsoft Store 评价 API 以编程方式回复评价之外，你还可使用合作伙伴中心回复评价。

步骤 1：完成使用 Microsoft 应用商店评审 API 的先决条件

在开始编写代码以调用 Microsoft 应用商店评审 API 之前，请确保已完成以下先决条件。

  • 你（或你的组织）必须有一个 Azure AD 目录，并且必须对该目录拥有全局管理员权限。 如果你已使用 Microsoft 365 或 Microsoft 的其他业务服务，表示你已经具有 Azure AD 目录。 否则，你可以免费在合作伙伴中心中创建新的 Azure AD。

  • 你必须将 Azure AD 应用程序与你的合作伙伴中心帐户相关联、检索应用程序的租户 ID 和客户端 ID 并生成密钥。 Azure AD 应用程序表示要从中调用Microsoft应用商店评审 API 的应用或服务。 需要使用该租户 ID、客户端 ID 和密钥来获取要传递给 API 的 Azure AD 访问令牌。

    注意

    你只需执行一次此任务。 获取租户 ID、客户端 ID 和密钥后，每当需要创建新的 Azure AD 访问令牌时，都可以重复使用它们。

若要将 Azure AD 应用程序与你的合作伙伴中心帐户相关联并检索所需值：

  1. 在合作伙伴中心，将组织的合作伙伴中心帐户与组织的 Azure AD 目录相关联。

  2. 然后，从合作伙伴中心的“帐户设置”部分的“用户”页面添加 Azure AD 应用程序，这里的应用程序表示应用或服务并且将用于回复评价。 确保为此应用程序分配“管理者”角色。 如果你的 Azure AD 目录中尚不包含该应用程序，可以在合作伙伴中心创建新的 Azure AD 应用程序。

  3. 返回到“用户”页，单击 Azure AD 应用程序的名称转到“应用程序设置”，然后复制“租户 ID”和“客户端 ID”值。

  4. 单击“添加新密钥”。 在下一个屏幕上，复制“密钥”值。 离开此页后，不再可以访问此信息。 有关详细信息，请参阅管理 Azure AD 应用程序的密钥。

步骤 2：获取 Azure AD 访问令牌

在调用 Microsoft 应用商店评审 API 中的任何方法之前，必须先获取传递到 API 中每个方法的 授权 标头的 Azure AD 访问令牌。 获取访问令牌后，你有 60 分钟的时间来使用它，60 分钟后它将过期。 该令牌到期后，可以对它进行刷新，以便可以在之后调用该 API 时继续使用。

若要获取访问令牌，请按照 使用客户端凭据的服务到服务调用 中的说明将 HTTP POST 发送到 https://login.microsoftonline.com/<tenant_id>/oauth2/token 终结点。 示例请求如下所示。

POST https://login.microsoftonline.com/<tenant_id>/oauth2/token HTTP/1.1
Host: login.microsoftonline.com
Content-Type: application/x-www-form-urlencoded; charset=utf-8

grant_type=client_credentials
&client_id=<your_client_id>
&client_secret=<your_client_secret>
&resource=https://manage.devcenter.microsoft.com

对于 POST URI 中的 tenant_id 值以及 client_id 和 client_secret 参数，请指定在上一部分中从合作伙伴中心中为应用程序检索的租户 ID、客户端 ID 和密钥。 对于 resource 参数，必须指定 https://manage.devcenter.microsoft.com。

在你的访问令牌到期后，你可按照此处的说明刷新令牌。

步骤 3：调用Microsoft应用商店评审 API

获得 Azure AD 访问令牌后，即可调用Microsoft应用商店评审 API。 你必须将访问令牌传递到每个方法的 Authorization 标头。

Microsoft应用商店评审 API 包含多种方法，可用于确定是否允许你响应给定的评审，以及提交对一个或多个评论的回复。 按照此过程使用此 API：

  1. 获取要回复的评价的 ID。 在 Microsoft 应用商店分析 API 中获取应用评审方法的响应数据以及 [评论报告]（/windows/apps/publish/reviews-report）的脱机下载中提供了评审 ID。
  2. 调用应用评审方法的 get 响应信息，以确定是否允许你响应评审。 当客户提交评价时，他们可以选择不接收对其评价的回复。 你无法回复由选择不接收评价回复的客户提交的评价。
  3. 调用 对应用评审 方法的提交响应，以编程方式响应评审。