Obter contatos do Outlook em uma pasta compartilhada

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

O Microsoft Graph oferece suporte de forma programática à obtenção de contatos em pastas de contatos que foram compartilhadas por outros usuários, além de receber as pastas compartilhadas em si. O suporte também se aplica a pastas em uma caixa de correio delegada.

Por exemplo, Henrique compartilhou com Diogo uma pasta de contatos personalizada e deu a ele acesso de leitura. Se John tiver entrado em seu aplicativo e fornecido permissões delegadas (Contacts.Read.Shared ou Contacts.ReadWrite.Shared), seu aplicativo poderá acessar a pasta de contatos personalizados de Garth e os contatos nessa pasta. Para obter detalhes, consulte as seções a seguir.

Observação

As permissões de compartilhamento (Contacts.Read.Shared ou Contacts.ReadWrite.Shared) permitem que você leia ou grave contatos em uma pasta compartilhada ou delegada. Eles não têm suporte subscrever alterar notificações em itens nessas pastas. Para configurar as assinaturas de notificação de alteração nos contatos na pasta de contatos compartilhada, representante ou qualquer outra de um usuário no locatário, use a permissão de aplicativo Contacts.Read.

Obter um contato na pasta compartilhada

Você pode obter um contato específico na pasta de contatos personalizada que Henrique compartilhou com Diogo:

GET users/{Garth-userId | Garth-userPrincipalName}/contactFolders/{folder-id}/contacts/{id}

Após a conclusão bem-sucedida, você receberá HTTP 200 OK e a instância de contact identificada por {id} da pasta de contatos compartilhada de Henrique.

Obter todos os contatos na pasta compartilhada

Obtenha todos os contatos na pasta de contatos compartilhada do Henrique:

GET users/{Garth-userId | Garth-userPrincipalName}/contactFolders/{folder-id}/contacts

Após a conclusão bem-sucedida, você receberá HTTP 200 OK e uma coleção de instâncias de contact na pasta de contatos compartilhada de Henrique.

Obter a pasta compartilhada

Obtenha a pasta de contatos que Henrique compartilhou com Diogo.

GET users/{Garth-userId | Garth-userPrincipalName}/contactFolders/{folder-id}

Após a conclusão bem-sucedida, você receberá HTTP 200 OK e uma instância de contactFolder que representa a pasta de contatos compartilhada de Henrique.

As mesmas funcionalidades GET se aplicariam se Henrique tivesse delegado a Diogo toda a sua caixa de correio.

Se Garth não compartilhou a pasta de contatos com John, nem delegou sua caixa de correio a John, especificar a ID de usuário ou o nome principal do usuário de Garth nessas operações GET retornará um erro.

Próximas etapas

Saiba mais sobre:

  • Last updated on