Обновление teamsApp
Пространство имен: microsoft.graph
Обновите приложение , ранее опубликованное в каталоге приложений Microsoft Teams. Чтобы обновить приложение, свойству distributionMethod для приложения необходимо присвоить значение organization
.
Этот API специально обновляет приложение, опубликованное в каталоге приложений вашей организации (каталоге приложений клиента).
Этот API доступен в следующих национальных облачных развертываниях.
Глобальная служба | Правительство США L4 | Правительство США L5 (DOD) | Китай управляется 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ❌ |
Разрешения
Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более привилегированное разрешение или разрешения только в том случае, если это требуется приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.
- Этот API могут вызывать только администраторы служб Teams или более привилегированная роль.
Тип разрешения | Разрешения с наименьшими привилегиями | Более высокие привилегированные разрешения |
---|---|---|
Делегированные (рабочая или учебная учетная запись) | AppCatalog.Submit | AppCatalog.ReadWrite.All, Directory.ReadWrite.All |
Делегированные (личная учетная запись Майкрософт) | Не поддерживается. | Не поддерживается. |
Для приложений | Не поддерживается. | Не поддерживается. |
Примечание.
- Разрешение Directory.ReadWrite.All поддерживается только для обратной совместимости. Рекомендуется обновить решения, чтобы использовать другое разрешение, указанное в предыдущей таблице, и избегать использования этих разрешений в будущем.
HTTP-запрос
POST /appCatalogs/teamsApps/{id}/appDefinitions
Параметры запроса
Свойство | Тип | Описание |
---|---|---|
requiresReview | Логический | Этот необязательный параметр запроса активирует процесс проверки приложения. Пользователи с правами администратора могут отправлять приложения без запуска проверки. Если пользователи хотят запросить проверку перед публикацией, они должны задать для параметра requiresReview значение true . Пользователь с правами администратора может отказаться от установки обязательного просмотра или задать значение false , а приложение будет утверждено и немедленно опубликовано. |
Заголовки запросов
Заголовок | Значение |
---|---|
Авторизация | Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации. |
Content-Type | application/zip. Обязательно. |
Текст запроса
В тексте запроса добавьте полезные данные zip-манифеста Teams. Дополнительные сведения см. в разделе Создание пакета приложения.
Заметка: Используйте идентификатор, возвращенный из вызова списка опубликованных приложений , чтобы сослаться на приложение, которое вы хотите обновить. Не используйте идентификатор из манифеста пакета zip-приложения.
Отклик
В случае успешного выполнения этот метод возвращает код отклика 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
Дополнительные сведения о ZIP-файле приложения Teams см. в разделе Создание пакета приложения.
Отклик
Ниже показан пример отклика.
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