Добавление приложения в команду

Пространство имен: microsoft.graph

Установите приложение в указанную команду.

Этот API доступен в следующих национальных облачных развертываниях.

Глобальная служба Правительство США L4 Правительство США L5 (DOD) Китай управляется 21Vianet

Разрешения

Для вызова этого API требуется одно из следующих разрешений. Дополнительные сведения, включая сведения о том, как выбрать разрешения, см. в статье Разрешения.

Тип разрешения Разрешения (в порядке повышения привилегий)
Делегированные (рабочая или учебная учетная запись) TeamsAppInstallation.ReadWriteSelfForTeam1, TeamsAppInstallation.ReadWriteForTeam1, TeamsAppInstallation.ReadWriteAndConsentSelfForTeam, Group.ReadWrite.All2, Directory.ReadWrite.All2
Делегированные (личная учетная запись Майкрософт) Не поддерживается.
Приложение TeamsAppInstallation.ReadWriteSelfForTeam.All1, TeamsAppInstallation.ReadWriteForTeam.All1, TeamsAppInstallation.ReadWriteAndConsentForTeam.All, TeamsAppInstallation.ReadWriteAndConsentSelfForTeam.All, Group.ReadWrite.All2, Directory.ReadWrite.All2

Примечание.
1 Эти разрешения не могут использоваться для установки приложений, которым требуется согласие на разрешения согласия для конкретного ресурса .
2 Эти разрешения поддерживаются только для обратной совместимости. Мы рекомендуем обновить решения, чтобы использовать альтернативное разрешение и не использовать эти разрешения в будущем.

HTTP-запрос

POST /teams/{team-id}/installedApps

Заголовки запросов

Заголовок Значение
Авторизация Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации.

Текст запроса

Текст запроса должен содержать созданный идентификатор приложения каталога. Дополнительные сведения см. в разделе Свойства teamsApp.

В следующей таблице перечислены дополнительные свойства, которые можно включить в текст запроса.

Свойство Тип Описание
teamsApp String Идентификатор добавляемого приложения.
consentedPermissionSet teamsAppPermissionSet Набор разрешений для конкретных ресурсов, на которые предоставляется согласие.

Примечание. Разрешения, на которые было предоставлено согласие во время установки, должны соответствовать разрешениям для конкретных ресурсов, указанным в teamsAppDefinition приложения. Чтобы получить разрешения для приложения и делегированных ресурсов, см. пример 6. Если в teamsAppDefinition указаны только делегированные разрешения для конкретного ресурса, разрешения можно опустить в тексте запроса.

Отклик

В случае успешного выполнения этот метод возвращает код отклика 200 OK. Он не возвращает ничего в теле ответа.

Примеры

Пример 1. Установка приложения в команде

Запрос

Ниже показан пример запроса.

POST https://graph.microsoft.com/v1.0/teams/87654321-0abc-zqf0-321456789q/installedApps
Content-type: application/json

{
   "teamsApp@odata.bind":"https://graph.microsoft.com/v1.0/appCatalogs/teamsApps/12345678-9abc-def0-123456789a"
}

Отклик

Ниже показан пример отклика.

HTTP/1.1 200 OK

Чтобы получить список разрешений для конкретных ресурсов, необходимых приложению, получите приложение из appCatalog, как показано в примере 6.

Запрос

POST https://graph.microsoft.com/v1.0/teams/7023576d-9e40-47ca-9cf2-daae6838e785/installedApps
Content-Type: application/json

{
  "teamsApp@odata.bind" : "https://graph.microsoft.com/v1.0/appCatalogs/teamsApps/7023576d-9e40-47ca-9cf2-daae6838e785",
    "consentedPermissionSet": {
        "resourceSpecificPermissions": [
        {
          "permissionValue": "OnlineMeeting.ReadBasic.Chat",
          "permissionType": "delegated"
        },
        {
          "permissionValue": "ChatMessage.Read.Chat",
          "permissionType": "application"
        }]
      }
}

Отклик

HTTP/1.1 201 Created

Если при вызове появляется сообщение The required permissions have not been consented to by the callerоб ошибке , в тексте запроса не указываются все разрешения RSC, необходимые приложению, на которые пользователь должен предоставить согласие. Убедитесь, что вы создаете запрос, как показано в примере.