Compartir a través de


Enumerar allChannels

Espacio de nombres: microsoft.graph

Obtiene la lista de channels en este team o compartidos con este team (canales entrantes).

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) Channel.ReadBasic.All ChannelSettings.Read.All, ChannelSettings.ReadWrite.All
Delegado (cuenta personal de Microsoft) No admitida. No admitida.
Aplicación Channel.ReadBasic.All ChannelSettings.Read.All, ChannelSettings.ReadWrite.All

Nota: esta API admite permisos de administrador. Los administradores de servicios de Microsoft Teams pueden acceder a los equipos de los que no son miembros.

Solicitud HTTP

GET /teams/{team-id}/allChannels

Parámetros de consulta opcionales

Este método admite los parámetros de consulta $filter y $selectOData para ayudar a personalizar la respuesta.

Usar $select para mejorar el rendimiento

Rellenar elde correo electrónico de ymoderationSettings propiedades de un canal es una operación costosa que da como resultado un rendimiento lento. Use $selectpara excluir elde correo electrónicoy moderationSettings propiedades para mejorar el rendimiento.

Encabezados de solicitud

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

Cuerpo de la solicitud

No proporcione un cuerpo de solicitud para este método.

Respuesta

Si se ejecuta correctamente, este método devuelve un código de respuesta 200 OK y la colección de objetos channel en el cuerpo de la respuesta. La respuesta también incluye la propiedad @odata.id que se puede usar para acceder al canal y ejecutar otras operaciones en el objeto de channel.

Nota:

Actualmente, se produce un error al invocar la dirección URL devuelta desde la propiedad @odata.id para los canales compartidos entre espacios empresariales. Puede resolver este problema si quita la parte /tenants/{tenant-id} de la dirección URL antes de llamar a esta API. Para obtener más información, vea Problemas conocidos de Microsoft Graph.

Ejemplos

Ejemplo 1: mostrar todos los canales

Solicitud

En el ejemplo siguiente se muestra la solicitud.

GET https://graph.microsoft.com/v1.0/teams/893075dd-2487-4122-925f-022c42e20265/allChannels

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

{
  "value": [
    {
       "@odata.id": "https://graph.microsoft.com/v1.0/tenants/b3246f44-b4gb-4627-96c6-25b18fa2c910/teams/893075dd-2487-4122-925f-022c42e20265/channels/19:561fbdbbfca848a484f0a6f00ce9dbbd@thread.tacv2",
      "id": "19:561fbdbbfca848a484f0a6f00ce9dbbd@thread.tacv2",
      "createdDateTime": "2020-05-27T19:22:25.692Z",
      "displayName": "General",
      "description": "AutoTestTeam_20210311_150740.2550_fim3udfdjen9",
      "membershipType": "standard",
      "tenantId": "b3246f44-b4gb-4627-96c6-25b18fa2c910",
      "isArchived": false
    },
    {
       "@odata.id": "https://graph.microsoft.com/v1.0/tenants/b3246f44-b4gb-5678-96c6-25b18fa2c910/teams/893075dd-5678-5634-925f-022c42e20265/channels/19:561fbdbbfca848a484gabdf00ce9dbbd@thread.tacv",
      "id": "19:561fbdbbfca848a484gabdf00ce9dbbd@thread.tacv2",
      "createdDateTime": "2020-05-27T19:22:25.692Z",
      "displayName": "Shared channel from Contoso",
      "membershipType": "shared",
      "tenantId": "b3246f44-b4gb-5678-96c6-25b18fa2c910",
      "isArchived": false
    }
  ]
}

Ejemplo 2: Mostrar todos los canales privados

Solicitud

En el ejemplo siguiente se muestra la solicitud.

GET https://graph.microsoft.com/v1.0/teams/893075dd-2487-4122-925f-022c42e20265/allChannels?$filter=membershipType eq 'shared'

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

{
  "value": [
    {
       "@odata.id": "https://graph.microsoft.com/v1.0/tenants/b3246f44-b4gb-5678-96c6-25b18fa2c910/teams/893075dd-5678-5634-925f-022c42e20265/channels/19:561fbdbbfca848a484gabdf00ce9dbbd@thread.tacv",
      "id": "19:561fbdbbfca848a484gabdf00ce9dbbd@thread.tacv2",
      "createdDateTime": "2020-05-27T19:22:25.692Z",
      "displayName": "Shared channel from Contoso",
      "membershipType": "shared",
      "tenantId": "b3246f44-b4gb-5678-96c6-25b18fa2c910",
      "isArchived": false
    }
  ]
}