更新 teamsApp
命名空间：microsoft.graph
更新 以前发布到 Microsoft Teams 应用目录的应用。 若要更新应用，应用的 distributionMethod 属性必须设置为 organization。
此 API 专门更新发布到组织应用目录的应用 (租户应用目录) 。
此 API 可用于以下国家级云部署。
| 全局服务 | 美国政府 L4 | 美国政府 L5 (DOD) | 由世纪互联运营的中国 |
|---|---|---|---|
| ✅ | ✅ | ✅ | ❌ |
权限
为此 API 选择标记为最低特权的权限。 只有在应用需要它时，才使用更高的特权权限。 有关委派权限和应用程序权限的详细信息，请参阅权限类型。 要了解有关这些权限的详细信息，请参阅 权限参考。
- 只有 Teams 服务管理员或更高特权角色才能调用此 API。
| 权限类型 | 最低特权权限 | 更高特权权限 |
|---|---|---|
| 委派（工作或学校帐户） | AppCatalog.Submit | AppCatalog.ReadWrite.All、Directory.ReadWrite.All |
| 委派（个人 Microsoft 帐户） | 不支持。 | 不支持。 |
| 应用程序 | 不支持。 | 不支持。 |
注意
- 仅支持向后兼容性的 Directory.ReadWrite.All 权限。 建议更新解决方案，以使用上表中列出的替代权限，并避免今后使用这些权限。
HTTP 请求
POST /appCatalogs/teamsApps/{id}/appDefinitions
查询参数
| 属性 | 类型 | 说明 |
|---|---|---|
| requiresReview | 布尔值 | 此可选查询参数将触发应用评审过程。 具有管理员权限的用户无需触发评审即可提交应用。 如果用户希望在发布前请求评审，则必须将 requiresReview 设置为 true。 具有管理员权限的用户可以选择不设置 requiresReview 或将值设置为 false ，并且应用获得批准并立即发布。 |
请求标头
| 标头 | 值 |
|---|---|
| Authorization | 持有者 {token}。 必填。 详细了解 身份验证和授权。 |
| Content-Type | application/zip。 必填。 |
请求正文
在请求正文中，包括 Teams zip 清单有效负载。 有关详细信息，请参阅 创建应用包。
注意： 使用 从列表已发布应用 调用返回的 ID 引用要更新的应用。 不要使用 zip 应用包清单中的 ID。
响应
如果成功，此方法返回 204 No Content 响应代码。
示例
示例 1：更新以前发布到 Microsoft Teams 应用目录的应用程序
请求
以下示例显示了一个请求。
POST https://graph.microsoft.com/v1.0/appCatalogs/teamsApps/06805b9e-77e3-4b93-ac81-525eb87513b8/appDefinitions
Content-type: application/zip
app.zip
有关 Teams 应用程序 zip 文件的详细信息，请参阅 创建应用包。
响应
以下示例显示了相应的响应。
HTTP/1.1 204 No Content
示例 2：在当前租户目录中发布之前更新现有应用的新版本以供管理员评审
请求
以下示例显示了一个请求。
POST https://graph.microsoft.com/v1.0/appCatalogs/teamsApps/e3e29acb-8c79-412b-b746-e6c39ff4cd22/appDefinitions?requiresReview=true
Content-type: application/zip
app.zip
响应
如果成功，此方法在响应正文中返回响应 201 Created 代码和键值对 "publishingState": "submitted" 。 有关详细信息，请参阅 teamsAppDefinition。
HTTP/1.1 201 Created
Location: https://graph.microsoft.com/v1.0/appCatalogs/teamsApps/e3e29acb-8c79-412b-b746-e6c39ff4cd22/appDefinitions/MGQ4MjBlY2QtZGVmMi00Mjk3LWFkYWQtNzgwNTZjZGU3Yzc4IyMxLjAuMA==
Content-Type: application/json
{
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#appDefinition",
"@odata.etag": "158749010",
"id": "MGQ4MjBlY2QtZGVmMi00Mjk3LWFkYWQtNzgwNTZjZGU3Yzc4IyMxLjAuMA==",
"teamsAppId": "e3e29acb-8c79-412b-b746-e6c39ff4cd22",
"displayName": "Test app",
"version": "1.0.11",
"azureADAppId": "a651cc7d-ec54-4fb2-9d0e-2c58dc830b0b",
"requiredResourceSpecificApplicationPermissions":[
"ChannelMessage.Read.Group",
"Channel.Create.Group",
"Tab.ReadWrite.Group",
"Member.Read.Group"
],
"publishingState": "submitted",
"lastModifiedDateTime": "2020-02-10 22:48:33.841"
}