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.
Dezembro de 2024: Novo e geralmente disponível
Relatórios
Os registos de atividades do Microsoft Graph, que fornecem um registo de auditoria de todos os pedidos HTTP que o Microsoft Graph recebeu e processou para o seu inquilino, estão agora disponíveis na China operados pela 21Vianet.
Segurança | Alertas e incidentes
Ativou a descrição, displayName, resolvingComment e propriedades de gravidade como propriedades suportadas num Pedido de incidente de atualização .
Trabalho em equipa e comunicações | Gestão de turnos
- Teste a eliminação de uma instância openShift, shift ou timeOff numa agenda no modo de rascunho.
- Utilize a propriedade eligibilityFilteringEnabledEntities na workforceIntegration para obter ou definir o suporte para ver resultados filtrados por elegibilidade.
Usuários
Publicou as seguintes permissões com privilégios menores para gerir cenários específicos no objeto de utilizador :
Permissão | Comments |
---|---|
User-Mail.ReadWrite.All | Permissão com menos privilégios para atualizar a propriedade Outros Correios . |
User-PasswordProfile.ReadWrite.All | Permissão com menos privilégios para atualizar a propriedade passwordProfile . |
User-Phone.ReadWrite.All | Permissão com menos privilégios para atualizar os businessPhones e as propriedades do mobilePhone . Anteriormente, apenas a permissão Directory.AccessAsUser.All era suportada para atualizar as propriedades do utilizador administrador. Recomendamos que mova antes a permissão ** com privilégios menores. |
User.EnableDisableAccount.All | Permissão com menos privilégios para atualizar a propriedade accountEnabled . Também requer a permissão User.Read.All. Anteriormente, apenas a permissão Directory.AccessAsUser.All era suportada para atualizar a conta status para utilizadores administradores. Recomendamos que mova a permissão com privilégios menor. |
User.DeleteRestore.All | Permissão com menos privilégios para eliminar um utilizador, restaurar um utilizador eliminado da reciclagem ou eliminar permanentemente um utilizador eliminado da reciclagem. Também permite obter utilizadores eliminados através do /directory/deleteditems/microsoft.graph.user ponto final. |
Dezembro de 2024: Novo apenas em pré-visualização
Armazenamento de Cópias de Segurança
Utilize a nova API de pedidos de adição em massa de restauro para soluções de restauro mais convenientes, eficientes e dimensionáveis. Esta API foi concebida para simplificar o processo de restauro ao permitir a submissão direta de recursos de restauro num pedido em massa. São suportados os seguintes recursos:
- driveRestoreArtifactsBulkAdditionRequest
- mailboxRestoreArtifactsBulkAdditionRequest
- siteRestoreArtifactsBulkAdditionRequest
Gerenciamento de dispositivos e aplicativos | PC na nuvem
- Utilize a propriedade disasterRecoveryType em cloudPcCrossRegionDisasterRecoverySetting para obter ou definir o tipo de recuperação após desastre a efetuar quando ocorre um desastre no CLOUD PC de um utilizador.
- Utilize a propriedade userInitiatedDisasterRecoveryAllowed em cloudPcCrossRegionDisasterRecoverySetting para obter ou definir se o cliente permite que o utilizador final inicie uma ativação de recuperação após desastre.
- Preteriu a propriedade crossRegionDisasterRecoveryEnabled do recurso cloudPcCrossRegionDisasterRecoverySetting . No futuro, utilize a propriedade disasterRecoveryType .
- Ativado
endpointConnectivityCheckVMAgentEndPointCommunicationError
como um tipo de erro suportado na propriedade errorType do recurso cloudPcOnPremisesConnectionHealthCheck .
Identidade e acesso | Gerenciamento do diretório
Ao restaurar utilizadores eliminados de forma recuperável, pode agora especificar se Microsoft Entra ID deve substituir o userPrincipalName do utilizador por um novo valor.
Identidade e acesso | Identidade e entrada
- Utilize as APIs do Microsoft Graph para se manter informado sobre as atualizações mais recentes do produto, incluindo o mapa de objetivos do produto e os anúncios de alteração, a alternativa programática ao separador Novidades no centro de administração do Microsoft Entra.
- Agora pode gerir tokens OATH de hardware para a sua organização e utilizadores programaticamente através das seguintes APIs do Microsoft Graph:
- hardwareOathTokenAuthenticationMethodDevice tipo de recurso e os métodos associados para gerir os tokens de hardware no seu inquilino, incluindo a atribuição a utilizadores
- hardwareOathAuthenticationMethod tipo de recurso e os respetivos métodos associados para gerir tokens que já estão atribuídos aos utilizadores ativando ou desativando-os
Relatórios | Relatórios de monitorização do Microsoft 365
As APIs de monitorização do Microsoft 365 fornecem dados telemétricos para monitorizar o estado de funcionamento de vários serviços Microsoft numa subscrição do Microsoft 365 para a sua organização. Utilize as novas operações no recurso serviceActivity para obter dados telemétricos para Exchange Online, Microsoft 365 Apps e Microsoft Teams.
Segurança | Alertas e incidentes
Ativou a descrição, displayName e as propriedades de gravidade como propriedades suportadas num Pedido de incidente de atualização .
Sites e listas
Criar e gerir uma página de ligação de notícias no SharePoint.
Trabalho em equipa e comunicações | Mensagens
Utilize a propriedade firstChannelName na equipa para definir o nome do primeiro canal criado numa equipa.
Novembro de 2024: Novo e geralmente disponível
Arquivos
Utilize uma gama de novos métodos e recursos para uma gestão melhorada do armazenamento de ficheiros, incluindo métodos para gerir colunas e itens de reciclagem. Também pode executar operações como restaurar, bloquear, desbloquear e muito mais nos recursos fileStorageContainer, fileStorage e recycleBin .
Aplicações | Políticas
Utilize a propriedade state em keyCredentialConfiguration e passwordCredentialConfiguration para indicar se uma restrição é avaliada.
Segurança | Alertas e incidentes
Ativou os active
estados , , pendingApproval
declined
, unremediated
, running
e partiallyRemediated
na enumeração evidenceRemediationStatus. Utilize estes novos estados através da propriedade remediationStatus do alertEvidence e dos respetivos tipos herdados.
Segurança | Identidades
A API de gestão de sensores do Defender para Identidade permite-lhe criar relatórios detalhados sobre os sensores na área de trabalho, fornecendo informações como o nome do servidor, a versão do sensor, o tipo, o estado e o estado de funcionamento status. Também lhe permite gerir as definições do sensor, incluindo adicionar descrições, ativar ou desativar atualizações atrasadas e especificar o controlador de domínio ao qual o sensor se liga para consultar o Entra ID. Para obter mais informações, consulte sensor.
Trabalho em equipa e comunicações | Chamadas e reuniões online
Utilize a propriedade administrativeUnitInfos no participante e organizador para obter os IDs de uma ou mais unidades administrativas para um participante da chamada.
Novembro de 2024: Novo apenas em pré-visualização
Gerenciamento de dispositivos e aplicativos | PC na nuvem
- Foram adicionados novos pontos finais que suportam permissões de aplicação nos seguintes métodos do recurso cloudPC :
- Utilize a propriedade reservePercentage no método [cloudPcProvisioningPolicy: apply] para especificar a percentagem de PCs na Cloud a manter disponíveis para cenários partilhados de primeira linha.
- Utilize o método getCloudPCPerformanceReport para obter relatórios relacionados com o desempenho dos PCs na Cloud.
- Utilize o parâmetro reportName com o método getInaccessibleCloudPcReports para especificar o tipo de relatório do PC na Cloud.
- Ativou as
performanceTrendReport
opções einaccessibleCloudPcTrendReport
para o parâmetro reportName no método Create cloudPcExportJob .
Gestão de dispositivos e aplicações | Atualizações de dispositivos
- Implemente uma atualização de qualidade de acesso frequente com o Windows Autopatch.
- Utilize a propriedade isHotpatchUpdate no productRevision para identificar se o conteúdo é passível de acesso frequente.
- Utilize a propriedade isHotpatchEnabled em userExperienceSettings para identificar se a atualização é oferecida como um hotpatch.
Identidade e acesso | Identidade e entrada
- Utilize o recurso oidcIdentityProvider e os respetivos métodos para interagir com fornecedores de identidade do OpenID Connect num Microsoft Entra inquilino externo.
- Foi adicionado o recurso certificateBasedAuthPki para gerir a coleção de instâncias de infraestrutura de chaves públicas (PKI) para o método de autenticação baseado em certificado e o recurso certificateAuthorityDetail para aceder às propriedades de cada objeto de autoridade de certificação num certificadoBasedAuthPki.
Identidade e acesso | Acesso à rede
Liste, crie, obtenha, atualize e elimine os recursos fqdnFilteringRule e webCategoryFilteringRule que são tipos derivados de filteringRule.
Relatórios | Relatórios de identidade e acesso
Utilize a propriedade sessionId no signIn para obter o identificador da sessão que foi gerada durante um início de sessão.
Segurança | Aplicações na cloud detetadas
O novo Microsoft Defender para a API de aplicações na Cloud no Microsoft Graph foi concebido para fornecer uma forma eficiente e fiável de consultar informações de aplicações detetadas, facilitando a análise dos riscos associados às aplicações detetadas. Utilize os seguintes recursos e os respetivos métodos para obter dados e informações sobre o ecossistema de aplicações SaaS detetado:
- cloudAppDiscoveryReport
- discoveredCloudAppDetail
- discoveredCloudAppInfo
- discoveredCloudAppUser
- discoveredCloudAppIPAddress
- discoveredCloudAppDevice
- endpointDiscoveredCloudAppDetail
Segurança | Deteção de Dados Eletrónicos
Adição da autenticação de aplicações para Descoberta Eletrônica do Microsoft Purview Graph APIs. Para obter mais informações sobre como configurar o acesso apenas à aplicação, veja Configurar a autenticação de aplicações.
Trabalho em equipa e comunicações | Interações de IA
Utilize o método getAllEnterpriseInteractions para obter Microsoft 365 Copilot dados de interação, incluindo pedidos de utilizador para respostas Copilot e Copilot.
Trabalho em equipa e comunicações | Chamadas e reuniões online
- Ligue informações de eventos externos a um virtualEventTownhall ou virtualEventWebinar ao definir um externalEventId.
- Utilize externalEventInformation em virtualEventTownhall e virtualEventWebinar para identificar as informações de eventos externos de um evento virtual.
- Utilize a propriedade allowedLobbyAdmitters em onlineMeeting para obter ou definir os utilizadores que podem admitir a partir da sala de espera.
- Utilize a propriedade allowedLobbyAdmitters em onlineMeeting para obter ou definir os utilizadores que podem admitir a partir da sala de espera.
- Obtenha ou defina se os utilizadores de Reuniões Microsoft 365 Copilot no Teams podem receber respostas a pedidos relacionados com sentimentos.
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.