更新某个加载项的提交

2025-06-10

在 Microsoft Store 提交 API 中使用此方法更新现有的附加组件（也称为应用内产品或 IAP）提交。使用此方法成功更新提交后，必须提交提交以供引入和发布。

有关此方法如何融入使用 Microsoft Store 提交 API 创建加载项提交流程的更多信息，请参阅管理加载项提交。

先决条件

若要使用此方法，首先需要执行以下操作：

如果尚未这样做，请完成Microsoft应用商店提交 API 的所有先决条件。
获取 Azure AD 访问令牌，以供在此方法的请求标头中使用。获取访问令牌后，在它到期前，你有 60 分钟的使用时间。令牌过期后，可以获取一个新令牌。
为你的一个应用程序创建一个插件提交。可以在合作伙伴中心执行此操作，也可以使用创建加载项提交方法执行此操作。

请求

此方法具有以下语法。有关标头和请求正文的使用示例和说明，请参阅以下部分。

方法	请求 URI
放置	`https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/{inAppProductId}/submissions/{submissionId}`

请求标头

标题	类型	DESCRIPTION
授权	字符串	必填。 Azure AD 访问令牌，形式为Bearer<token>。

请求参数

名称	类型	DESCRIPTION
应用内产品ID	字符串	必填。要为其更新提交的加载项的应用商店 ID。商店 ID 在合作伙伴中心可用，并且包含在响应数据中，用于请求创建加载项或请求获取加载项详细信息。
提交ID (submissionId)	字符串	必填。要更新的提交 ID。请求创建加载项提交的响应数据中提供了此 ID。对于在合作伙伴中心创建的提交，此 ID 也可以在合作伙伴中心的提交页面的 URL 中提供。

请求主体

请求正文具有以下参数。

价值	类型	DESCRIPTION
内容类型	字符串	加载项中提供的内容类型。这可以是以下值之一：未设置图书下载 EMagazine 电子报纸音乐下载 MusicStream OnlineDataStorage 视频下载 VideoStream Asp 在线下载
关键字	数组	包含最多 10 个附加组件关键字的一个字符串数组。您的应用程序可以使用这些关键字查询加载项。
一生	字符串	加载项的生命周期。这可以是以下值之一：永远 OneDay ThreeDays FiveDays OneWeek TwoWeeks 一个月 TwoMonths 三个月六个月一年
清单	物体	一个对象，其中包含加载项的列表信息。有关详细信息，请参阅列出的资源。
定价	物体	一个对象，其中包含加载项的定价信息。有关详细信息，请参阅定价资源。
目标发布模式	字符串	提交时的发布模式。这可以是以下值之一：立刻手动具体日期
目标发布日期	字符串	如果 targetPublishMode 设置为 SpecificDate，则提交的发布日期应采用 ISO 8601 格式。
标签	字符串	加载项的自定义开发人员数据（此信息以前称为标记）。
能见度	字符串	加载项的可见性。这可以是以下值之一：隐藏公众私人未设置

请求示例

以下示例演示如何更新加载项提交。

PUT https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/9NBLGGH4TNMP/submissions/1152921504621230023 HTTP/1.1
Authorization: Bearer <your access token>
Content-Type: application/json
{
  "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"
  },
  "targetPublishDate": "2016-03-15T05:10:58.047Z",
  "targetPublishMode": "Immediate",
  "tag": "SampleTag",
  "visibility": "Public",
}

响应

以下示例演示了成功调用此方法的 JSON 响应正文。响应正文包含有关更新提交的信息。关于响应正文中数值的详细信息，请参阅插件提交资源。

{
  "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"
  },
  "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"
}

错误代码

如果请求无法成功完成，响应将包含以下 HTTP 错误代码之一。

错误代码	DESCRIPTION
400	无法更新提交，因为请求无效。
409	由于加载项的当前状态，无法更新提交，或者是因为加载项使用合作伙伴中心功能，而 Microsoft Store 提交 API当前不支持该功能。

通过