Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Espacio de nombres: microsoft.graph
Los equipos están compuestos de canales, que son las conversaciones que tiene con sus compañeros de equipo. Cada canal está dedicado a un tema específico, departamento o proyecto. Los canales son el lugar donde realmente se realiza el trabajo, donde se producen conversaciones de texto, audio y vídeo abiertas a todo el equipo, donde se comparten archivos y se agregan las pestañas.
Métodos
| Método | Tipo de valor devuelto | Descripción |
|---|---|---|
| Enumerar canales | Colección channel | Obtiene la lista de canales en un equipo. |
| Enumerar canales entrantes | Colección channel | Obtiene la lista de channels entrantes (canales compartidos con un team). |
| Enumerar todos los canales | Colección channel | Obtiene la lista de canales en un equipo o compartidos con un equipo (canales entrantes). |
| Crear un canal | channel | Crea un canal, incluyendo el nombre para mostrar y la descripción. |
| Obtener canal | channel | Lee las propiedades y relaciones del canal. |
| Obtención del canal principal | channel | El canal general del equipo |
| Canal de actualización | channel | Actualiza las propiedades del canal. |
| Eliminar canal | Ninguno | Elimina un canal. |
| Enumerar mensajes de canal | chatMessage | Obtiene los mensajes en un canal |
| Obtener todos los mensajes del canal | Colección channel | Obtiene todos los mensajes de todos los canales en los que un usuario es participante. |
| Obtener todos los mensajes de canal retenidos | Colección chatMessage | Obtenga todos los mensajes retenidos en todos los canales de un equipo. |
| Crear publicación de mensaje del canal | chatMessage | Enviar un mensaje a un canal |
| Crear respuesta a publicación de mensaje del canal | chatMessage | Responder a un mensaje en un canal |
| Obtener la carpeta de los archivos. | driveItem | Recupera los detalles de la carpeta de SharePoint donde se almacenan los archivos para el canal. |
| Enumerar pestañas | teamsTab | Enumera las pestañas ancladas a un canal. |
| Enumerar miembros de canal | Colección conversationmember | Obtenga una lista de miembros de un canal, incluidos los miembros directos de canales estándar, privados y compartidos. |
| Enumerar todos los miembros | Colección conversationmember | Obtenga una lista de todos los miembros de un canal. |
| Agregar miembro de canal | conversationMember | Agregue un miembro a una clase o canal. Solo se admite para canales con un elemento membershipType de private o shared. |
| Obtener miembro de canal | Colección conversationmember | Obtiene un miembro de un canal. |
| canal Archivo | Ninguno | Archivo un canal en un equipo. |
| Canal noarchivo | Ninguno | Restaure un canal archivado en un equipo. |
| Actualizar el rol del miembro del canal | conversationMember | Actualizar las propiedades de un miembro del canal. Solo se admite para canales con un elemento membershipType de private o shared. |
| Quitar miembro de canal | Ninguno | Eliminar un miembro de un canal. Solo se admite para canales con un elemento membershipType de private o shared. |
| Completar migración | channel | Quita el modo de migración del canal y pone el canal a disposición de los usuarios para publicar y leer mensajes. |
| Enumerar pestañas en el canal | teamsTab | Enumera las pestañas ancladas de un canal. |
| Agregar una pestaña al canal | teamsTab | Agrega (ancla) una pestaña a un canal. |
| Obtener pestaña de un canal | teamsTab | Obtiene una pestaña anclada específica de un canal. |
| Actualizar pestaña en el canal | teamsTab | Actualiza las propiedades de una pestaña en un canal. |
| Quitar pestaña del canal | Ninguno | Quita (desancla) una pestaña de un canal. |
| Disposición de dirección de correo electrónico del canal | provisionChannelEmailResult | Disponga una dirección de correo electrónico para el canal. |
| Quitar dirección de correo electrónico del canal | Ninguno | Quite la dirección de correo electrónico del canal. |
| Quitar un canal entrante | Ninguno | Quita un canal entrante (un canal compartido con un equipo) de un equipo. |
| Enumerar equipos que comparten un canal | Colección sharedWithChannelTeamInfo | Obtenga la lista de equipos que se han compartido un canal especificado. |
| Obtener el equipo que comparte un canal | sharedWithChannelTeamInfo | Obtenga un equipo que haya compartido un canal especificado. |
| Dejar de compartir el canal con el equipo | Ninguno | Deje de compartir un canal con un equipo mediante la eliminación del correspondiente recurso sharedWithChannelTeamInfo. |
| Enumerar miembros permitidos | Colección conversationmember | Obtiene la lista de conversationMembers que pueden acceder a un canal compartido. |
| Comprobar acceso del usuario | Boolean | Determine si un usuario tiene acceso a un canal compartido. |
Propiedades
| Propiedad | Tipo | Descripción |
|---|---|---|
| createdDateTime | dateTimeOffset | Solo lectura. Marca de tiempo en la que se creó el canal. |
| description | Cadena | Descripción textual opcional para el canal. |
| displayName | Cadena | Nombre del canal que se mostrará al usuario en Microsoft Teams. La longitud máxima es de 50 caracteres. |
| Cadena | La dirección de correo electrónico para enviar mensajes al canal. Solo lectura. | |
| id | Cadena | Identificador único de los canales. Solo lectura. |
| isArchived | Booleano | Indica si el canal está archivado. Solo lectura. |
| isFavoriteByDefault | Booleano | Indica si el canal debe marcarse como recomendado para que todos los miembros del equipo se muestren en su lista de canales.
Nota: Todos los canales recomendados se muestran automáticamente en la lista de canales para los usuarios de educación y trabajadores de primera línea. La propiedad solo se puede establecer mediante programación a través del método Create team . El valor predeterminado es false. |
| membershipType | channelMembershipType | El tipo de un canal. Se puede establecer durante la creación y no se puede cambiar. Los valores posibles son: standard, private, unknownFutureValue y shared El valor predeterminado es standard. Use el encabezado de Prefer: include-unknown-enum-members solicitud para obtener los siguientes miembros en esta enumeración evolvable: shared. |
| tenantId | string | Identificador del inquilino de Microsoft Entra. |
| webUrl | Cadena | Un hipervínculo que irá hasta el canal en Microsoft Teams. Esta es la dirección URL que obtendrá cuando haga clic en un canal en Microsoft Teams y seleccione Obtener vínculo al canal. Esta dirección URL debe tratarse como un objeto opaco y no analizarse. Solo lectura. |
| summary | channelSummary | Contiene información de resumen sobre el canal, incluido el número de propietarios, miembros, invitados y un indicador de miembros de otros inquilinos. La propiedad summary solo se devolverá si se especifica en la $select cláusula del método de canal Get . |
valores channelMembershipType
| Member | Descripción |
|---|---|
| estándar | Channel hereda la lista de miembros del equipo primario. |
| private | El canal puede tener miembros que son un subconjunto de todos los miembros del equipo primario. |
| unknownFutureValue | Valor de sentinel de enumeración evolvable. No usar. |
| compartido | Los miembros se pueden agregar directamente al canal sin agregarlos al equipo. |
Atributos de instancia
Los atributos de instancia son propiedades con comportamientos especiales. Estas propiedades son temporales y o bien a) definen el comportamiento que debería tener el servicio o b) proporcionan valores de propiedad a corto plazo, como una dirección URL de descarga de un elemento que expira.
| Nombre de propiedad | Tipo | Description |
|---|---|---|
| @microsoft.graph.channelCreationMode | cadena | Indica que el canal está en estado de migración y se está usando actualmente para propósitos de migración. Acepta un valor: migration. |
Nota:
channelCreationModees una enumeración que toma el valormigration.
Para ver un ejemplo de solicitud POST, consulte Solicitar (crear un canal en estado de migración).
Relaciones
| Relación | Tipo | Description |
|---|---|---|
| allMembers | Colección conversationmember | Colección de registros de pertenencia asociados al canal, incluidos los miembros directos e indirectos de los canales compartidos. |
| filesFolder | driveItem | Metadatos para la ubicación en la que se almacenan los archivos del canal. |
| members | Colección conversationmember | Una colección de registros de suscripción asociados al canal. |
| messages | Colección chatMessage | Una colección de todos los mensajes en el canal. Una propiedad de navegación. Admite valores NULL. |
| operations | Colección teamsAsyncOperation | Las operaciones asincrónicas que se han ejecutado o se ejecutan en este equipo. |
| sharedWithTeams | Colección sharedWithChannelTeamInfo | Una colección de equipos con los que se comparte un canal. |
| pestañas | Colección teamsTab | Una colección de todas las pestañas en el canal. Una propiedad de navegación. |
Representación JSON
La siguiente representación JSON muestra el tipo de recurso.
{
"createdDateTime": "String (timestamp)",
"description": "String",
"displayName": "String",
"email": "String",
"id": "String (identifier)",
"isArchived": "Boolean",
"isFavoriteByDefault": "Boolean",
"membershipType": "String",
"webUrl": "String"
}