Usar a API do Microsoft Graph para acessar as notificações de alteração

Namespace: microsoft.graph

A API REST do Microsoft Graph usa um mecanismo de webhook para fornecer notificações de alteração aos clientes. Um cliente é um serviço Web que configura sua própria URL para receber notificações. Aplicativos cliente usam notificações para atualizar seu estado após alterações. Para saber mais, incluindo como se inscrever e lidar com as notificações recebidas, confira Configurar notificações para alterações nos dados de usuário.

Usando a API do Microsoft Graph, um aplicativo pode se inscrever para alterações nos seguintes recursos:

Recurso Trajetórias dos recursos com suporte Os dados do recurso podem ser incluídos nas notificações
Impressão na nuvem [printer][] Alterações quando um trabalho de impressão está pronto para ser baixado (evento JobFetchable):
/print/printers/{id}/jobs
Não
Impressão na nuvem printTaskDefinition Alterações quando há um trabalho válido na fila (evento JobStarted) :
/print/printtaskdefinition/{id}/tasks
Não
[Mensagem][] do Outlook Alterações em todas as mensagens na caixa de correio de um usuário:
/users/{id}/messages
Alterações em todas as mensagens na caixa de entrada de um usuário:
/users/{id}/mailFolders('inbox')/messages
Não
[Evento][] do Outlook Alterações em todas as mensagens na caixa de correio de um usuário:
/users/{id}/events
Não
Contato pessoal do Outlook Alterações em todas as mensagens na caixa de correio de um usuário:
/users/{id}/contacts
Não
Usuário Alterações em todos os usuários:
/users
Alterações em um usuário específico:
/users/{id}
Não
[Grupo][] Alterações em todos os grupos:
/groups
Alterações em um grupo específico:
/groups/{id}
Mudanças nos proprietários de um grupo específico:
/groups/{id}/owners
Mudanças em membros de um grupo específico:
/groups/{id}/members
Não
Grupo Microsoft 365 [conversação][] Alterações nas conversas de um grupo:
groups/{id}/conversations
Não
driveItem no OneDrive (pessoal) Alterações no conteúdo da hierarquia de qualquer pasta:
/users/{id}/drive/root
Não
driveItem no OneDrive for Business Alterações no conteúdo da hierarquia de qualquer pasta:
/drives/{id}/root
/users/{id}/drive/root
Não
[lista][] em um site do SharePoint Alterações no conteúdo da lista:
/sites/{id}/lists/{id}
Não
Alerta de segurança Alterações em um alerta específico:
/security/alerts/{id}
Alterações em alertas filtrados:
/security/alerts/?$filter
Não
Teams callRecord Mudanças para todos os registros de chamadas: /communications/callRecords Não
Equipes chatmessage Alterações nas mensagens de chat em todos os canais de todas as equipes:
/teams/getAllMessages
Alterações nas mensagens de um chat específico:
/teams/{id}/channels/{id}/messages
Alterações nas mensagens de todos os chats:
/chats/getAllMessages
Alterações nas mensagens de um chat específico:
/chats/{id}/messages
Sim

Observação: qualquer trajetória de recurso que comece com o /users/{id} também pode aceitar /me referenciar o usuário conectado.

Permissions

Em geral, as operações de assinatura exigem permissão de leitura ao recurso. Por exemplo, para obter notificações de mensagens, seu aplicativo precisa da permissão Mail.Read. O artigo criar assinatura lista as permissões necessárias para cada tipo de recurso. A tabela a seguir lista os tipos de permissões que o aplicativo pode solicitar para usar webhooks para tipos específicos de recursos.

Tipo de permissão Tipos de recurso com suporte
Delegado - conta corporativa ou de estudante alerta, contato, conversa, driveItem, [lista][], [evento][], [grupo][], [mensagem][], usuário
Delegado - conta pessoal da Microsoft contato, driveItem, [lista][], [evento][], [mensagem][]
Aplicativo [alert][], [contact][], list, driveItem, event, group, message, [user][], callRecord, chatMessage, [printer][], printTaskDefinition

Confira também