Compartir a través de


conversationMember: remove

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.

Quite varios miembros de un equipo en una sola solicitud. La respuesta proporciona detalles sobre qué pertenencias se pudieron quitar y no se pudieron quitar.

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

Se trata de una acción enlazada para quitar varios elementos de una colección conversationMember en una sola solicitud.

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

Encabezados de solicitud

Encabezado Valor
Authorization {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización.
Content-Type application/json. Obligatorio.

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporcione la representación JSON de la lista de derivados conversationMember que se van a quitar de un equipo. Se puede quitar un máximo de 20 derivados conversationMember en una sola solicitud.

En la tabla siguiente se muestra el parámetro que se puede usar con este método.

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

Respuesta

Si se ejecuta correctamente, este método devuelve una 204 No Content respuesta si todos los miembros especificados se quitaron correctamente del equipo o una 207 Multi-Status respuesta si solo se quitaron algunos miembros. El llamador debe inspeccionar la carga de respuesta para identificar qué eliminaciones de miembros han producido errores. El cuerpo de la respuesta contiene una colección de derivados del recurso actionResultPart . Si se produce un error en la solicitud, la API devuelve un error. Para obtener más información sobre los errores de Microsoft Graph, consulte Respuestas de error de Microsoft Graph y tipos de recursos.

Ejemplos

Ejemplo 1: Eliminación masiva de miembros de un equipo

En el ejemplo siguiente se muestra cómo quitar varios miembros de un equipo en una sola solicitud.

Solicitud

En el ejemplo siguiente se muestra la solicitud.

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

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

Respuesta

En el ejemplo siguiente se muestra la respuesta.

HTTP/1.1 204 No Content

Ejemplo 2: Eliminación masiva de miembros de un equipo mediante el nombre principal de usuario

En el ejemplo siguiente se muestra cómo quitar varios miembros de un equipo en una sola solicitud mediante sus nombres principales de usuario.

Solicitud

En el ejemplo siguiente se muestra la solicitud.

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

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

Respuesta

En el ejemplo siguiente se muestra la respuesta.

HTTP/1.1 204 No Content

Ejemplo 3: Eliminación masiva de miembros de un equipo con eliminaciones erróneas

En el ejemplo siguiente se muestra cómo quitar varios miembros de un equipo cuando se produce un error en la eliminación de un miembro.

Solicitud

En el ejemplo siguiente se muestra la solicitud.

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

{
    "values": [
        {
            "@odata.type": "microsoft.graph.aadUserConversationMember",
            "user@odata.bind": "https://graph.microsoft.com/beta/users('c04f28bf-ab68-40a2-974b-e6af31fa78fb')"
        },
        {
            "@odata.type": "microsoft.graph.aadUserConversationMember",
            "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 207 Multi-Status
Content-Type: application/json

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.aadUserConversationMemberResult)",
    "value": [
        {
            "@odata.type": "#microsoft.graph.aadUserConversationMemberResult",
            "userId": "c04f28bf-ab68-40a2-974b-e6af31fa78fb",
            "error": {
                "code": "NotFound",
                "message": "Could not find resource"
            }
        },
        {
            "@odata.type": "#microsoft.graph.aadUserConversationMemberResult",
            "userId": "86503198-b81b-43fe-81ee-ad45b8848ac9",
            "error": null
        }
    ]
}

Quitar miembro de un equipo