Usar as APIs de importação e exportação de caixa de correio no Microsoft Graph

As APIs de importação e exportação de caixa de correio no Microsoft Graph permitem que seu aplicativo importe e exporte conteúdo das caixas de correio do Exchange Online. O conteúdo da caixa de correio pode ser acessado como uma coleção de pastas e itens em um formato consistente, sem a necessidade de gerenciar os metadados ou a estrutura de cada tipo de item individualmente. Esses itens podem ser exportados como um fluxo opaco em fidelidade total (você não pode alterar o fluxo de exportação). As exportações de fidelidade total garantem que, ao importar um item, o Exchange o recrie sem perda de informações.

Essas APIs dão suporte ao acesso a dados nas caixas de correio principais dos usuários e caixas de correio compartilhadas no Exchange Online. Os itens podem ser importados para a mesma caixa de correio ou para outra.

Importante

As APIs de importação e exportação de caixa de correio no Microsoft Graph não foram projetadas para backup e restauração de caixa de correio. Para backup e restauração de caixa de correio no Microsoft 365, consulte Backup do Microsoft 365.

Como usar as APIs de importação e exportação de caixa de correio

As etapas a seguir permitem que seu aplicativo exporte e importe sistematicamente conteúdo das caixas de correio do Exchange:

  1. Obtenha uma lista de caixas de correio que pertencem a um usuário específico.
  2. Descubra o conteúdo da caixa de correio como um conjunto de pastas e itens. Use a propriedade id retornada pelas pastas de Lista como o identificador de pasta para operações de importação e exportação de caixa de correio. Por exemplo, filtre as pastas por classe $filter=type eq 'IPF.Appointment' para localizar pastas de classe de calendário.
  3. Exportar itens de uma caixa de correio.
  4. Crie ou atualize pastas de caixa de correio.
  5. Importe um item para a mesma caixa de correio ou para uma caixa de correio diferente.

Casos de uso comuns

Caso de uso Recurso REST Confira também
Criar, obter, atualizar ou excluir uma pasta de caixa de correio pasta de caixa de correio métodos de mailboxFolder
Obter um ou mais itens de caixa de correio mailboxItem métodos de mailboxItem
Obter delta para pastas mailboxFoldermailboxFolder: delta
Obter delta para itens mailboxItem mailboxItem: delta
Importar ou exportar caixas de correio mailbox Métodos de caixa de correio
Obter uma lista de caixas de correio que pertencem a um usuário exchangeSettings Listar configurações do Exchange

Próximas etapas

Use as APIs de importação e exportação de caixa de correio no Microsoft Graph para importar e exportar conteúdo das caixas de correio do Exchange. Para saber mais:

  • Explore os recursos e os métodos mais úteis para seu cenário.
  • Experimente a API no Explorador do Graph.

Importar um item da caixa de correio do Exchange usando as APIs de importação e exportação de caixa de correio