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.

Importante

Os recursos no status de visualização estão sujeitos a alterações sem aviso prévio e podem não ser promovidos ao status de disponibilidade geral (GA). Não use recursos de visualização em aplicativos de produção.

Setembro de 2026: novo e em disponibilidade geral

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 | 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 .

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.

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.

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.

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.

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 | 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.

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 .

Trabalho em equipe e comunicação | Chamadas e reuniões online

• Atualizados os métodos getAllRecordings e getAllTranscripts para documentar um problema de atualização de serviço que pode fazer com que solicitações paginadas retornem uma coleção vazia seguida de itens duplicados.
• O método getAllRecordings foi atualizado para retornar uma URL do Microsoft Graph que você pode usar para baixar o conteúdo de gravação.

Agosto de 2026: novo apenas na visualização

Aplicativos

• Adicionada a propriedade coopEnforcement ao recurso authenticationBehaviors . Os proprietários de aplicativos podem usá-lo 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.

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, habilitando a atribuição de rótulo para contêineres do SharePoint Embedded.

Identidade e acesso | Governança

• Adicionado suporte para gatilhos de fluxo de trabalho de ciclo de vida baseados em tempo configuráveis por meio do recurso timeBasedAttributeTriggerV2 . Selecione um atributo de usuário do tipo data e configure um operador para executar fluxos de trabalho em uma data exata, dentro de uma janela sem interrupção ou entre dois deslocamentos antes ou depois dessa data.

Identidade e acesso | Identidade e entrada

• Foram adicionados os recursos anonymousCalendarSharingFreeBusySimple, anonymousCalendarSharingFreeBusyDetail e anonymousCalendarSharingFreeBusyReviewer derivados do m365CapabilityBase. Use esses recursos em políticas de acesso entre locatários para autorizar usuários externos anônimos a exibir informações de disponibilidade do calendário com fidelidade simples, detalhada ou do revisor.

Email

• Alterou a propriedade members no recurso distributionList para uma relação expansível. Use $expand=members com o método Obter lista de distribuição em vez dos métodos autônomos removidos para listar e obter membros.

Inteligência de pessoas e no local de trabalho

• Atualizado Gerenciar precedência de fonte de perfil no Microsoft 365 para esclarecer fontes de dados com suporte para dados de RH e posição de trabalho, explicar como a precedência de origem afeta propriedades de valor único versus propriedades de vários valores e adicionar diretrizes sobre como configurar e remover corretamente as configurações de nível de locatário usando a API do Graph Microsoft ou o PowerShell.
• Adicionado o artigo de conceito People data sources no Microsoft 365 que descreve as fontes de dados que criam o perfil de usuário do Microsoft 365, incluindo o Microsoft Entra ID, conectores do Copilot, dados organizacionais, SharePoint, People Skills, edições de usuário e a fonte de usuário da API. O artigo também fornece uma tabela de referência de IDs de origem (GUIDs) internas e explica como os metadados de origem aparecem na saída da API de perfil.

Segurança | Busca avançada

• Adicionada a função getHuntingSchemaTables ao recurso de segurança . Use-o para recuperar apenas as tabelas de busca avançadas que o usuário conectado pode acessar, retornadas como uma coleção para que você possa aplicar parâmetros de consulta OData para solicitar um subconjunto de tabelas e colunas de destino.

Segurança | Alertas e incidentes

• Adicionada a ação createAlert ao recurso de alerta para criar alertas do Microsoft 365 Defender programaticamente, incluindo propriedades de alerta, opções de vinculação de incidentes, roteamento de espaço de trabalho e definições de entidade embutidas em uma única solicitação.

Segurança | Gerenciamento de casos

• Adicionada a propriedade slaPolicies ao tipo de recurso case, uma coleção somente leitura de objetos caseSlaPolicyEntry que relatam o status atual e o tempo de destino de violação de cada política SLA aplicada a um caso.
• Adicionados os métodos baixar conteúdo do anexo e carregar conteúdo do anexo ao tipo de recurso anexo para transferir evidências de caso em partes e recuperá-las após a verificação de malware.
• Adicionados os métodos get relation e delete relation ao tipo de recurso relation para ler e remover links entre uma ocorrência e os recursos de segurança relacionados.
• Adicionado o método de tarefa de exclusão ao tipo de recurso de tarefa para remover uma tarefa de um caso.

Segurança | Conformidade e segurança de dados

• Adicionados os privacyDataMatchmembros , aiPowerede unknownFutureValue à enumeração classificationMethod para o recurso sensitiveType . Esses membros dão suporte à correspondência de dados de privacidade com base nos dados do locatário, à classificação baseada em IA que pode se beneficiar de inserções fornecidas pelo chamador com suporte e ao tratamento compatível com o encaminhamento de valores futuros.
• Substituiu a propriedade offsetChunks e o tipo de recurso embeddingOffsetChunk pela propriedade chunkOffsets e o tipo complexo chunkOffsets em embeddingInput. Use chunkOffsets para associar vetores de incorporação pré-computados a seus intervalos de texto de origem usando posições iniciais e comprimentos codificados em base64.

Trabalho em equipe e comunicação | Chamadas e reuniões online

• Atualizados os métodos getAllRecordings e getAllTranscripts para documentar um problema de atualização de serviço que pode fazer com que solicitações paginadas retornem uma coleção vazia seguida de itens duplicados.

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

• Adicionado o tipo de recurso agentCommunicationConfiguration e métodos relacionados para configurar como os agentes enviam e recebem mensagens no Microsoft Teams. Defina as configurações de comunicação padrão em um agentIdentityBlueprint e substitua-as por um agente específico no agentIdentity.
• Adicionadas as ações reordenar seções e reordenar itens de seção . Use essas ações para aplicar uma ordem personalizada completa às seções de um usuário ou aos itens em uma seção definida pelo usuá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.