更新 teamsApp

项目
02/14/2022

命名空间：microsoft.graph

重要

Microsoft Graph版本下的 /beta API 可能会发生更改。不支持在生产应用程序中使用这些 API。若要确定 API 是否在 v1.0 中可用，请使用版本选择器。

更新之前发布到应用程序目录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/beta/appCatalogs/teamsApps/06805b9e-77e3-4b93-ac81-525eb87513b8/appDefinitions
Content-type: application/zip

[Zip file containing a Teams app package]

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

响应

如果成功，此方法返回 204 No Content 响应代码。

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

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

[Zip file containing a Teams app package]


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')
    .version('beta')
    .post(teamsAppDefinition);

重要

Microsoft Graph SDK 默认使用 v1.0 版本的 API，并且不支持 beta 版本中提供的所有类型、属性和 API。有关使用 SDK 访问 beta API 的详细信息，请参阅将 Microsoft Graph SDK 与 beta API 配合使用。

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

响应

如果成功，此方法在响应201 Created正文中返回响应代码和键/publishingState``submitted值对：。 请参阅 teamsappdefinition。

HTTP/1.1 201 Created
Location: https://graph.microsoft.com/beta/appCatalogs/teamsApps/e3e29acb-8c79-412b-b746-e6c39ff4cd22/appDefinitions/MGQ4MjBlY2QtZGVmMi00Mjk3LWFkYWQtNzgwNTZjZGU3Yzc4IyMxLjAuMA==
Content-Type: application/json

{
    "@odata.context": "https://graph.microsoft.com/beta/$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",
}