Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Namespace: microsoft.graph
Uma conversa é 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 afetarão 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. |
| 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 | Obter uma conversa individual entre o utilizador e a aplicação |
| Remover todo o acesso do utilizador | Nenhum | Remova o acesso a uma conversa para um utilizador. |
| 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). |
| 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. |
| 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. |
| 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. |
| 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. |
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. Nulo 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. |
| 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.
{
"createdDateTime": "dateTimeOffset",
"chatType": "string",
"id": "string (identifier)",
"isHiddenForAllMembers": "Boolean",
"lastUpdatedDateTime": "dateTimeOffset",
"onlineMeetingInfo": {
"@odata.type": "microsoft.graph.teamworkOnlineMeetingInfo"
},
"tenantId": "string",
"topic": "string",
"viewpoint": {
"@odata.type": "microsoft.graph.chatViewpoint"
},
"webUrl": "string",
}