Tipo de recurso team (equipo)
Espacio de nombres: microsoft.graph
Importante
Las API de la /beta versión de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en v1.0, use el selector de versiones.
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. 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 un equipo | teamsAsyncOperation | Crea un equipo desde cero. |
| Crear equipo a partir de un grupo | team | Crea un nuevo equipo o agrega un equipo a un grupo existente. |
| Obtener equipo | team | Recupera las propiedades y relaciones del equipo especificado. |
| Actualizar equipo | team | Actualiza las propiedades del equipo especificado. |
| Eliminar equipo | 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. |
| Actualizar el rol del 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. |
| Obtener foto del equipo | Datos binarios | Obtenga la foto (imagen) de un equipo. |
| Completar migración | 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 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 |
|---|---|---|
| displayName | cadena | El nombre del equipo. |
| description | cadena | Descripción opcional para el equipo. La longitud máxima es de 1024 caracteres. |
| 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. |
| 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. |
| visibility | teamVisibilityType | La visibilidad del grupo y del equipo. El valor predeterminado es público. |
| 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. |
| discoverySettings | teamDiscoverySettings | Las opciones para configurar la detección del equipo por parte de otros usuarios. |
| 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. |
| classSettings | teamClassSettings | Definir la configuración de una clase. Solo está disponible cuando el equipo representa una clase. |
| isMembershipLimitedToOwners | Boolean | Si se establece en true, el equipo se encuentra actualmente en el estado de pertenencia solo de propietario y no es accesible para otros miembros del equipo, como estudiantes. |
| createdDateTime | dateTimeOffset | Marca de tiempo en la que se creó el 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.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 |
|---|---|---|
| channels | Colección channel | La colección de canales y mensajes relacionados con el equipo. |
| installedApps | Colección teamsappinstallation | Las aplicaciones instaladas en el equipo. |
| members | Colección conversationmember | Miembros y propietarios del equipo. |
| owners | user | La lista de propietarios del equipo. Actualmente, al crear un equipo con permisos de aplicación, debe especificar exactamente un propietario. Cuando se usan permisos delegados del usuario, no se puede especificar ningún propietario (el usuario actual es el propietario). El propietario debe especificarse como un ID de objeto (GUID), no un UPN. |
| operations | Colección teamsAsyncOperation | Las operaciones asincrónicas que se han ejecutado o se ejecutan en este equipo. |
| photo | profilePhoto | La foto del equipo. |
| primaryChannel | channel | El canal general del equipo |
| schedule | schedule | La programación de turnos para este 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. |
| etiquetas | Colección teamworkTag | Las etiquetas asociadas al equipo. |
Representación JSON
Esta es una representación JSON del recurso.
Nota: Si el equipo es de tipo clase, se aplica una propiedad classSettings sobre el equipo.
{
"guestSettings": {"@odata.type": "microsoft.graph.teamGuestSettings"},
"memberSettings": {"@odata.type": "microsoft.graph.teamMemberSettings"},
"messagingSettings": {"@odata.type": "microsoft.graph.teamMessagingSettings"},
"funSettings": {"@odata.type": "microsoft.graph.teamFunSettings"},
"discoverySettings": {"@odata.type": "microsoft.graph.teamDiscoverySettings"},
"internalId": "string",
"isArchived": false,
"webUrl": "string (URL)",
"displayName": "string",
"description": "string",
"classification": "string",
"specialization": "string",
"visibility": "string",
"classSettings": {"@odata.type": "microsoft.graph.teamClassSettings"},
"isMembershipLimitedToOwners":"boolean",
"createdDateTime": "dateTimeOffset"
}