创建和管理提交

使用 Microsoft Store 提交 API 以编程方式查询和创建您的或您组织的合作伙伴中心帐户的应用、加载项及软件包试用版提交。 如果帐户管理许多应用或加载项，并且想要自动执行和优化这些资产的提交过程，则此 API 非常有用。 此 API 使用 Azure Active Directory（Azure AD）对来自应用或服务的调用进行身份验证。

以下步骤介绍了使用 Microsoft 应用商店提交 API 的端到端过程：

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

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

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

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

• 必须 将 Azure AD 应用程序与合作伙伴中心帐户相关联， 并获取租户 ID、客户端 ID 和密钥。 需要这些值才能获取 Azure AD 访问令牌，该令牌将在调用 Microsoft 应用商店提交 API 时使用。

• 准备您的应用程序，以便与 Microsoft 商店提交 API 配合使用。

  • 如果你的应用尚不存在于合作伙伴中心，则必须通过在合作伙伴中心保留应用名称来 创建应用。 不能使用 Microsoft 应用商店提交 API 在合作伙伴中心创建应用;你必须在合作伙伴中心工作才能创建它，然后之后，可以使用 API 访问应用并以编程方式为其创建提交。 在为加载项和航班创建提交之前，可以使用 API 以编程方式创建加载项和航班。

  • 在使用此 API 为给定应用创建提交之前，必须先 为合作伙伴中心中的应用创建一个提交，包括回答 年龄分级 问卷。 执行此操作后，你将能够使用 API 以编程方式为此应用创建新提交。 在使用 API 处理这些类型的提交时，您无需创建加载项提交或软件包航班提交。

  • 如果您要创建或更新应用的提交，并且需要包括应用包，则准备应用包。

  • 如果要创建或更新应用提交，并且需要包括应用商店一览的屏幕截图或 图像，请准备应用屏幕截图和图像。

  • 如果要创建或更新加载项提交，并且需要包含图标，准备图标。

如何将 Azure AD 应用程序与合作伙伴中心帐户相关联

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

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

2. 接下来，在合作伙伴中心的 帐户设置 部分中的“用户”页中，添加 Azure AD 应用程序，表示将用于访问合作伙伴中心帐户提交的应用或服务。 请确保为该应用分配 管理员 角色。 如果 Azure AD 目录中尚不存在该应用程序，可以在 合作伙伴中心创建新的 Azure AD 应用程序。

3. 返回到 用户 页面，单击你的 Azure AD 应用程序名称以进入应用程序设置，并抄写 租户 ID 和 客户端 ID 值。

4. 单击“添加新密钥。 在以下屏幕上，记下 密钥的 值。 离开此页面后，将无法再次访问此信息。 有关详细信息，请参阅 管理 Azure AD 应用程序的密钥。

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

在调用 Microsoft Store 提交 API 中的方法之前，必须先获取 Azure AD 访问令牌，并将其传递到 API 中每个方法的 Authorization header。 获取访问令牌后，在它到期前，你有 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。

访问令牌过期后，可以通过再次进行相同的 HTTP 调用来提取一个新令牌。

有关演示如何使用 C#、Java 或 Python 代码获取访问令牌的示例，请参阅Microsoft应用商店提交 API 代码示例。