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

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

Добавление нового conversationMember в группу.

Примечание

Свойство роли по умолчанию будет пустым для всех участников. Это свойство содержит только дополнительные квалификаторы, если это необходимо. Например, если участник имеет owner привилегии, свойство ролей содержит owner в качестве одного из значений. Аналогично, если участник является гостем, свойство роли содержит guest в качестве одного из значений. Базовый участник не должен иметь значений, указанных в свойстве роли.

Разрешения

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

Тип разрешения Разрешения (в порядке повышения привилегий)
Делегированные (рабочая или учебная учетная запись) TeamMember.ReadWrite.All
Делегированные (личная учетная запись Майкрософт) Не поддерживается.
Приложение TeamMember.ReadWrite.All

Примечание

Использование разрешений приложения для добавления гостей в команду не поддерживается.

HTTP-запрос

POST /teams/{team-id}/members

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

Имя Описание
Авторизация Bearer {token}. Обязательный.
Content-Type application/json. Обязательный.

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

В теле запроса укажите описание объекта conversationMember в формате JSON.

Отклик

В случае успеха этот метод возвращает код отклика 201 Created и объект conversationMember в тексте отклика.

Чтобы добиться наилучших результатов, регулируйте звонки с использованием 2-секундной буферизации.

Примеры

Пример 1. Добавление участника в команду

Запрос

POST https://graph.microsoft.com/v1.0/teams/ee0f5ae2-8bc6-4ae5-8466-7daeebbfa062/members
Content-type: application/json

{
    "@odata.type": "#microsoft.graph.aadUserConversationMember",
    "roles": ["owner"],
    "user@odata.bind": "https://graph.microsoft.com/v1.0/users('8b081ef6-4792-4def-b2c9-c363a1bf41d5')"
}

Отклик

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

HTTP/1.1 201 Created
Content-type: application/json

{
    "@odata.type": "#microsoft.graph.aadUserConversationMember",
    "id": "ZWUwZjVhZTItOGJjNi00YWU1LTg0NjYtN2RhZWViYmZhMDYyIyM3Mzc2MWYwNi0yYWM5LTQ2OWMtOWYxMC0yNzlhOGNjMjY3Zjk=",
    "roles": [
        "owner"
    ],
    "userId": "50dffbae-ad0f-428e-a86f-f53b0acfc641",
    "displayName": "Cameron White",
    "email": "CameronW@M365x987948.OnMicrosoft.com"
}

Пример 2. Добавление участника в команду с использованием имени субъекта-пользователя

Запрос

POST https://graph.microsoft.com/v1.0/teams/ee0f5ae2-8bc6-4ae5-8466-7daeebbfa062/members
Content-type: application/json

{
    "@odata.type": "#microsoft.graph.aadUserConversationMember",
    "roles": ["owner"],
    "user@odata.bind": "https://graph.microsoft.com/v1.0/users('jacob@contoso.com')"
}

Отклик

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

HTTP/1.1 201 Created
Content-type: application/json

{
    "@odata.type": "#microsoft.graph.aadUserConversationMember",
    "id": "ZWUwZjVhZTItOGJjNi00YWU1LTg0NjYtN2RhZWViYmZhMDYyIyM3Mzc2MWYwNi0yYWM5LTQ2OWMtOWYxMC0yNzlhOGNjMjY3Zjk=",
    "roles": [
        "owner"
    ],
    "userId": "50dffbae-ad0f-428e-a86f-f53b0acfc641",
    "displayName": "Jacob Hancock",
    "email": "jacob@contoso.com"
}

См. также