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.

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.

Maio de 2026: Novo e geralmente disponível

Agentes

• Adicionado o tipo de recurso agentUser e métodos relacionados para gerir o ciclo de vida das identidades de utilizador do agente.
• Foram adicionados recursos verifiedIdProfile e configuração de perfil relacionada para configurar ID Verificada do Microsoft Entra.

Identidade e acesso | Gerenciamento do diretório

Utilize o tipo de recurso deviceRegistrationPolicy e os respetivos métodos relacionados para gerir a política que controla as restrições de quota de registo de dispositivos, autenticação adicional e políticas de autorização para o seu inquilino Microsoft Entra.

Identidade e acesso | Identidade e entrada

• Foram adicionados os tipos de recursos onVerifiedIdClaimValidationCustomExtension e onVerifiedIdClaimValidationListener e métodos associados para suportar a lógica personalizada para validação de afirmações de ID verificada apresentações de credenciais durante fluxos de autenticação através de Microsoft Entra extensões de autenticação personalizadas no ID externa.
• Foram adicionadas capacidades de validação de afirmações e confiança de correspondência para ID verificada perfis, permitindo uma verificação de afirmações mais forte e uma correspondência mais flexível.

Maio de 2026: Novo apenas na pré-visualização

Identidade e acesso | Identidade e entrada

Foram adicionados os tipos de recursos onVerifiedIdClaimValidationCustomExtension e onVerifiedIdClaimValidationListener e métodos associados para suportar a lógica personalizada para validação de afirmações de ID verificada apresentações de credenciais durante fluxos de autenticação através de Microsoft Entra extensões de autenticação personalizadas no ID externa.

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.
• Foi adicionado suporte para o sharePointGroup e respetivos membros num contentor do SharePoint Embedded, permitindo que as aplicações funcionassem com grupos de permissões do SharePoint e gerissem os respetivos membros.

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.

Identidade e acesso | Identidade e entrada

• Utilize riskRemediation como parte dos controlos de concessão de acesso condicional para impor uma política de acesso condicional de Risco de Utilizador. Quando seleciona "Exigir remediação de risco" nos controlos de concessão da política, o Microsoft Entra ID Protection gere o fluxo de remediação adequado com base na ameaça observada e no método de autenticação do utilizador. Em sessões de Utilizador de Risco sem palavra-passe, atualiza os detalhes de risco com microsoftRevokedSessions.

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.
• As seguintes APIs do Microsoft Teams suportam a paginação @odata.nextLink para processar limites de canais aumentados. Quando o conjunto de resultados abrange várias páginas, a resposta inclui a propriedade @odata.nextLink com um URL para obter a página seguinte dos resultados:
  • List channels
  • Listar incomingChannels
  • Listar allChannels

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

Agentes

Foram adicionados avisos de preterição aos recursos agentRegistry, agentCardManifest, agentCollection e agentInstance e às respetivas operações relacionadas. Estas APIs de Registo de Agente serão substituídas por APIs baseadas em Agent 365 a partir de 1 de maio de 2026.

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 .

Gerenciamento de dispositivos e aplicativos | PC na nuvem

• Os /me/cloudPCs/{cloudPCId}/getCloudPcLaunchInfo pontos finais e /users/{userId}/cloudPCs/{cloudPCId}/getCloudPcLaunchInfo são preteridos e deixarão de devolver dados a 30 de outubro de 2026. No futuro, utilize a API retrieveCloudPcLaunchDetail .
• Foi adicionado o tipo de recurso cloudPcOnPremisesConnectionSubnetIpDetail para representar os detalhes de IP da sub-rede de uma ligação no local do PC na Cloud.
• Utilize a propriedade subnetPrivateIpDetail em cloudPcOnPremisesConnection para obter informações detalhadas sobre os endereços IP privados da sub-rede associados à sub-rede.

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

Identidade e acesso | Gerenciamento do diretório

Foram adicionadas as relações herdadasAppRoleAssignments e herdadasOauth2PermissionGrants ao recurso agentIdentity para obter permissões herdadas do Principal de Serviço do Esquema de Identidade do Agente principal.

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.
• Foi adicionado o método cancelProcessing ao recurso de fluxo de trabalho para cancelar execuções de fluxos de trabalho que estão atualmente em curso ou em fila.
• Foi adicionada a propriedade referenceId e a relação de ficheiros ao recurso customDataProvidedResourceUploadSession para identificar o contexto para o qual os dados estão a ser carregados, como um ID de instância de revisão de acesso, e identificar os ficheiros carregados durante uma sessão de carregamento, respetivamente. Também foi adicionado suporte melhorado para capacidades de consulta para a operação de API list customDataProvidedResourceUploadSession objects .

Identidade e acesso | Identidade e entrada

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

Email

Introduziu a nova API de notas que permite aos utilizadores criar e gerir notas simples na respetiva pasta Notas . As notas suportam conteúdo de texto com anexos de imagem inline opcionais e são adequadas para cenários de captura rápida. Utilize o recurso de nota e as seguintes APIs:

• Listar notas na pasta Notas do utilizador.
• Crie uma nota na pasta Notas do utilizador.
• Obtenha uma nota.
• Atualizar uma nota.
• Eliminar uma nota.
• Obter delta para controlar as alterações às notas.
• Listar anexos de uma nota.
• Criar um anexo numa nota.
• Eliminar um anexo de uma nota.

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

Saiba como lidar com redirecionamentos HTTP ao aceder a pastas e itens em caixas de correio de arquivo com pastas com o filtro automático através das APIs de importação e exportação da caixa de correio. Para obter mais informações, consulte Processar redirecionamentos de caixas de correio de arquivo.

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.
• Organize conversas, canais e reuniões em secções personalizadas na lista de chat do Microsoft Teams de um utilizador com os novos recursos teamworkSection e teamworkSectionItem . Utilize as APIs de gestão de secções para listar, criar, obter, atualizar e eliminar secções e adicionar, remover e mover itens nas secções.

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.