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
A API REST do Microsoft Graph pode fornecer notificações de alteração aos clientes por meio de vários pontos de extremidade, incluindo webhooks, Hubs de Eventos e Grade de Eventos. Para saber como assinar e receber notificações para seu aplicativo, consulte Configurar notificações de alterações nos dados do usuário.
Um aplicativo pode assinar as alterações nos recursos do Microsoft Graph listados na tabela. As assinaturas de recursos marcados com um asterisco (*) só estão disponíveis no /beta ponto de extremidade.
Observação
Para recursos do Microsoft Teams, o limite por organização de 10.000 assinaturas no total é compartilhado cumulativamente entre todas as assinaturas de notificação de alteração do Teams no locatário. Inclui assinaturas criadas para diferentes recursos do Teams, como chats, mensagens de chat, transcrições de chamadas, gravações de chamadas, canais, equipes e membros da conversa, que contam para a mesma cota organizacional. Quando o número combinado de assinaturas ativas do Teams atinge esse limite, qualquer solicitação adicional de criação de assinatura para um recurso do Teams falha com um 403 Forbidden erro.
| Recurso | Caminhos de recursos com suporte | Limitaçõ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 |
- |
| Impressão na nuvem printTaskDefinition | Alterado quando há um trabalho válido na fila (evento jobStarted): /print/printtaskdefinition/{id}/tasks |
- |
| Copilot aiInsights | Insights de IA do Copilot de reuniões das quais um determinado usuário faz parte: /copilot/users/{userId}/onlineMeetings/getAllAiInsights Insights de IA do Copilot para uma reunião específica: /copilot/users/{userId}/onlineMeetings/{onlineMeetingId}/aiInsights |
Cotas máximas de assinatura para insights de IA em todas as reuniões de um usuário:
Cotas máximas de assinatura para insights de IA de uma reunião específica:
|
| Copilot aiInteraction | Interações de IA do Copilot das quais um determinado usuário faz parte: copilot/users/{userId}/interactionHistory/getAllEnterpriseInteractions Interações de IA do Copilot em uma organização: copilot/interactionHistory/getAllEnterpriseInteractions |
Cotas máximas de assinaturas:
|
| driveItem no OneDrive (pessoal) | Alterações no conteúdo dentro da hierarquia de qualquer pasta: /users/{id}/drive/root |
- |
| driveItem no OneDrive corporativo ou de estudante | Alterações no conteúdo dentro da hierarquia da pasta raiz: /drives/{id}/root , /users/{id}/drive/root |
- |
| group | Alterações em todos os grupos: /groups Alterações em um grupo específico: /groups/{id} Alterações nos proprietários de um grupo específico: /groups/{id}/owners Alterações nos membros de um grupo específico: /groups/{id}/members |
Cotas máximas de assinaturas:
Não há suporte para locatários do Azure AD B2C. OBSERVAÇÃO: A criação e a exclusão reversível de grupos também acionam o updatedchangeType. |
| Alerta de Monitoramento de Integridade do Microsoft Entra | Alterações em todos os alertas de monitoramento de integridade: /reports/healthmonitoring/alerts Alterações em um tipo específico de alerta: /reports/healthmonitoring/alert com a notificationQueryOptions propriedade no conteúdo da solicitação definida como $filter=alertType eq '{alertType}' |
- |
| lista em um site do SharePoint | Alterações no conteúdo dentro da lista: /sites/{site-id}/lists/{list-id} |
- |
| Grupo Microsoft 365 conversação | Alterações nas conversas de um grupo: groups/{id}/conversations |
- |
| Mensagem do Outlook | Alterações em todas as mensagens na caixa de correio de um usuário: /users/{id}/messages , /me/messages Alterações nas mensagens na Caixa de Entrada de um usuário: /users/{id}/mailFolders('inbox')/messages , /me/mailFolders('inbox')/messages |
É permitido um máximo de 1.000 assinaturas ativas por caixa de correio para todos os aplicativos. |
| Evento do Outlook | Alterações em todos os eventos na caixa de correio de um usuário: /users/{id}/events , /me/events |
É permitido um máximo de 1.000 assinaturas ativas por caixa de correio para todos os aplicativos. |
| Contato pessoal do Outlook | Alterações em todos os contatos pessoais na caixa de correio de um usuário: /users/{id}/contacts , /me/contacts |
É permitido um máximo de 1.000 assinaturas ativas por caixa de correio para todos os aplicativos. |
| Alerta de segurança | Alterações em um alerta específico: /security/alerts/{id} Alterações nos alertas filtrados: /security/alerts/?$filter={parameters} |
Para obter mais informações, consulte Alertas da API de Segurança. |
| Aprovações de equipes | Alterações em todas as aprovações em um locatário: /solutions/approval/approvalItems |
Cotas máximas de assinaturas:
|
| Teams callRecord | Mudanças para todos os registros de chamadas: /communications/callRecords Alterações nos registros de chamadas filtrados: /communications/callRecords?$filter={parameters} |
Para obter mais informações, consulte Alterar notificações para Registros de Chamada. Cotas máximas de assinaturas:
OBSERVAÇÃO: A criação de registros de chamada também dispara o updatedchangeType. |
| CallRecording do Teams | Todas as gravações em uma organização: communications/onlineMeetings/getAllRecordings Todas as gravações de uma reunião específica: communications/onlineMeetings/{onlineMeetingId}/recordings Uma gravação de chamada que se torna disponível em uma reunião organizada por um usuário específico: users/{id}/onlineMeetings/getAllRecordings Uma gravação de chamada que se torna disponível em uma reunião em que um determinado aplicativo do Teams está instalado: appCatalogs/teamsApps/{id}/installedToOnlineMeetings/getAllRecordings * |
Cotas máximas de assinaturas:
|
| Transcrição de chamada do Teams | Todas as transcrições em uma organização: communications/onlineMeetings/getAllTranscripts Todas as transcrições de uma reunião específica: communications/onlineMeetings/{onlineMeetingId}/transcripts Uma transcrição de chamada que fica disponível em uma reunião organizada por um usuário específico: users/{id}/onlineMeetings/getAllTranscripts Uma transcrição de chamada que fica disponível em uma reunião em que um determinado aplicativo do Teams está instalado: appCatalogs/teamsApps/{id}/installedToOnlineMeetings/getAllTrancripts * |
Cotas máximas de assinaturas:
|
| Chat do Teams | Alterações em qualquer chat no locatário: /chats Alterações em um chat específico: /chats/{id} Alterações em um chat específico com o parâmetro de consulta notifyOnUserSpecificProperties : /chats/{id}?notifyOnUserSpecificProperties={Boolean} Alterações em todos os chats em uma organização onde um determinado aplicativo do Teams está instalado: /appCatalogs/teamsApps/{id}/installedToChats Alterações em todos os chats dos quais um determinado usuário faz parte: /users/{id}/chats Alterações em todos os chats dos quais um determinado usuário faz parte com o parâmetro de consulta notifyOnUserSpecificProperties : /users/{id}/chats?notifyOnUserSpecificProperties={Boolean} |
Cotas máximas de assinaturas:
|
| Teams chatMessage | Alterações nas mensagens de chat em todos os canais em todas as equipes: /teams/getAllMessages Alterações nas mensagens de chat em um canal específico: /teams/{id}/channels/{id}/messages Alterações nas mensagens de chat em todos os chats: /chats/getAllMessages Alterações nas mensagens de chat em um chat específico: /chats/{id}/messages Alterações nas mensagens de chat em todos os chats dos quais um determinado usuário faz parte: /users/{id}/chats/getAllMessages Alterações nas mensagens de chat para todos os chats em uma organização em que um determinado aplicativo do Teams está instalado: /appCatalogs/teamsApps/{id}/installedToChats/getAllMessages |
Cotas máximas de assinaturas:
|
| Canal do Teams | Alterações nos canais em todas as equipes: /teams/getAllChannels Alterações no canal em uma equipe específica: /teams/{id}/channels |
Cotas máximas de assinaturas:
|
| conversationMember do Teams | Alterações na associação de uma equipe específica: /teams/{id}/members Alterações na associação em todos os canais de uma equipe específica: teams/{id}/channels/getAllMembers Alterações na associação em um chat específico: /chats/{id}/members Alterações na associação de todos os chats em uma organização em que um determinado aplicativo do Teams está instalado: /appCatalogs/teamsApps/{id}/installedToChats/getAllMembers Alterações na associação em todos os chats: /chats/getAllMembers |
Cotas máximas de assinaturas:
|
| Teams onlineMeeting* | Alterações em uma reunião online: /communications/onlineMeetings(joinWebUrl='{encodedJoinWebUrl}')/meetingCallEvents |
Não dá suporte ao uso $select para retornar apenas propriedades selecionadas. A notificação avançada consiste em todas as propriedades da instância alterada. Uma assinatura permitida por aplicativo por reunião online. Para obter mais informações, consulte Obter notificações de alteração para atualizações de eventos de chamada de reunião do Microsoft Teams. |
| Teams presença | Alterações na presença de um único usuário: /communications/presences/{id} Alterações na presença de vários usuários: /communications/presences?$filter=id in ({id},{id}...) |
A assinatura para a presença de vários usuários é limitada a 650 usuários distintos. Não dá suporte ao uso $select para retornar apenas propriedades selecionadas. A notificação avançada consiste em todas as propriedades da instância alterada. Uma assinatura permitida por aplicativo por usuário delegado. Para obter mais informações, consulte Obter notificações de alteração para atualizações de presença no Microsoft Teams. |
| Equipe do Teams | Alterações em qualquer equipe no locatário: /teams Alterações em uma equipe específica: /teams/{id} |
Cotas máximas de assinaturas:
|
| Turnos do Teams offerShiftRequest | Alterações em qualquer solicitação de turno de oferta em uma equipe: /teams/{id}/schedule/offerShiftRequests |
Cotas máximas de assinaturas:
|
| Turnos do Teams openShiftChangeRequest | Alterações em qualquer solicitação de turno aberto em uma equipe: /teams/{id}/schedule/openShiftChangeRequests |
Cotas máximas de assinaturas:
|
| Turnos do Teams turno | Alterações em qualquer turno em uma equipe: /teams/{id}/schedule/shifts |
Cotas máximas de assinaturas:
|
| Troca de turnos do Teams ShiftsChangeRequest | Alterações em qualquer solicitação de troca de turno em uma equipe: /teams/{id}/schedule/swapShiftsChangeRequests |
Cotas máximas de assinaturas:
|
| TimeOffRequest dos turnos do Teams | Alterações em qualquer solicitação de folga em uma equipe: /teams/{id}/schedule/timeOffRequests |
Cotas máximas de assinaturas:
|
| todoTask | Alterações em todas as tarefas em uma lista de tarefas específica: /me/todo/lists/{todoTaskListId}/tasks |
- |
| user | Alterações para todos os usuários: /users Alterações em um usuário específico: /users/{id} |
Cotas máximas de assinaturas:
Não há suporte para contas pessoais da Microsoft como outlook.com. Não há suporte para locatários do Azure AD B2C. OBSERVAÇÃO: A criação e a exclusão reversível de usuários também acionam o updatedchangeType. |
Observação
Muitos recursos têm limites ou cotas de quantas assinaturas podem ser feitas nesse recurso. Ao exceder esse limite, as tentativas de criar uma assinatura resultarão em uma resposta de 403 Forbidden erro.
A propriedade message da resposta de erro explicará o limite que foi excedido.
Alguns desses recursos dão suporte a notificações avançadas (notificações com dados de recursos). Para obter detalhes, consulte Configurar notificações de alteração que incluem dados de recursos.
Observação: qualquer trajetória de recurso que comece com o
/users/{id}também pode aceitar/mereferenciar o usuário conectado.