Crear equipos y administrar miembros con Microsoft Graph

Puede usar la API de Microsoft Teams en Microsoft Graph para crear equipos de varias maneras. Este artículo describe el enfoque que recomendamos para los mejores resultados.

Creación de equipos inicial

Todos los equipos están respaldados por los grupos de Microsoft 365. La forma más rápida para poner en marcha a su equipo cuando cree nuevos equipos a través de Microsoft Graph es configurando un nuevo grupo de Microsoft 365 con todos sus propietarios y miembros, y convertirlo en un equipo.

  1. Cree un grupo de Microsoft 365 usando la operación Crear grupo. Puede especificar propietarios y miembros. Asegúrese de que tiene los propietarios adecuados para el grupo recién creado, como se describe en el paso 2.

    Para crear un equipo para este grupo, debe establecer los siguientes valores de propiedad tal como se muestra a continuación:

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

    En el ejemplo siguiente se muestra la respuesta.

    Nota: se puede acortar el objeto de respuesta que se muestra para mejorar la legibilidad. Se devolverán todas las propiedades de una llamada real.

    HTTP/1.1 200 OK
    Content-type: application/json
    Content-length: xxx
    {
        "@odata.context":"https://graph.microsoft.com/v1.0/$metadata#groups/$entity",
        "id":"b7f968af-ca51-42f6-a77e-82c7147bc8f2"
    }
    
  2. Asegúrese de que el grupo tiene dos o más propietarios. Para hacerlo, puede usar la operación Agregar propietario. Deben ser cuentas de usuario reales y no cuentas de servicio. Tener dos propietarios ayuda a manejar los casos, como medida preventiva, en el caso de que un propietario abandone la empresa o no esté disponible para realizar operaciones de administración de equipos.

  3. Agregue al grupo a todos los miembros (e invitados si es necesario) mediante la operación agregar miembros si no lo ha hecho en el paso 1. Si va a agregar varios miembros, añada un 1 segundo de retardo después de cada operación de adición.

  4. Una vez que se haya creado el grupo correctamente, lo que puede tardar unos 15 minutos más una vez completado el paso 1, cree un equipo de Microsoft Teams con la operación crear equipo a partir de grupo. Si se produce un error, puede que el proceso de creación de grupos no se haya completado. Espere unos minutos y vuelva a intentarlo.

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

    En el ejemplo siguiente se muestra la respuesta.

    Nota: se puede acortar el objeto de respuesta que se muestra para mejorar la legibilidad. Se devolverán todas las propiedades de una llamada real.

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

    El equipo creado tiene el mismo identificador que el grupo.

  5. Cuando finalice este proceso, todos los propietarios y miembros deberían poder ver el equipo recién creado en el cliente de Teams.

Agregar o administrar miembros

Para agregar miembros después de crear un equipo, use la operación agregar miembro. Se recomienda agregar un retardo de 1 segundo entre las operaciones de adición. Tenga en cuenta lo siguiente con respecto a los cambios en la pertenencia:

  1. Los cambios de suscripción realizados en los grupos de Microsoft 365 se sincronizan con Teams a través de un mecanismo de sincronización en segundo plano que generalmente demora 24 horas (o más, en algunos casos).

  2. El proceso en segundo plano solo se activa si uno o más usuarios del equipo (propietario o miembro) están activos en el cliente de escritorio de Teams. Iniciar la aplicación Teams y/o que se esté ejecutando constituye una actividad: no es necesario que un usuario visite específicamente el equipo que se está modificando.

    Nota: los clientes móviles de Teams no desencadenan la sincronización de pertenencia. Al menos un usuario debe estar en el cliente de escritorio para asegurarse de que este proceso en segundo plano se ejecuta sin inconvenientes.

Lista de comprobación para validación

Después de crear un equipo, puede usar la siguiente lista de comprobación para asegurarse de que el equipo se creó correctamente.

Validar la creación de equipos

  1. Compruebe que el grupo de Microsoft 365 que realiza la copia de seguridad del equipo haya sido creado a través de los centros de administración de Azure AD o de Microsoft 365.

  2. Compruebe que la creación del equipo se haya realizado correctamente mediante el portal de administración de Teams.

  3. Compruebe que el equipo tiene los propietarios y miembros adecuados que aparecen en el portal de administración de Teams.

  4. Compruebe que los propietarios del equipo pueden ver al equipo después de iniciar sesión en el cliente de escritorio o Web de Teams.

  5. Compruebe que los miembros pueden ver al equipo después de iniciar sesión en el cliente de escritorio o Web de Teams.

Validar la adición de miembros

  1. Compruebe que los nuevos miembros se mostrarán en el grupo mediante el Centro de administración de Microsoft 365 o Azure AD.

  2. Compruebe que los nuevos miembros pueden ver al equipo después de iniciar sesión en el cliente de escritorio o Web de Teams.