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