tipo de recurso de equipe
Namespace: microsoft.graph
No Microsoft Teams, uma equipe é um conjunto de objetos de canal. Um canal representa um tópico e, portanto, um isolamento lógico da discussão em uma equipe.
Cada equipe está associada a um grupo Microsoft 365.
O grupo tem a mesma ID da equipe, por exemplo, /groups/{id}/team é o mesmo /teams/{id}.
Confira mais informações sobre como trabalhar com grupos e membros em equipes, confira Usar a API REST do Microsoft Graph para trabalhar com o Microsoft Teams.
Métodos
| Método | Tipo de retorno | Descrição |
|---|---|---|
| Criar | teamsAsyncOperation | Crie uma equipe do zero. |
| Criar equipe a partir do grupo | team | Crie uma nova equipe ou adicione uma equipe a um grupo Microsoft 365 existente. |
| Get | team | Recupere as propriedades e relações da equipe especificada. |
| Atualizar | team | Atualize as propriedades da equipe especificada. |
| Delete | Nenhum | Exclua a equipe e o grupo associado. |
| Listar membros | coleção conversationMember | Obtenha a lista de membros nessa equipe. |
| Adicionar membro | conversationMember | Adicione um novo membro à equipe. |
| Adicionar membros em massa | coleçãoactionResultPart | Adicione vários membros à equipe em uma única solicitação. |
| Obter membro | conversationMembercoleção | Obtenha um membro na equipe. |
| Obter canal primário | canal | O canal geral da equipe. |
| Atualizar membro | conversationMember | Alterar um membro para um proprietário ou voltar para um membro regular. |
| Remover membro | Nenhum | Remova um membro existente da equipe. |
| Remover membros em massa | coleçãoactionResultPart | Remova vários membros de uma equipa num único pedido. |
| Arquivar equipe | teamsAsyncOperation | Coloque a equipe em um estado somente leitura. |
| Desarquivar equipe | teamsAsyncOperation | Restaure a equipe com um estado de leitura e gravação. |
| Clonar equipe | teamsAsyncOperation | Copie a equipe e o grupo associado. |
| Listar suas equipes | Coleção team | Liste as equipas de que é membro. |
| Listar as suas equipas associadas | Coleção associatedTeamInfo | Obtenha a lista de equipes no Microsoft Teams as quais um usuário está associado. |
| Listar todas as equipes em uma organização | Coleção team | Listar todas as equipes em uma organização. |
| Concluir a migração para a equipa | equipe | Remove o modo de migração da equipe e disponibiliza a equipe aos usuários para postar e ler mensagens. |
| Listar todos os canais | Coleção channel | Obtenha a lista de canais desta equipe ou compartilhados com esta equipe (canais de entrada). |
| List channels | channel collection | Obtenha a lista de canais em uma equipe. |
| Lstar canais de entrada | Coleção channel | Obtenha a lista de canais de entrada (canais compartilhados com uma equipe). |
| Remover canal de entrada | Nenhum | Remova um canal de entrada (um canal compartilhado com uma equipe) de uma equipe. |
| Listar aplicativos em equipe | Coleção teamsAppInstallation | Liste os aplicativos instalados em uma equipe. |
| Adicionar aplicativo à equipe | Nenhuma | Adicione (instale) um aplicativo a uma equipe. |
| Instalar o aplicativo na equipe do | teamsAppInstallation | Obtenha o aplicativo especificado instalado em uma equipe. |
| Atualizar o aplicativo instalado para a equipe | Nenhuma | Atualize o aplicativo instalado em uma equipe para a versão mais recente. |
| Remover aplicativo da equipe | Nenhuma | Remova (desinstale) um aplicativo de uma equipe. |
| Listar as concessões de permissões | Coleção resourceSpecificPermissionGrant | Liste as permissões que foram concedidas às aplicações para aceder à equipa. |
Propriedades
| Propriedade | Tipo | Descrição |
|---|---|---|
| id | string | O identificador exclusivo da equipa. O grupo tem o mesmo ID que a equipa. Esta propriedade é só de leitura e é herdada do tipo de entidade base. |
| classificação | string | Um rótulo opcional. Normalmente descreve a confidencialidade da empresa ou dos dados da equipe. Tem de corresponder a um de um conjunto pré-configurado no diretório do inquilino. |
| classSettings | teamClassSettings | Definir configurações de uma classe. Disponível apenas quando a equipe representa uma classe. |
| createdDateTime | dateTimeOffset | Carimbo de data/hora de criação da equipe. |
| description | string | Uma descrição opcional para a equipe. Comprimento máximo: 1024 carateres. |
| displayName | string | O nome da equipe. |
| funSettings | teamFunSettings | Configurações que definem o uso de Giphy, memes e figurinhas na equipe. |
| guestSettings | teamGuestSettings | Configurações que definem se os convidados podem criar, atualizar ou excluir canais na equipe. |
| internalId | string | Um ID exclusivo para a equipa que foi utilizado em alguns locais, como o registo de auditoria/Office 365 API de Atividade de Gestão. |
| isArchived | Booliano | Se essa equipe está no modo somente leitura. |
| memberSettings | teamMemberSettings | Configurações para configurar se os membros podem executar determinadas ações, por exemplo, criar canais e adicionar bots na equipe. |
| messagingSettings | teamMessagingSettings | Configurações para definir a mensagens e menções na equipe. |
| specialization | teamSpecialization | Opcional. Indica se a equipe destina-se a um caso de uso específico. Cada especialização de equipe tem acesso a comportamentos e experiências exclusivos direcionados ao seu caso de uso. |
| summary | teamSummary | Contém informações resumidas sobre a equipe, incluindo o número de proprietários, membros e convidados. |
| tenantId | cadeia de caracteres | O ID do inquilino Microsoft Entra. |
| visibility | teamVisibilityType | A visibilidade de um grupo e equipe. O padrão é Público. |
| webUrl | cadeia de caracteres (somente leitura) | Uma hiperligação que vai para a equipa no cliente do Microsoft Teams. Obtém este URL quando clica com o botão direito do rato numa equipa no cliente do Microsoft Teams e seleciona Obter ligação para a equipa. Essa URL deve ser tratada como um blob opaco e não analisado. |
Atributos de instância
Atributos de instância são propriedades com comportamentos especiais. Estas propriedades são temporárias. Definem o comportamento que o serviço deve executar ou fornecem valores de propriedade de curto prazo, como um URL de transferência para um item que expira.
| Nome da propriedade | Tipo | Descrição |
|---|---|---|
| @microsoft.graph.teamCreationMode | cadeia de caracteres | Indica que a equipe está em estado de migração e atualmente está sendo usada para fins de migração. Ele aceita um valor: migration.
Nota: no futuro, a Microsoft poderá exigir que você ou os seus clientes paguem taxas adicionais com base na quantidade de dados importados. |
Para um exemplo de solicitação POST, confira Solicitação (criar equipe no estado de migração).
Relações
| Relação | Tipo | Descrição |
|---|---|---|
| allChannels | Coleção channel | Lista de canais hospedados ou compartilhados com a equipe (canais de entrada). |
| channels | Coleção channel | A coleção de canais e mensagens associadas à equipe. |
| incomingChannels | Coleção channel | Lista de canais compartilhados com a equipe. |
| installedApps | Coleção teamsAppInstallation | Os aplicativos instalados nessa equipe. |
| members | coleção conversationMember | Membros e proprietários da equipe. |
| operations | Coleção teamsAsyncOperation | As operações assíncronas que foram executadas ou estão em execução nesta equipe. |
| photo | profilePhoto | A foto de perfil da equipe. |
| primaryChannel | channel | O canal geral da equipe. |
| Cronograma | Cronograma | Cronograma de turno para essa equipe. |
| tags | Coleção teamworkTag | Os rótulos associados com a equipe. |
| template | teamsTemplate | O modelo usado para criar essa equipe. Confira os modelos disponíveis. |
| permissionGrants | Coleção resourceSpecificPermissionGrant | Uma coleção de permissões concedidas a aplicativos para acessar a equipe. |
Representação JSON
A representação JSON seguinte mostra o tipo de recurso.
Observação: se a equipe for do tipo classe, uma propriedade classSettings será aplicada à equipe.
{
"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)"
}