管理软件包外部测试版提交Manage package flight submissions

Microsoft Store 提交 API 提供可用于管理针对应用的软件包外部测试版提交的方法,包括逐步软件包推出。The Microsoft Store submission API provides methods you can use to manage package flight submissions for your apps, including gradual package rollouts. 有关 Microsoft Store 提交 API 的介绍(包括使用 API 的先决条件),请参阅使用 Microsoft Store 服务创建和管理提交For an introduction to the Microsoft Store submission API, including prerequisites for using the API, see Create and manage submissions using Microsoft Store services.

重要

如果使用 Microsoft Store 提交 API 来创建包航班的提交,请确保只使用 API 而不是合作伙伴中心对提交进行进一步更改。If you use the Microsoft Store submission API to create a submission for a package flight, be sure to make further changes to the submission only by using the API, rather than Partner Center. 如果你使用仪表板更改你最初使用此 API 创建的提交,则将无法再使用此 API 更改或提交该提交。If you use the dashboard to change a submission that you originally created by using the API, you will no longer be able to change or commit that submission by using the API. 在某些情况下,在提交过程中无法继续进行时,提交可能会处于错误状态。In some cases, the submission could be left in an error state where it cannot proceed in the submission process. 如果发生这种情况,你必须删除提交并创建新的提交。If this occurs, you must delete the submission and create a new submission.

管理软件包外部测试版提交的方法Methods for managing package flight submissions

使用以下方法获取、创建、更新、提交或删除软件包外部测试版提交。Use the following methods to get, create, update, commit, or delete a package flight submission. 在可以使用这些方法之前,包航班必须已存在于合作伙伴中心。Before you can use these methods, the package flight must already exist in Partner Center. 可以在 合作伙伴中心 创建包航班,或使用 管理包航班中所述的 Microsoft Store 提交 API 方法。You can create a package flight in Partner Center or by using the Microsoft Store submission API methods in described in Manage package flights.

方法Method URIURI 说明Description
GETGET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}/submissions/{submissionId} 获取现有软件包外部测试版提交Get an existing package flight submission
GETGET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}/submissions/{submissionId}/status 获取现有软件包外部测试版提交的状态Get the status of an existing package flight submission
POSTPOST https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}/submissions 创建新的软件包外部测试版提交Create a new package flight submission
PUTPUT https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}/submissions/{submissionId} 更新现有软件包外部测试版提交Update an existing package flight submission
POSTPOST https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}/submissions/{submissionId}/commit 提交新的或更新的软件包外部测试版提交Commit a new or updated package flight submission
DELETEDELETE https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}/submissions/{submissionId} 删除软件包外部测试版提交Delete a package flight submission

创建软件包外部测试版提交Create a package flight submission

若要创建软件包外部测试版提交,请遵循此过程。To create a submission for a package flight, follow this process.

  1. 如果尚未执行此操作,请完成 使用 Microsoft Store 服务创建和管理提交中所述的先决条件,包括将 Azure AD 应用程序与合作伙伴中心帐户关联并获取客户端 ID 和密钥。If you have not yet done so, complete the prerequisites described in Create and manage submissions using Microsoft Store services, including associating an Azure AD application with your Partner Center account and obtaining your client ID and key. 你只需执行此操作一次;有了客户端 ID 和密钥后,当你需要创建新的 Azure AD 访问令牌时,可以随时重复使用它们。You only need to do this one time; after you have the client ID and key, you can reuse them any time you need to create a new Azure AD access token.

  2. 获取 Azure AD 访问令牌Obtain an Azure AD access token. 在 Microsoft Store 提交 API 中,必须将此访问令牌传递给相关方法。You must pass this access token to the methods in the Microsoft Store submission API. 获取访问令牌后,在它到期前,你有 60 分钟的使用时间。After you obtain an access token, you have 60 minutes to use it before it expires. 该令牌到期后,可以获取新的令牌。After the token expires, you can obtain a new one.

  3. 通过执行 Microsoft Store 提交 API 中的以下方法创建软件包外部测试版提交Create a package flight submission by executing the following method in the Microsoft Store submission API. 此方法创建新的正在进行的提交,这是你上次发布的提交的副本。This method creates a new in-progress submission, which is a copy of your last published submission.

    POST https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}/submissions
    

    响应正文包含外部测试版提交资源(包括新提交的 ID、用于将提交的任何程序包上传到 Azure Blob 存储的共享访问签名 (SAS) URI)和新提交的数据(包括所有应用一览和定价信息)。The response body contains a flight submission resource that includes the ID of the new submission, the shared access signature (SAS) URI for uploading any packages for the submission to Azure Blob storage, and the data for the new submission (including all the listings and pricing information).

    备注

    SAS URI 提供对 Azure 存储中的安全资源的访问权限(无需帐户密钥)。A SAS URI provides access to a secure resource in Azure storage without requiring account keys. 有关 SAS URI 以及借助 Azure Blob 使用这些 URI 的背景信息,请参阅共享访问签名,第 1 部分:了解 SAS 模型共享访问签名,第 2 部分:使用 Blob 存储创建和使用 SASFor background information about SAS URIs and their use with Azure Blob storage, see Shared Access Signatures, Part 1: Understanding the SAS model and Shared Access Signatures, Part 2: Create and use a SAS with Blob storage.

  4. 若要为提交添加新的软件包,请准备软件包并将它们添加到 ZIP 存档。If you are adding new packages for the submission, prepare the packages and add them to a ZIP archive.

  5. 使用新提交所需的任何更改修订外部测试版提交数据,并执行以下方法来更新软件包外部测试版提交Revise the flight submission data with any required changes for the new submission, and execute the following method to update the package flight submission.

    PUT https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}/submissions/{submissionId}
    

    备注

    如果要为提交添加新的软件包,请确保更新提交数据以便在 ZIP 存档中引用这些文件的名称和相对路径。If you are adding new packages for the submission, make sure you update the submission data to refer to the name and relative path of these files in the ZIP archive.

  6. 如果要为提交添加新包,请使用 SAS URI 将 ZIP 存档上载到 Azure Blob 存储,该 URI 已在之前调用的 POST 方法的响应正文中提供。If you are adding new packages for the submission, upload the ZIP archive to Azure Blob storage using the SAS URI that was provided in the response body of the POST method you called earlier. 你可以使用不同的 Azure 库在多个平台上进行此操作,包括:There are different Azure libraries you can use to do this on a variety of platforms, including:

    以下 C# 代码示例演示如何在用于 .NET 的 Azure 存储客户端库中使用 CloudBlockBlob 类将 ZIP 存档上载到 Azure Blob 存储。The following C# code example demonstrates how to upload a ZIP archive to Azure Blob storage using the CloudBlockBlob class in the Azure Storage Client Library for .NET. 此示例假定 ZIP 存档已写入流对象。This example assumes that the ZIP archive has already been written to a stream object.

    string sasUrl = "https://productingestionbin1.blob.core.windows.net/ingestion/26920f66-b592-4439-9a9d-fb0f014902ec?sv=2014-02-14&sr=b&sig=usAN0kNFNnYE2tGQBI%2BARQWejX1Guiz7hdFtRhyK%2Bog%3D&se=2016-06-17T20:45:51Z&sp=rwl";
    Microsoft.WindowsAzure.Storage.Blob.CloudBlockBlob blockBob =
        new Microsoft.WindowsAzure.Storage.Blob.CloudBlockBlob(new System.Uri(sasUrl));
    await blockBob.UploadFromStreamAsync(stream);
    
  7. 通过执行以下方法确认软件包外部测试版提交Commit the package flight submission by executing the following method. 这会提醒合作伙伴中心你已完成提交,你的更新现在应应用到你的帐户。This will alert Partner Center that you are done with your submission and that your updates should now be applied to your account.

    POST https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}/submissions/{submissionId}/commit
    
  8. 通过执行以下方法来检查提交状态以获取软件包外部测试版提交的状态Check on the commit status by executing the following method to get the status of the package flight submission.

    GET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}/submissions/{submissionId}/status
    

    若要确认提交状态,请查看响应正文中的 status 值。To confirm the submission status, review the status value in the response body. 如果请求成功,此值应该从 CommitStarted 更改为 PreProcessing;如果请求中存在错误,此值应该更改为 CommitFailedThis value should change from CommitStarted to either PreProcessing if the request succeeds or to CommitFailed if there are errors in the request. 如果存在错误,statusDetails 字段将包含有关错误的更多详细信息。If there are errors, the statusDetails field contains further details about the error.

  9. 在提交成功完成之后,提交会发送至应用商店以供引入。After the commit has successfully completed, the submission is sent to the Store for ingestion. 你可以继续使用以前的方法或通过访问合作伙伴中心来监视提交进度。You can continue to monitor the submission progress by using the previous method, or by visiting Partner Center.

代码示例Code examples

下文中提供了详细的代码示例,演示如何以不同的多种编程语言创建软件包外部测试版提交。The following articles provide detailed code examples that demonstrate how to create a package flight submission in several different programming languages:

StoreBroker PowerShell 模块StoreBroker PowerShell module

除了直接调用 Microsoft Store 提交 API 的方式外,我们还提供在该 API 之上实现命令行界面的开源 PowerShell 模块。As an alternative to calling the Microsoft Store submission API directly, we also provide an open-source PowerShell module which implements a command-line interface on top of the API. 此模块称为 StoreBrokerThis module is called StoreBroker. 你可以使用此模块从命令行管理你的应用、外部测试版和加载项提交,而不是通过直接调用 Microsoft Store 提交 API,或者你可以浏览源以查看更多有关如何调用此 API 的示例。You can use this module to manage your app, flight, and add-on submissions from the command line instead of calling the Microsoft Store submission API directly, or you can simply browse the source to see more examples for how to call this API. 在 Microsoft 内,StoreBroker 模块作为将许多第一方应用程序提交到 Microsoft Store 的主要方式被频繁使用。The StoreBroker module is actively used within Microsoft as the primary way that many first-party applications are submitted to the Store.

有关详细信息,请参阅我们 GitHub 上的 StoreBroker 页面For more information, see our StoreBroker page on GitHub.

管理软件包外部测试版提交的逐步软件包推出Manage a gradual package rollout for a package flight submission

可在软件包外部测试版提交中逐步向 Windows 10 上一定比例的应用客户推出已更新的软件包。You can gradually roll out the updated packages in a package flight submission to a percentage of your app’s customers on Windows 10. 这使你可以监视特定程序包的反馈和分析数据,从而确保在更广泛地推出更新前对此更新无虑。This allows you to monitor feedback and analytic data for the specific packages to make sure you’re confident about the update before rolling it out more broadly. 可更改已发布提交的推出百分比(或终止更新),而无需创建新提交。You can change the rollout percentage (or halt the update) for a published submission without having to create a new submission. 有关更多详细信息,包括如何在合作伙伴中心启用和管理逐步包推出的说明,请参阅 此文For more details, including instructions for how to enable and manage a gradual package rollout in Partner Center, see this article.

若要以编程方式启用软件包外部测试版提交的逐步软件包推出,请遵循此过程使用 Microsoft Store 提交 API 中的以下方法:To programmatically enable a gradual package rollout for a package flight submission, follow this process using methods in the Microsoft Store submission API:

  1. 创建软件包外部测试版提交获取软件包外部测试版提交Create a package flight submission or get a package flight submission.
  2. 在响应数据中,找到 " packageRollout " 资源,将 " isPackageRollout " 字段设置为 "true",并将 " packageRolloutPercentage " 字段设置为应该获取更新包的应用客户的百分比。In the response data, locate the packageRollout resource, set the isPackageRollout field to true, and set the packageRolloutPercentage field to the percentage of your app's customers who should get the updated packages.
  3. 将已更新的软件包外部测试版提交数据传递到更新软件包外部测试版提交方法。Pass the updated package flight submission data to the update a package flight submission method.

针对软件包外部测试版提交启用逐步软件包推出后,你可以使用以下方法以编程方式获取、更新、终止或完成逐步推出。After a gradual package rollout is enabled for a package flight submission, you can use the following methods to programmatically get, update, halt, or finalize the gradual rollout.

方法Method URIURI 说明Description
GETGET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}/submissions/{submissionId}/packagerollout 获取软件包外部测试版提交的逐步推出信息Get the gradual rollout info for a package flight submission
POSTPOST https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}/submissions/{submissionId}/updatepackagerolloutpercentage 更新软件包外部测试版提交的逐步推出百分比Update the gradual rollout percentage for a package flight submission
POSTPOST https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}/submissions/{submissionId}/haltpackagerollout 终止软件包外部测试版提交的逐步推出Halt the gradual rollout for a package flight submission
POSTPOST https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}/submissions/{submissionId}/finalizepackagerollout 完成软件包外部测试版提交的逐步推出Finalize the gradual rollout for a package flight submission

数据资源Data resources

管理软件包外部测试版提交的 Microsoft Store 提交 API 方法使用以下 JSON 数据资源。The Microsoft Store submission API methods for managing package flight submissions use the following JSON data resources.

外部测试版提交资源Flight submission resource

此资源描述了软件包外部测试版提交。This resource describes a package flight submission.

{
  "id": "1152921504621243649",
  "flightId": "cd2e368a-0da5-4026-9f34-0e7934bc6f23",
  "status": "PendingCommit",
  "statusDetails": {
    "errors": [],
    "warnings": [],
    "certificationReports": []
  },
  "flightPackages": [
    {
      "fileName": "newPackage.appx",
      "fileStatus": "PendingUpload",
      "id": "",
      "version": "1.0.0.0",
      "languages": ["en-us"],
      "capabilities": [],
      "minimumDirectXVersion": "None",
      "minimumSystemRam": "None"
    }
  ],
  "packageDeliveryOptions": {
    "packageRollout": {
        "isPackageRollout": false,
        "packageRolloutPercentage": 0.0,
        "packageRolloutStatus": "PackageRolloutNotStarted",
        "fallbackSubmissionId": "0"
    },
    "isMandatoryUpdate": false,
    "mandatoryUpdateEffectiveDate": "1601-01-01T00:00:00.0000000Z"
  },
  "fileUploadUrl": "https://productingestionbin1.blob.core.windows.net/ingestion/8b389577-5d5e-4cbe-a744-1ff2e97a9eb8?sv=2014-02-14&sr=b&sig=wgMCQPjPDkuuxNLkeG35rfHaMToebCxBNMPw7WABdXU%3D&se=2016-06-17T21:29:44Z&sp=rwl",
  "targetPublishMode": "Immediate",
  "targetPublishDate": "",
  "notesForCertification": "No special steps are required for certification of this app."
}

此资源具有以下值。This resource has the following values.

Value 类型Type 说明Description
idid 字符串string 提交的 ID。The ID for the submission.
flightIdflightId 字符串string 提交相关联的软件包外部测试版的 ID。The ID of the package flight that the submission is associated with.
状态status 字符串string 提交的状态。The status of the submission. 这可以是以下值之一:This can be one of the following values:
  • None
  • 已取消Canceled
  • PendingCommitPendingCommit
  • CommitStartedCommitStarted
  • CommitFailedCommitFailed
  • PendingPublicationPendingPublication
  • 发布Publishing
  • 已发布Published
  • PublishFailedPublishFailed
  • PreProcessingPreProcessing
  • PreProcessingFailedPreProcessingFailed
  • 认证Certification
  • CertificationFailedCertificationFailed
  • ReleaseRelease
  • ReleaseFailedReleaseFailed
statusDetailsstatusDetails 对象 (object)object 包含有关提交状态的附加详细信息的状态详细信息资源,其中包括任何错误的相关信息。A status details resource that contains additional details about the status of the submission, including information about any errors.
flightPackagesflightPackages arrayarray 包含提供提交中关于每个程序包详细信息的软件包外部测试版资源Contains flight package resources that provide details about each package in the submission.
packageDeliveryOptionspackageDeliveryOptions 对象 (object)object 包含提交的逐步软件包推出和强制更新设置的软件包递送选项资源A package delivery options resource that contains gradual package rollout and mandatory update settings for the submission.
fileUploadUrlfileUploadUrl 字符串string 用于为提交上传任何程序包的共享访问签名 (SAS) URI。The shared access signature (SAS) URI for uploading any packages for the submission. 如果要为提交添加新的程序包,请将包含这些程序包的 ZIP 存档上载到此 URI。If you are adding new packages for the submission, upload the ZIP archive that contains the packages to this URI. 有关详细信息,请参阅创建软件包外部测试版提交For more information, see Create a package flight submission.
targetPublishModetargetPublishMode 字符串string 提交的发布模式。The publish mode for the submission. 这可以是以下值之一:This can be one of the following values:
  • 即时Immediate
  • 手动Manual
  • SpecificDateSpecificDate
targetPublishDatetargetPublishDate 字符串string 提交的发布日期采用 ISO 8601 格式(如果 targetPublishMode 设为“SpecificDate”)。The publish date for the submission in ISO 8601 format, if the targetPublishMode is set to SpecificDate.
notesForCertificationnotesForCertification 字符串string 提供认证测试人员的其他信息,例如测试帐户凭据以及访问和验证功能的步骤。Provides additional info for the certification testers, such as test account credentials and steps to access and verify features. 有关详细信息,请参阅认证说明For more information, see Notes for certification.

状态详细信息资源Status details resource

此资源包含有关提交状态的附加详细信息。This resource contains additional details about the status of a submission. 此资源具有以下值。This resource has the following values.

Value 类型Type 描述Description
错误errors 对象 (object)object 包含提交的错误详细信息的状态详细信息资源数组。An array of status detail resources that contain error details for the submission.
warningswarnings 对象 (object)object 包含提交的警告详细信息的状态详细信息资源数组。An array of status detail resources that contain warning details for the submission.
certificationReportscertificationReports 对象 (object)object 提供对提交的认证报告数据的访问权限的认证报告资源数组。An array of certification report resources that provide access to the certification report data for the submission. 如果认证失败,可检查这些报告,获取详细信息。You can examine these reports for more information if the certification fails.

状态详细信息资源Status detail resource

此资源包含关于提交的任何相关错误或警告的附加详细信息。This resource contains additional information about any related errors or warnings for a submission. 此资源具有以下值。This resource has the following values.

Value 类型Type 说明Description
codecode stringstring 描述错误或警告类型的提交状态代码A submission status code that describes the type of error or warning.
详细信息details 字符串string 包含有关问题的更多详细信息的消息。A message with more details about the issue.

认证报告资源Certification report resource

此资源提供对提交的认证报告数据的访问权限。This resource provides access to the certification report data for a submission. 此资源具有以下值。This resource has the following values.

Value 类型Type 描述Description
datedate 字符串string 生成报表的日期和时间,采用 ISO 8601 格式。The date and time the report was generated, in ISO 8601 format.
reportUrlreportUrl 字符串string 用于访问报告的 URL。The URL at which you can access the report.

软件包外部测试版资源Flight package resource

此资源提供有关提交中的程序包的详细信息。This resource provides details about a package in a submission.

{
  "flightPackages": [
    {
      "fileName": "newPackage.appx",
      "fileStatus": "PendingUpload",
      "id": "",
      "version": "1.0.0.0",
      "languages": ["en-us"],
      "capabilities": [],
      "minimumDirectXVersion": "None",
      "minimumSystemRam": "None"
    }
  ],
}

此资源具有以下值。This resource has the following values.

备注

当调用更新应用提交方法时,请求正文中仅需要此对象的 fileNamefileStatusminimumDirectXVersionminimumSystemRam 值。When calling the update a package flight submission method, only the fileName, fileStatus, minimumDirectXVersion, and minimumSystemRam values of this object are required in the request body. 其他值由合作伙伴中心填充。The other values are populated by Partner Center.

Value 类型Type 描述Description
fileNamefileName 字符串string 包的名称。The name of the package.
fileStatusfileStatus 字符串string 程序包的状态。The status of the package. 这可以是以下值之一:This can be one of the following values:
  • None
  • PendingUploadPendingUpload
  • 已上传Uploaded
  • PendingDeletePendingDelete
idid 字符串string 唯一标识程序包的 ID。An ID that uniquely identifies the package. 此值由合作伙伴中心使用。This value is used by Partner Center.
版本version 字符串string 应用包的版本。The version of the app package. 有关详细信息,请参阅程序包版本编号For more information, see Package version numbering.
体系结构architecture 字符串string 应用包的体系结构(例如 ARM)。The architecture of the app package (for example, ARM).
语言languages arrayarray 语言代码数组,用于指示应用支持的语言。An array of language codes for the languages the app supports. 有关详细信息,请参阅支持的语言For more information, see For more information, see Supported languages.
capabilitiescapabilities arrayarray 程序包所需的功能数组。An array of capabilities required by the package. 有关功能的详细信息,请参阅应用功能声明For more information about capabilities, see App capability declarations.
minimumDirectXVersionminimumDirectXVersion 字符串string 应用包支持的最低 DirectX 版本。The minimum DirectX version that is supported by the app package. 这可以仅针对面向 Windows 8.x 的应用进行设置;对于面向其他版本的应用,它将忽略。This can be set only for apps that target Windows 8.x; it is ignored for apps that target other versions. 这可以是以下值之一:This can be one of the following values:
  • None
  • DirectX93DirectX93
  • DirectX100DirectX100
minimumSystemRamminimumSystemRam 字符串string 应用包所需的最小 RAM。The minimum RAM that is required by the app package. 这可以仅针对面向 Windows 8.x 的应用进行设置;对于面向其他版本的应用,它将忽略。This can be set only for apps that target Windows 8.x; it is ignored for apps that target other versions. 这可以是以下值之一:This can be one of the following values:
  • None
  • Memory2GBMemory2GB

软件包递送选项资源Package delivery options resource

此资源包含提交的逐步软件包推出和强制更新设置。This resource contains gradual package rollout and mandatory update settings for the submission.

{
  "packageDeliveryOptions": {
    "packageRollout": {
        "isPackageRollout": false,
        "packageRolloutPercentage": 0.0,
        "packageRolloutStatus": "PackageRolloutNotStarted",
        "fallbackSubmissionId": "0"
    },
    "isMandatoryUpdate": false,
    "mandatoryUpdateEffectiveDate": "1601-01-01T00:00:00.0000000Z"
  },
}

此资源具有以下值。This resource has the following values.

Value 类型Type 描述Description
packageRolloutpackageRollout 对象 (object)object 包含提交的逐步软件包推出设置的软件包推出资源A package rollout resource that contains gradual package rollout settings for the submission.
isMandatoryUpdateisMandatoryUpdate booleanboolean 指示是否要将此提交中的软件包视为对自行安装的应用更新强制。Indicates whether you want to treat the packages in this submission as mandatory for self-installing app updates. 有关自行安装的应用更新的强制软件包的详细信息,请参阅为应用下载并安装包更新For more information about mandatory packages for self-installing app updates, see Download and install package updates for your app.
mandatoryUpdateEffectiveDatemandatoryUpdateEffectiveDate datedate 此提交中的软件包变为强制的日期和时间,采用 ISO 8601 格式和 UTC 时区。The date and time when the packages in this submission become mandatory, in ISO 8601 format and UTC time zone.

软件包推出资源Package rollout resource

此资源包含提交的逐步软件包推出设置This resource contains gradual package rollout settings for the submission. 此资源具有以下值。This resource has the following values.

Value 类型Type 描述Description
isPackageRolloutisPackageRollout booleanboolean 指示是否为提交启用逐步软件包推出。Indicates whether gradual package rollout is enabled for the submission.
packageRolloutPercentagepackageRolloutPercentage floatfloat 将在逐步推出中收到软件包的用户百分比。The percentage of users who will receive the packages in the gradual rollout.
packageRolloutStatuspackageRolloutStatus 字符串string 以下指示逐步软件包推出状态的字符串之一:One of the following strings that indicates the status of the gradual package rollout:
  • PackageRolloutNotStartedPackageRolloutNotStarted
  • PackageRolloutInProgressPackageRolloutInProgress
  • PackageRolloutCompletePackageRolloutComplete
  • PackageRolloutStoppedPackageRolloutStopped
fallbackSubmissionIdfallbackSubmissionId 字符串string 将由不获取逐步推出软件包的客户接收的提交 ID。The ID of the submission that will be received by customers who do not get the gradual rollout packages.

备注

PackageRolloutStatusFallbackSubmissionId值由合作伙伴中心分配,不应由开发人员设置。The packageRolloutStatus and fallbackSubmissionId values are assigned by Partner Center, and are not intended to be set by the developer. 如果已将这些值包括在请求正文中,则将忽略这些值。If you include these values in a request body, these values will be ignored.

枚举Enums

这些方法使用以下枚举。These methods use the following enums.

提交状态代码Submission status code

以下代码表示提交的状态。The following codes represent the status of a submission.

代码Code 说明Description
None 未指定任何代码。No code was specified.
InvalidArchiveInvalidArchive 包含程序包的 ZIP 存档无效或具有无法识别的存档格式。The ZIP archive containing the package is invalid or has an unrecognized archive format.
MissingFilesMissingFiles ZIP 存档未包含提交数据中列出的所有文件,或者它们位于存档中的错误位置。The ZIP archive does not have all files which were listed in your submission data, or they are in the wrong location in the archive.
PackageValidationFailedPackageValidationFailed 提交中的一个或多个程序包验证失败。One or more packages in your submission failed to validate.
InvalidParameterValueInvalidParameterValue 请求正文中的某一个参数无效。One of the parameters in the request body is invalid.
InvalidOperationInvalidOperation 所尝试的操作无效。The operation you attempted is invalid.
InvalidStateInvalidState 所尝试的操作对当前状态的软件包外部测试版无效。The operation you attempted is not valid for the current state of the package flight.
ResourceNotFoundResourceNotFound 找不到指定的软件包外部测试版。The specified package flight could not be found.
ServiceErrorServiceError 导致请求失败的内部服务错误。An internal service error prevented the request from succeeding. 重新尝试请求。Try the request again.
ListingOptOutWarningListingOptOutWarning 开发人员已从以前的提交中删除了某个列表,或者未包含程序包支持的列表信息。The developer removed a listing from a previous submission, or did not include listing information that is supported by the package.
ListingOptInWarningListingOptInWarning 开发人员添加了一个列表。The developer added a listing.
UpdateOnlyWarningUpdateOnlyWarning 开发人员正在尝试插入仅具有更新支持的某些内容。The developer is trying to insert something that only has update support.
其他Other 提交处于无法识别或未分类的状态。The submission is in an unrecognized or uncategorized state.
PackageValidationWarningPackageValidationWarning 程序包验证过程导致出现警告。The package validation process resulted in a warning.