Obtenir des contacts Outlook dans un dossier partagéGet Outlook contacts in a shared folder

Outlook permet aux clients de partager des dossiers au sein de leur organisation et d’autoriser un accès en lecture, en création, en modification ou en suppression à des dossiers de contacts individuels.Outlook lets customers share folders with one another and provide "read", "create", "modify", or "delete" access to individual contact folders. Outlook permet également à un client de déléguer à un autre utilisateur la possibilité d’agir à sa place, ainsi que d’accéder à des dossiers spécifiques ou à l’intégralité de sa boîte aux lettres. Cette opération est également appelée « délégation » dans Outlook.Outlook also allows a customer to delegate another user to act on the customer's behalf, and access specific folders or the customer's entire mailbox; this is also known as "delegation" in Outlook.

Microsoft Graph prend en charge par programme l’obtention de contacts dans des dossiers de contacts partagés par d’autres utilisateurs, ainsi que l’obtention des dossiers partagés proprement dits.Programmatically, Microsoft Graph supports getting contacts in contact folders that have been shared by other users, as well as getting the shared folders themselves. La prise en charge s’applique également aux dossiers d’une boîte aux lettres déléguée.The support also applies to folders in a delegated mailbox.

Par exemple, Garth a partagé avec John un dossier de contacts personnalisé et a attribué John l’accès en lecture.As an example, Garth has shared with John a custom contact folder and given John read access. Si John s’est connecté à votre application et a fourni des autorisations déléguées (Contacts.Read.Shared or Contacts.ReadWrite.Shared), votre application peut accéder au dossier de contacts personnalisé de Garth ainsi qu’aux contacts figurant dans celui-ci comme décrit ci-dessous.If John has signed into your app and provided delegated permissions (Contacts.Read.Shared or Contacts.ReadWrite.Shared), your app will be able to access Garth's custom contact folder and contacts in that folder as described below.

Remarque : les autorisations de partage (Contacts.Read.Shared ou Contacts.ReadWrite.Shared) vous permettent de lire ou d’écrire des contacts dans un dossier partagé ou délégué.Note The sharing permissions (Contacts.Read.Shared or Contacts.ReadWrite.Shared) allow you to read or write contacts in a shared or delegated folder. Elles ne prennent pas en charge l’abonnement aux notifications de modifications sur les éléments dans ces dossiers.They do not support subscribing to change notifications on items in such folders. Pour configurer les abonnements aux notifications de modifications sur les contacts dans un dossier de contacts partagé, délégué ou tout autre dossier de contacts utilisateur dans le client, utilisez l’autorisation d’application Contacts.Read.To set up change notification subscriptions on contacts in a shared, delegated, or any other user's contact folder in the tenant, use the application permission, Contacts.Read.

Obtenir un contact dans le dossier partagéGet a contact in the shared folder

Vous pouvez obtenir un contact spécifique dans le dossier de contacts personnalisé que Garth a partagé avec John :You can get a specific contact in the custom contact folder that Garth has shared with John:

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

Si l’opération réussit, vous recevez le message « HTTP 200 OK » et l’instance contact identifiée par {id} du dossier de contacts partagé de Garth.On successful completion, you'll get HTTP 200 OK and the contact instance identified by {id} from Garth's shared contact folder.

Obtenir tous les contacts dans le dossier partagéGet all contacts in the shared folder

Obtenez tous les contacts du dossier de contacts partagé de Garth :Get all the contacts in Garth's shared contact folder:

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

Si l’opération réussit, vous recevez le message « HTTP 200 OK » et une collection d’instances contact dans le dossier de contacts partagé de Garth.On successful completion, you'll get HTTP 200 OK and a collection of contact instances in Garth's shared contact folder.

Obtenir le dossier partagéGet the shared folder

Obtenez le dossier de contacts que Garth a partagé avec John.Get the contact folder that Garth has shared with John.

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

Si l’opération réussit, vous recevez le message « HTTP 200 OK » et une instance contactFolder représentant le dossier de contacts partagé de Garth.On successful completion, you'll get HTTP 200 OK and a contactFolder instance that represents Garth's shared contact folder.

Les mêmes fonctionnalités GET s’appliquent si Garth a délégué à John sa boîte aux lettres entière.The same GET capabilities apply if Garth had delegated John his entire mailbox.

Si Garth n’a pas partagé le dossier de contacts avec John et ne lui a pas délégué sa boîte aux lettres, un message d’erreur s’affiche en cas de spécification de l’ID utilisateur ou du nom d’utilisateur principal de Garth dans ces opérations GET.If Garth has not shared the contact folder with John, nor has he delegated his mailbox to John, specifying Garth’s user ID or user principal name in those GET operations will return an error.

Étapes suivantesNext steps

Pour en savoir plus, voir :Find out more about: