Tipo de recurso team (equipo)
Espacio de nombres: microsoft.graph
Importante
Las API de la versión /beta 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 la versión 1.0, use el selector de Versión.
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. |
| Obtener | 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. |
| Eliminación masiva de miembros | Colección actionResultPart | Quite varios miembros de un equipo en una sola solicitud. |
| 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 | Enumere los equipos de los que es miembro. |
| Enumerar los equipos asociados | colección associatedTeamInfo | Obtenga la lista de los associatedTeamInfo 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. |
| Obtener foto del equipo | Datos binarios | Obtenga la foto (imagen) de un equipo. |
| 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 | Obtener la lista de canales compartidos con este equipo. |
| 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 | Enumera los permisos concedidos a las aplicaciones para acceder al equipo. |
| Obtener turnos abiertos en todos los equipos unidos | colección openShift | Obtenga todos los objetos openShift en todos los equipos de los que un usuario sea miembro directo. |
| Obtención de turnos en todos los equipos unidos | colección shift | Obtenga todos los objetos de desplazamiento en todos los equipos de los que un usuario sea miembro directo. |
| Obtener tiempos de espera en todos los equipos unidos | colección timeOff | Obtener todos los objetos timeOff en todos los equipos de los que un usuario es miembro directo. |
Propiedades
| Propiedad | Tipo | Descripción |
|---|---|---|
| classSettings | teamClassSettings | Definir la configuración de una clase. Solo está disponible cuando el equipo representa una clase. |
| 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. |
| createdDateTime | dateTimeOffset | Marca de tiempo en la que se creó el equipo. |
| description | cadena | Descripción opcional para el equipo. Longitud máxima: 1024 caracteres. |
| discoverySettings | teamDiscoverySettings | Las opciones para configurar la detección del equipo por parte de otros usuarios. |
| displayName | cadena | El nombre del equipo. |
| funSettings | teamFunSettings | Configuración para configurar el uso de Giphy, memes y stickers en el equipo. |
| guestSettings | teamGuestSettings | Las opciones para configurar si los invitados pueden crear, actualizar o eliminar los canales en el equipo. |
| 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. |
| internalId | cadena | Un identificador único para el equipo que se usa 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. |
| isMembershipLimitedToOwners | Boolean | Si se establece trueen , el equipo se encuentra actualmente en el estado de pertenencia al equipo solo propietario e inaccesible para otros miembros del equipo, como los alumnos. |
| 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 de resumen 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) | Hipervínculo que va al equipo en el cliente de Microsoft Teams. Es la dirección URL que obtiene al hacer clic con el botón derecho en un equipo del cliente de Microsoft Teams y seleccionar 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 está en un estado de migración y que se está usando actualmente con fines 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. |
| 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 por el usuario, no se puede especificar ningún propietario (el usuario actual es el propietario). El propietario debe especificarse como un identificador 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 |
| templateDefinition | teamtemplatedefinition | Representación genérica de una definición de plantilla de equipo para un equipo con una estructura y configuración específicas. |
| 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
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",
"discoverySettings": {"@odata.type": "microsoft.graph.teamDiscoverySettings"},
"displayName": "String",
"funSettings": {"@odata.type": "microsoft.graph.teamFunSettings"},
"guestSettings": {"@odata.type": "microsoft.graph.teamGuestSettings"},
"id": "String (identifier)",
"internalId": "String",
"isArchived": "Boolean",
"isMembershipLimitedToOwners": "Boolean",
"memberSettings": {"@odata.type": "microsoft.graph.teamMemberSettings"},
"messagingSettings": {"@odata.type": "microsoft.graph.teamMessagingSettings"},
"specialization": "String",
"summary": {"@odata.type": "microsoft.graph.teamSummary"},
"tenantId": "String",
"visibility": "String",
"webUrl": "String (URL)"
}