通过

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

重要

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

使用 Microsoft 应用商店评论 API 以编程方式响应应用商店中应用的评论。 对于希望在不使用合作伙伴中心的情况下批量响应许多评论的开发人员，此 API 特别有用。 此 API 使用 Azure Active Directory（Azure AD）对来自应用或服务的调用进行身份验证。

以下步骤描述了端到端过程：

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

注释

除了使用 Microsoft 应用商店评论 API 以编程方式响应评论之外，还可以使用合作伙伴中心回复评论。

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

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

  • 您（或您的组织）必须具有 Azure AD 目录，并且必须对该目录拥有 全局管理员 权限。 如果已从 Microsoft 使用 Microsoft 365 或其他业务服务，则已有 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 中的任一方法之前，必须先获取 Azure AD 访问令牌，并将其传递给 API 中每个方法的 授权 标头。 获取访问令牌后，在它到期前，你有 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 和密钥。 对于“资源”参数，必须指定 https://manage.devcenter.microsoft.com。

访问令牌过期后，您可以按照此处 的说明刷新它。

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

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

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

  1. 获取要回复的评论的 ID。 在 Microsoft Store 分析 API 中的 获取应用评审 方法的响应数据中，可获得评审 ID，并可在 [审阅报告](/windows/apps/publish/reviews-report) 的 离线下载 中获取这些评审。
  2. 调用 获取应用评审的响应信息 方法，以确定是否允许你回复评论。 当客户提交评审时，他们可以选择不接收评审的回复。 你无法响应已选择不接收评审回复的客户提交的评论。
  3. 调用 提交对应用评审的响应 方法以编程方式响应评审。
  • Last updated on