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 em APIs do Microsoft Graph, documentação, SDKs e muito mais.

Para obter atualizações mais detalhadas no nível da API, consulte o changelog da API do Graph Microsoft.

Para obter detalhes sobre as atualizações anteriores do Microsoft Graph, consulte o histórico de novidades do Microsoft Graph.

Importante

Os recursos no status de visualização estão sujeitos a alterações sem aviso prévio e podem não ser promovidos ao status de disponibilidade geral (GA). Não use recursos de visualização em aplicativos de produção.

Outubro de 2026: novo e em disponibilidade geral

Calendários

  • Promoveu a propriedade isSharedWithMe do recurso de calendário de beta para v1.0. A propriedade é usada para identificar os calendários compartilhados.
  • Adicionado o método delta ao tipo de recurso de calendário . Use-o para acompanhar calendários adicionados, excluídos ou atualizados na caixa de correio de um usuário.

Correio | Rastreamento de mensagem

Adicionado suporte para identificar mensagens recuperadas no rastreamento de mensagens. Use recalled como um valor com suporte da propriedade status do recurso exchangeMessageTrace.

Outubro de 2026: novo apenas na visualização

Backup e recuperação | Backup e armazenamento do Microsoft 365

  • Acompanhe as atividades do administrador em recursos de backup e restauração, incluindo alterações de política, execuções dinâmicas de regras, remoção e conclusões de tarefas de restauração, usando o recurso activityLogBase e seus tipos derivados.
  • Removeu a propriedade tags no restoreTaskActivityLog em favor da propriedade restoreJobType . Use a propriedade restoreJobType com valores do tipo de enumeração restoreJobType .
  • Adicionado o membro backupPolicyDeleted como um novo valor com suporte para a propriedade activityType no recurso activityLogBase e seus tipos derivados.

Gerenciamento de dispositivos e aplicativos | PC na nuvem

Atualizada a data em que as propriedades de imagem preteridas em cloudPcDeviceImage, cloudPcSourceDeviceImage e cloudPcGalleryImage deixarão de retornar dados de 31 de janeiro de 2024 a 7 de dezembro de 2026. Nenhuma substituição está planejada para recommendedSku. Revise as diretrizes de propriedade de substituição nesses tópicos de recursos e atualize as integrações afetadas antes do prazo.

Arquivos

O método getSharePointApiUsage foi atualizado para dar suporte a relatórios de priorização de serviço do SharePoint. Use este relatório para recuperar contagens de solicitação de API total, padrão, pesada, padrão cobrada e cobrada pesada por aplicativo e data.

Identidade e acesso | Governança

  • Adicionado o tipo de recurso accessDriftSummary e métodos relacionados para identificar recursos controlados cujo acesso real difere da intenção do pacote de acesso. Use-o para listar e inspecionar resumos de desvios, recuperar detalhes de desvios e baixar relatórios de reconciliação em massa. Os detalhes de desvio de acesso identificam se cada identidade afetada é um usuário ou grupo por meio da propriedade identityType de entraDriftIdentityInfo.

Correio | Rastreamento de mensagem

Adicionado suporte para identificar mensagens recuperadas no rastreamento de mensagens. Use recalled como um valor com suporte da propriedade status do recurso exchangeMessageTrace.

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

  • Adicionada a propriedade isHidden ao recurso mailboxFolder para identificar pastas de caixa de correio ocultas.
  • Use o parâmetro de consulta includeHiddenFolders existente para listar pastas e listar pastas filho. Defina-a para true incluir pastas ocultas e não ocultas.

Segurança

Adicionada a propriedade incidentConfiguration ao recurso detectionAction e ao tipo complexo incidentConfiguration . Use essa configuração para excluir alertas gerados por uma regra de detecção personalizada da correlação automática de incidentes e criar incidentes autônomos de alerta único.

Segurança | Consulta de log de auditoria

Foram adicionados 35 membros, por meio MESRawEmailContentMetadatade , à enumeração auditLogRecordType e adicionados os tipos derivados de auditData correspondentes para representar cargas de eventos de auditoria específicas da carga de PlannerCustomFieldDefinition trabalho.

Segurança | Conformidade e segurança de dados

Atualizou a enumeração evaluationErrorType para usar motivos voltados para o cliente para avaliações de política incompletas e removeu a propriedade errorMessage do tipo complexo evaluationErrorDetail . Use errorType para identificar por que uma avaliação não pôde ser concluída.

Segurança | Pastas de trabalho

  • Adicionado o tipo de recurso de pasta de trabalho e métodos relacionados para gerenciar documentos de pasta de trabalho de Segurança da Microsoft no escopo do locatário. Use IDs estáveis para implantações repetíveis e substitua o conteúdo JSON de uma pasta de trabalho como um documento completo.

Trabalho em equipe e comunicação | Sistema de mensagens

Adicionado suporte para definir e desconfigurar reações de emoji personalizadas em mensagens de chat, especificando um nome de exibição (displayName), identificador emitido pelo serviço (reactionId) ou ambos. Para obter mais informações, consulte chatMessageReaction.

Setembro de 2026: novo e em disponibilidade geral

Calendários | Horas e locais de trabalho

Adicionado suporte somente aplicativo aos recursos workHoursAndLocationsSetting, workPlanOccurrence e workPlanRecurrence e métodos relacionados. Os aplicativos podem usar a permissão do Calendars.Read.All aplicativo para ler a configuração, as recorrências e as ocorrências de um usuário e Calendars.ReadWrite.All para criá-las, atualizá-las e excluí-las.

Notificações de alteração

Promoveu o unknownFutureValue membro da enumeração changeType de beta para v1.0. A enumeração é usada pelos recursos changeNotification e commsNotification para identificar os tipos de alteração de notificação.

Arquivos

Grupos

Adicionada a propriedade onPremisesExtensionAttributes ao recurso de grupo . Use-o para acessar os atributos de extensão 1-15 sincronizados do Active Directory local.

Identidade e acesso | Gerenciamento do diretório

  • Adicionado o tipo de recurso directoryRoleManagementDeletedItemContainer e métodos relacionados à v1.0. Use essas APIs para listar e inspecionar funções personalizadas excluídas temporariamente, restaurá-las para a coleção de definições de função ativa ou excluí-las permanentemente.
  • Adicionada a ação de provisionamento ao recurso de dispositivo na v1.0 para permitir que provedores de VDI (Virtual Desktop Infrastructure aprovados) provisionem dispositivos em um diretório do cliente. Adicionada a ação de provisionamento ao recurso de dispositivo na v1.0 para permitir que provedores de VDI (Virtual Desktop Infrastructure aprovados) provisionem dispositivos em um diretório do cliente.

Identidade e acesso | Governança

Identidade e acesso | Identidade e entrada

Segurança | Consulta de log de auditoria

Adicionadas as propriedades isRecordCountLimitExceeded, recordCountLimit e approximateReturnedRecordCount ao recurso auditLogQuery . Use essas propriedades para determinar se uma consulta concluída excedeu o limite de contagem de registros por pesquisa e para inspecionar o limite aplicável e a contagem aproximada de registros retornados.

Trabalho em equipe e comunicação | Sistema de mensagens

O método getAllRetainedMessages foi atualizado para dar suporte à exportação de versões retidas de mensagens de canal privado que foram editadas ou excluídas depois que o locatário concluiu a migração de armazenamento de canal privado.

Setembro de 2026: novo somente na versão prévia

Agentes

Adicionada a propriedade isDisabled ao recurso agentIdentityBlueprint . Use-o para desativar um blueprint de identidade de agente sem excluí-lo.

Application

A propriedade isDeviceAccessEnabled foi adicionada ao recurso onPremisesPublishing para configurar o acesso ao dispositivo para o Acesso privado do Microsoft Entra.

Backup e recuperação | Backup e armazenamento do Microsoft 365

  • A propriedade policyId foi adicionada ao tipo de recurso restoreSessionBase para definir o escopo das sessões de restauração para uma política de proteção.
  • Adicionado o parâmetro policyId opcional ao método de pesquisa restorePoint: para validar a associação à unidade de proteção e melhorar o roteamento no escopo da política. Você também pode filtrar a coleção de pontos de restauração por protectionUnit/policyId.

Armazenamento de backup

  • Adicionado o método getStatisticsByPolicy para recuperar estatísticas de proteção em nível de política para o Armazenamento de Backup do Microsoft 365. Use o relatório para monitorar artefatos protegidos e desprotegidos nos estados concluído, em andamento e com falha, revisar a atividade de desligamento e determinar quando as métricas foram calculadas pela última vez.

Calendar | Places

  • Adicionado o tipo de recurso stringDictionary para representar pares de chave-valor de cadeia de caracteres personalizados.
  • Adicionada a propriedade customProperties ao tipo de recurso place para armazenar pares de chave-valor de cadeia de caracteres definidos pelo cliente.
  • Adicionada a propriedade lastUpdatedTime somente leitura ao tipo de recurso place para indicar quando o local foi atualizado pela última vez.

Calendários | Horas e locais de trabalho

Adicionado suporte somente aplicativo aos recursos workHoursAndLocationsSetting, workPlanOccurrence e workPlanRecurrence e métodos relacionados. Os aplicativos podem usar a permissão do Calendars.Read.All aplicativo para ler a configuração, as recorrências e as ocorrências de um usuário e Calendars.ReadWrite.All para criá-las, atualizá-las e excluí-las.

Notificações de alteração

Adicionado o unknownFutureValue membro à enumeração changeType usada pelo recurso changeNotification para dar suporte a tipos de alteração de notificação compatíveis com encaminhamento.

Gerenciamento de dispositivos e aplicativos | PC na nuvem

  • A propriedade isDisasterRecoveryActive foi adicionada ao recurso cloudPC para indicar se o PC na nuvem atualmente é executado em sua região de recuperação de desastre após um evento de failover.
  • Use failoverInProgress e failbackInProgress como valores com suporte para a propriedade status nos recursos cloudPC e cloudPcStatusSummary.

Arquivos

  • Adicionado o parâmetro userObjectId ao método getByUser no recurso fileStorageContainer para recuperar uma lista de contêineres de armazenamento de arquivos pertencentes a um usuário, passando a ID do objeto do Microsoft Entra ID do usuário.
  • A propriedade isPatternToken foi adicionada ao recurso fileStorageContainerCustomPropertyValue para indicar se um valor de propriedade personalizada é um urlTemplate padrão que os consumidores devem resolver antes de usar, em vez de um valor literal.

Identidade e acesso | Gerenciamento do diretório

  • Adicionado o tipo de recurso directoryRoleManagementDeletedItemContainer e métodos relacionados para recuperar definições de função personalizadas que foram excluídas. Use essas APIs para listar e inspecionar funções personalizadas excluídas temporariamente, restaurá-las para a coleção de definições de função ativa ou excluí-las permanentemente.
  • A ação de provisionamento foi adicionada ao recurso de dispositivo para permitir que provedores de VDI (Virtual Desktop Infrastructure aprovados) provisionem dispositivos em um diretório do cliente.

Grupos

  • A propriedade disableNesting foi adicionada ao recurso de grupo . Use-o para impedir que outros grupos sejam adicionados como membros de um grupo de segurança.

Identidade e acesso | Gerenciamento do diretório

  • A ação de provisionamento foi adicionada ao recurso de dispositivo para permitir que provedores de VDI (Virtual Desktop Infrastructure aprovados) provisionem dispositivos em um diretório do cliente.

Identidade e acesso | Governança

  • Esclarecemos que o método Get accessPackageResourceEnvironment retorna ambientes de recursos do SharePoint Online somente quando é chamado com permissões delegadas. Um ambiente de recursos do SharePoint Online corresponde a um site raiz do SharePoint, portanto, para recuperar informações do site raiz com permissões de aplicativo, use o método Listar sites com a $filter=siteCollection/root ne null opção de consulta.
  • Adicionado suporte de visualização pública para políticas de ciclo de vida que regem identidades de agentes e usuários convidados. Use lifecyclePolicy e seus tipos de política derivados para configurar escopo, regras, imposição de fluxo de trabalho, avaliação de impacto e relatórios de processamento.
  • Foram adicionadas ações de ciclo de vida de usuário convidado para atestar, adicionar o usuário conectado como patrocinador e remover o usuário conectado como patrocinador.

Identidade e acesso | Identidade e entrada

Adicionada a propriedade requireCertificateSidAlignment ao recurso x509CertificateAuthenticationMethodConfiguration . Use-o para exigir o alinhamento SID do certificado para usuários híbridos e somente na nuvem durante a autenticação baseada em certificado.

Identidade e acesso | Monitorando a integridade &

People and workplace intelligence | Análise

Adicionada a propriedade sensitivityLabel ao tipo de recurso searchHit para fornecer informações de rótulo de confidencialidade para o recurso de resultado da pesquisa.

Relatórios | Relatórios de cobrança de parceiros

Adicionado o tipo de recurso billedAggregatedUsage e o método de exportação relacionado para que os parceiros CSP gerem relatórios de uso agregados e faturados do Azure para uma fatura específica.

Segurança | Consulta de log de auditoria

Adicionadas as propriedades isRecordCountLimitExceeded, recordCountLimit e approximateReturnedRecordCount ao recurso auditLogQuery . Use essas propriedades para determinar se uma consulta concluída excedeu o limite de contagem de registros por pesquisa e para inspecionar o limite aplicável e a contagem aproximada de registros retornados.

Segurança | Conformidade e segurança de dados

  • Adicionado o contentFiltering membro à enumeração userActivityTypes usado pelos escopos de proteção de computação para um usuário e escopos de proteção de computação para APIs de locatário , permitindo que os aplicativos determinem se as políticas de prevenção contra perda de dados regem a filtragem de conteúdo antes de avaliar o conteúdo.
  • O recurso contentActivity foi atualizado para dar suporte a relatórios de avaliações de política seguras por padrão que não puderam ser concluídas. Os planos de aplicação podem enviar motivos estruturados de inspeção incompleta por meio da API de ingestão de atividade de conteúdo existente.
  • Adicionada a propriedade policyConfiguration ao tipo de recurso policyScopeBase . Os planos de imposição podem usar a configuração efetiva de Segurança por Padrão retornada pelas APIs do escopo de proteção para determinar se devem auditar ou bloquear o conteúdo quando a avaliação da política não puder ser concluída.

Tarefas e planos

Adicionado o tipo de recurso de plano para o Planner Graph V4. Use essas APIs para criar e gerenciar planos e tarefas com recursos avançados de agendamento, dependência, campo personalizado e chat do que a superfície da API do Planner existente.

Trabalho em equipe e comunicação | Sistema de mensagens

O método getAllRetainedMessages foi atualizado para documentar o suporte para versões de mensagens de canal privado retidas capturadas após a conclusão da migração de armazenamento de canal privado do locatário.

Contribuir com o Microsoft Graph

Existem cenários em que você gostaria que o Microsoft Graph oferecesse suporte?

  • Sugira e vote 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 dos clientes e lança novos recursos para os pontos de extremidade beta (https://graph.microsoft.com/beta) e v1.0 (https://graph.microsoft.com/v1.0).

  • Participe da chamada semanal da comunidade da plataforma Microsoft 365 e torne-se um membro ativo da comunidade do Microsoft Graph. Para descobrir o calendário completo de chamadas para desenvolvedores, visite a página da comunidade do Microsoft 365 e do Power Platform.

  • Participe do nosso painel de pesquisa para fornecer sua opinião sobre nossas experiências para desenvolvedores.

Conteúdo relacionado

  • Última atualização em