Compartilhar via

Obter mensagens do Outlook em uma pasta compartilhada ou delegada

O Outlook permite que os clientes compartilhem pastas de e-mail entre si e forneçam acesso de "leitura", "criação", "modificação" ou "exclusão" a pastas individuais. O Outlook também permite que um cliente delegue outro usuário para agir em nome do cliente e acesse pastas de correio específicas ou toda a caixa de correio do cliente; isso também é conhecido como "delegação" no Outlook.

Através de programação, o Microsoft Graph suporta a obtenção de mensagens em pastas de correio que foram partilhadas por outros utilizadores e a obtenção das próprias pastas partilhadas. O suporte também se aplica a pastas delegadas.

Por exemplo, o Garth partilhou e deu acesso de leitura à sua Caixa de Entrada ao João. Se o João iniciar sessão na sua aplicação e fornecer permissões delegadas (Mail.Read.Shared ou Mail.ReadWrite.Shared), a sua aplicação acede ao correio da Garth e à Caixa de Entrada do Garth, conforme descrito neste artigo.

Permissões do Microsoft Graph

Use as permissões delegadas, Mail.Read.Shared ou Mail.ReadWrite.Shared, para ler ou gravar mensagens em uma pasta compartilhada ou delegada.

Estas duas permissões não suportam a subscrição de notificações de alteração em itens em pastas partilhadas ou delegadas. Para configurar assinaturas de notificação de alteração de mensagens em uma pasta de correio compartilhada, delegada, ou de qualquer outra pasta de correio de usuário no locatário, use a permissão do aplicativo,

Saiba mais em permissões de correio.

Obtenha uma mensagem na pasta compartilhada

Você pode obter uma mensagem específica na caixa de entrada do Henrique:

GET users/{Garth-userId | Garth-userPrincipalName}/mailfolders('Inbox')/messages/{id}

Após a conclusão bem-sucedida, obtém HTTP 200 OK e a instância de mensagem identificada pela {id} Caixa de Entrada do Garth.

Obter todas as mensagens na pasta compartilhada

Obtenha todas as mensagens na caixa de entrada do Henrique:

GET users/{Garth-userId | Garth-userPrincipalName}/mailfolders('Inbox')/messages

Após a conclusão bem-sucedida, obtém HTTP 200 OK e uma coleção de instâncias de mensagens na Caixa de Entrada do Garth.

Obter a pasta compartilhada

Obtenha a pasta (caixa de entrada) que Henrique compartilhou com Diogo.

GET users/{Garth-userId | Garth-userPrincipalName}/mailfolders('Inbox')

Após a conclusão bem-sucedida, obtém HTTP 200 OK e uma instância mailFolder que representa a pasta Caixa de Entrada do Garth.

Os mesmos recursos de GET se aplicam se Henrique delegar a Diogo mais acesso à sua caixa de entrada ou se Henrique delegar toda a sua caixa de correio a Diogo.

Se o Garth não tiver partilhado a sua Caixa de Entrada com o João, nem tiver delegado a sua caixa de correio ao João, especificar o ID de utilizador ou o nome principal de utilizador do Garth nessas operações GET devolve um erro.

Próximas etapas

  • Last updated on