Administrar el ciclo de vida de los canales privados en Microsoft TeamsManage the life cycle of private channels in Microsoft Teams

Aquí encontrará las instrucciones que necesita para administrar el uso de la API Graph para administrar los canales privados de los equipos de su organización.Here you'll find the guidance you need to manage use the Graph API to manage Teams private channels in your organization.

Configurar si los propietarios y miembros pueden crear canales privadosSet whether team members can create private channels

Como administrador, puede usar la API de Graph para controlar si los miembros pueden crear canales privados en un equipo específico.As an admin, you can use Graph API to control whether members can create private channels in specific teams. Por ejemplo:Here's an example.

PATCH /teams/<team_id>
{"memberSettings": 
  {
    "allowCreatePrivateChannels": false
  }
}

Crear un canal privado en nombre de un propietario del equipoCreate a private channel on behalf of a team owner

Como administrador, puede usar la API Graph para crear un canal privado en nombre de un propietario del equipo.As an admin, you can use the Graph API to create a private channel on behalf of a team owner. Por ejemplo, quizá quiera hacerlo si su organización pretende centralizar la creación de canales privados.For example, you may want to do this if your organization wants to centralize creation of private channels.

POST /teams/{id}/channels
{ "membershipType": "Private",
  "displayName": "<Channel_Name>",
  "members":[{    
           "@odata.type":"#microsoft.graph.aadUserConversationMember",
           "user@odata.bind":"https://graph.microsoft.com/beta/users('<user_id>')",
           "roles":["owner"]
            }]

Obtenga una lista de todos los mensajes del canal privadoGet a list of all private channel messages

Quizá quiera obtener una lista de todos los mensajes y las respuestas de un canal privado para poder archivarlos y hacer una auditoría.You may want to get a list of all messages and replies posted in a private channel for archiving and auditing purposes. Aquí se muestra cómo usar la API de Graph para hacerlo.Here's how to use Graph API to do this.

GET /teams/{id}/channels/{id}/messages
GET /teams/{id}/channels/{id}/messages/{id}/replies/{id}

Encuentre las direcciones URL de SharePoint para todos los canales privados en un equipoFind SharePoint URLs for all private channels in a team

Tanto si quieres hacer una exhibición de documentos electrónicos o archivos de una suspensión por litigio en un canal privado o quieres diseñar una aplicación personalizada que ubique los archivos en ciertos canales privados, querrás una manera de consultar las únicas colecciones de sitios SharePoint que se han creado para cada canal privado.Whether you're looking to perform eDiscovery or legal hold on files in a private channel or looking to build a custom app that places files in specific private channels, you'll want a way to query the unique SharePoint site collections that are created for each private channel.

Como administrador, puede usar los comandos de las API de Graph para consultar estas direcciones URL.As an admin, you can use Graph APIs commands to query these URLs.

Puede probar estos comandos a través del Explorador de Graph.You can try these commands through Graph Explorer.

  1. Use lo siguiente para obtener la lista de los identificadores de los canales privados para enviarlos al equipo, donde <group_id> es el ID del grupo del equipo.Use the following to get the list of private channel IDs for a given team, where <group_id> is the group ID of the team. Lo necesitará en las siguientes llamadas.You'll need this in subsequent calls. (Puede encontrar fácilmente el ID del grupo en el enlace del equipo.)(You can easily find the group ID in the link to the team).

    SolicitudRequest

    GET https://graph.microsoft.com/beta/teams/<group_id>/channels?$filter=membershipType eq 'private'
    

    RespuestaResponse

    HTTP/1.1 200 OK
    Content-type: application/json
    Content-length:
    
    {
      "value": [
        {
          "description": "description-value",
          "displayName": "display-name-value",
          "id": "channel_id",
          "membershipType": "membership-type-value",
          "isFavoriteByDefault": false,
          "webUrl": "webUrl-value",
          "email": "email-value"
        }
      ]
    }
    
  2. Para cada canal privado del que quiera obtener la dirección URL de SharePoint, haga la siguiente solicitud, donde <channel_id> es el ID del canal.For each private channel which you want to get the SharePoint URL, make the following request, where <channel_id> is the channel ID.

    SolicitudRequest

    GET https://graph.microsoft.com/beta/teams/<group_id>/channels/<channel_id>/filesFolder
    

    RespuestaResponse

    HTTP/1.1 200 OK
    Content-type: application/json
    Content-length:
    
    {
      "value": [
        {
          "description": "description-value",
          "displayName": "display-name-value",
          "id": "channel_id",
          "membershipType": "membership-type-value",
          "isFavoriteByDefault": false,
          "webUrl": "webUrl-value",
          "email": "email-value"
        }
      ]
    }
    

Lista y actualización de roles de los propietarios y los miembros de un canal privadoList and update roles of owners and members in a private channel

Quizá quiera extraer una lista de los propietarios y los miembros de un canal privado para decidir si necesita ascender a ciertos miembros de un canal privado al rol de propietario.You may want to list out the owners and members of a private channel to decide whether you need to promote certain members of the private channel to an owner. Esto puede ocurrir cuando tienes propietarios de canales privados que han dejado la organización y el canal privado requiere ayuda administrativa para reclamar la propiedad del mismo.This can happen when you have owners of private channels who have left the organization and the private channel requires admin help to claim ownership of the channel.

Como administrador, puede usar la API Graph para realizar estas acciones.As an admin, you can use the Graph API to perform these actions.

Puede probar estos comandos a través del Explorador de Graph.You can try these commands through Graph Explorer.

  1. Use lo siguiente, donde <group_id> es el ID de grupo del equipo y <channel_id> es el ID del canal.Use the following, where <group_id> is the group ID of the team and <channel_id> is the channel ID.

    SolicitudRequest

    GET https://graph.microsoft.com/beta/teams/<group_id>/channels/<channel_id>/members
    

    RespuestaResponse

    HTTP/1.1 200 OK Content-type: application/json
    Content-length: 
    {
          "@odata.context": "https://graph.microsoft.com/beta/$metadata#teams({group_id}')/channels('{channel_id}')/members",
          "@odata.count": 2,
          "value": [
              {
                  "@odata.type": "#microsoft.graph.aadUserConversationMember",
                  "id": "id-value",
                  "roles": [],
                  "displayName": "display-name-value",
                  "userId": "userId-value",
                  "email": "email-value"
              },
              {
                  "@odata.type": "#microsoft.graph.aadUserConversationMember",
              "id": "id-value",
              "roles": ["owner"],
              "displayName": "display-name-value",
              "userId": "userId-value",
              "email": "email-value"
              }
          ]
    }
    
  2. Use lo siguiente para ascender un miembro a propietario, donde <group_id>, <channel_id> e <id> se obtienen de llamadas anteriores.Use the following to promote the member to an owner, where <group_id>, <channel_id>, and <id> are returned from the previous call. Tenga en cuanta que <id> y <userId> que se obtienen de llamadas anteriores no son los mismos y no son intercambiables.Note that <id> and <userId> returned from the previous call aren't the same and aren't interchangeable. Asegúrese de que usa el <id>.Make sure you use <id>.

    SolicitudRequest

    PATCH 
    https://graph.microsoft.com/beta/teams/<group_id>/channels/<channel_id>/members/<id>
    
    {
    "@odata.type": "#microsoft.graph.aadUserConversationMember",
    "roles": ["owner"]
    }
    

    RespuestaResponse

    HTTP/1.1 200 OK
    Content-type: application/json
    
    {
      "@odata.context": "https://graph.microsoft.com/beta/$metadata#teams('{group_id}')/channels('{channel_id}')/members/$entity",
      "@odata.type": "#microsoft.graph.aadUserConversationMember",
      "id": "id-value",
      "roles": ["owner"],
      "displayName": "display-name-value",
      "userId": "userId-value",
      "email": "email-value"
     }
    

Usar la API de Microsoft Graph para trabajar con Microsoft TeamsUse the Microsoft Graph API to work with Teams

Enumerar canalesList channels

Crear un canalCreate channel

Agregar un miembro al canalAdd member to channel

Actualizar un miembro del canalUpdate member in channel

Quitar un miembro del canalRemove member from channel