Novidades do Microsoft Graph

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.

Abril de 2026: Novo e geralmente disponível

Aplicativos

• Foi adicionado o tipo de recurso approvedClientApp para gerir aplicações cliente aprovadas para acesso ao ambiente de trabalho remoto.
• Foi adicionada a propriedade managerApplications aos recursos application e agentIdentityBlueprint para permitir que as aplicações originais da Microsoft sejam designadas como gestores de esquemas de agente.

Armazenamento de cópias de segurança

• Quando uma política de proteção é desativada, a atividade de cópia de segurança para imediatamente, não são criadas novas cópias de segurança e os recursos protegidos já não são abrangidos pela política. Todas as cópias de segurança efetuadas antes da desativação são mantidas de acordo com a política de retenção, após a qual são retiradas. Pode restaurar dados com pontos de restauro anteriores mesmo após a desativação.
• Uma política de proteção só pode ser eliminada depois de ter sido desativada. Quando elimina uma política, todas as unidades de proteção associadas são removidas e a proteção de cópias de segurança para os recursos anteriormente abrangidos pela política. Os dados de cópia de segurança existentes são mantidos de acordo com a política de retenção antes de serem retirados. Pode restaurar dados com pontos de restauro anteriores mesmo após a eliminação.

Arquivos

• Utilize os parâmetros de altura e largura para transferir um ficheiro noutro formato quando format=jpg.
• Utilize a API De atividades de Lista para obter atividades recentes que ocorreram numa unidade, lista, item ou numa hierarquia de itens.

Identidade e acesso | Governança

Utilize approverRemove como um novo valor suportado para a propriedade requestType do recurso accessPackageAssignmentRequest . Para obter mais informações, veja accessPackageAssignmentRequest.

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.

Trabalho em equipa e comunicações | Mensagens

Foram removidos os parâmetros e a model documentação de orientação do modelo de pagamento das APIs de exportação do Microsoft Teams e da documentação de notificação de alteração relacionada. O model parâmetro de consulta já não é necessário e é ignorado se for fornecido. Para obter mais informações, veja Modelos de pagamento e requisitos de licenciamento para APIs do Microsoft Teams.

Abril de 2026: Novo apenas em pré-visualização

Aplicativos

Foi adicionada a propriedade deprecationDate ao recurso applicationTemplate para indicar quando uma aplicação será removida da galeria de aplicações Microsoft Entra.

Armazenamento de cópias de segurança

• Quando uma política de proteção é desativada, a atividade de cópia de segurança para imediatamente, não são criadas novas cópias de segurança e os recursos protegidos já não são abrangidos pela política. Todas as cópias de segurança efetuadas antes da desativação são mantidas de acordo com a política de retenção, após a qual são retiradas. Pode restaurar dados com pontos de restauro anteriores mesmo após a desativação.
• Uma política de proteção só pode ser eliminada depois de ter sido desativada. Quando elimina uma política, todas as unidades de proteção associadas são removidas e a proteção de cópias de segurança para os recursos anteriormente abrangidos pela política. Os dados de cópia de segurança existentes são mantidos de acordo com a política de retenção antes de serem retirados. Pode restaurar dados com pontos de restauro anteriores mesmo após a eliminação.
• Utilize a propriedade billingPolicyId em protectionUnitBase, driveProtectionUnit, mailboxProtectionUnit e siteProtectionUnit para obter ou definir o identificador exclusivo da política de faturação atribuída à unidade de proteção para alocação de custos.
• Atualizea propriedade billingPolicyId num objeto driveProtectionUnit .
• Atualizea propriedade billingPolicyId num objeto mailboxProtectionUnit .
• Atualizea propriedade billingPolicyId num objeto siteProtectionUnit .

Identidade e acesso | Governança

• Utilize default, notVisiblee visible como valores suportados para a propriedade approverInformationVisibility dos recursos accessPackageApprovalStage e approvalStage para indicar se as informações do aprovador estão visíveis para o requerente.

Arquivos

• Utilize os parâmetros de consulta de altura e largura na API de conversão de conteúdo driveItem para transferir um ficheiro noutro formato quando format=jpg.

Identidade e acesso | Identidade e entrada

Foram adicionadas as propriedades blueprintIde de descritiva do agente de origem aos recursos agentRiskDetection e riskyAgent .

Inteligência de pessoas e do local de trabalho | Perfil

Utilize as atividades, prémios e propriedades fieldsOfStudy na educationActivityDetail para obter ou definir coleções de atividades, prémios ou campos de estudo.

Relatórios | Relatórios de identidade e acesso

Foi adicionado o recurso azureADPremiumLicenseInsight e as respetivas APIs associadas para obter informações sobre a utilização da licença premium Microsoft Entra ID P1 e P2 para o inquilino, incluindo discriminações de utilização de funcionalidades para as funcionalidades P1, P2, Acesso à Internet e Acesso Privado.

Segurança | Conformidade

Atualizou as capacidades do tipo de recurso auditLogQuery e os respetivos métodos associados da seguinte forma:

• Foi atualizada a enumeração auditLogRecordType para representar mais de 400 tipos de operações de registo de auditoria nos serviços cloud da Microsoft.
• Foram adicionados 135 novos tipos derivados do recurso auditData para representar dados de registo de auditoria para serviços e funcionalidades específicos, incluindo interações de IA e Copilot, gestão de agentes, conformidade e gestão do ciclo de vida de dados (Microsoft Purview, Deteção de Dados Eletrónicos, DLP), serviços cloud (Firewall do Azure, Microsoft Defender, Sentinel), e serviços de colaboração (Teams, Planner, SharePoint, Viva). Para obter uma lista completa dos tipos de dados de auditoria, veja auditData derived types (Tipos derivados de dados auditData).

Segurança | Microsoft Defender para Identidade

Utilize a propriedade sensorTypes no sensorCandidate para obter a lista de tipos de dispositivo para o sensor.

Trabalho em equipa e comunicações | Mensagens

Utilize as APIs de mensagens direcionadas para gerir mensagens no Microsoft Teams que são visíveis apenas para destinatários especificados em chats ou canais de grupo:

• Utilize o tipo de recurso targetedChatMessage para representar uma mensagem de destino num chat ou canal.
• Obtenha todas as mensagens direcionadas enviadas a um utilizador em chats de grupo e canais para fins de conformidade e arquivamento.
• Obtenha todas as mensagens direcionadas retidas para um utilizador, incluindo mensagens eliminadas pelo remetente, mas preservadas devido às políticas de retenção organizacional.
• Elimine uma mensagem de destino de um canal ao fornecer o ID de equipa, o ID do canal e o ID da mensagem.
• Elimine uma mensagem de destino de uma conversa ao fornecer o ID de chat e o ID da mensagem.

Março de 2026: Novo e geralmente disponível

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.

Calendários | Places

• Foi adicionado um problema conhecido do RBAC no Places API de atualização: os pedidos de atualização ainda podem ser bem-sucedidos sem a função de Administrador do Exchange, mas resultam em comportamentos inesperados.
• Ao utilizar permissões de aplicação com as APIs Criar local, Atualizar local e Eliminar local, tem de configurar a função necessária TenantPlacesManagement (para gerir Places) e a MailRecipient função (para gerir utilizadores e caixas de correio). Para obter mais informações sobre como configurar estas funções, veja Controle de Acesso Baseado em Funções para Aplicações no Exchange Online.

Gerenciamento de dispositivos e aplicativos | PC na nuvem

• Utilize a propriedade osVersionNumber nos recursos cloudPcDeviceImage e cloudPcGalleryImage para obter a versão do sistema operativo de uma imagem.
• Utilize a propriedade sizeInGB em cloudPcDeviceImage para obter o tamanho da imagem em GB.

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:
  • Obter coluna
  • Atualizar coluna
  • Eliminar coluna
• Transfira um intervalo parcial de bytes de uma versão anterior de um ficheiro.
• Os pedidos feitos com a API de contentores de lista sem um contexto de utilizador (autenticação apenas de aplicação) não são atualmente suportados para inquilinos multigeográficos.

Identidade e acesso | Gerenciamento do diretório

Introduziu a API de Identidade do Agente para suportar o registo e a gestão de agentes de IA no Microsoft Entra ID. Esta API permite aos construtores de agentes e administradores de inquilinos:

• Criar esquemas de identidade do agente como definições de base para agentes
• Configurar permissões herdáveis que controlam os âmbitos que podem ser herdados por instâncias de agente
• Criar principais de esquema de identidade do agente como representações específicas do inquilino
• Criar várias instâncias de identidade de agente a partir de um único esquema para cenários de vários instancing
• Gerir patrocinadores que podem autorizar e gerir ciclos de vida de agentes

A API também introduz tipos de suporte, incluindo inheritableScopes, allAllowedScopes, enumeratedScopes, noScopes e a enumeração scopeCollectionKind .

Foi adicionada a propriedade createdByAppId aos recursos servicePrincipal e aplicação.

Identidade e acesso | Governança

• Foi adicionado o allDirectoryAgentIdentities membro à 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.

Identidade e acesso | Identidade e entrada

• 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.
• Foram adicionadas as seguintes propriedades e os respetivos tipos complexos associados aos recursos crossTenantAccessPolicyConfigurationDefault e crossTenantAccessPolicyConfigurationPartner das APIs de política de acesso entre inquilinos para suportar as definições de ligação do serviço de aplicações e colaboração do Microsoft 365:
  • propriedade appServiceConnectInbound para obter ou definir a configuração predefinida ou específica do parceiro para as definições de ligação do serviço de aplicações de entrada.
  • propriedade m365CollaborationInbound para obter ou definir a configuração predefinida ou específica do parceiro para definições de colaboração do Microsoft 365 de entrada.
  • A propriedade m365CollaborationOutbound obtém ou define a configuração predefinida ou específica do parceiro para definições de colaboração do Microsoft 365 de saída.

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.
• Utilize as novas APIs profilePropertySetting para configurar definições ao nível do inquilino para propriedades de perfil.

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.

Trabalho em equipa e comunicações | Chamadas e reuniões online

Foi adicionado suporte de chamada ad hoc para alterar notificações de transcrições e gravações no Microsoft Teams. Agora pode subscrever os seguintes recursos para ser notificado quando uma transcrição ou gravação estiver disponível para uma chamada ad hoc:

• communications/adhocCalls/{adhocCallId}/transcripts
• users/{userId}/adhocCalls/getAllTranscripts
• communications/adhocCalls/{adhocCallId}/recordings
• users/{userId}/adhocCalls/getAllRecordings

Para obter mais informações, consulte Obter notificações de alteração para transcrições e gravações com o Microsoft Graph.

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

Março de 2026: Novo apenas em pré-visualização

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.
• Foi adicionada a propriedade trafficRoutingMethod ao recurso onPremisesPublishing para controlar a forma como o tráfego é distribuído por vários conectores num grupo de conectores no Microsoft Entra proxy de aplicações.

Armazenamento de cópias de segurança

• Utilize a propriedade backupRetentionPeriodInDays em driveProtectionUnit, mailboxProtectionUnit e siteProtectionUnit para obter o período de retenção da cópia de segurança, em dias.
• 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.

Calendários | Places

• Foi adicionado um problema conhecido do RBAC no Places API de atualização: os pedidos de atualização ainda podem ser bem-sucedidos sem a função de Administrador do Exchange, mas resultam em comportamentos inesperados.
• Ao utilizar permissões de aplicação com o local Criar, Upsert coloca, Local de atualização e Eliminar APIs de local, tem de configurar a função necessária TenantPlacesManagement (para gerir Places) e a MailRecipient função (para gerir utilizadores e caixas de correio). Para obter mais informações sobre como configurar estas funções, veja Controle de Acesso Baseado em Funções para Aplicações no Exchange Online.

Gerenciamento de dispositivos e aplicativos | PC na nuvem

• Adicionados underServiceMaintenance e inUse como novos valores suportados para a enumeração cloudPcConnectivityStatus . Utilize estes valores com a propriedade status em cloudPcConnectivityResult para indicar que o CLOUD PC está temporariamente indisponível para manutenção iniciada pelo serviço ou está atualmente a ser utilizado por um utilizador.
• 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.
• Repita o carregamento de um objeto cloudPcDeviceImage que falhou anteriormente.
• Preteriu o método de recarregamento a favor de retryUpload.

Experiência dos colaboradores | Cativação dos colaboradores

Utilize o utilizador seguinte, não siga os seguidores da lista, os seguidores da lista e as SEGUINTES APIs para Viva Engage para gerir o enredo após as relações.

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.
• Transfira um intervalo parcial de bytes de uma versão anterior de um ficheiro.
• Utilize a lista, crie, obtenha e elimine APIs para gerir permissões de utilizador para tipos de contentores de armazenamento de ficheiros do SharePoint Embedded.
• Arquivo ou desarcultar um contentor de armazenamento do SharePoint Embedded.
• Os pedidos feitos com a API de contentores de lista sem um contexto de utilizador (autenticação apenas de aplicação) não são atualmente suportados para inquilinos multigeográficos.
• Utilize a propriedade itemCount no recurso de lista para aceder rapidamente ao número total de itens numa lista do SharePoint sem obter todos os itens ou fazer consultas adicionais.
• Utilize a propriedade principalId no sharePointGroup para obter o ID principal do grupo do SharePoint no inquilino.
• Utilize a propriedade sharePointGroup no sharePointIdentitySet para obter o grupo do SharePoint associado a um objeto sharePointIdentitySet .

Grupos

Foi adicionado o recurso ownerlessGroupPolicy e as operações de API relacionadas para permitir que os administradores de TI configurem políticas para gerir grupos que perderam o seu único proprietário. Utilize esta API para enviar e-mails de notificação acionáveis para membros ativos de grupos sem proprietário para aceitar a propriedade.

Identidade e acesso | Gerenciamento do diretório

• Introduziu as APIs Backup e recuperação do Entra para permitir que os administradores de TI criem cópias de segurança e restaurem Microsoft Entra ID dados do inquilino. Pode ver instantâneos e iniciar tarefas de pré-visualização para análise antes de executar as tarefas de recuperação. Também pode monitorizar a status de processos de recuperação, incluindo êxitos e falhas. Para obter mais informações, veja Descrição geral das APIs Backup e recuperação do Microsoft Entra.
• Utilize keyCredentials como uma propriedade em appManagementConfiguration para obter uma coleção de definições de restrições de certificados a aplicar a uma aplicação ou principal de serviço.
• Utilize passwordCredentials como uma propriedade em appManagementConfiguration para obter uma coleção de definições de restrições de palavra-passe a aplicar a uma aplicação ou principal de serviço.
• Utilize customSecurityAttributes como uma propriedade em appManagementPolicyActorExemptions para obter uma coleção de objetos customSecurityAttributeExemption para isentar da aplicação da política.

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.

• Foi adicionado privilegeLevel como uma propriedade no accessPackageCatalog. Este valor representa o nível de privilégio dos catálogos de pacotes de acesso.
• 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 .
• Foi adicionado o método List generativeAIInsights para obter informações de atividade de IA geradora e mcP a partir dos registos de tráfego de Acesso Seguro Global. Utilize este método para monitorizar padrões de atividade de IA, investigar o contexto de destino e correlacionar sessões de utilizador para análise de segurança e conformidade.
• Foram adicionadas as APIs da Firewall da Cloud para gerir políticas de firewall, regras e ligações de políticas para Microsoft Entra Acesso Seguro Global. Utilize os seguintes novos recursos e as respetivas APIs associadas:
  • Utilize o recurso cloudFirewallPolicy e os respetivos métodos associados para criar e gerir políticas de firewall na cloud.
  • Utilize o recurso cloudFirewallRule e os respetivos métodos associados para definir regras de firewall com condições de correspondência de origem e destino.
  • Utilize o recurso cloudFirewallPolicyLink e os respetivos métodos associados para ligar políticas de firewall da cloud a perfis de filtragem.

Segurança | Alertas e incidentes

• Adicionado o alerta: moveAlerts e incidente: mergeIncidents actions to support moving alerts and merging incidents in Microsoft Defender.
• Foi adicionada a enumeração correlationReason e o tipo de recurso mergeResponse .

Gestão de inquilinos | Governação

Introduziu o conjunto de API de governação de inquilinos para permitir que as organizações giram e governem relações com outros inquilinos. As principais capacidades incluem:

• Ativar a receção de convites e a deteção de inquilinos relacionada
• Estabelecer relações de governação entre um inquilino governativo e um inquilino regido
• Controlar relações estabelecidas
• Configurar políticas de relação

Segurança | Microsoft Defender para Identidades

• 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.
• As APIs de gestão de sensores do Defender para Identidade permitem-lhe detetar servidores elegíveis, controlar a integração automática, ativar ou desativar o agente unificado e gerir as definições de auditoria necessárias durante a ativação, tudo isto através de uma única interface de gestão.

Para obter mais informações, veja Descrição geral das APIs de Governação de Inquilinos.

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.

Conteúdo relacionado

• Blogue para programadores do Microsoft Graph.
• Registo de alterações do Microsoft API do Graph.
• Histórico de novidades do Microsoft Graph.