Novidades do Microsoft Graph

O Microsoft Graph fornece um modelo de programação unificado que você pode usar para acessar dados no Microsoft 365, Windows e Enterprise Mobility + Security. Este artigo fornece informações sobre as novidades em APIs do Microsoft Graph, documentação, SDKs e muito mais.

Para obter atualizações mais detalhadas no nível da API, consulte o changelog da API do Graph Microsoft.

Para obter detalhes sobre as atualizações anteriores do Microsoft Graph, consulte o histórico de novidades do Microsoft Graph.

Outubro de 2026: novo e em disponibilidade geral

Correio | Rastreamento de mensagem

• Adicionado suporte para identificar mensagens recuperadas no rastreamento de mensagens. Use a propriedade de status do recurso exchangeMessageTrace, que agora pode retornar recalled.

Outubro de 2026: novo apenas na visualização

Backup e recuperação | Backup e armazenamento do Microsoft 365

• Acompanhe as atividades do administrador em recursos de backup e restauração, incluindo alterações de política, execuções dinâmicas de regras, remoção e conclusões de tarefas de restauração, usando o recurso activityLogBase e seus tipos derivados.

Importação e exportação de caixa de correio

• Adicionada a propriedade isHidden ao recurso mailboxFolder para identificar pastas de caixa de correio ocultas.
• Use o parâmetro de consulta includeHiddenFolders existente para listar pastas e listar pastas filho. Defina-a para true incluir pastas ocultas e não ocultas.

Setembro de 2026: novo e em disponibilidade geral

Calendários | Horas e locais de trabalho

Adicionado suporte somente aplicativo aos recursos workHoursAndLocationsSetting, workPlanOccurrence e workPlanRecurrence e métodos relacionados. Os aplicativos podem usar a permissão do Calendars.Read.All aplicativo para ler a configuração, as recorrências e as ocorrências de um usuário e Calendars.ReadWrite.All para criá-las, atualizá-las e excluí-las.

Notificações de alteração

Promoveu o unknownFutureValue membro da enumeração changeType de beta para v1.0. A enumeração é usada pelos recursos changeNotification e commsNotification para identificar os tipos de alteração de notificação.

Arquivos

• A propriedade isPatternToken foi adicionada ao recurso fileStorageContainerCustomPropertyValue para indicar se um valor de propriedade personalizada é um urlTemplate padrão que os consumidores devem resolver antes de usar, em vez de um valor literal.
• A propriedade isOfficeRestricted foi adicionada aos recursos fileStorageContainerTypeSettings e fileStorageContainerTypeRegistrationSettings e à enumeração fileStorageContainerTypeSettingsOverride .
• Use o método revokeGrants do recurso de permissão para revogar o acesso a um link de compartilhamento para destinatários especificados.

Grupos

Adicionada a propriedade onPremisesExtensionAttributes ao recurso de grupo . Use-o para acessar os atributos de extensão 1-15 sincronizados do Active Directory local.

Identidade e acesso | Gerenciamento do diretório

• Adicionada a ação de provisionamento ao recurso de dispositivo na v1.0 para permitir que provedores de VDI (Virtual Desktop Infrastructure aprovados) provisionem dispositivos em um diretório do cliente.

Identidade e acesso | Governança

• Promoveu as revisões de acesso APIs de dados fornecidas pelo cliente de beta para v1.0. Use-os para analisar os dados de direito que você carrega para recursos que o próprio Microsoft Entra não descobre, como aplicativos de terceiros. A superfície promovida inclui:
  • a propriedade description em accessReviewInstanceDecisionItemResource para descrever o recurso em revisão.
  • accessReviewInstanceDecisionItemPermission tipo complexo e a propriedade permission em accessReviewInstanceDecisionItem, que descrevem a permissão que concede o acesso principal ao recurso em revisão.
  • accessReviewInstanceDecisionItemCustomDataProvidedResource específico, que representa um recurso de item de decisão cujos dados de direito são fornecidos pelo cliente em vez de descobertos pelo Microsoft Entra.
  • batchApplyCustomDataProvidedResourceDecisions em accessReviewInstance para definir o resultado de aplicação em todos os itens de decisão que correspondem a um recurso fornecido pelo cliente em uma chamada.
  • accessReviewInstanceDecisionItemApplyResult tipo de enumeração para representar o resultado da aplicação de uma decisão registrada ao recurso de destino.
• Esclarecemos que o método de recursos de lista retorna recursos do SharePoint Online somente quando é chamado com permissões delegadas. Para recuperar informações do site do SharePoint com permissões de aplicativo, use o método sites: getAllSites .

Identidade e acesso | Identidade e entrada

Adicionados os tipos de recursos anonymousCalendarSharingFreeBusyDetail, anonymousCalendarSharingFreeBusyReviewer e anonymousCalendarSharingFreeBusySimple . Use esses recursos de política de acesso entre locatários para autorizar usuários externos anônimos a exibir informações de disponibilidade do calendário em diferentes níveis de detalhes.

Segurança | Consulta de log de auditoria

• Adicionadas as propriedades isRecordCountLimitExceeded, recordCountLimit e approximateReturnedRecordCount ao recurso auditLogQuery . Use essas propriedades para determinar se uma consulta concluída excedeu o limite de contagem de registros por pesquisa e para inspecionar o limite aplicável e a contagem aproximada de registros retornados.

Trabalho em equipe e comunicação | Sistema de mensagens

O método getAllRetainedMessages foi atualizado para dar suporte à exportação de versões retidas de mensagens de canal privado que foram editadas ou excluídas depois que o locatário concluiu a migração de armazenamento de canal privado.

Setembro de 2026: novo somente na versão prévia

Agentes

Adicionada a propriedade isDisabled ao recurso agentIdentityBlueprint . Use-o para desativar um blueprint de identidade de agente sem excluí-lo.

Application

A propriedade isDeviceAccessEnabled foi adicionada ao recurso onPremisesPublishing para configurar o acesso ao dispositivo para o Acesso privado do Microsoft Entra.

Backup e recuperação | Backup e armazenamento do Microsoft 365

• A propriedade policyId foi adicionada ao tipo de recurso restoreSessionBase para definir o escopo das sessões de restauração para uma política de proteção.
• Adicionado o parâmetro policyId opcional ao método de pesquisa restorePoint: para validar a associação à unidade de proteção e melhorar o roteamento no escopo da política. Você também pode filtrar a coleção de pontos de restauração por protectionUnit/policyId.

Armazenamento de backup

• Adicionado o método getStatisticsByPolicy para recuperar estatísticas de proteção em nível de política para o Armazenamento de Backup do Microsoft 365. Use o relatório para monitorar artefatos protegidos e desprotegidos nos estados concluído, em andamento e com falha, revisar a atividade de desligamento e determinar quando as métricas foram calculadas pela última vez.

Calendar | Places

• Adicionado o tipo de recurso stringDictionary para representar pares de chave-valor de cadeia de caracteres personalizados.
• Adicionada a propriedade customProperties ao tipo de recurso place para armazenar pares de chave-valor de cadeia de caracteres definidos pelo cliente.
• Adicionada a propriedade lastUpdatedTime somente leitura ao tipo de recurso place para indicar quando o local foi atualizado pela última vez.

Calendários | Horas e locais de trabalho

Adicionado suporte somente aplicativo aos recursos workHoursAndLocationsSetting, workPlanOccurrence e workPlanRecurrence e métodos relacionados. Os aplicativos podem usar a permissão do Calendars.Read.All aplicativo para ler a configuração, as recorrências e as ocorrências de um usuário e Calendars.ReadWrite.All para criá-las, atualizá-las e excluí-las.

Notificações de alteração

Adicionado o unknownFutureValue membro à enumeração changeType usada pelo recurso changeNotification para dar suporte a tipos de alteração de notificação compatíveis com encaminhamento.

Gerenciamento de dispositivos e aplicativos | PC na nuvem

• A propriedade isDisasterRecoveryActive foi adicionada ao recurso cloudPC para indicar se o PC na nuvem atualmente é executado em sua região de recuperação de desastre após um evento de failover.
• Use failoverInProgress e failbackInProgress como valores com suporte para a propriedade status nos recursos cloudPC e cloudPcStatusSummary.

Arquivos

• Adicionado o parâmetro userObjectId ao método getByUser no recurso fileStorageContainer para recuperar uma lista de contêineres de armazenamento de arquivos pertencentes a um usuário, passando a ID do objeto do Microsoft Entra ID do usuário.
• A propriedade isPatternToken foi adicionada ao recurso fileStorageContainerCustomPropertyValue para indicar se um valor de propriedade personalizada é um urlTemplate padrão que os consumidores devem resolver antes de usar, em vez de um valor literal.

Identidade e acesso | Gerenciamento do diretório

• Adicionado o tipo de recurso directoryRoleManagementDeletedItemContainer e métodos relacionados para recuperar definições de função personalizadas que foram excluídas. Use essas APIs para listar e inspecionar funções personalizadas excluídas temporariamente, restaurá-las para a coleção de definições de função ativa ou excluí-las permanentemente.
• A ação de provisionamento foi adicionada ao recurso de dispositivo para permitir que provedores de VDI (Virtual Desktop Infrastructure aprovados) provisionem dispositivos em um diretório do cliente.

Grupos

• A propriedade disableNesting foi adicionada ao recurso de grupo . Use-o para impedir que outros grupos sejam adicionados como membros de um grupo de segurança.

Identidade e acesso | Gerenciamento do diretório

• A ação de provisionamento foi adicionada ao recurso de dispositivo para permitir que provedores de VDI (Virtual Desktop Infrastructure aprovados) provisionem dispositivos em um diretório do cliente.

Identidade e acesso | Governança

Esclarecemos que o método Get accessPackageResourceEnvironment retorna ambientes de recursos do SharePoint Online somente quando é chamado com permissões delegadas. Um ambiente de recursos do SharePoint Online corresponde a um site raiz do SharePoint, portanto, para recuperar informações do site raiz com permissões de aplicativo, use o método Listar sites com a $filter=siteCollection/root ne null opção de consulta.

• Adicionado suporte de visualização pública para políticas de ciclo de vida que regem identidades de agentes e usuários convidados. Use lifecyclePolicy e seus tipos de política derivados para configurar escopo, regras, imposição de fluxo de trabalho, avaliação de impacto e relatórios de processamento.
• Foram adicionadas ações de ciclo de vida de usuário convidado para atestar, adicionar o usuário conectado como patrocinador e remover o usuário conectado como patrocinador.

Identidade e acesso | Identidade e entrada

Adicionada a propriedade requireCertificateSidAlignment ao recurso x509CertificateAuthenticationMethodConfiguration . Use-o para exigir o alinhamento SID do certificado para usuários híbridos e somente na nuvem durante a autenticação baseada em certificado.

People and workplace intelligence | Análise

Adicionada a propriedade sensitivityLabel ao tipo de recurso searchHit para fornecer informações de rótulo de confidencialidade para o recurso de resultado da pesquisa.

Relatórios | Relatórios de cobrança de parceiros

Adicionado o tipo de recurso billedAggregatedUsage e o método de exportação relacionado para que os parceiros CSP gerem relatórios de uso agregados e faturados do Azure para uma fatura específica.

Segurança | Conformidade e segurança de dados

Adicionado o contentFiltering membro à enumeração userActivityTypes usado pelos escopos de proteção de computação para um usuário e escopos de proteção de computação para APIs de locatário , permitindo que os aplicativos determinem se as políticas de prevenção contra perda de dados regem a filtragem de conteúdo antes de avaliar o conteúdo.

O recurso contentActivity foi atualizado para dar suporte a relatórios de avaliações de política seguras por padrão que não puderam ser concluídas. Os planos de aplicação podem enviar motivos estruturados de inspeção incompleta por meio da API de ingestão de atividade de conteúdo existente.

Segurança | Consulta de log de auditoria

• Adicionadas as propriedades isRecordCountLimitExceeded, recordCountLimit e approximateReturnedRecordCount ao recurso auditLogQuery . Use essas propriedades para determinar se uma consulta concluída excedeu o limite de contagem de registros por pesquisa e para inspecionar o limite aplicável e a contagem aproximada de registros retornados.

Trabalho em equipe e comunicação | Sistema de mensagens

O método getAllRetainedMessages foi atualizado para documentar o suporte para versões de mensagens de canal privado retidas capturadas após a conclusão da migração de armazenamento de canal privado do locatário.

Agosto de 2026: novo e em disponibilidade geral

Aplicativos

• Adicionado o tipo de recurso authenticationBehaviors e a propriedade coopEnforcement ao ponto de extremidade v1.0. Os proprietários de aplicativos podem usar a propriedade para testar explicitamente a imposição de Cross-Origin-Opener-Policy, suprimir temporariamente a imposição enquanto corrige um fluxo de autenticação de navegador incompatível ou retornar ao padrão do serviço. A propriedade está disponível apenas no serviço global e não está disponível em implantações de nuvem nacional.
• Adicionada a propriedade authenticationBehaviors ao tipo de recurso de aplicativo na v1.0. Retornado apenas em $select.

Notificações de alteração | do Azure

• Adicionado suporte para fornecer notificações de alteração para pontos de extremidade Web Push (RFC 8291) para o tipo de recurso de assinatura .
• Adicionado o método getVapidPublicKey para obter a chave pública VAPID (RFC 8292) usada ao criar assinaturas Web Push.

Arquivos

• Adicionado o método Upsert columns ao tipo de recurso fileStorageContainer para criar ou atualizar até 20 objetos columnDefinition em uma única solicitação.
• Adicionado o parâmetro appliedByUser à ação assignSensitivityLabel no recurso driveItem . Esse parâmetro permite que os chamadores somente de aplicativo especifiquem a identidade do usuário em nome da qual o rótulo de confidencialidade é aplicado.

Identidade e acesso | Gerenciamento do diretório

• Adicionada a propriedade managerApplications aos recursos agentIdentity e agentIdentityBlueprintPrincipal para identificar os aplicativos que gerenciam o blueprint de identidade do agente de backup.

Adicionado o tipo de recurso de recuperação e métodos relacionados para recuperar programaticamente objetos críticos do diretório do Microsoft Entra de instantâneos pontuais criados automaticamente. Use essas APIs para inspecionar os instantâneos disponíveis, visualizar e definir o escopo das alterações antes da restauração, executar trabalhos de recuperação, monitorar o progresso e revisar as alterações com falha.

Identidade e acesso | Governança

• Adicionado o tipo complexo externalSapAcConnectionInfo, juntamente com os tipos de suporte authenticationInfo e clientCredentialAuthenticationInfo, para configurar conexões do gerenciamento de direitos do Microsoft Entra para sistemas de Controle de Acesso (AC) SAP. Defina-os na propriedade connectionInfo de um externalOriginResourceConnector quando seu connectorType for sapAc.
• Promovemos o provisionamento de fluxos de trabalho de fluxos de vida e APIs de assunto de fluxo de trabalho de beta para v1.0, introduzindo um modelo de assunto mais amplo e extensível para fluxos de trabalho e apresentando resultados de processamento por assunto. A superfície promovida inclui:
  • tipo base workflowSubject e seu provisionamentoObjectWorkflowSubject e directoryObjectWorkflowSubject tipos derivados
  • subjectProcessingResult com a propriedade de navegação subjectProcessingResults nos recursos de execução e fluxo de trabalho
  • subjectSummary e o método de resumo no recurso subjectProcessingResult
  • activateAndWait no recurso de fluxo de trabalho, retornando o recurso awaitedWorkflowProcessingResult
  • recursos provisioningAttributeMapping e attributeSetEntry
  • recurso customTaskExtensionResponseData , a propriedade replyMode em customTaskExtension e a propriedade targetSubject em customTaskExtensionCalloutData
  • Propriedade targetSubjectType em workflowBase e propriedade workflowSubject em taskProcessingResult
  • subjectType e customTaskExtensionReplyMode enumerações, juntamente com os membros da extensibility enumeração e extensibilityOnDemand
• Adicionado o tipo de recurso externalOriginResourceConnector e os métodos para criar, listar, obter, atualizar e excluir conexões do gerenciamento de direitos do Microsoft Entra para o SAP Identity Access Governance (SAP IAG). Para um conector SAP IAG, especifique o ponto de extremidade SAP IAG, o ponto de extremidade do token OAuth e a ID do cliente, juntamente com a assinatura do Azure, o grupo de recursos, o cofre de chaves e o segredo que identificam onde o segredo do cliente está armazenado. O conector está associado a um recurso de pacote de acesso para que o gerenciamento de direitos possa provisionar acesso a recursos no SAP IAG por meio de pacotes de acesso.
• Adicionadas as propriedades reviewerId e scopeType ao accessReviewReviewerScope para especificar um revisor diretamente ou como um escopo conhecido em vez de por meio de uma consulta.
• Adicionada a propriedade applyDescription a accessReviewInstanceDecisionItem para descrever o resultado da aplicação de uma decisão.
• Adicionadas as propriedades appRoleId e appRoleDisplayName ao accessReviewInstanceDecisionItemServicePrincipalResource para identificar a função do aplicativo em revisão.
• Adicionada a propriedade errors a accessReviewInstance e o tipo de recurso accessReviewError para relatar erros que ocorrem durante o ciclo de vida da instância de revisão.
• Adicionados os tipos de recurso accessReviewPrincipalScope, accessReviewResourceScope e accessReviewPackageAssignmentPolicyScope . Use-os nas propriedades principalScopes e resourceScopes de principalResourceMembershipsScope para declarar quais entidades de segurança têm acesso a quais recursos revisados sem escrever uma expressão de consulta.
• Adicionados os tipos de enumeração accessReviewPrincipalScopeType, accessReviewResourceScopeType e accessReviewReviewerScopeType para identificar escopos conhecidos de entidade de segurança, recurso e revisor.

Identidade e acesso | Identidade e entrada

Adicionado suporte para gerenciar recursos entre locatários do Microsoft 365 em políticas de acesso entre locatários. Use o recurso m365CapabilityBase e o relacionamento m365Capabilities para gerenciar quais experiências do Microsoft 365, como compartilhamento de calendário, Dicas de email, reserva de locais e migração entre locatários, estão habilitadas entre locatários. Para a política padrão, você pode listar, criar e atualizar recursos. Para políticas de parceiros, você pode listar, criar, atualizar e excluir recursos.

Email

• Adicionado o tipo de recurso de anotação e métodos para listar, criar, obter, atualizar e excluir anotações de captura rápida na pasta Anotações de um usuário. Use a consulta delta para sincronizar notas que foram adicionadas, atualizadas ou excluídas desde a solicitação anterior. Você também pode listar, adicionar e excluir anexos de imagem embutida e usar propriedades estendidas abertas ou herdadas para armazenar dados personalizados em uma anotação.

Segurança | Alertas e incidentes

• Adicionada a propriedade tenantId ao recurso userAccount para fornecer a ID de locatário doméstico do Entra para a conta de usuário comprometida indicada em um alerta de segurança em que a evidência do alerta está relacionada a um processEvidence, userEvidence ou mailboxEvidence.
• Adicionado o alerta: moveAlerts e incident: mergeIncidents para dar suporte a alertas em movimento e mesclagem de incidentes no Microsoft Defender.
• Adição do tipo de recurso correlationReason enumeration e mergeResponse .

Segurança | Descoberta Eletrônica

Adicionado o cloudNativeHtmlConversion membro à enumeração additionalDataOptions .

Importação e exportação de caixa de correio

• Adicionada a propriedade wellKnownName ao tipo de recurso mailboxFolder na v1.0. Use esta propriedade para identificar pastas criadas pelo Outlook usando um nome independente de localidade.
• Adicionado o método Excluir mailboxItem ao tipo de recurso mailboxItem na v1.0. Use esse método para excluir um item de caixa de correio individual de uma pasta de caixa de correio com semântica de exclusão reversível ou exclusão irreversível do Exchange.

Segurança

Atualizou a data de desativação da API de alertas de segurança herdada do Microsoft Graph de 31 de agosto de 2026 para 15 de outubro de 2026.

Identidade e acesso | Monitorando a integridade &

• Adicionado suporte para marcar as recomendações do Microsoft Entra e seus recursos afetados. Use os métodos recommendation: addTag, recommendation: removeTag, impactedResource: addTag e impactedResource: removeTag para gerenciar o relacionamento de tags , apoiados pelo novo recurso recommendationTag . Você também pode adicionar ou remover uma marca em até 50 recursos afetados em uma única solicitação usando os métodos impactedResource: addTag e impactedResource: removeTag .
• Adicionados estados de correção alternativos para recomendações e recursos afetados. Use os métodos markPlanned, acceptRisk e applyAlternateMitigation no recurso de recomendação e os métodos correspondentes no recurso impactedResource .
• Adicionado o needsMoreAction membro à enumeração recommendationStatus e o critical membro à enumeração recommendationPriority .
• Adicionado o recurso nistClassification e a propriedade nistClassifications ao recurso recommendationBase para mapear recomendações para funções e categorias do NIST Cybersecurity Framework 2.0.
• Adicionada a propriedade categoryGroup (e a nova enumeração recommendationCategoryGroup ), completedBySystemDateTime, completedByUserDateTime, failedReviewDateTime, needsMoreActionResourceCount, remediatedDateTime e statusModifiedDateTime ao recurso recommendationBase . Adicionado o microsoftEntraSuite membro à enumeração requiredLicenses e a propriedade lastRefreshedDateTime ao recurso recommendationConfiguration .

People and workplace intelligence | Análise

Adicionada a propriedade sensitivityLabel ao tipo de recurso searchHit para fornecer informações de rótulo de confidencialidade para o recurso de resultado da pesquisa.

Segurança

Adicionada a propriedade incidentConfiguration ao recurso detectionAction e ao tipo complexo incidentConfiguration . Use essa configuração para excluir alertas gerados por uma regra de detecção personalizada da correlação automática de incidentes e criar incidentes autônomos de alerta único.

Segurança | Consulta de log de auditoria

• Adicionadas as propriedades isRecordCountLimitExceeded, recordCountLimit e approximateReturnedRecordCount ao recurso auditLogQuery . Use essas propriedades para determinar se uma consulta concluída excedeu o limite de contagem de registros por pesquisa e para inspecionar o limite aplicável e a contagem aproximada de registros retornados.

Segurança | Conformidade e segurança de dados

Adicionado o contentFiltering membro à enumeração userActivityTypes usado pelos escopos de proteção de computação para um usuário e escopos de proteção de computação para APIs de locatário , permitindo que os aplicativos determinem se as políticas de prevenção contra perda de dados regem a filtragem de conteúdo antes de avaliar o conteúdo.

Adicionada a propriedade policyConfiguration ao tipo de recurso policyScopeBase . Os planos de imposição podem usar a configuração efetiva de Segurança por Padrão retornada pelas APIs do escopo de proteção para determinar se devem auditar ou bloquear o conteúdo quando a avaliação da política não puder ser concluída.

O recurso contentActivity foi atualizado para dar suporte a relatórios de avaliações de política seguras por padrão que não puderam ser concluídas. Os planos de imposição podem enviar motivos estruturados de inspeção incompleta por meio da API de ingestão de atividade de conteúdo existente

Trabalho em equipe e comunicação | Sistema de mensagens

O método getAllRetainedMessages foi atualizado para documentar o suporte para versões de mensagens de canal privado retidas capturadas após a conclusão da migração de armazenamento de canal privado do locatário.

Contribuir com o Microsoft Graph

Existem cenários em que você gostaria que o Microsoft Graph oferecesse suporte?

• Sugira e vote em novos recursos usando o Portal de Comentários do Microsoft Graph. Alguns novos recursos são originados como solicitações populares da comunidade de desenvolvedores. A equipe do Microsoft Graph avalia regularmente as necessidades dos clientes e lança novos recursos para os pontos de extremidade beta (https://graph.microsoft.com/beta) e v1.0 (https://graph.microsoft.com/v1.0).

• Participe da chamada semanal da comunidade da plataforma Microsoft 365 e torne-se um membro ativo da comunidade do Microsoft Graph. Para descobrir o calendário completo de chamadas para desenvolvedores, visite a página da comunidade do Microsoft 365 e do Power Platform.

• Participe do nosso painel de pesquisa para fornecer sua opinião sobre nossas experiências para desenvolvedores.

Conteúdo relacionado

• Blog do desenvolvedor do Microsoft Graph.
• Log de alterações da API do Graph Microsoft.
• Histórico de novidades do Microsoft Graph.