tipo de recurso de equipeteam resource type

Namespace: microsoft.graphNamespace: microsoft.graph

No Microsoft Teams, uma equipe é um conjunto de objetos de canal.A team in Microsoft Teams is a collection of channel objects. Um canal representa um tópico e, portanto, um isolamento lógico da discussão em uma equipe.A channel represents a topic, and therefore a logical isolation of discussion, within a team.

Cada equipe está associada a um grupo.Every team is associated with a group. O grupo tem a mesma ID da equipe, por exemplo, /groups/{id}/team é igual a /teams/{id}.The group has the same ID as the team - for example, /groups/{id}/team is the same as /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.For more information about working with groups and members in teams, see Use the Microsoft Graph REST API to work with Microsoft Teams.

MétodosMethods

MétodoMethod Tipo de retornoReturn Type DescriçãoDescription
Criar equipeCreate team teamsAsyncOperationteamsAsyncOperation Crie uma equipe do zero.Create a team from scratch.
Criar equipe a partir do grupoCreate team from group teamteam Crie uma nova equipe ou adicione uma equipe a um grupo existente.Create a new team, or add a team to an existing group.
Obter equipeGet team teamteam Recupere as propriedades e relações da equipe especificada.Retrieve the properties and relationships of the specified team.
Atualizar equipeUpdate team teamteam Atualize as propriedades da equipe especificada.Update the properties of the specified team.
Excluir equipeDelete team NenhumNone Exclua a equipe e o grupo associado.Delete the team and its associated group.
Listar membrosList members coleção conversationMemberconversationMember collection Obtenha o conversationMembers da propriedade de navegação dos membros.Get the conversationMembers from the members navigation property.
Adicionar membrosAdd members conversationMemberconversationMember Adicionar um novo membro.Add a new member.
Remover membrosRemove members NenhumNone Excluir um objeto conversationMember.Delete a conversationMember object.
Alterar a função do membroChange member's role conversationMemberconversationMember Alterar um membro para um proprietário ou voltar para um membro regular.Change a member to an owner or back to a regular member.
Arquivar equipeArchive team teamsAsyncOperationteamsAsyncOperation Coloque a equipe em um estado somente leitura.Put the team in a read-only state.
Desarquivar equipeUnarchive team teamsAsyncOperationteamsAsyncOperation Restaure a equipe com um estado de leitura e gravação.Restore the team to a read-write state.
Clonar equipeClone team teamsAsyncOperationteamsAsyncOperation Copie a equipe e o grupo associado.Copy the team and its associated group.
Listar suas equipesList your teams Coleção teamteam collection Liste as equipes das quais você é membro.List the teams you are a member of.

PropriedadesProperties

PropriedadeProperty TipoType DescriçãoDescription
displayNamedisplayName stringstring O nome da equipe.The name of the team.
descriptiondescription stringstring Uma descrição opcional para a equipe.An optional description for the team.
classificaçãoclassification stringstring Um rótulo opcional.An optional label. Normalmente descreve a confidencialidade da empresa ou dos dados da equipe.Typically describes the data or business sensitivity of the team. Deve coincidir com um dos conjuntos predefinidos no diretório do locatário.Must match one of a pre-configured set in the tenant's directory.
specializationspecialization teamSpecializationteamSpecialization Opcional.Optional. Indica se a equipe destina-se a um caso de uso específico.Indicates whether the team is intended for a particular use case. Cada especialização de equipe tem acesso a comportamentos e experiências exclusivos direcionados ao seu caso de uso.Each team specialization has access to unique behaviors and experiences targeted to its use case.
visibilityvisibility teamVisibilityTypeteamVisibilityType A visibilidade de um grupo e equipe.The visibility of the group and team. O padrão é Público.Defaults to Public.
funSettingsfunSettings teamFunSettingsteamFunSettings Configurações que definem o uso de Giphy, memes e figurinhas na equipe.Settings to configure use of Giphy, memes, and stickers in the team.
guestSettingsguestSettings teamGuestSettingsteamGuestSettings Configurações que definem se os convidados podem criar, atualizar ou excluir canais na equipe.Settings to configure whether guests can create, update, or delete channels in the team.
internalIdinternalId stringstring 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.A unique ID for the team that has been used in a few places such as the audit log/Office 365 Management Activity API.
isArchivedisArchived BoolianoBoolean Se essa equipe está no modo somente leitura.Whether this team is in read-only mode.
memberSettingsmemberSettings teamMemberSettingsteamMemberSettings Configurações para configurar se os membros podem executar determinadas ações, por exemplo, criar canais e adicionar bots na equipe.Settings to configure whether members can perform certain actions, for example, create channels and add bots, in the team.
messagingSettingsmessagingSettings teamMessagingSettingsteamMessagingSettings Configurações para definir a mensagens e menções na equipe.Settings to configure messaging and mentions in the team.
webUrlwebUrl cadeia de caracteres (somente leitura)string (readonly) Um hiperlink que será enviado à equipe no cliente do Microsoft Teams.A hyperlink that will go to the team in the Microsoft Teams client. 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.This is the URL that you get when you right-click a team in the Microsoft Teams client and select Get link to team. Essa URL deve ser tratada como um blob opaco e não analisado.This URL should be treated as an opaque blob, and not parsed.

RelaçõesRelationships

RelaçãoRelationship TipoType DescriçãoDescription
channelschannels Coleção channelchannel collection A coleção de canais e mensagens associadas à equipe.The collection of channels & messages associated with the team.
installedAppsinstalledApps Coleção teamsAppInstallationteamsAppInstallation collection Os aplicativos instalados nessa equipe.The apps installed in this team.
membersmembers coleção conversationMemberconversationMember collection Membros e proprietários da equipe.Members and owners of the team.
operationsoperations Coleção teamsAsyncOperationteamsAsyncOperation collection As operações assíncronas que foram executadas ou estão em execução nesta equipe.The async operations that ran or are running on this team.
primaryChannelprimaryChannel channelchannel O canal geral da equipe.The general channel for the team.
Cronogramaschedule Cronogramaschedule Cronograma de turno para essa equipe.The schedule of shifts for this team.
templatetemplate teamsTemplateteamsTemplate O modelo usado para criar essa equipe.The template this team was created from. Confira os modelos disponíveis.See available templates.

Representação JSONJSON representation

Veja a seguir uma representação JSON do recurso.The following is a JSON representation of the resource.

Observação: se a equipe for do tipo classe, uma propriedade classSettings será aplicada à equipe.Note: If the team is of type class, a classSettings property is applied on the team.

{
  "guestSettings": {"@odata.type": "microsoft.graph.teamGuestSettings"},
  "memberSettings": {"@odata.type": "microsoft.graph.teamMemberSettings"},
  "messagingSettings": {"@odata.type": "microsoft.graph.teamMessagingSettings"},
  "funSettings": {"@odata.type": "microsoft.graph.teamFunSettings"},
  "internalId": "string",
  "isArchived": false,
  "webUrl": "string (URL)",
  "classSettings": {"@odata.type": "microsoft.graph.teamClassSettings"}
}

Confira tambémSee also