Usar a API do Microsoft Graph para acessar as notificações de alteraçãoUse the Microsoft Graph API to get change notifications

Namespace: microsoft.graphNamespace: microsoft.graph

A API REST do Microsoft Graph usa um mecanismo de webhook para fornecer notificações de alteração aos clientes.The Microsoft Graph REST API uses a webhook mechanism to deliver change notifications to clients. Um cliente é um serviço Web que configura sua própria URL para receber notificações.A client is a web service that configures its own URL to receive notifications. Aplicativos cliente usam notificações para atualizar seu estado após alterações.Client apps use notifications to update their state upon changes. 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.For more details, including how to subscribe to and handle incoming notifications, see Set up notifications for changes in user data.

Usando a API do Microsoft Graph, um aplicativo pode se inscrever para alterações nos seguintes recursos:Using the Microsoft Graph API, an app can subscribe to changes on the following resources:

RecursoResource Trajetórias dos recursos com suporteSupported resource paths Os dados do recurso podem ser incluídos nas notificaçõesResource data can be included in notifications
Impressão na nuvem printerCloud printing printer Alterações quando um trabalho de impressão está pronto para ser baixado (evento JobFetchable):Changes when a print job is ready to be downloaded (JobFetchable event):
/print/printers/{id}/jobs
NãoNo
Impressão na nuvem printTaskDefinitionCloud printing printTaskDefinition Alterações quando há um trabalho válido na fila (evento JobStarted) :Changes when there is a valid job in the queue (JobStarted event) :
/print/printtaskdefinition/{id}/tasks
NãoNo
[Mensagem][] do OutlookOutlook message Alterações em todas as mensagens na caixa de correio de um usuário:Changes to all messages in a user's mailbox:
/users/{id}/messages
Alterações em todas as mensagens na caixa de entrada de um usuário:Changes to messages in a user's Inbox:
/users/{id}/mailFolders('inbox')/messages
NãoNo
[Evento][] do OutlookOutlook event Alterações em todas as mensagens na caixa de correio de um usuário:Changes to all events in a user's mailbox:
/users/{id}/events
NãoNo
Contato pessoal do OutlookOutlook personal contact Alterações em todas as mensagens na caixa de correio de um usuário:Changes to all personal contacts in a user's mailbox:
/users/{id}/contacts
NãoNo
Usuáriouser Alterações em todos os usuários:Changes to all users:
/users
Alterações em um usuário específico:Changes to a specific user:
/users/{id}
NãoNo
[Grupo][]group Alterações em todos os grupos:Changes to all groups:
/groups
Alterações em um grupo específico:Changes to a specific group:
/groups/{id}
Mudanças nos proprietários de um grupo específico:Changes to owners of a specific group:
/groups/{id}/owners
Mudanças em membros de um grupo específico:Changes to members of a specific group:
/groups/{id}/members
NãoNo
Grupo Microsoft 365 [conversação][]Microsoft 365 group conversation Alterações nas conversas de um grupo:Changes to a group's conversations:
groups/{id}/conversations
NãoNo
driveItem no OneDrive (pessoal)driveItem on OneDrive (personal) Alterações no conteúdo da hierarquia de qualquer pasta:Changes to content within the hierarchy of any folder:
/users/{id}/drive/root
NãoNo
driveItem no OneDrive for BusinessdriveItem on OneDrive for Business Alterações no conteúdo da hierarquia de qualquer pasta:Changes to content within the hierarchy of the root folder:
/drives/{id}/root
/users/{id}/drive/root
NãoNo
[lista][] em um site do SharePointlist under a SharePoint site Alterações no conteúdo da lista:Changes to content within the list:
/sites/{id}/lists/{id}
NãoNo
Alerta de segurançaSecurity alert Alterações em um alerta específico:Changes to a specific alert:
/security/alerts/{id}
Alterações em alertas filtrados:Changes to filtered alerts:
/security/alerts/?$filter
NãoNo
Teams callRecordTeams callRecord Mudanças para todos os registros de chamadas: /communications/callRecordsChanges to all call records: /communications/callRecords NãoNo
Equipes chatmessageTeams chatmessage Alterações nas mensagens de chat em todos os canais de todas as equipes:Changes to chat messages in all channels in all teams:
/teams/getAllMessages
Alterações nas mensagens de um chat específico:Changes to chat messages in a specific channel:
/teams/{id}/channels/{id}/messages
Alterações nas mensagens de todos os chats:Changes to chat messages in all chats:
/chats/getAllMessages
Alterações nas mensagens de um chat específico:Changes to chat messages in a specific chat:
/chats/{id}/messages
SimYes

Observação: qualquer trajetória de recurso que comece com o /users/{id} também pode aceitar /me referenciar o usuário conectado.Note: Any resource path that begins with /users/{id} can also accept /me to reference the signed-in user.

PermissionsPermissions

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.In general, subscription operations require read permission to the resource. For example, to get notifications for messages, your app needs the Mail.Read permission. The create subscription article lists permissions needed for each resource type. The following table lists the types of permissions your app can request to use webhooks for specific resource types.

Tipo de permissãoPermission type Tipos de recurso com suporteSupported resource types
Delegado - conta corporativa ou de estudanteDelegated - work or school account alerta, contato, conversa, driveItem, [lista][], [evento][], [grupo][], [mensagem][], usuárioalert, contact, conversation, driveItem, list, event, group, message, user
Delegado - conta pessoal da MicrosoftDelegated - personal Microsoft account contato, driveItem, [lista][], [evento][], [mensagem][]contact, driveItem, list, event, message
AplicativoApplication alert, contact, list, driveItem, event, group, message, user, callRecord, chatMessage, printer, printTaskDefinitionalert, contact, list, driveItem, event, group, message, user, callRecord, chatMessage, printer, printTaskDefinition

Confira tambémSee also