Compartir a través de


Tipo de recurso team (equipo)

Espacio de nombres: microsoft.graph

Un equipo en Microsoft Teams es una colección de canales. Un canal representa un tema y, por tanto, un aislamiento lógico de conversación en un equipo.

Cada equipo está asociado a un grupo de Microsoft 365. El grupo tiene el mismo id. que el equipo: por ejemplo, /groups/{id}/team es el mismo que /teams/{id}. Para obtener más información sobre cómo trabajar con miembros de equipos y grupos, consulte Usar la API de Microsoft Graph para trabajar con Microsoft Teams.

Métodos

Método Tipo de valor devuelto Descripción
Crear teamsAsyncOperation Crea un equipo desde cero.
Crear equipo a partir de un grupo team Cree un nuevo equipo o agregue un equipo a un grupo de Microsoft 365 existente.
Get team Recupera las propiedades y relaciones del equipo especificado.
Actualizar team Actualiza las propiedades del equipo especificado.
Delete Ninguno Eliminar el equipo y el grupo asociado.
Enumerar los miembros Colección conversationmember Obtener la lista de miembros en el equipo.
Agregar miembro conversationMember Agregar un nuevo miembro al equipo.
Agregar miembros en masa Colección actionResultPart Agregar varios miembros al equipo en una sola solicitud.
Obtener miembro Colección conversationmember Obtener un miembro en el equipo.
Obtención del canal principal channel El canal general del equipo
Actualizar miembro conversationMember Cambiar un miembro a un propietario o volver a un miembro regular.
Eliminar miembro Ninguno Quitar un miembro existente del equipo.
Archivar equipo teamsAsyncOperation Pone el equipo en un estado de solo lectura.
Desarchivar equipo teamsAsyncOperation Restaura el equipo a un estado de lectura y escritura.
Clonar equipo teamsAsyncOperation Copia el equipo y el grupo asociado.
Enumerar los equipos Colección team Enumera los equipos de los que es miembro.
Enumerar los equipos asociados colección associatedTeamInfo Obtenga la lista de los equipos de Microsoft Teams a los que está asociado un usuario.
Enumerar todos los equipos de una organización Colección team Enumerar todos los equipos de una organización.
Migración completa para el equipo team Quita el modo de migración del equipo y pone el equipo a disposición de los usuarios para que puedan publicar y leer mensajes.
Enumerar todos los canales Colección channel Obtiene la lista de channels en este team o compartidos con este team (canales entrantes).
Enumerar canales Colección channel Obtener la lista de canales de un equipo.
Enumerar canales entrantes Colección channel Obtiene la lista de channels entrantes (canales compartidos con un team).
Quitar un canal entrante Ninguno Quita un canal entrante (un canal compartido con un equipo) de un equipo.
Enumerar aplicaciones en el equipo Colección teamsappinstallation Enumera las aplicaciones instaladas en un chat.
Agregar la aplicación al equipo Ninguno Agregar una aplicación a un sitio
Obtener aplicaciones instaladas en el equipo teamsAppInstallation Obtener la aplicación especificada instalada en un equipo.
Actualizar aplicaciones instaladas en el equipo Ninguno Actualice la aplicación instalada en un equipo a la versión más reciente.
Quitar aplicación del equipo Ninguno Quitar (desinstalar) una aplicación de un equipo.
Enumerar concesiones de permisos Colección de resourceSpecificPermissionGrant Enumere los permisos que se han concedido a las aplicaciones para acceder al equipo.

Propiedades

Propiedad Tipo Descripción
id string Identificador único del equipo. El grupo tiene el mismo identificador que el equipo. Esta propiedad es de solo lectura y se hereda del tipo de entidad base.
classification cadena Una etiqueta opcional. Normalmente describe la confidencialidad de los datos o empresa del equipo. Debe coincidir con un conjunto preconfigurado en el directorio del espacio empresarial.
classSettings teamClassSettings Definir la configuración de una clase. Solo está disponible cuando el equipo representa una clase.
createdDateTime dateTimeOffset Marca de tiempo en la que se creó el equipo.
description cadena Descripción opcional para el equipo. La longitud máxima es de 1024 caracteres.
displayName cadena El nombre del equipo.
funSettings teamFunSettings Las opciones para configurar el uso de Giphy, adhesivos y memes en el equipo.
guestSettings teamGuestSettings Las opciones para configurar si los invitados pueden crear, actualizar o eliminar los canales en el equipo.
internalId cadena Un identificador único para el equipo que se ha usado en algunos lugares, como el registro de auditoría o la API de Actividad de administración de Office 365.
isArchived Booleano Si este equipo está en modo de solo lectura.
memberSettings teamMemberSettings Las opciones para configurar si los miembros pueden realizar ciertas acciones, como crear canales y agregar bots, en el equipo.
messagingSettings teamMessagingSettings Las opciones para configurar la mensajería y las menciones en el equipo.
specialization teamSpecialization Opcional. Indica si el equipo está destinado a un caso de uso particular. La especialización de cada equipo tiene acceso a comportamientos y experiencias únicos dirigidos a su caso de uso.
summary teamSummary Contiene información resumida sobre el equipo, incluido el número de propietarios, miembros e invitados.
tenantId string Identificador del inquilino de Microsoft Entra.
visibility teamVisibilityType La visibilidad del grupo y del equipo. El valor predeterminado es público.
webUrl Cadena (sólo lectura) Un hipervínculo que llevará al equipo en el cliente de Microsoft Teams. Esta es la dirección URL que obtendrá cuando haga clic derecho en un equipo en el cliente de Microsoft Teams y seleccione Obtener vínculo al equipo. Esta dirección URL debe tratarse como un objeto opaco y no analizarse.

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.teamCreationMode cadena Indica que el equipo se encuentra en estado de migración y se está usando actualmente para propósitos de migración. Acepta un valor: migration. Aviso: En el futuro, Microsoft puede solicitarle a usted o a sus clientes que paguen tarifas adicionales en función de la cantidad de datos importados.

Para ver un ejemplo de solicitud de POST, consulte Solicitar (crear equipo en estado de migración).

Relaciones

Relación Tipo Descripción
allChannels Colección channel Lista de canales hospedados o compartidos con el equipo (canales entrantes).
channels Colección channel La colección de canales y mensajes asociados al equipo.
incomingChannels Colección channel Lista de canales compartidos con el equipo.
installedApps Colección teamsappinstallation Las aplicaciones instaladas en el equipo.
members Colección conversationmember Miembros y propietarios del equipo.
operations Colección teamsAsyncOperation Las operaciones asincrónicas que se han ejecutado o se ejecutan en este equipo.
photo profilePhoto La foto de perfil del equipo.
primaryChannel channel El canal general del equipo
schedule schedule La programación de turnos para este equipo.
etiquetas Colección teamworkTag Las etiquetas asociadas al equipo.
template teamsTemplate La plantilla a partir de la que se creó el equipo. Vea las plantillas disponibles
permissionGrants Colección de resourceSpecificPermissionGrant Colección de permisos concedidos a las aplicaciones para acceder al equipo.

Representación JSON

La siguiente representación JSON muestra el tipo de recurso.

Nota: Si el equipo es de tipo clase, se aplica una propiedad classSettings sobre el equipo.

{
  "classSettings": {"@odata.type": "microsoft.graph.teamClassSettings"},
  "classification": "String",
  "createdDateTime": "DateTimeOffset",
  "description": "String",
  "displayName": "String",
  "funSettings": {"@odata.type": "microsoft.graph.teamFunSettings"},
  "guestSettings": {"@odata.type": "microsoft.graph.teamGuestSettings"},
  "internalId": "String",
  "isArchived": "Boolean",
  "memberSettings": {"@odata.type": "microsoft.graph.teamMemberSettings"},
  "messagingSettings": {"@odata.type": "microsoft.graph.teamMessagingSettings"},
  "specialization": "String",
  "tenantId": "String",
  "visibility": "String",
  "webUrl": "String (URL)"
}