大网数据广告活动
Microsoft Graph 接口

更新 teamsApp

· 52CE 我爱测

更新之前发布到应用程序Teams的应用程序。

命名空间:microsoft.graph

更新之前发布到应用程序Microsoft Teams的应用程序。 若要更新应用, 必须将应用的 distributionMethod 属性设置为 organization。

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

权限

要调用此 API,需要以下权限之一。要了解详细信息,包括如何选择权限的信息,请参阅权限。

注意: 只有全局管理员可以调用此 API。

权限类型 权限(从最低特权到最高特权)
委派(工作或学校帐户) AppCatalog.Submit、AppCatalog.ReadWrite.All、Directory.ReadWrite.All**
委派(个人 Microsoft 帐户) 不支持
应用程序 不支持。

注意:标记为 ** 的权限仅支持向后兼容。 建议您更新解决方案以使用上表中列出的备用权限,并避免今后使用这些权限。

HTTP 请求

POST /appCatalogs/teamsApps/{id}/appDefinitions

查询参数

属性 类型 说明
requiresReview 布尔值 此可选查询参数将触发应用评审过程。 具有管理员权限的用户无需触发审查即可提交应用。 如果用户想要在发布之前请求审阅,则必须将 设置为 requiresReview true。 具有管理员权限的用户可以选择 requiresReview 不设置或将 false 值设置为 ,应用将被视为已批准,并且将立即发布。

请求标头

标头 值
Authorization Bearer {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

[Zip file containing a Teams app package]

有关应用程序 zip Teams的详细信息,请参阅创建应用包。

响应
HTTP/1.1 204 No Content

示例 2:在当前租户目录中发布之前,更新现有应用的新版本供管理员审阅

请求

HTTP

POST https://graph.microsoft.com/v1.0/appCatalogs/teamsApps/e3e29acb-8c79-412b-b746-e6c39ff4cd22/appDefinitions?requiresReview=true
Content-type: application/zip

[Zip file containing a Teams app package]

JavaScript


const options = {
    authProvider,
};

const client = Client.init(options);

const teamsAppDefinition = [Zip file containing a Teams app package];

await client.api('/appCatalogs/teamsApps/e3e29acb-8c79-412b-b746-e6c39ff4cd22/appDefinitions?requiresReview=true')
    .post(teamsAppDefinition);

有关如何将 SDK 添加 到项目并 创建 authProvider 实例的 详细信息,请参阅 SDK 文档。


响应

如果成功,此方法在响应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",
}

历史资料。此文对应 2023-02-03 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者(原始作者元数据 nkramer)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / Microsoft Graph 中文文档历史快照
适用范围
历史中文快照 2023-02-03;详见原文产品版本;文档日期 未标明
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。