conversationMember: agregar

Espacio de nombres: microsoft.graph

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

Agregar varios miembros a un grupo en una sola solicitud al equipo. La respuesta ofrece información detallada sobre qué pertenencias se pudieron o no crear.

Esta API está disponible en las siguientes implementaciones nacionales de nube.

Servicio global Gobierno de EE. UU. L4 Us Government L5 (DOD) China operada por 21Vianet

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.

Tipo de permiso Permisos con privilegios mínimos Permisos con privilegios más altos
Delegado (cuenta profesional o educativa) TeamMember.ReadWrite.All No disponible.
Delegado (cuenta personal de Microsoft) No admitida. No admitida.
Aplicación TeamMember.ReadWrite.All No disponible.

Solicitud HTTP

Esta es una acción vinculada para agregar varios elementos a una colección conversationMember en una sola solicitud.

POST /teams/{team-id}/members/add

Encabezados de solicitud

Encabezado Valor
Authorization {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización.

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporcione la representación JSON de la lista de derivados conversationMember que se debe agregar al equipo. Se puede agregar un máximo de 200 conversationMember derivados en una sola solicitud.

La siguiente tabla muestra los parámetros que se pueden usar con esta acción.

Parámetro Tipo Descripción
values Colección conversationMember Lista de miembros de la conversación que se deben agregar.

Respuesta

Si se ejecuta correctamente, este método devuelve un código de respuesta 200 OK y la colección de derivados de un actionResultPart en el cuerpo de la respuesta.

Esta API devuelve una 200 respuesta para indicar que todos los miembros proporcionados se agregaron al equipo o una 207 respuesta para indicar que solo se agregaron al equipo algunos de los miembros proporcionados. El autor de la llamada debe inspeccionar la carga de respuesta para determinar cuándo se produjeron errores al agregar miembros. El cuerpo de la respuesta es una colección de derivados del recurso actionResultPart. Esta API responde con un error cuando se produce un error en la solicitud. Para obtener más información sobre los errores de Microsoft Graph, consulte Errores y tipos de recursos de Microsoft Graph.

Ejemplos

Ejemplo 1: agregar usuarios de forma masiva a un equipo

Solicitud

El ejemplo siguiente muestra una solicitud para agregar varios miembros a un equipo.

POST https://graph.microsoft.com/beta/teams/e4183b04-c9a2-417c-bde4-70e3ee46a6dc/members/add
Content-Type: application/json

{
    "values": [
        {
            "@odata.type": "microsoft.graph.aadUserConversationMember",
            "roles":[],
            "user@odata.bind": "https://graph.microsoft.com/beta/users('18a80140-b0fb-4489-b360-2f6efaf225a0')"
        },
        {
            "@odata.type": "microsoft.graph.aadUserConversationMember",
            "roles":["owner"],
            "user@odata.bind": "https://graph.microsoft.com/beta/users('86503198-b81b-43fe-81ee-ad45b8848ac9')"
        }
    ]
}

Respuesta

En el ejemplo siguiente se muestra la respuesta.

Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.

HTTP/1.1 200 OK
Content-Type: application/json

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.aadUserConversationMemberResult)",
    "value": [
        {
            "@odata.type": "#microsoft.graph.aadUserConversationMemberResult",
            "userId": "18a80140-b0fb-4489-b360-2f6efaf225a0",
            "error": null
        },
        {
            "@odata.type": "#microsoft.graph.aadUserConversationMemberResult",
            "userId": "86503198-b81b-43fe-81ee-ad45b8848ac9",
            "error": null
        }
    ]
}

Ejemplo 2: Agregar miembros de forma masiva a un equipo mediante el nombre principal de usuario

Solicitud

En el ejemplo siguiente se muestra una solicitud para agregar varios miembros a un equipo mediante el nombre principal de usuario de los miembros.

POST https://graph.microsoft.com/beta/teams/e4183b04-c9a2-417c-bde4-70e3ee46a6dc/members/add
Content-Type: application/json

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

Respuesta

A continuación se muestra la respuesta.

Nota: Se puede reducir el objeto de respuesta que se muestra aquí para mejorar la legibilidad.

HTTP/1.1 200 OK
Content-Type: application/json

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.aadUserConversationMemberResult)",
    "value": [
        {
            "@odata.type": "#microsoft.graph.aadUserConversationMemberResult",
            "userId": "18a80140-b0fb-4489-b360-2f6efaf225a0",
            "error": null
        },
        {
            "@odata.type": "#microsoft.graph.aadUserConversationMemberResult",
            "userId": "86503198-b81b-43fe-81ee-ad45b8848ac9",
            "error": null
        }
    ]
}