Compartir a través de


Agregar miembro al equipo

Espacio de nombres: microsoft.graph

Agregue un nuevo conversationMember a un equipo.

Nota:

  • La propiedad roles está vacía de forma predeterminada para todos los miembros. Esta propiedad solo contiene calificadores adicionales cuando corresponda; por ejemplo, si el miembro tiene owner privilegios, la propiedad roles contiene owner como uno de los valores. De forma similar, si el miembro es un invitado, la propiedad roles contendrá guest como uno de los valores. Un miembro básico no debe tener ningún valor especificado en la propiedad roles .
  • Después de agregar un nuevo miembro de conversación a un equipo, la adición puede tardar algún tiempo en reflejarse. Los usuarios pueden usar notificaciones de cambio para suscribirse a las notificaciones de cambios de pertenencia en un equipo determinado.

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.

Nota:

No se admite el uso de permisos de la aplicación para agregar miembros invitados a un equipo.

Solicitud HTTP

POST /teams/{team-id}/members

Encabezados de solicitud

Nombre Descripción
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 una representación JSON del objeto conversationMember.

Respuesta

Si se ejecuta correctamente, este método devuelve un código de respuesta 201 Created y un objeto conversationMember en el cuerpo de la respuesta.

Para obtener los mejores resultados, las llamadas de escalonamiento con un búfer de 2 segundos.

Nota:

El código 404 Not Found de respuesta se devuelve cuando se intenta agregar un usuario deshabilitado o bloqueado.

Ejemplos

Ejemplo 1: Agregar un miembro a un equipo

Solicitud

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')"
}

Respuesta

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

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@contoso.com"
}

Ejemplo 2: Agregar un miembro a un equipo utilizando el nombre principal de usuario

Solicitud

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')"
}

Respuesta

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

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"
}