Создание команд и управление участниками с помощью Microsoft Graph

Вы можете использовать API Microsoft Teams и Microsoft Graph, чтобы создавать команды разными способами. В этой статье описан рекомендуемый подход для достижения наилучших результатов.

Исходное создание команды

В основе всех команд лежат группы Microsoft 365. Самый быстрый способ начать работу при создании команд посредством Microsoft Graph — настроить новую группу Microsoft 365, всех ее владельцев и участников, а затем преобразовать ее в команду.

  1. Создайте группу Microsoft 365 с помощью операции создания группы. Вы можете указать владельцев и участников. Убедитесь в наличии соответствующих владельцев для только что созданной группы, как описано в шаге 2.

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

    • groupTypes = { "Unified" }
    • mailEnabled = true
    • securityEnabled = false
    POST /groups
    {
        "displayName":"Flight 157",
        "mailNickname":"flight157",
        "description":"Everything about flight 157",
        "visibility":"Private",
        "groupTypes":["Unified"],
        "mailEnabled":true,
        "securityEnabled":false,
        "members@odata.bind":[
            "https://graph.microsoft.com/v1.0/users/bec05f3d-a818-4b58-8c2e-2b4e74b0246d",
            "https://graph.microsoft.com/v1.0/users/ae67a4f4-2308-4522-9021-9f402ff0fba8",
            "https://graph.microsoft.com/v1.0/users/eab978dd-35d0-4885-8c46-891b7d618783",
            "https://graph.microsoft.com/v1.0/users/6a1272b5-f6fc-45c4-95fe-fe7c5a676133"
        ],
        "owners@odata.bind":[
            "https://graph.microsoft.com/v1.0/users/6a1272b5-f6fc-45c4-95fe-fe7c5a676133",
            "https://graph.microsoft.com/v1.0/users/eab978dd-35d0-4885-8c46-891b7d618783"
        ]
    }
    

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

    Примечание. Представленный здесь объект отклика может быть сокращен для удобочитаемости. При фактическом вызове будут возвращены все свойства.

    HTTP/1.1 200 OK
    Content-type: application/json
    
    {
        "@odata.context":"https://graph.microsoft.com/v1.0/$metadata#groups/$entity",
        "id":"b7f968af-ca51-42f6-a77e-82c7147bc8f2"
    }
    
  2. Обеспечьте для группы наличие двух или более владельцев. Это можно сделать с помощью операции добавления владельца. Они должны быть реальными учетными записями пользователей, а не учетными записями служб. Наличие двух владельцев помогает обслуживать сценарии, когда один владелец покидает компанию или недоступен для выполнения операций управления командой.

  3. Добавьте всех участников (и гостей при необходимости) в группу с помощью операции добавления участника, если это не сделано на шаге 1. При добавлении нескольких участников добавьте 1-секундную задержку после каждой операции добавления.

  4. После успешного создания группы, что может занять до 15 минут после выполнения шага 1, создайте команду Microsoft Teams с помощью операции создания команды из группы. Если вы столкнулись с ошибкой, процесс создания группы, возможно, не завершен. Попробуйте подождать несколько минут.

    POST https://graph.microsoft.com/v1.0/teams
    Content-Type: application/json
    {
      "template@odata.bind": "https://graph.microsoft.com/v1.0/teamsTemplates('standard')",
      "group@odata.bind": "https://graph.microsoft.com/v1.0/groups('groupId')"
    }
    

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

    Примечание. Представленный здесь объект отклика может быть сокращен для удобочитаемости. При фактическом вызове будут возвращены все свойства.

    HTTP/1.1 202 Accepted
    Content-Type: application/json
    Location: /teams/{teamId}/operations/{operationId}
    Content-Location: /teams/{teamId}
    {
    }
    

    Идентификатор созданной команды такой же, как и идентификатор группы.

  5. После завершения этого процесса все владельцы и участники должны увидеть созданную команду в клиенте Teams.

Добавление участников и управление ими

Чтобы добавить участников после создания команды, используйте операцию добавления участника. Рекомендуем добавить 1-секундную задержку между операциями добавления. Учитывайте следующее касательно изменений участия:

  1. Изменения участия, внесенные в группу Microsoft 365, синхронизируются с Teams с помощью фонового механизма синхронизации, который обычно занимает 24 часа (или больше в некоторых случаях).

  2. Фоновый процесс запускается, если один или несколько пользователей команды (владелец или участник) активны в классическом клиенте Teams. Активность заключается в запуске приложения Teams и/или его работе. Пользователю не требуется специально посещать команду, которая изменяется.

    Примечание. Мобильные клиенты Teams не запускают синхронизацию участия. По крайней мере один пользователь должен находиться в классическом клиенте, чтобы обеспечить правильное выполнение фонового процесса.

Контрольный список для проверки

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

Проверка создания команды

  1. Убедитесь, что создана группа Microsoft 365, дублирующая команду, с помощью Центров администрирования Azure AD или Microsoft 365.

  2. Убедитесь, что команда успешно создана, в портале администрирования Teams.

  3. Проверьте, что у команды есть соответствующие владельцы и участники, с помощью портала администрирования Teams.

  4. Убедитесь, что владельцы команды видят команду после входа в классический или веб-клиент Teams.

  5. Убедитесь, что участники видят команду после входа в классический или веб-клиент Teams.

Проверка добавления участников

  1. Проверьте, что новые участники отображаются в группе, с помощью Центра администрирования Azure AD или Microsoft 365.

  2. Убедитесь, что добавленные участники видят команду после входа в классический или веб-клиент Teams.