管理加载项提交

创建插件提交

若要为加载项创建提交，请遵循以下步骤。

1. 如果尚未这样做，请完成 使用 Microsoft 应用商店服务创建和管理提交中所述的先决条件，包括将 Azure AD 应用程序与合作伙伴中心帐户关联并获取客户端 ID 和密钥。 只需执行一次;获取客户端 ID 和密钥后，可以随时重复使用它们，以创建新的 Azure AD 访问令牌。

2. 获取 Azure AD 访问令牌。 在 Microsoft Store 提交 API 中，必须将此访问令牌传递给相关方法。 获取访问令牌后，在它到期前，你有 60 分钟的使用时间。 令牌过期后，可以获取一个新令牌。

3. 在 Microsoft 应用商店提交 API 中执行以下方法。 此方法创建一个新的未完成的提交，它是您上次已发布提交的副本。 有关详细信息，请参阅 创建加载项提交。

   POST https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/{id}/submissions
   

   响应正文包含一个 加载项提交 资源，其中包括新提交的 ID、用于上传任何加载项图标到 Azure Blob 存储的共享访问签名（SAS）URI，以及新提交的所有数据（例如列表和定价信息）。

   注释

   SAS URI 提供对 Azure 存储中安全资源的访问权限，而无需帐户密钥。 有关 SAS URI 及其与 Azure Blob 存储配合使用的背景信息，请参阅 共享访问签名，第 1 部分：了解 SAS 模型 和 共享访问签名，第 2 部分：创建 SAS 并将其与 Blob 存储配合使用。

4. 如果要为提交添加新 图标，请准备这些图标 并将其添加到 ZIP 存档。

5. 根据新提交的要求对 加载项提交 数据进行必要的更改，并执行下述方法来更新提交。 有关更多信息，请参阅 更新插件提交。

   PUT https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/{id}/submissions/{submissionId}
   

   注释

   如果要为提交添加新图标，请确保更新提交数据以引用 ZIP 存档中这些文件的名称和相对路径。

6. 如果要为提交添加新图标，请使用前面调用的 POST 方法响应正文中提供的 SAS URI 将 ZIP 存档上传到 Azure Blob 存储 。 可以使用不同的 Azure 库在各种平台上执行此操作，包括：

   • 适用于 .NET 的 Azure 存储客户端库
   • 用于 Java 的 Azure 存储 SDK
   • 用于 Python 的 Azure 存储 SDK

   以下 C# 代码示例演示如何使用适用于 .NET 的 Azure 存储客户端库中的 CloudBlockBlob 类将 ZIP 存档上传到 Azure Blob 存储。 此示例假定 ZIP 存档已写入流对象。

   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. 通过执行以下方法提交。 这将提醒合作伙伴中心你已完成提交，并且你的更新现在应应用于你的帐户。 有关详细信息，请参阅 加载项提交。

   POST https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/{id}/submissions/{submissionId}/commit
   

8. 通过执行以下方法检查提交状态。 有关详细信息，请参阅 查看加载项提交的状态。

   GET https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/{id}/submissions/{submissionId}/status
   

   若要确认提交状态，请查看响应正文中的 状态 值。 如果请求成功，此值应从 CommitStarted 更改为 PreProcessing;如果请求中存在错误，则此值应更改为 CommitFailed。 如果存在错误，statusDetails 字段包含有关错误的更多详细信息。

9. 提交成功完成后，提交将发送到应用商店进行引入。 可以使用以前的方法或访问合作伙伴中心，继续监视提交进度。

{
  "id": "1152921504621243680",
  "contentType": "EMagazine",
  "keywords": [
    "books"
  ],
  "lifetime": "FiveDays",
  "listings": {
    "en": {
      "description": "English add-on description",
      "icon": {
        "fileName": "add-on-en-us-listing2.png",
        "fileStatus": "Uploaded"
      },
      "title": "Add-on Title (English)"
    },
    "ru": {
      "description": "Russian add-on description",
      "icon": {
        "fileName": "add-on-ru-listing.png",
        "fileStatus": "Uploaded"
      },
      "title": "Add-on Title (Russian)"
    }
  },
  "pricing": {
    "marketSpecificPricings": {
      "RU": "Tier3",
      "US": "Tier4",
    },
    "sales": [],
    "priceId": "Free",
    "isAdvancedPricingModel": true
  },
  "targetPublishDate": "2016-03-15T05:10:58.047Z",
  "targetPublishMode": "Immediate",
  "tag": "SampleTag",
  "visibility": "Public",
  "status": "PendingCommit",
  "statusDetails": {
    "errors": [
      {
        "code": "None",
        "details": "string"
      }
    ],
    "warnings": [
      {
        "code": "ListingOptOutWarning",
        "details": "You have removed listing language(s): []"
      }
    ],
    "certificationReports": [
      {
      }
    ]
  },
  "fileUploadUrl": "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",
  "friendlyName": "Submission 2"
}