tipo de recurso de equipe
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 de 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 equipe | 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. |
| Obter equipe | team | Recupere as propriedades e relações da equipe especificada. |
| Atualizar equipe | team | Atualize as propriedades da equipe especificada. |
| Excluir equipe | 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. |
| Atualizar a função do 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 equipes 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. |
| Migração completa | 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. |
| 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 |
|---|---|---|
| displayName | string | O nome da equipe. |
| description | string | Uma descrição opcional para a equipe. O comprimento máximo é de 1024 caracteres. |
| 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. |
| 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. |
| visibility | teamVisibilityType | A visibilidade de um grupo e equipe. Padrão é Público. |
| 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. |
| discoverySettings | teamDiscoverySettings | Configurações de capacidade de descoberta da equipe por outras pessoas. |
| 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. |
| classSettings | teamClassSettings | Definir configurações de uma classe. Disponível apenas quando a equipe representa uma classe. |
| isMembershipLimitedToOwners | Booliano | Se definido para true, a equipe está atualmente no estado de membro da equipe apenas para o proprietário e não é acessível a outros membros da equipe, tais como estudantes. |
| createdDateTime | dateTimeOffset | Carimbo de data/hora de criação da equipe. |
| summary | teamSummary | Contém informações resumidas sobre a equipe, incluindo o número de proprietários, membros e convidados. |
| tenantId | cadeia de caracteres | A ID do locatário do Azure Active Directory. |
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. |
| 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 usar permissões delegadas pelo usuário, nenhum proprietário pode ser especificado (o usuário atual é o proprietário). O proprietário deve ser especificado como um objeto ID (GUID), não 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 a partir do qual essa equipe foi criada. Consulte modelos disponíveis. |
| 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
Veja a seguir uma representação JSON do recurso.
Observação: se a equipe for do tipo classe, uma propriedade classSettings será aplicada à equipe.
{
"guestSettings": {"@odata.type": "microsoft.graph.teamGuestSettings"},
"memberSettings": {"@odata.type": "microsoft.graph.teamMemberSettings"},
"messagingSettings": {"@odata.type": "microsoft.graph.teamMessagingSettings"},
"funSettings": {"@odata.type": "microsoft.graph.teamFunSettings"},
"discoverySettings": {"@odata.type": "microsoft.graph.teamDiscoverySettings"},
"internalId": "string",
"isArchived": false,
"webUrl": "string (URL)",
"displayName": "string",
"description": "string",
"classification": "string",
"specialization": "string",
"visibility": "string",
"classSettings": {"@odata.type": "microsoft.graph.teamClassSettings"},
"isMembershipLimitedToOwners":"boolean",
"createdDateTime": "dateTimeOffset",
"summary": {"@odata.type": "microsoft.graph.teamSummary"}
}
Confira também
Comentários
Enviar e exibir comentários de