Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Namespace: microsoft.graph
Importante
As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.
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 objetos associatedTeamInfo 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. |
| Obter foto da equipe | Dados Binários | Obter a foto (imagem) de uma equipe. |
| 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 compartilhados com esta 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 concedidas às aplicações para aceder à equipa. |
| Obter turnos abertos em todas as equipas associadas | coleção openShift | Obtenha todos os objetos openShift em todas as equipas de que um utilizador é membro direto. |
| Obter turnos em todas as equipas associadas | coleção shift | Obter todos os objetos de turno em todas as equipas de que um utilizador é membro direto. |
| Obter folgas em todas as equipas associadas | coleção timeOff | Obter todos os objetos timeOff em todas as equipas de que um utilizador é membro direto. |
Propriedades
| Propriedade | Tipo | Descrição |
|---|---|---|
| classSettings | teamClassSettings | Definir configurações de uma classe. Disponível apenas quando a equipe representa uma classe. |
| 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. |
| 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. |
| discoverySettings | teamDiscoverySettings | Configurações de capacidade de descoberta da equipe por outras pessoas. |
| displayName | string | O nome da equipe. |
| firstChannelName | Cadeia de caracteres | O nome do primeiro canal na equipa. Esta é uma propriedade opcional, utilizada apenas durante a criação da equipa e não é devolvida em métodos para obter e listar equipas. |
| funSettings | teamFunSettings | Definições para configurar a utilização de Giphy, memes e autocolantes na equipa. |
| guestSettings | teamGuestSettings | Configurações que definem se os convidados podem criar, atualizar ou excluir canais na equipe. |
| 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. |
| internalId | string | Um ID exclusivo para a equipa 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. |
| isMembershipLimitedToOwners | Booliano | Se estiver definida como true, a equipa está atualmente no estado de associação da equipa apenas de proprietário e inacessível por outros membros da equipa, como os estudantes. |
| 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 de resumo sobre a equipa, 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. É o URL que obtém 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. 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 equipa está num estado de migração e está atualmente a ser utilizada 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. |
| owners | user | A lista de proprietários desta equipe. Atualmente, ao criar uma equipe usando permissões de aplicativo, exatamente um proprietário deve ser especificado. Ao utilizar permissões delegadas pelo utilizador, não é possível especificar nenhum proprietário (o utilizador atual é o proprietário). O proprietário tem de ser especificado como um ID de objeto (GUID) e não como um UPN. |
| operations | Coleção teamsAsyncOperation | As operações assíncronas que foram executadas ou estão em execução nesta equipe. |
| photo | profilePhoto | Foto da equipe. |
| primaryChannel | channel | O canal geral da equipe. |
| Cronograma | Cronograma | Cronograma de turno para essa equipe. |
| template | teamsTemplate | O modelo usado para criar essa equipe. Confira os modelos disponíveis. |
| templateDefinition | teamtemplatedefinition | Representação genérica de uma definição de modelo de equipa para uma equipa com uma estrutura e configuração específicas. |
| permissionGrants | Coleção resourceSpecificPermissionGrant | Uma coleção de permissões concedidas a aplicativos para acessar a equipe. |
| tags | Coleção teamworkTag | Os rótulos associados com 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",
"discoverySettings": {"@odata.type": "microsoft.graph.teamDiscoverySettings"},
"displayName": "String",
"firstChannelName": "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)"
}