Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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:
- Obtenha uma lista de caixas de correio que pertencem a um usuário específico.
- 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. - Exportar itens de uma caixa de correio.
- Crie ou atualize pastas de caixa de correio.
- 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.