更新 teamsApp

  • 项目

命名空间：microsoft.graph

更新 以前发布到 Microsoft Teams 应用目录的应用。 若要更新应用，应用的 distributionMethod 属性必须设置为 organization。

此 API 专门更新发布到组织应用目录的应用 (租户应用目录) 。

此 API 可用于以下国家级云部署。

全局服务 美国政府 L4 美国政府 L5 (DOD) 由世纪互联运营的中国
✅ ✅ ✅ ❌

权限

为此 API 选择标记为最低特权的权限。 只有在应用需要它时，才使用更高的特权权限。 有关委派权限和应用程序权限的详细信息，请参阅权限类型。 要了解有关这些权限的详细信息，请参阅 权限参考。

只有全局管理员可以调用此 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"
}

相关内容

Microsoft Graph 特定于服务的节流限制