Obtener contactos de Outlook en una carpeta compartidaGet Outlook contacts in a shared folder

Outlook permite a los clientes compartir carpetas entre ellos y proporcionar acceso de "lectura", "creación", "edición" o "eliminación" a las carpetas de contactos individuales.Outlook lets customers share folders with one another and provide "read", "create", "modify", or "delete" access to individual contact folders. Outlook también permite a un cliente delegar en otro usuario en nombre del cliente y tener acceso a carpetas de correo específico o a todo buzón del cliente; esto también se denomina "delegación" en 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.

Mediante programación, Microsoft Graph admite la recepción de mensajes en carpetas de correo que han compartido otros usuarios, así como obtener esas carpetas compartidas.Programmatically, Microsoft Graph supports getting contacts in contact folders that have been shared by other users, as well as getting the shared folders themselves. El soporte también se aplica a los archivos en un buzón de correo delegado.The support also applies to folders in a delegated mailbox.

Por ejemplo, Juan ha compartido con Miguel una carpeta de contactos personalizada y le ha concedido el acceso de lectura.As an example, Garth has shared with John a custom contact folder and given John read access. Si Miguel ha iniciado sesión en la aplicación y ha proporcionado permisos delegados (Contacts.Read.Shared o Contacts.ReadWrite.Shared), la aplicación podrá acceder a la carpeta de contactos personalizada de Juan y a los contactos en dicha carpeta, tal y como se describe a continuación.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.

Nota Los permisos de uso compartidos (Contacts.Read.Shared o Contacts.ReadWrite.Shared) le permiten leer o escribir contactos en una carpeta compartida o delegada.Note The sharing permissions (Contacts.Read.Shared or Contacts.ReadWrite.Shared) allow you to read or write contacts in a shared or delegated folder. No admiten la suscripción a notificaciones de cambios en elementos de dichas carpetas.They do not support subscribing to change notifications on items in such folders. Para configurar las suscripciones de notificación de cambios a los contactos en una carpeta compartida o delegada, o cualquier otra carpeta de contactos de un usuario en el espacio empresarial, use los permisos de aplicación 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.

Obtener un contacto en la carpeta compartidaGet a contact in the shared folder

Puede obtener un contacto específico en la carpeta de contactos personalizada que Juan ha compartido con Miguel: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}

Cuando se complete correctamente, verá HTTP 200 OK y la instancia de contacto identificada por {id} desde la carpeta de contactos que ha compartido Juan.On successful completion, you'll get HTTP 200 OK and the contact instance identified by {id} from Garth's shared contact folder.

Obtener todos los contactos en la carpeta compartidaGet all contacts in the shared folder

Obtener todos los contactos en la carpeta de contactos que ha compartido Juan:Get all the contacts in Garth's shared contact folder:

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

Cuando se complete correctamente, verá HTTP 200 OK y una colección de instancias contacto en la carpeta de contactos que ha compartido Juan.On successful completion, you'll get HTTP 200 OK and a collection of contact instances in Garth's shared contact folder.

Obtener la carpeta compartidaGet the shared folder

Obtener la carpeta que Juan ha compartido con Miguel.Get the contact folder that Garth has shared with John.

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

Cuando se complete correctamente, verá HTTP 200 OK y la instancia contactFolder que representa la carpeta de contactos que ha compartido Juan.On successful completion, you'll get HTTP 200 OK and a contactFolder instance that represents Garth's shared contact folder.

Las mismas capacidades de "obtener" aplican si Jorge hubiera delegado en Juan todo su buzón.The same GET capabilities apply if Garth had delegated John his entire mailbox.

Si Juan no ha compartido su carpeta de contactos con Miguel ni ha delegado su buzón en él, especificar el identificador de usuario del Juan o el nombre principal de usuario en esas operaciones "obtener" devolverá un error.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.

Pasos siguientesNext steps

Obtenga más información sobre:Find out more about: