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.
O Microsoft Graph fornece um modelo de programação unificado que pode utilizar para aceder a dados no Microsoft 365, Windows e Enterprise Mobility + Security. Este artigo fornece informações sobre as novidades nas APIs do Microsoft Graph, documentação, SDKs e muito mais.
Para obter atualizações mais detalhadas ao nível da API, consulte o registo de alterações do Microsoft API do Graph.
Para obter detalhes sobre as atualizações anteriores do Microsoft Graph, consulte Histórico de novidades do Microsoft Graph.
Importante
As funcionalidades em status de pré-visualização estão sujeitas a alterações sem aviso prévio e podem não ser promovidas a status de disponibilidade geral (GA). Não utilize funcionalidades de pré-visualização em aplicações de produção.
Março de 2026: Novo e geralmente disponível
People e inteligência no local de trabalho | definições de administrador do People
Utilize o novo perfil ApIs de origem para permitir que os administradores personalizem as informações de apresentação de uma origem de perfil vista pelos utilizadores em toda a organização nas experiências do Microsoft 365.
Aplicativos
A utilização da propriedade signInAudience para limitar o local onde uma aplicação pode ser utilizada não substitui a validação adequada do inquilino e a imposição de autorização no código da aplicação. Se a sua aplicação esperar acesso apenas em inquilinos específicos, tem de impor essa validação no código da aplicação. Para saber mais, veja Proteger aplicações e APIs ao validar afirmações.
Arquivos
Utilize as novas APIs de colunas de contentor adicionadas para suportar ainda mais o armazenamento de ficheiros estruturados em aplicações Do SharePoint Embedded:
Identidade e acesso | Governança
- Foi adicionado o
allDirectoryAgentIdentitiesmembro à enumeração allowedTargetScope para permitir que os pacotes de acesso direcionem todas as identidades do agente de diretório. - Foi adicionado o tipo de recurso targetAgentIdentitySponsorsOrOwners que define os patrocinadores ou proprietários de uma identidade de agente específica.
Contatos pessoais
Utilize as propriedades primaryEmailAddress, secondaryEmailAddress e tertiaryEmailAddress no contacto para obter ou definir o endereço de e-mail principal, secundário ou terciário de um contacto.
Março de 2026: Novo apenas em pré-visualização
Experiência dos colaboradores | Cativação dos colaboradores
Apresentamos as novas APIs Seguir utilizador, Desacompanhar utilizador, Listar Seguidores, Listar As Seguintes APIs para Viva Engage para gerir o enredo após as relações.
Aplicativos
Utilizar as propriedades signInAudience e signInAudienceRestrictions para limitar onde uma aplicação pode ser utilizada não substitui a validação adequada do inquilino e a imposição de autorização no código da aplicação. Se a sua aplicação esperar acesso apenas em inquilinos específicos, tem de impor essa validação no código da aplicação. Para saber mais, veja Proteger aplicações e APIs ao validar afirmações.
Armazenamento de cópias de segurança
Adicionou o includeNewerItems membro como valor suportado para a propriedade tags no restorePoint para obter um ponto de restauro dentro de um período de tempo especificado que inclui quaisquer itens mais recentes criados durante esse período.
Arquivos
Foi adicionado suporte para os DELETE /groups/{group-id}/drive/items/{item-id}/retentionLabelpontos finais , DELETE /me/drive/items/{item-id}/retentionLabele DELETE /users/{user-id}/drive/items/{item-id}/retentionLabel para driveItem: removeRetentionLabel API.
Files | Contentor de armazenamento de ficheiros
Arquivo ou desarcultar um contentor de armazenamento do SharePoint Embedded.
Identidade e acesso | Governança
Foi adicionado o tipo de recurso targetAgentIdentitySponsorsOrOwners que define os patrocinadores ou proprietários de uma identidade de agente específica.
Identidade e acesso | Acesso à rede
- Foram adicionadas as propriedades homeTenantId, crossTenantAccessType e deviceJoinType ao recurso de ligação para suportar cenários de colaboração Traga o Seu Próprio Dispositivo (BYOD) e Empresa-empresa (B2B) em registos de ligação de tráfego de Acesso Seguro Global.
- Foi adicionado o tipo de enumeração crossTenantAccessType .
- Foi adicionado o tipo de enumeração deviceJoinType .
Fevereiro de 2026: Novo e geralmente disponível
Conexões de dados externos
Foram adicionadas 19 etiquetas semânticas de domínio de 19 pessoas à enumeração de etiquetas para Microsoft 365 Copilot conectores. Estas etiquetas permitem aos programadores mapear dados de perfis de pessoas de sistemas externos para propriedades padronizadas do Microsoft Graph. Utilize estas etiquetas nas definições de esquema para melhorar a deteção e a integração de dados de pessoas em experiências Microsoft 365 Copilot. As novas etiquetas incluem: personEmails, , personAnniversariespersonAddresses, personName, personNote, personPhonespersonCurrentPosition, , personWebAccounts, personWebSite, personSkills, personProjects, , personAccount, , personAwards, personCertifications, , personAssistants, , personColleagues, personManager, , personAlternateContactse personEmergencyContacts.
Arquivos
Foi atualizado o requisito de consentimento do administrador para as seguintes permissões delegadas relacionadas com a gestão de contentores de armazenamento de ficheiros do SharePoint Embedded:
- A
FileStorageContainerType.Manage.Allpermissão delegada já não requer o consentimento do administrador. - A
FileStorageContainerTypeReg.Manage.Allpermissão delegada já não requer o consentimento do administrador.
Grupos
- Foram adicionadas as propriedades resourceBehaviorOptions e resourceProvisioningOptions ao recurso de grupo . Estas propriedades permitem-lhe especificar comportamentos de grupo e recursos associados para um grupo do Microsoft 365.
- Foi adicionado um problema conhecido: para grupos de segurança eliminados de forma recuperável, a propriedade securityEnabled devolve
falseem vez detrue. Para identificar o tipo de grupo, utilize a propriedade groupTypes , onde["Unified"]indica um grupo do Microsoft 365 e uma matriz vazia ([]) indica um grupo de segurança. Para obter mais informações, consulte Obter itens eliminados e Listar itens eliminados.
Gerenciamento de dispositivos e aplicativos | PC na nuvem
Foi adicionada configureAgent como uma nova ação para cloudpcexternalpartner.
Foi adicionada deployAgent como uma nova ação para cloudpcexternalpartner.
Adição de retrieveDeployAgentActionResults como uma nova ação para cloudpcexternalpartner.
Adição de retrieveActionReports como uma nova ação para cloudpcexternalpartner.
Foi adicionado cloudPcExternalPartnerAgentSetting como um novo tipo complexo para cloudpcexternalpartner.
Foi adicionado cloudPcExternalPartnerActionResult como um novo tipo complexo para cloudpcexternalpartner.
Foi adicionado cloudPcExternalPartnerActionReport como um novo tipo complexo para cloudpcexternalpartner.
Identidade e acesso | Identidade e entrada
- O método de autenticação de código QR no Microsoft Entra ID permite-lhe gerir o método de autenticação de código QR para os utilizadores e como podem iniciar sessão com um código QR e PIN. Os seguintes recursos principais suportam esta capacidade:
- O recurso qrCodePinAuthenticationMethod e as APIs relacionadas para gerir métodos de autenticação de PIN de código QR para os utilizadores. Este método de autenticação de fator único foi concebido para trabalhadores de primeira linha e combina um código QR com um PIN. Foram também adicionados os seguintes recursos relacionados: qrCode, qrPin e qrCodeImageDetails.
- O recurso qrCodePinAuthenticationMethodConfiguration para gerir a política do método de autenticação de código QR para um inquilino.
- Atualizou as enumerações authenticationMethodModes e baseAuthenticationMethod para adicionar o
qrCodePinmembro para suportar este novo método de autenticação.
Correio | Rastreio de mensagens
Utilize a API de rastreio de mensagens para controlar o fluxo de mensagens de e-mail através da sua organização Exchange Online. Para obter mais informações, veja exchangeMessageTrace.
Pesquisar
- Foram adicionados os tipos de dados principal e principalCollection à externalConnection para especificar o tipo de dados para itens de propriedade relacionados com pessoas na ligação externa.
- Adicionou a propriedade description às propriedades externalConnection para permitir a adição de uma descrição às propriedades do esquema na ligação externa.
- Foram adicionadas mais etiquetas ou etiquetas semânticas que podem ser adicionadas a etiquetas na propriedade externalConnection no esquema de ligação externo. As etiquetas ajudam Microsoft 365 Copilot compreender a semântica dos dados na ligação e fornecem resultados mais relevantes.
- Foi adicionada a propriedade contentCategory à externalConnection para especificar a categoria de domínio do conteúdo associado à ligação externa para uma relevância e classificação melhoradas.
Segurança | Segurança e conformidade de dados
- Adicionou o
labelNotFoundExceptionmembro ao tipo de enumeração usageRights . Este membro representa uma etiqueta sem definições de proteção, pelo que não existem direitos de utilização a avaliar no Microsoft Purview. - Foi adicionado o
restrictWebGroundingmembro à enumeração dlpAction para suportar a restrição de ações de base na Web em políticas de prevenção de perda de dados no Microsoft Purview.
Segurança | Proteção contra ameaças
Foi atualizado o requisito de consentimento do administrador para as seguintes permissões delegadas relacionadas com submissões de ameaças:
- A
ThreatSubmission.Readpermissão delegada requer agora o consentimento do administrador. - A
ThreatSubmission.ReadWritepermissão delegada requer agora o consentimento do administrador.
Trabalho em equipa e comunicações | Administração
- Obtenha o ID da política para um determinado nome de política e tipo de política na administração do Teams.
- Atribua uma política do Teams a um utilizador com o ID de utilizador, o tipo de política e o ID da política.
- Anular a atribuição de uma política do Teams a um utilizador com o ID de utilizador e o tipo de política.
- Atribua um número de telefone do Teams a uma conta de utilizador.
- Desatribui um número de telefone do Teams a partir de uma conta de utilizador.
- Obtenha os detalhes da tarefa de um único número de telehone.
- Atualize um número de telefone do Teams existente com atributos opcionais.
- Verifique a status de atribuição ou anulação da atribuição de número de telefone para uma conta de utilizador.
- Obtenha uma lista de números de telefone do Teams atribuídos a uma conta de utilizador.
Fevereiro de 2026: Novo apenas em pré-visualização
Aplicativos
Utilize a propriedade requiredResourceAccess em agentIdentityBlueprint para especificar as permissões do Microsoft Graph (âmbitos delegados e funções de aplicação) exigidas pelo agente.
Armazenamento de cópias de segurança
Os utilizadores podem agora procurar um fastRestore ponto final e restaurar seletivamente ficheiros e pastas ao criar uma sessão de navegação.
O processo de restauro granular foi concebido para ser simples e eficiente e consiste em três passos principais:
Criar uma sessão de procura
Inicie uma sessão de procura de um ponto de restauro específico (cópia de segurança snapshot).- Pode criar uma sessão de navegação do SharePoint ou uma sessão de navegação OneDrive for Business.
Procurar itens
Assim que a sessão for criada, o utilizador pode consulta-la para listar todos os itens de cópia de segurança disponíveis na sessão de procura.- Os resultados são devolvidos como uma coleção de objetos browseQueryResponseItem , cada um representando um ficheiro, pasta ou outro recurso.
- Pode procurar itens numa sessão de navegação do SharePoint ou numa sessão de navegação OneDrive for Business.
Criar uma sessão de restauro
Selecione um ou mais itens na sessão de navegação e inicie uma sessão de restauro.- Apenas os itens selecionados são restaurados para o estado anterior, deixando o resto do site ou unidade inalterado.
- Pode criar uma sessão de restauro granular do SharePoint ou uma sessão de restauro granular OneDrive for Business.
Arquivos
DriveItem adicionado: archive and driveItem: unarchive to enable organizations to archive/unarchive driveItems. Foi adicionado suporte para exclusão da política de proteção status e controlo de carimbo de data/hora no armazenamento de cópias de segurança:
Foi adicionada a propriedade offboardRequestedDateTime ao recurso protectionPolicyBase .
Foram adicionados os
offboardRequestedvalores eoffboardedà enumeração protectionPolicyStatus .
Gestão de dispositivos e aplicações | Licenciamento na cloud
Utilize as novas APIs de licenciamento na cloud para gerir dados de licenciamento de inquilinos, utilizadores e grupos para serviços do Microsoft 365. Estas APIs fornecem acesso programático a loteamentos, atribuições, erros de atribuição, ciclos de vida da subscrição e membros em espera. Para obter mais informações, veja Utilizar a API de licenciamento na cloud no Microsoft Graph (pré-visualização).
Arquivos
DriveItem adicionado: archive and driveItem: unarchive to enable organizations to archive and unarchive driveItem objects.
Identidade e acesso | Identidade e entrada
- Foi adicionada a enumeração agentIdentityType para representar o tipo de Microsoft Entra identidade do agente para deteção e gestão de riscos. Utilize a propriedade identityType nos recursos riskyAgent e agentRiskDetection para classificar diferentes tipos de identidades de agente.
- Foram adicionados novos recursos de eventos de autenticação para suportar cenários de migração de utilizadores Just-In-Time (JIT) a partir de sistemas de autenticação legados:
- Utilize o recurso onPasswordSubmitListener para configurar serviços de escuta de eventos de autenticação que são acionados durante a submissão de palavra-passe.
- Utilize o recurso onPasswordSubmitCustomExtension para configurar extensões personalizadas que validam palavras-passe em sistemas de autenticação legados externos.
- Utilize o recurso onPasswordSubmitHandler como o tipo base para processadores invocados durante eventos de submissão de palavra-passe.
- Utilize o recurso onPasswordMigrationCustomExtensionHandler para configurar processadores que invocam extensões personalizadas durante a migração do JIT.
Pesquisar
Foram adicionados os tipos de dados principal e principalCollection ao recurso externalConnection para especificar o tipo de dados para itens de propriedade relacionados com pessoas na ligação externa.
Tarefas e planos
Utilize a API de propriedades expandidas para armazenar ou obter dados personalizados no recurso todoTaskList .
Segurança | Segurança e conformidade de dados
- Adicionou o
labelNotFoundExceptionmembro ao tipo de enumeração usageRights . Este membro representa uma etiqueta sem definições de proteção, pelo que não existem direitos de utilização a avaliar no Microsoft Purview. - Preteriu a propriedade accessedResources em processConversationMetadata a favor da propriedade accessedResources_v2 .
- Utilize a propriedade accessedResources_v2 em processConversationMetadata para obter informações detalhadas sobre os recursos acedidos durante a conversação, incluindo identificadores, tipo de acesso e status.
- Utilize a propriedade agents em processConversationMetadata para obter informações sobre os agentes de IA que participaram na preparação da mensagem.
Segurança | proteção de colaboração e Email
Melhorias ao recurso detonationDetails que representa detalhes da análise de ficheiros suspeitos e URLs em e-mails no Microsoft Defender para Office 365:
- Foram adicionadas as seguintes propriedades para fornecer uma análise de ameaças mais detalhada:
- detonationBehaviourDetailsV2 - Mostra eventos que ocorreram durante a detonação no formato JSON
- entityMetadata – Mais metadados sobre a entidade no formato JSON
- mitreTechniques - Técnicas de ataque alinhadas com a arquitetura MITRE ATT&CK
- staticAnalysis - Resultados da análise estática realizada no ficheiro ou URL
- submissionSource - A origem da submissão
- A propriedade detonationBehaviourDetails foi preterida e deixará de devolver dados em março de 2026. Em vez disso, utilize a propriedade detonationBehaviourDetailsV2 .
- Adicionou o
moveToQuarantinemembro à enumeração remediationAction . Utilize o cabeçalho doPrefer: include-unknown-enum-memberspedido para aceder a este membro de enumeração em evolução.
Pesquisar
Foram adicionados tipos de dados Principal e PrincipalCollection à externalConnection para especificar como o tipo de dados de itens relacionados com a propriedade pessoas na ligação externa.
Janeiro de 2026: Novo e geralmente disponível
Identidade e acesso | Governança
Utilize a relação administrationScopeTargets no fluxo de trabalhoBase, fluxo de trabalho e fluxo de trabalhoVersion recursos para especificar as unidades administrativas no âmbito de um fluxo de trabalho de ciclo de vida.
Identidade e acesso | Identidade e entrada
- A partir de 26 de janeiro de 2026, os utilizadores que gerem os seus próprios métodos de autenticação através de operações self-service, como adicionar, atualizar ou eliminar números de telefone e endereços de e-mail, têm de concluir a autenticação multifator (MFA) se tiverem sido autenticados há mais de 10 minutos na sessão atual. Para obter mais orientações sobre como lidar com esta alteração na sua aplicação, veja Descrição geral da API dos métodos de autenticação Microsoft Entra.
- Adicionado
qrCodecomo um novo valor suportado para a enumeração usageAuthMethod , que é o tipo para a propriedade authMethod em credentialUsageSummary, userCredentialUsageDetails, userEventsSummary e userRegistrationActivitySummary resources. Este valor representa a utilização do código QR como um método de autenticação. - Agora, pode gerir métodos de autenticação externa (EAM) no Microsoft Entra ID para permitir que os utilizadores escolham um fornecedor externo para cumprir os requisitos de autenticação multifator (MFA) quando iniciam sessão no Microsoft Entra ID. Para saber mais, confira:
- externalAuthenticationMethod tipo de recurso para gerir métodos de autenticação externos registados num utilizador para autenticação com um fornecedor de identidade externo.
- externalAuthenticationMethodConfiguration tipo de recurso para gerir a política ao nível do inquilino.
- Foi adicionada a propriedade createdDateTime ao recurso authenticationMethod , que é o tipo base para os seguintes recursos do método de autenticação derivado: fido2AuthenticationMethod, microsoftAuthenticatorAuthenticationMethod, passwordAuthenticationMethod, platformCredentialAuthenticationMethod, temporaryAccessPassAuthenticationMethod e windowsHelloForBusinessAuthenticationMethod.
Relatórios | Relatórios de uso do Microsoft 365
No futuro, utilize as APIs de utilização Microsoft 365 Copilot no segmento caminho do /copilot URL. Para saber mais, confira:
- Raiz do relatório copilot
- Obter resumo da contagem de utilizadores do Copilot
- Obter tendência de contagem de utilizadores do Copilot
- Obter detalhes do utilizador de utilização do Copilot
Segurança | Investigação avançada
Foram adicionadas orientações de migração para apIs de investigação avançadas Microsoft Defender para Ponto de Extremidade (MDPE) para ajudar as organizações a transitar das APIs descontinuadas que estavam disponíveis através do https://api.securitycenter.microsoft.com ponto final para as APIs de investigação avançadas disponíveis no Microsoft Graph. Para obter mais informações, veja Migrar das APIs mais antigas.
Segurança | Alertas e incidentes
- Foi adicionada a propriedade priorityScore ao recurso do incidente para fornecer uma classificação de prioridade para o incidente de 0 a 100, > sendo 85 a prioridade máxima, 15 - 85 prioridade média e < 15 prioridade baixa. Esta classificação é gerada com machine learning e baseia-se em vários fatores, incluindo gravidade, impacto de interrupção, informações sobre ameaças, tipos de alerta, criticidade de ativos, análise de ameaças, raridade de incidentes e sinais de prioridade adicionais.
- Fez as seguintes atualizações às APIs para gerir sensores de Microsoft Defender para Identidade (MDI):
- Foi adicionada a propriedade domainName ao recurso sensorCandidate para especificar o nome de domínio do sensor.
- Foi adicionada a propriedade serviceStatus ao recurso do sensor para indicar que o serviço status. Os valores possíveis são
stopped,starting,running,disabled,onboarding,unknown,unknownFutureValue.
Segurança | Deteção de Dados Eletrónicos
Utilize a propriedade reportFileMetadata em ediscoveryPurgeDataOperation para obter os metadados do ficheiro de relatório da tarefa de remoção.
Trabalho em equipa e comunicações | Aplicações
É TeamsAppInstallation.ManageSelectedForTeam.All a permissão de aplicação com menos privilégios necessária para instalar ou atualizar uma aplicação do Teams que requer consentimento para permissões de consentimento específico do recurso (RSC) ao utilizar o teamsAppInstallation numa equipa: atualizar a API.
Janeiro de 2026: Novo apenas em pré-visualização
Aplicativos
A propriedade allowedTenantIds em allowedTenantsAudience tem de conter pelo menos um valor e não pode incluir mais de 20 valores.
Gerenciamento de dispositivos e aplicativos | PC na nuvem
- Utilize os seguintes recursos para representar os dados enviados para o Azure Logic Apps como parte de um pedido de nota de aviso de extensão personalizada quando for utilizada uma extensão personalizada num catálogo:
- accessPackageAssignmentCalloutData – para atribuições de pacotes de acesso
- accessPackageAssignmentRequestCalloutData – para pedidos de atribuição de pacotes de acesso
- Foi adicionado o recurso controlConfiguration e a relação controlConfigurations ao recurso entitlementManagement para representar as políticas que controlam o ciclo de vida e o acesso aos pacotes de acesso em toda a organização.
- Foi adicionado o recurso entraIdProtectionRiskyUserApproval para representar a configuração de aprovação para utilizadores de risco detetados pelo Microsoft Entra ID Protection.
- Foi adicionado o recurso insiderRiskyUserApproval para representar a configuração de aprovação para utilizadores de risco detetados por Gerenciamento de Risco Interno do Microsoft Purview.
Identidade e acesso | Identidade e entrada
Adicionou o microsoftRevokedSessions valor à enumeração riskDetail para indicar que a Microsoft revogou as sessões. Este membro de enumeração aplica-se aos seguintes recursos Microsoft Entra Identity Protection: riskDetection, riskUserActivity, riskyUser e signIn.
- Adicionado
mexicocomo um novo valor suportado para o tipo de enumeração cloudPcGeographicLocationType . Esta enumeração é o tipo de retorno para a propriedade geographicLocationType em cloudPcDomainJoinConfiguration e cloudPcSupportedRegion. - Adicionou o
cloudPCInventoryReportmembro ao tipo de enumeração cloudPcReportName . Esta enumeração é o tipo de retorno para a propriedade reportName na cloudPcExportJob, getFrontlineReport action e getCloudPcRecommendationReports action. - Utilize a propriedade category em cloudPcSourceDeviceImage para obter a categoria da imagem de origem pedida. Para obter mais informações, veja Obter objetos cloudPcSourceDeviceImage com uma categoria específica.
- Adicionado
refreshPolicyConfigurationcomo um valor suportado para a propriedade status na cloudPC e cloudPcStatusSummary para indicar que o PC na Cloud está em processo de atualização das novas configurações de política.
Gestão de dispositivos e aplicações | Atualizações de dispositivos
Foi adicionado um novo modelo de gestão de aprovação e implementação para atualizações de qualidade do Windows em ambientes geridos por Bloqueio automático. Agora, pode definir políticas de atualização de qualidade com regras de aprovação personalizáveis, atribuir anéis de implementação a dispositivos de grupo para implementação faseada e gerir o status de aprovação do conteúdo de atualização antes de implementar nos dispositivos. Os seguintes recursos fornecem mais informações:
Grupos
Utilize a propriedade welcomeMessageEnabled no recurso do grupo para controlar se uma mensagem de boas-vindas é enviada para novos membros quando são adicionados a um grupo do Microsoft 365. O valor padrão é true.
Identidade e acesso | Identidade e entrada
- Adicionado
riskRemediationcomo um novo membro à enumeração conditionalAccessGrantControl . Este valor permite que os utilizadores resolvam automaticamente o risco do utilizador através de políticas de acesso condicional. - Utilize a propriedade groupSyncInbound em crossTenantIdentitySyncPolicyPartner para definir se os grupos podem ser sincronizados a partir de um inquilino parceiro nas definições de política de acesso entre inquilinos.
Rastreamento de mensagens
Utilize o recurso userConfiguration e os respetivos métodos associados para gerir definições, metadados ou dados de aplicações específicos do utilizador associados a pastas de caixa de correio, utilizando formatos XML, binários ou de dicionário.
Relatórios | Relatórios de identidade e acesso
Foi removido o tipo de recurso conditionalAccessAudience . O tipo de retorno da propriedade conditionalAccessAudiences do tipo de recurso signIn é uma coleção de objetos de Cadeia e não o tipo complexo conditionalAccessAudience . Utilize a API de rastreio de mensagens para controlar o fluxo de mensagens de e-mail através da sua organização Exchange Online. Para obter mais informações, veja exchangeMessageTrace.
Relatórios | Relatórios de identidade e acesso
Adicionado qrCode como um novo valor suportado para a enumeração usageAuthMethod , que é o tipo para a propriedade authMethod em credentialUsageSummary, userCredentialUsageDetails, userEventsSummary e userRegistrationActivitySummary resources. Este valor representa a utilização do código QR como um método de autenticação.
Segurança | Alertas e incidentes
Foi adicionada a propriedade priorityScore ao recurso do incidente para fornecer uma classificação de prioridade para o incidente de 0 a 100, > sendo 85 a prioridade máxima, 15 - 85 prioridade média e < 15 prioridade baixa. Esta classificação é gerada com machine learning e baseia-se em vários fatores, incluindo gravidade, impacto de interrupção, informações sobre ameaças, tipos de alerta, criticidade de ativos, análise de ameaças, raridade de incidentes e sinais de prioridade adicionais.
Segurança | Zonas de cloud
Foi adicionado suporte para a gestão de zonas no Microsoft Defender para a Cloud, permitindo às organizações segmentar ambientes multi cloud (Azure, AWS, GCP e DevOps ou origens de registo) em agrupamentos lógicos para gestão de acesso e segurança em escala. O tipo de recurso de zona e o respetivo recurso de ambiente associado permitem-lhe aplicar consistentemente controlos de acesso com menos privilégios e gerir coleções de ambientes anexados no Microsoft Graph.
Segurança | Segurança e conformidade de dados
- Preteriu a propriedade accessedResources em processConversationMetadata a favor da propriedade accessedResources_v2 .
- Utilize a propriedade accessedResources_v2 em processConversationMetadata para obter informações detalhadas sobre os recursos acedidos durante a conversação, incluindo identificadores, tipo de acesso e status.
- Utilize a propriedade agents em processConversationMetadata para obter informações sobre os agentes de IA que participaram na preparação da mensagem.
- Foi adicionada a propriedade contentCategory em processConversationMetadata e processFileMetadata para indicar se o conteúdo é gerado ou não.
Trabalho em equipa e comunicações | Aplicações
Utilize a propriedade layoutType no recurso do canal para criar canais com diferentes experiências de conversação e alternar entre eles em qualquer altura. A propriedade suporta dois valores: post para o formato pós-resposta tradicional e chat para uma experiência de threading semelhante a um chat. Pode definir o tipo de esquema ao criar um canal e atualizá-lo mais tarde para alternar entre esquemas.
É TeamsAppInstallation.ManageSelectedForTeam.All a permissão de aplicação com menos privilégios necessária para instalar ou atualizar uma aplicação do Teams que requer consentimento para permissões de consentimento específico do recurso (RSC) ao utilizar o teamsAppInstallation numa equipa: atualizar a API.
Administração de inquilinos | Gestão de configuração
As novas APIs de Gestão de Configuração de Inquilinos no Microsoft Graph permitem que os administradores controlem e giram as definições de configuração numa única carga de trabalho ou em várias cargas de trabalho numa organização. Para saber mais sobre os casos de utilização suportados, veja Utilizar as APIs de Gestão de Configuração de Inquilinos no Microsoft Graph (pré-visualização).
Dezembro de 2025: Novo e geralmente disponível
Calendários | Places
- Crie, obtenha descendentes e elimine um local e os respetivos objetos derivados (por exemplo, edifício, secretária, piso ou secção. Estas APIs permitem a integração e gestão dimensionáveis do diretório Places.
- As novas APIs de mapa no Places permitem que as aplicações com permissões de leitura ou escrita adequadas interajam com objetos de funcionalidade de mapa. Para obter mais informações, veja Trabalhar com a API de Places no Microsoft Graph.
- Utilize o recurso checkInClaim para representar o status marcar de um evento de calendário do Outlook reservado num local. Para obter mais informações, consulte Criar checkInClaim e Obter checkInClaim.
- Utilize a propriedade wifiState na compilação para indicar se um edifício tem Wi-Fi.
- Utilize a propriedade heightAdjustableState na secretária para indicar se uma secretária é ajustável à altura.
- Utilize a propriedade teamsEnabledState na sala para indicar se uma sala está ativada para o Microsoft Teams.
- Utilize a propriedade placeId na sala e área de trabalho como um identificador exclusivo imutável alternativo.
- Utilize o recurso unavailablePlaceMode para indicar por que motivo uma secretária ou área de trabalho está marcada como indisponível para reserva.
Trabalho em equipa e comunicações | Administração
Obtenha ou liste configurações de utilizador para utilizadores com contas no contexto do Teams.
Trabalho em equipa e comunicações | Chamadas e reuniões online
- Utilize a propriedade sensitivityLabelAssignment em onlineMeeting e virtualEventSession para especificar a etiqueta de confidencialidade aplicada à reunião do Teams.
- Utilize a propriedade expiryDateTime em onlineMeeting e virtualEventSession para indicar a data e hora em que o recurso da reunião expira.
- Utilize a propriedade meetingSpokenLanguageTag em onlineMeeting e virtualEventSession para especificar o idioma falado utilizado durante a reunião para fins de gravação e transcrição.
- Utilize a propriedade meetingOptionsWebUrl em onlineMeeting e virtualEventSession para obter o URL para a página de opções de reunião do Teams para a reunião especificada.
Trabalho em equipa e comunicações | Mensagens
Quando $expand=members está incluída, a API de Chats de Lista devolve um máximo de 25 itens, mesmo que seja especificado um valor maior $top .
Dezembro de 2025: Novo apenas em pré-visualização
Calendários | Places
Upsert um ou mais objetos de colocação no modo assíncrono.
Segurança
Foi adicionado suporte para os tipos de evidências mailboxConfigurationEvidence e activeDirectoryDomainEvidence em alertas de segurança
Novembro de 2025: Novo apenas em pré-visualização
Faça a gestão de horas de trabalho e localizações flexíveis com os seguintes recursos: workHoursAndLocationsSetting, workPlanOccurrence e workPlanRecurrence. Estes recursos permitem-lhe definir padrões de trabalho, localizações e folgas recorrentes e específicas para cenários híbridos modernos.
Trabalho em equipa e comunicações | Aplicações
Faça a gestão de aplicações do Teams ao nível do canal dentro de uma equipa com as seguintes APIs:
- Listar aplicações num canal.
- Obter uma aplicação num canal.
- Ativar uma nova aplicação do Teams num canal.
- Desative uma aplicação num canal.
Setembro de 2025: Novo e geralmente disponível
Aplicativos
Utilize a propriedade signInAudienceRestrictions no recurso da aplicação para restringir aplicações multi-inquilino a inquilinos Microsoft Entra específicos. Esta funcionalidade permite que as organizações limitem a utilização de aplicações a uma lista específica de IDs de inquilino permitidos, fornecendo controlos de segurança e conformidade melhorados para cenários multi-inquilino.
Gestão de dispositivos e aplicações | Impressão na nuvem
Utilize os novos tamanhos de suporte de dados suportados na propriedade mediaSizes do recurso printerCapabilities .
Arquivos
- Utilize as APIs de tarefas de migração entre inquilinos do SharePoint no Microsoft Graph para permitir que as organizações giram as tarefas durante as migrações inquilino a inquilino. Para obter mais informações, veja sharePointMigrationTask.
- Utilize a propriedade eliminada em sharePointGroupIdentityMapping e sharePointUserIdentityMapping para indicar que um mapeamento de identidade foi eliminado com êxito.
Identidade e acesso | Governança
- Utilize os seguintes recursos para representar os dados enviados para o Azure Logic Apps como parte de um pedido de nota de aviso de extensão personalizada quando for utilizada uma extensão personalizada num catálogo:
- accessPackageAssignmentCalloutData – para atribuições de pacotes de acesso
- accessPackageAssignmentRequestCalloutData – para pedidos de atribuição de pacotes de acesso
- Foi adicionado o recurso controlConfiguration e a relação controlConfigurations ao recurso entitlementManagement para representar as políticas que controlam o ciclo de vida e o acesso aos pacotes de acesso em toda a organização.
- Foi adicionado o recurso entraIdProtectionRiskyUserApproval para representar a configuração de aprovação para utilizadores de risco detetados pelo Microsoft Entra ID Protection.
- Foi adicionado o recurso insiderRiskyUserApproval para representar a configuração de aprovação para utilizadores de risco detetados por Gerenciamento de Risco Interno do Microsoft Purview.
Identidade e acesso | Identidade e entrada
Adicionou o microsoftRevokedSessions valor à enumeração riskDetail para indicar que a Microsoft revogou as sessões. Este membro de enumeração aplica-se aos seguintes recursos Microsoft Entra Identity Protection: riskDetection, riskUserActivity, riskyUser e signIn.
Identidade e acesso | Acesso à rede
Personalize a mensagem de página de bloco apresentada aos utilizadores quando o Acesso Seguro Global bloqueia o acesso aos recursos Web. Utilize o recurso customBlockPage para configurar mensagens personalizadas com suporte de markdown limitado.
- Utilize o recurso userConfiguration e os respetivos métodos associados para gerir definições, metadados ou dados de aplicações específicos do utilizador associados a pastas de caixa de correio, utilizando formatos XML, binários ou de dicionário.
- A API callRecord: getPstnCalls esclarece agora que não devolve informações apenas para planos de chamadas da Telstra .
- Os seguintes pontos finais já não são suportados para gerir a localização de trabalho do utilizador:
POST /users/{usersId}/presence/clearAutomaticLocationPOST /communications/presences/{presenceId}/clearAutomaticLocationPOST /users/{usersId}/presence/clearLocationPOST /communications/presences/{presenceId}/clearLocationPOST /users/{usersId}/presence/setAutomaticLocationPOST /communications/presences/{presenceId}/setAutomaticLocationPOST /users/{usersId}/presence/setManualLocationPOST /communications/presences/{presenceId}/setManualLocation
Relatórios | Relatórios de identidade e acesso
- Foi removido o tipo de recurso conditionalAccessAudience . O tipo de retorno da propriedade conditionalAccessAudiences do tipo de recurso signIn é uma coleção de objetos de Cadeia e não o tipo complexo conditionalAccessAudience .
Trabalho em equipa e comunicações | Chamadas e reuniões online
- Quando
$expand=membersestá incluída, a API de Chats de Lista devolve um máximo de 25 itens, mesmo que seja especificado um valor maior$top. - Os seguintes pontos finais já não são suportados para gerir a localização de trabalho de um utilizador:
POST /users/{usersId}/presence/clearAutomaticLocationPOST /communications/presences/{presenceId}/clearAutomaticLocationPOST /users/{usersId}/presence/clearLocationPOST /communications/presences/{presenceId}/clearLocationPOST /users/{usersId}/presence/setAutomaticLocationPOST /communications/presences/{presenceId}/setAutomaticLocationPOST /users/{usersId}/presence/setManualLocationPOST /communications/presences/{presenceId}/setManualLocation
Trabalho em equipa e comunicações | Mensagens
- Foi adicionado suporte para subscrições de associação a canais para receber notificações de alteração de associação indireta para canais partilhados .
- Introduziu uma nova notificação de alteração para a associação a canais partilhados quando um canal é partilhado ou desagrupar de uma equipa.
- Obtenha um membro específico da coleção allMembers do canal. Esta API fornece acesso unificado a membros diretos e indiretos em todos os tipos de canal, incluindo canais partilhados.
- Inicie a migração de mensagens externas ao ativar o modo de migração num canal existente.
- Inicie a migração de mensagens externas ao ativar o modo de migração num chat existente.
- Conclua a migração de mensagens externas ao remover o modo de migração de um chat.
- Utilize a propriedade layoutType no recurso do canal para criar canais com diferentes experiências de conversação e alternar entre eles em qualquer altura. A propriedade suporta dois valores:
postpara o formato pós-resposta tradicional echatpara uma experiência de threading semelhante a um chat. Pode definir o tipo de esquema ao criar um canal e atualizá-lo mais tarde para alternar entre esquemas.
Contribuir para o Microsoft Graph
Existem cenários em que você gostaria que o Microsoft Graph oferecesse suporte?
Sugira e vote em novas funcionalidades com o Portal de Comentários do Microsoft Graph. Alguns novos recursos são originados como solicitações populares da comunidade de desenvolvedores. A equipa do Microsoft Graph avalia regularmente as necessidades dos clientes e lança novas funcionalidades para os pontos finais beta (
https://graph.microsoft.com/beta) e v1.0 (https://graph.microsoft.com/v1.0).Adira à chamada semanal da comunidade da plataforma do Microsoft 365 e torne-se um membro ativo da comunidade do Microsoft Graph. Para descobrir o calendário completo das chamadas para programadores, visite a página da comunidade do Microsoft 365 e do Power Platform.
Junte-se ao nosso painel de investigação para fornecer os seus contributos sobre as nossas experiências de programador.