向 Microsoft Store 发送请求

从 Windows 10 版本 1607 起，Windows SDK 在 Windows.Services.Store 命名空间中为与 Microsoft Store 相关的操作（如应用内购买）提供 API。 但是，尽管支持应用商店的服务在操作系统发布过程中不断地更新、扩展和提高，但新的 API 通常只会在主要操作系统版本中添加到 Windows SDK。

我们提供的 SendRequestAsync 方法可以在发布新版本的 Windows SDK 之前灵活地为通用 Windows 平台 (UWP) 应用提供新的应用商店操作。 你可以使用此方法为最新版本的 Windows SDK 中尚未提供对应 API 的新操作向应用商店发送请求。

SendRequestAsync 是一种 StoreRequestHelper 类的静态方法。 若要调用此方法，你必须将以下信息传递给此方法：

• StoreContext 对象，用于提供与你想要为其执行操作的用户相关的信息。 有关此对象的更多信息，请参阅 StoreContext 类入门。
• 用于标识你想要向应用商店发送的请求的整数。
• 如果请求支持任何参数，你还可以传递 JSON 格式的字符串，它包含要与请求一起传递的参数。

下面的示例演示如何调用此方法。 本示例要求使用适用于 Windows.Services.Store 和 System.Threading.Tasks 命名空间的语句。

public async Task<bool> AddUserToFlightGroup()
{
    StoreSendRequestResult result = await StoreRequestHelper.SendRequestAsync(
        StoreContext.GetDefault(), 8,
        "{ \"type\": \"AddToFlightGroup\", \"parameters\": { \"flightGroupId\": \"your group ID\" } }");

    if (result.ExtendedError == null)
    {
        return true;
    }

    return false;
}

请参阅以下部分，了解与当前可通过 SendRequestAsync 方法发送的请求相关的信息。 如果添加了新请求的支持，我们将会更新此文章。

请求应用内评分和评价

你可以在应用中通过将请求整数 16 传递给 SendRequestAsync 方法，以编程方式启动对话框，请客户对应用进行评分和提交评价。 有关详细信息，请参阅在应用中显示评分和评价对话框。

适合于外部测试版组方案的请求

SendRequestAsync 方法支持一组外部测试版组方案的请求，例如为外部测试版组添加用户或设备。 若要提交这些请求，请将 requestKind 参数值 7 或 8 以及 JSON 格式的字符串一起传递给用于指示你想要与任何相关参数一起提交的请求的 parametersAsJson 参数。 该方法还支持使用 BigID 映射 PFN 的请求（显示目录中的 ProductID）。 若要提交此请求，请将值 9 传递给 requestKind 参数。 这些 requestKind 值在以下方面不同。

当前实施的是以下外部测试版组请求。

检索排名最高的外部测试版组的远程变量

此请求将为当前用户或设备检索排名最高的外部测试版组的远程变量。 若要发送此请求，请将以下信息传递至 SendRequestAsync 方法的 requestKind 和 parametersAsJson 参数。

以下示例显示了要传递至 parametersAsJson 的 JSON 数据格式。 必须为类型字段分配字符串 GetRemoteVariables。 在合作伙伴中心中为你已在其中定义了远程变量的项目 ID 分配 projectId 字段。

{ 
    "type": "GetRemoteVariables", 
    "parameters": "{ \"projectId\": \"your project ID\" }" 
}

提交此请求之后，StoreSendRequestResult 返回值的 Response 属性将包含 JSON 格式的字符串及以下字段。

以下示例展示了此请求的返回值。

{ 
  "anonymous": false, 
  "name": "Insider Slow",
  "settings":
  {
      "Audience": "Slow"
      ...
  }
}

将当前设备或用户添加到外部测试版组

若要发送此请求，请将以下信息传递至 SendRequestAsync 方法的 requestKind 和 parametersAsJson 参数。

以下示例显示了要传递至 parametersAsJson 的 JSON 数据格式。 必须为类型字段分配字符串 AddToFlightGroup。 为你想要向其中添加设备或用户的外部测试版组 ID 分配 flightGroupId 字段。

{ 
    "type": "AddToFlightGroup", 
    "parameters": "{ \"flightGroupId\": \"your group ID\" }" 
}

如果请求中没有错误，则 StoreSendRequestResult 返回值的 HttpStatusCode 属性将包含响应代码。

从外部测试版组中删除当前设备或用户

若要发送此请求，请将以下信息传递至 SendRequestAsync 方法的 requestKind 和 parametersAsJson 参数。

以下示例显示了要传递至 parametersAsJson 的 JSON 数据格式。 必须为类型字段分配字符串 RemoveFromFlightGroup。 为你想要从其中删除设备或用户的外部测试版组 ID 分配 flightGroupId 字段。

{ 
    "type": "RemoveFromFlightGroup", 
    "parameters": "{ \"flightGroupId\": \"your group ID\" }" 
}

如果请求中没有错误，则 StoreSendRequestResult 返回值的 HttpStatusCode 属性将包含响应代码。

相关主题

• 在应用中显示评分和评价对话框
• SendRequestAsync