Novidades do Microsoft Graph
O Microsoft Graph fornece um modelo de programação unificado que você pode usar para acessar 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 no nível da API, consulte o changelog do Microsoft API do Graph.
Para obter detalhes sobre as atualizações anteriores no Microsoft Graph, consulte O que há de novo histórico no Microsoft Graph.
Importante
Os recursos na versão prévia status estão sujeitos a alterações sem aviso prévio e podem não ser promovidos a status de GA (geralmente disponíveis). Não use recursos de visualização em aplicativos de produção.
Abril de 2024: Novo e geralmente disponível
Aplicativos
Atualizou o valor padrão para signInAudience para novos aplicativos de
AzureADandPersonalMicrosoftAccount
paraAzureADMyOrg
. Daqui para frente, se você não atribuir explicitamente um valor à propriedade durante a criação do aplicativo, o aplicativo será atribuído automaticamente ao valorAzureADMyOrg
.Adicionou o suporte para adicionar segredos de senha a aplicativos durante a criação do aplicativo. Anteriormente, você só podia adicionar segredos aos aplicativos existentes por meio do aplicativo Update ou das operações addPassword .
Use o recurso upsert para criar um aplicativo, federatedIdentityCredential ou servicePrincipal se ele não existir ou atualizar um objeto existente usando uma chave fornecida pelo cliente. Para obter mais informações, confira as seguintes operações de API:
Grupos
Adicionou o recurso upsert ao tipo de recurso de grupo. Use esse recurso para criar um grupo se ele não existir ou atualizar um grupo existente usando a chave exclusiva fornecida pelo cliente do Nome .
Segurança | Alertas herdados
O /security/alerts
ponto de extremidade está preterido e deixará de retornar dados em 10 de abril de 2026.
Sites e listas
Agora você pode:
- Acompanhe as alterações dos recursos do site do SharePoint .
- Controlar alterações para o item de lista do SharePoint recursos.
Trabalhe com páginas de site e seções horizonais e verticais de páginas.
Identidade e acesso | Governança
Use a operação Criar no recurso de fluxo de trabalho para criar agora até 100 fluxos de trabalho que é um aumento em relação ao limite anterior de 50.
Identidade e acesso | Identidade e entrada
Configure o provedor de identidade padrão a ser usado nas configurações de fluxo de resgate para Microsoft Entra ID colaboração B2B.
Usuários
Associe usuários ou grupos como patrocinadores para privilégios de um usuário convidado no locatário e mantenha as informações e o acesso do usuário convidado atualizados. Você pode atribuir um patrocinador, listar patrocinadores e remover um patrocinador.
Abril de 2024: Somente novidades na versão prévia
Gerenciamento de dispositivos e aplicativos | PC na nuvem
Preteriu a propriedade type na nuvemPcAuditResource em favor da propriedade resourceType .
Identidade e acesso | Governança
Use a operação Criar no recurso de fluxo de trabalho para criar agora até 100 fluxos de trabalho que é um aumento em relação ao limite anterior de 50.
Identidade e acesso | Acesso à rede
Atualizou a definição de locais físicos para equipamentos locais do cliente nos serviços de Acesso Seguro Global do tipo de recurso branchSite para o tipo de recurso remoteNetwork. O tipo de recurso branchSite e suas propriedades, relações e pontos de extremidade associados serão preteridos em breve. Use o tipo de recurso remoteNetwork e suas propriedades, relações e pontos de extremidade associados.
ETL de dados do setor
O conjunto de fluxo de provisionamento de saída, que representa uma coleção de fluxos de provisionamento de saída usados para configurar como a sincronização de dados escolares preenche dados no Microsoft 365 e Microsoft Entra ID, agora está geralmente disponível.
Um conjunto de fluxo de provisionamento de saída não pode conter mais de uma de cada configuração de fluxo de provisionamento: userProvisioningFlow, classGroupProvisioingFlow, securityGroupProvisioingFlow, administrativeUnitProvisioingFlow.
Ao chamar a API ETL de dados do setor, aproveite as permissões mais granulares adicionadas para ler ou escrever dados do conjunto de fluxo de saída usando as novas permissões IndustryData-OutboundFlow.Read.All
e IndustryData-OutboundFlow.ReadWrite.All
.
Inteligência de pessoas e do local de trabalho | Pessoas
Preteriu o /organization/{organizationId}/settings/itemInsights
ponto de extremidade em favor do novo recurso peopleAdminSettings e introduziu o método List no recurso peopleAdminSettings .
Relatórios | Relatórios de identidade e acesso
O recurso activeUsersBreakdownMetric preterido anteriormente e suas APIs associadas agora estão desativados. Para obter informações sobre a atividade diária e mensal do usuário em aplicativos registrados em seu locatário configurados para ID externa do Microsoft Entra para clientes, use o tipo de recurso activeUsersMetric e suas APIs associadas.
Segurança | Alertas herdados
O /security/alerts
ponto de extremidade está preterido e deixará de retornar dados em 10 de abril de 2026.
Segurança | Indicador de inteligência contra ameaças
O /security/tiindicators
ponto de extremidade está preterido e deixará de retornar dados em 10 de abril de 2026.
Trabalho em equipe e comunicações | Mensagens
Enviar chatMessage em um canal ou um chat com um anexo de arquivo usando o link de compartilhamento de arquivos.
Março de 2024: Novo e geralmente disponível
Aplicativos
Execute um upload em massa como um trabalho de sincronização para ingerir dados no serviço de sincronização Microsoft Entra ID.
Experiências entre dispositivos
Adicionou a capacidade de listar e obter as configurações do Windows e as instâncias de configurações do Windows.
Gerenciamento de dispositivos e aplicativos | PC na nuvem
- Lista, get, período de carência final, reinicialização, renomeação, restauração e solução de problemas agora estão disponíveis no cloudPC.
- As operações list e get agora estão disponíveis na nuvemPcAuditEvent.
- Listar, obter, criar, atualizar, excluir e atribuir operações de políticas de provisionamento agora estão disponíveis na cloudPcProvisioningPolicy.
- Listar, obter, criar, atualizar, excluir e atribuir operações de configurações de usuário agora estão disponíveis no cloudPcUserSetting.
- Listar, obter, criar, excluir e obter operações de imagens de origem agora estão disponíveis na nuvemPcDeviceImage.
- As operações list e get agora estão disponíveis na nuvemPcGalleryImage.
Educação | Atribuição
Habilitado o $expand
parâmetro de consulta para o método Get educationAssignment .
Identidade e acesso | Gerenciamento do diretório
- A entidade da organização agora retorna o
CIAM
tenantType para identificar locatários que são configurados como Microsoft Entra ID para locatários de clientes, uma solução ciam (gerenciamento de acesso) de identidade do cliente &. - Novas propriedades definidas por Intune no recurso do dispositivo: enrollmentType, isRooted e managementType.
Relatórios | Relatórios de cobrança de parceiros
Use a cobrançaReconciliation: exportar API para acessar dados de reconciliação de fatura cobrada.
Março de 2024: Novidades somente na versão prévia
Segurança | Treinamento e simulação de ataque
Use a API da campanha de treinamento para atribuir diretamente treinamentos de segurança aos usuários.
Aplicativos
Use o recurso upsert para criar um aplicativo, federatedIdentityCredential ou servicePrincipal se ele não existir ou atualizar um objeto existente usando uma chave fornecida pelo cliente. Para obter mais informações, confira as seguintes operações de API:
Gerenciamento de dispositivos e aplicativos | PC na nuvem
- Aplique a configuração atual da política de provisionamento em todos os dispositivos cloud pc em uma política especificada.
- Atualize a configuração da política de provisionamento para um conjunto específico de dispositivos cloud pc usando suas IDs.
- Adicionou a capacidade de marcar objetos alertRecord especificados conforme enviado por meio da propriedade isPortalNotificationSent .
- Execute o power-off em massa, o power-on, a reprovision, o redimensionamento, a reinicialização, a restauração e a solução de problemas em dispositivos cloud pc usando suas IDs.
Preteriu as seguintes propriedades:
- propriedade type na cloudPcOnPremisesConnection; em vez disso, use a propriedade connectionType .
- propriedade healthCheckStatusDetails na nuvemPcOnPremisesConnection; use a propriedade healthCheckStatusDetail em vez disso.
- propriedade additionalDetails na nuvemPcOnPremisesConnectionHealthCheck; em vez disso, use a propriedade additionalDetail.
- propriedade domainJoinConfiguration na nuvemPcProvisioningPolicy em favor da propriedade domainJoinConfigurations .
- propriedade onPremisesConnectionId na cloudPcProvisioningPolicy em favor da propriedade domainJoinConfigurations.
Gerenciamento de dispositivos e aplicativos | Atualizações de dispositivo
Foram adicionados métodos à API do Windows Atualizações para produtos Windows, incluindo recuperação de problemas conhecidos por intervalo de tempo, localização de revisões de produto por ID do catálogo e por base de dados de conhecimento número.
Arquivos
Use o método Obter arquivo por contentStream para baixar o conteúdo do arquivo diretamente em vez de obter uma 302
URL de redirecionamento.
Grupos
Adicionou o recurso upsert ao tipo de recurso de grupo. Use esse recurso para criar um grupo se ele não existir ou atualizar um grupo existente usando a chave exclusiva fornecida pelo cliente do Nome .
Identidade e acesso | Identidade e entrada
Use o tipo de recurso federatedTokenValidationPolicy e seus métodos associados para gerenciar se Microsoft Entra ID valida tokens de autenticação de federação.
Segurança | proteção de colaboração e Email
Adicionou a capacidade de listar emails analisados por Microsoft Defender para Office 365, obter metadados relacionados ao email e executar ações de resposta (exclusão suave, exclusão dura, mover para lixo eletrônico, mover para a caixa de entrada).
Segurança | Identidades
Adicionou a capacidade de obter, obter lista, atualizar Microsoft Defender para Identidade problemas de integridade.
Usuários
Adicionou a capacidade de converter um usuário externo em um usuário membro interno usando o usuário: convertExternalToInternalMemberUser API. Essa conversão permite que os usuários convertidos mantenham seu objeto e acesso de usuário existentes, ao mesmo tempo em que ganham os privilégios completos de um usuário membro interno no locatário.
Contribuir para o Microsoft Graph
Existem cenários em que você gostaria que o Microsoft Graph oferecesse suporte?
Sugerir e votar em novos recursos usando o Portal de Comentários do Microsoft Graph. Alguns novos recursos são originados como solicitações populares da comunidade de desenvolvedores. A equipe do Microsoft Graph avalia regularmente as necessidades do cliente e libera novos recursos para os pontos de extremidade beta (
https://graph.microsoft.com/beta
) e v1.0 (https://graph.microsoft.com/v1.0
).Junte-se à chamada semanal da comunidade de plataformas do Microsoft 365 e torne-se um membro ativo da comunidade do Microsoft Graph. Visite a página da comunidade do Microsoft 365 e do Power Platform para descobrir o calendário completo de chamadas de desenvolvedor.
Junte-se ao nosso painel de pesquisa para fornecer sua entrada em nossas experiências de desenvolvedor.
Conteúdo relacionado
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de