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.
Representa um chat que é uma coleção de chatMessages entre um ou mais participantes. Os participantes podem ser utilizadores ou aplicações.
Nota: se o chat estiver associado a uma instância onlineMeeting , alguns dos métodos listados afetam transitivamente a reunião.
Métodos
| Método | Tipo de retorno | Descrição |
|---|---|---|
| Gestão de conversas | ||
| List | coleção de chat | Obtenha a lista de conversas de que um utilizador faz parte. |
| Create | chat | Crie uma nova conversa. |
| Get | chat | Leia as propriedades e relações do chat. |
| Atualizar | chat | Atualize as propriedades do chat. |
| Delete | Nenhum | Eliminar uma conversa. |
| Remover todo o acesso do utilizador | Nenhum | Remova o acesso a uma conversa para um utilizador. |
| Listar membros | coleção conversationMember | Ver a lista de todos os usuários no bate-papo. |
| Adicionar membro | Cabeçalho location | Adicione um utilizador ao chat. |
| Obter membro | conversationMember | Obter um único usuário no bate-papo. |
| Remover membro | Nenhum | Remova um utilizador da conversa. |
| Obter chat entre o usuário e o aplicativo | chat | Obtenha uma conversa individual entre o utilizador e a aplicação. |
| Marcar o chat como lido | Nenhum | Marcar o chat como lido para um utilizador. |
| Marcar o chat como não lido | Nenhum | Marcar o chat como não lido para um utilizador. |
| Ocultar conversa | Nenhum | Ocultar uma conversa para um utilizador. |
| Mostrar conversa | Nenhum | Mostrar uma conversa para um utilizador. |
| Iniciar migração | chat | Inicie a migração de mensagens externas ao ativar o modo de migração num chat existente. |
| Migração completa | chat | Conclua a migração de mensagens externas ao remover o modo de migração de um chat. |
| Mensagens | ||
| Listar mensagens em um bate-papo | chatMessage | Obter mensagens numa conversa. |
| Obter resposta da mensagem | chatMessage | Receba uma única mensagem em um bate-papo. |
| Obter mensagens em todas as conversas | coleção de chat | Obter mensagens de todos os chats nos quais um usuário é um participante. |
| Obter mensagens retidas em todas as conversas | chatMessage collection | Obtenha todas as mensagensretidas de todas as conversas nas quais um utilizador participa, incluindo conversas um-para-um, conversas de grupo e conversas de reunião. |
| Obter mensagens de chat delta para o utilizador | chatMessage collection | Obtenha a lista de mensagens de todas as conversas nas quais um utilizador é participante, incluindo conversas um-para-um, conversas de grupo e conversas de reunião. |
| Aplicativos | ||
| Listar aplicativos no chat | Coleção teamsAppInstallation | Listar aplicações instaladas num chat (e reunião associada). |
| Instalar a aplicação no chat | teamsAppInstallation | Instale uma aplicação específica numa conversa (e reunião associada). |
| Adicionar aplicação no chat | Adicionar (instalar) uma aplicação numa conversa (e reunião associada). | |
| Atualizar aplicativo instalado no chat | Nenhum | Atualize para a versão mais recente da aplicação instalada no chat (e reunião associada). |
| Remover a aplicação do chat | Nenhum | Remover (desinstalar) a aplicação de uma conversa (e reunião associada). |
| Listar as concessões de permissões | Coleção resourceSpecificPermissionGrant | Liste as permissões concedidas às aplicações neste chat. |
| Guias | ||
| Listar separadores no chat | teamsTab | Separadores de lista afixados a uma conversa (e reunião associada). |
| Obter o separador no chat | teamsTab | Obter um separador específico afixado a uma conversa (e reunião associada). |
| Adicionar separador ao chat | teamsTab | Adicione (afixe) um separador a uma conversa (e reunião associada). |
| Separador Atualizar no chat | teamsTab | Atualize as propriedades de um separador numa conversa (e reunião associada). |
| Remover separador do chat | Nenhum | Remover (remover) um separador de uma conversa (e reunião associada). |
| Operations | ||
| Listar operações | Coleção teamsAsyncOperation | Obtenha a lista de operações assíncronas executadas ou em execução no chat. |
| Obter operação no chat | teamsAsyncOperation | Obtenha uma única operação assíncrona executada ou em execução no chat. |
| Mensagens afixadas | ||
| Listar mensagens afixadas | pinnedChatMessageInfo collection | Obtenha uma lista de mensagens afixadas numa conversa. |
| Afixar mensagem | pinnedChatMessageInfo | Afixe uma mensagem de chat numa conversa. |
| Remover mensagem | Nenhum | Remover uma mensagem de uma conversa. |
Nota: Ao utilizar permissões de aplicação, certifique-se de que sabe como obter o ID de chat. Uma vez que a listagem de conversas com permissões de aplicação não é suportada, nem todos os cenários são possíveis. É possível obter IDs de chat com permissões delegadas e de notificações de alteração para /chats/getAllMessages com permissões de aplicação.
Propriedades
| Propriedade | Tipo | Descrição |
|---|---|---|
| chatType | chatType | Especifica o tipo de chat. Os valores possíveis são: group, oneOnOne, meeting, unknownFutureValue. |
| createdBy | identitySet | O utilizador ou aplicação que criou o chat. Somente leitura. |
| createdDateTime | dateTimeOffset | Data e hora em que a conversa foi criada. Somente leitura. |
| id | Cadeia de caracteres | O identificador exclusivo do chat. Somente leitura. |
| isHiddenForAllMembers | Booliano | Indica se a conversa está oculta para todos os respetivos membros. Somente leitura. |
| lastUpdatedDateTime | dateTimeOffset | Data e hora em que o nome da conversa foi mudado ou a lista de membros foi alterada pela última vez. Somente leitura. |
| migrationMode | migrationMode | Indica se uma conversa está no modo de migração. Este valor destina-se null a conversas que nunca entraram no modo de migração. Os valores possíveis são: inProgress, completed, unknownFutureValue. |
| onlineMeetingInfo | teamworkOnlineMeetingInfo | Representa detalhes sobre uma reunião online. Se o chat não estiver associado a uma reunião online, a propriedade estará vazia. Somente leitura. |
| originalCreatedDateTime | dateTimeOffset | Carimbo de data/hora da hora de criação original do chat. O valor é null se o chat nunca tiver entrado no modo de migração. |
| tenantId | String | O identificador do inquilino no qual a conversa foi criada. Somente leitura. |
| topic | Cadeia de caracteres | (Opcional) Assunto ou tópico do chat. Apenas disponível para conversas de grupo. |
| ponto de vista | chatViewpoint | Representa informações específicas do autor da chamada sobre o chat, como a data e hora de leitura da última mensagem. Esta propriedade só é preenchida quando o pedido é feito num contexto delegado. |
| webUrl | String | O URL do chat no Microsoft Teams. O URL deve ser tratado como um blob opaco e não analisado. Somente leitura. |
valores de chatType
| Member | Descrição |
|---|---|
| oneOnOne | Indica que o chat é uma conversa de 1:1. O tamanho da lista é fixo para este tipo de chat; os membros não podem ser removidos/adicionados. |
| group | Indica que o chat é uma conversa de grupo. O tamanho da lista (de, pelo menos, duas pessoas) pode ser atualizado para este tipo de chat. Os membros podem ser removidos/adicionados mais tarde. |
| reunião | Indica que o chat está associado a uma reunião online. Este tipo de chat só é criado como parte da criação de uma reunião online. |
| unknownFutureValue | Valor da sentinela de enumeração evoluível. Não usar. |
valores migrationMode
| Member | Descrição |
|---|---|
| inProgress | O chat entrou no modo de migração. |
| concluído | O chat está fora do modo de migração. |
| unknownFutureValue | Valor da sentinela de enumeração evoluível. Não usar. |
Relações
| Relação | Tipo | Descrição |
|---|---|---|
| installedApps | Coleção teamsAppInstallation | Uma coleção de todas as aplicações no chat. Anulável. |
| lastMessagePreview | chatMessageInfo | Pré-visualização da última mensagem enviada no chat.
Null se não forem enviadas mensagens na conversa. Atualmente, apenas a operação de chats de lista suporta esta propriedade. |
| members | coleção conversationMember | Uma coleção de todos os membros na conversa. Anulável. |
| messages | chatMessage collection | Uma coleção de todas as mensagens no chat. Anulável. |
| operations | Coleção teamsAsyncOperation | Uma coleção de todas as operações assíncronas do Teams executadas ou em execução no chat. Anulável. |
| permissionGrants | Coleção resourceSpecificPermissionGrant | Uma coleção de permissões concedidas às aplicações para o chat. |
| pinnedMessages | pinnedChatMessageInfo collection | Uma coleção de todas as mensagens afixadas no chat. Anulável. |
| guias | teamsTab collection | Uma coleção de todos os separadores no chat. Anulável. |
Representação JSON
A representação JSON seguinte mostra o tipo de recurso.
{
"chatType": "String",
"createdBy": {"@odata.type": "microsoft.graph.identitySet"},
"createdDateTime": "String (timestamp)",
"id": "String (identifier)",
"isHiddenForAllMembers": "Boolean",
"lastUpdatedDateTime": "String (timestamp)",
"migrationMode": "String",
"onlineMeetingInfo": {"@odata.type": "microsoft.graph.teamworkOnlineMeetingInfo"},
"originalCreatedDateTime": "String (timestamp)",
"tenantId": "String",
"topic": "String",
"viewpoint": {"@odata.type": "microsoft.graph.chatViewpoint"},
"webUrl": "String"
}