Tipo de recurso team (equipo)

  • Artículo

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

Contenido relacionado