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.

Outubro de 2024: Novo e geralmente disponível

Armazenamento de cópias de segurança

Foram atualizados os pontos finais dos seguintes métodos:

• Listar unidadeProtectionUnits
• Listar caixa de correioProtectionUnits
• Listar siteProtectionUnits

Identidade e acesso | Gerenciamento do diretório

Obtenha o domínio raiz de um subdomínio.

Foram adicionadas recomendações para utilizar APIs RBAC unificadas em unifiedRoleDefinition em vez de directoryRole e directoryRoleTemplate.

Segurança | Deteção de Dados Eletrónicos

• Ativou a eliminação de itens de caixa de correio do Exchange no método ediscoverySearch: purgeData .
• Eliminou o permanentlyDeleted membro da enumeração purgeType a favor do permanentlyDelete membro.

Trabalho em equipa e comunicações | Aplicações

Utilize a propriedade clientAppId no teamsAppAuthorization para obter o ID de registo do ID da aplicação Microsoft Entra associado a uma aplicação no catálogo de aplicações do Microsoft Teams.

Trabalho em equipa e comunicações | Mensagens

Foi atualizado o método chatMessage: delta para utilizar um novo ponto final que obtém a lista de mensagens delta de todas as conversas nas quais um utilizador participa, incluindo conversas um-para-um, conversas de grupo e conversas de reunião.

Outubro de 2024: Novo apenas em pré-visualização

Armazenamento de cópias de segurança

Foram adicionados novos pontos finais para a adição em massa de unidades de proteção a uma política de proteção:

• Criar siteProtectionUnitsBulkAdditionJob

• Site de listaProtectionUnitsBulkAdditionJobs

• Obter siteProtectionUnitsBulkAdditionJob

• Criar caixa de correioProtectionUnitsBulkAdditionJob

• Listar caixa de correioProtectionUnitsBulkAdditionJobs

• Obter mailboxProtectionUnitsBulkAdditionJob

• Criar driveProtectionUnitsBulkAdditionJob

• Unidade de listaProtectionUnitsBulkAdditionJobs

• Obter driveProtectionUnitsBulkAdditionJob

Foram atualizados os pontos finais dos seguintes métodos:

• Listar unidadeProtectionUnits
• Listar caixa de correioProtectionUnits
• Listar siteProtectionUnits

Gerenciamento de dispositivos e aplicativos | PC na nuvem

• Ativou o $select parâmetro de consulta para o método cloudPC: getProvisionedCloudPCs .
• Utilize a propriedade notificationSetting na cloudPcUserSetting para definir os pedidos de notificação do PC na Cloud para um utilizador do CLOUD PC.

Relatórios | Relatórios de identidade e acesso

As APIs de alertas de monitorização do Microsoft Entra Health permitem-lhe detetar padrões de utilização anómalos em cenários de identidade críticos para a empresa para o seu inquilino e receber notificações de alerta. Utilize as operações dos recursos alert e alertConfiguration para obter e atualizar alertas e configurações de alertas. Para obter detalhes, veja a secção do registo de alterações relacionada.

Segurança | Deteção de Dados Eletrónicos

• Ativou a eliminação de itens de caixa de correio do Exchange no método ediscoverySearch: purgeData .
• Eliminou o permanentlyDeleted membro da enumeração purgeType a favor do permanentlyDelete membro.

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

• Utilize a propriedade externalRegistrationInformation em virtualEventRegistration para obter ou definir as informações externas para um registo de evento virtual.
• Utilize os seguintes novos métodos para eventos virtuais do tipo virtualEventTownhall :
  • Listar todas as câmaras municipais de eventos virtuais criadas num inquilino.
  • Obtenha as câmaras municipais de eventos virtuais onde um utilizador especificado é um organizador ou coorganizador.
  • Obtenha as câmaras municipais de eventos virtuais onde o utilizador com sessão iniciada é um organizador ou coorganizador.

Gestão de dispositivos e aplicações | Licenciamento na cloud

• Utilize a nova utilização de licenciamento na cloudA entidadeRight concebida para verificações de licenças de cliente e carga de trabalho, com relações estruturadas para fluir do utilizador ou grupo para usageRight. Esta nova entidade suporta as seguintes operações:
  • Listar direitos de utilização de um grupo
  • Listar direitos de utilização de um utilizador
  • Obter direitos de utilização para um grupo ou utilizador
• Utilize a propriedade cloudLicensing num grupo ou utilizador para obter as relações com os recursos de licenciamento na cloud.

Trabalho em equipa e comunicações | Mensagens

• Foi atualizado o método chatMessage: delta para utilizar um novo ponto final que obtém a lista de mensagens delta de todas as conversas nas quais um utilizador participa, incluindo conversas um-para-um, conversas de grupo e conversas de reunião.
• Remova vários membros de uma equipa num único pedido.

Usuários

Alterou as seguintes propriedades sincronizadas no local do tipo de recurso de utilizador que eram só de leitura no Microsoft Graph para serem atualizáveis através do Microsoft Graph:

• onPremisesDistinguishedName
• onPremisesDomainName
• onPremisesSamAccountName
• onPremisesSecurityIdentifier
• onPremisesUserPrincipalName

Setembro de 2024: Novo e geralmente disponível

Notificações de alteração

Anunciou a descontinuação das assinaturas de acesso partilhado (SAS) para autenticar os Hubs de Eventos para notificações de alteração do Microsoft Graph. Recomendamos que utilize Microsoft Entra ID controlo de acesso baseado em funções (RBAC). Siga a documentação de orientação para migrar para o RBAC.

Identidade e acesso | Gerenciamento do diretório

Foi removida a permissão preterida Directory.Write.Restricted anteriormente do dispositivo, grupo e recursos de utilizador .

Segurança | Alertas e incidentes

• Utilize a propriedade dnsDomain em deviceEvidence para obter o domínio DNS ao qual um computador pertence.
• Utilize a propriedade hostName no deviceEvidence para obter o nome do anfitrião sem o sufixo de domínio.
• Utilize a propriedade ntDomain em deviceEvidence para obter um agrupamento lógico de computadores numa rede do Microsoft Windows.

Segurança | Identidades

Foi adicionada a capacidade de obter, listar e atualizarMicrosoft Defender para Identidade problemas de estado de funcionamento que representam potenciais problemas identificados na configuração do Defender para Identidade de um cliente.

Trabalho em equipa e comunicações | Mensagens

• Obtenha todas as mensagens retidas em todos os canais numa equipa.
• Obtenha todas as mensagens retidas de todas as conversas nas quais um utilizador participa, incluindo conversas um-para-um, conversas de grupo e conversas de reunião.

Setembro de 2024: Novo apenas em pré-visualização

Aplicações | Principal de serviço

Utilize a propriedade opcional serviceManagementReference no método applicationTemplate: instantiate para definir o ID da árvore de serviços para um serviço.

Gerenciamento de dispositivos e aplicativos | PC na nuvem

• Ativou os middleEast membros e mexico como regiões suportadas na enumeração cloudPcRegionGroup .
• O método getShiftWorkCloudPcAccessState foi removido do recurso cloudPC . No futuro, utilize a API getFrontlineCloudPcAccessState .
• Utilize a propriedade autopilotConfiguration na cloudPcProvisioningPolicy para obter ou definir as definições do Windows Autopilot que permitem aos clientes Windows 365 experimentá-lo no Cloud PC.
• Utilize a propriedade osVersionNumber nos recursos cloudPcDeviceImage e cloudPcGalleryImage para obter a versão do sistema operativo de uma imagem.
• Introduziu o método retrieveSnapshots no recurso cloudPC para lhe permitir devolver uma lista de todos os instantâneos de um PC na Cloud.

Preteriu os seguintes métodos:

• bulkSetReviewStatus; utilize o recurso cloudPcBulkSetReviewStatus e as APIs suportadas.
• Listar instantâneos; utilize o recurso retrieveSnapshots e as respetivas APIs suportadas.

Arquivos

• Atualize as definições da reciclagem de um fileStorageContainer.
• Utilize os $skipparâmetros de consulta , $top, $orderBy, $filtere includeAllContainerUsers para personalizar a resposta da operação de permissões lista .
• Inclua todo o histórico de versões ao copiar um item de unidade. O histórico de versões está incluído até ao limite de definição da versão de destino.

Identidade e acesso | Gerenciamento do diretório

Utilize a propriedade passwordResetUri em internalDomainFederation para obter ou definir o URI para o qual os clientes são redirecionados para para repor a palavra-passe.

Identidade e acesso | Identidade e início de sessão

• Utilize a propriedade identifierUris nas operações get e update do recurso tenantAppManagementPolicy para obter ou definir restrições em formatos de URI de identificador vulneráveis ou facilmente comprometidos para uma aplicação.
• Foi atualizado o tipo de retorno para a propriedade applicationRestrictions do recurso tenantAppManagementPolicy de appManagementConfiguration para appManagementApplicationConfiguration.
• Foi atualizado o tipo de retorno para a propriedade servicePrincipalRestrictions do recurso tenantAppManagementPolicy de appManagementConfiguration para appManagementServicePrincipalConfiguration.
• Foi atualizado o tipo de retorno para a propriedade restrições do recurso appManagementPolicy de appManagementConfiguration para customAppManagementConfiguration.

Relatórios | Relatórios de uso do Microsoft 365

• Obtenha os dados de atividade mais recentes para utilizadores ativados de aplicações Microsoft 365 Copilot.
• Obtenha o número agregado de utilizadores ativos e ativados de Microsoft 365 Copilot durante um período de tempo especificado.
• Obtenha a tendência no número diário de utilizadores ativos e ativados de Microsoft 365 Copilot durante um período de tempo especificado.

Segurança | Alertas e incidentes

• Utilize a propriedade dnsDomain em deviceEvidence para obter o domínio DNS ao qual um computador pertence.
• Utilize a propriedade hostName no deviceEvidence para obter o nome do anfitrião sem o sufixo de domínio.
• Utilize a propriedade ntDomain em deviceEvidence para obter um agrupamento lógico de computadores numa rede do Microsoft Windows.

Segurança | Identidades

• Gerar uma nova chave de acesso de implementação.
• Obtenha a chave de acesso de implementação associada a um Microsoft Defender para Identidade.
• Obter o pacote de implementação do sensor URL e versão.

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

Utilize a propriedade isDeltaRosterEnabled em incomingCallOptions e outgoingCallOptions para indicar se a lista delta está ativada para uma chamada.

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.