Compartilhar via


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.
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 equipes das quais você é 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 aos aplicativos para acessar a equipe.

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. Deve coincidir com um dos conjuntos predefinidos no diretório do locatário.
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. O comprimento máximo é de 1024 caracteres.
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 Uma ID exclusiva da equipe, que foi usada em alguns locais, como o log de auditoria da API da Atividade de Gestão do Office 365.
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 do Microsoft Entra.
visibility teamVisibilityType A visibilidade de um grupo e equipe. O padrão é Público.
webUrl cadeia de caracteres (somente leitura) Um hiperlink que será enviado à equipe no cliente do Microsoft Teams. Esta é a URL que você recebe ao clicar com o botão direito do mouse em uma equipe no cliente do Microsoft Teams e escolher Obter o link para a equipe. 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. Essas propriedades são temporárias e a) definem o comportamento que o serviço deve apresentar ou b) fornecem valores de propriedades de curto prazo, como uma URL de download, para um item com data de expiração.

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. Observação: no futuro, a Microsoft pode exigir que você ou 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)"
}