Partager via

Format raccourci du lien de partage dans OneDrive et SharePoint

Dans OneDrive et SharePoint, les liens vers des fichiers et des dossiers partagés sont désormais présentés sous un format plus court. Par exemple, le tableau suivant présente l’ancien format et le nouveau format des liens OneDrive qui fonctionnent pour toutes les personnes de l’organisation.


Ancien format des liens Nouveau format
https://contoso-my.sharepoint.com/personal/john_contoso_com/_layouts/15/guestaccess.aspx?share=ERGZUIZ8E0pAuC1oJtwz4dQB23IabPgbMtiVe0OLPtMybw https://contoso-my.sharepoint.com/:w:/p/john_contoso_com/ERGZUIZ8E0pAuC1oJtwz4dQB23IabPgbMtiVe0OLPtMybw

Remarque

Les liens partagés avant ce changement ne sont pas concernés et continueront de fonctionner.

Le nouveau format des liens risque d’affecter les applications ou les services qui inspectent ou possèdent des dépendances sur les structures URL de OneDrive ou SharePoint, en particulier si ces applications ou services analysent l’URL du site ou certaines chaînes. Les nouveaux liens raccourcis sont compatibles avec toutes les API qui fonctionnent avec les liens guestaccess.aspx.

Les scénarios suivants sont concernés par ce changement :

  • Les applications qui analysent une URL entrée par un utilisateur final pour obtenir l’URL du site et construire des demandes d’API REST SharePoint, telles que GetFileByUrl ou GetSharingLinkData.

  • Les applications qui prennent l’URL entrée par un utilisateur final et utilisent le modèle CSOM pour tenter d’interroger les informations des fichiers.

  • Les applications qui analysent une URL entrée par un utilisateur final pour déterminer s’il s’agit d’un lien de partage anonyme ou à usage interne uniquement.

Les applications qui utilisent Microsoft Graph pour interagir avec les liens SharePoint continueront de fonctionner. Pour en savoir plus, consultez l’article Accès aux objets DriveItem partagés.

API REST SharePoint

L’API REST SharePoint n’a aucun moyen pris en charge d’interagir avec les liens entrés par l’utilisateur. Nous vous recommandons de migrer vers l’API Shares de Microsoft Graph si possible.

Si vous ne pouvez pas migrer vers Microsoft Graph, optez pour la solution suivante. Notez que cette solution n’est pas prise en charge.

  1. Déterminez l’URL de base. Il s’agit désormais du nom d’hôte du lien.

  2. Construisez la demande d’API en concaténant l’URL de base, SP.RemoteWeb et une méthode d’API spécifique :

    {hostname}/_api/SP.RemoteWeb(@a)/web/{specific_api_here}?@a='{url_encoded_link}'

Par exemple, pour l’URL d’entrée suivante :

https://contoso-my.sharepoint.com/personal/john_contoso_com/_layouts/15/guestaccess.aspx?share=ERGZUIZ8E0pAuC1oJtwz4dQB23IabPgbMtiVe0OLPtMybw

Il s’agit de la demande d’API d’origine :

https://contoso-my.sharepoint.com/personal/john_contoso_com/_api/web/GetFileByUrl(@url)?@url='https%3A%2F%2Fcontoso-my.sharepoint.com%2Fpersonal%2Fjohn_contoso_com%2F_layouts%2F15%2Fguestaccess.aspx%3Fshare%3DERGZUIZ8E0pAuC1oJtwz4dQB23IabPgbMtiVe0OLPtMybw

Il s’agit de la nouvelle demande d’API :

https://contoso-my.sharepoint.com/_api/SP.RemoteWeb(@url)/web/GetFileByUrl(@url)?@url='https%3A%2F%2Fcontoso-my.sharepoint.com%2Fpersonal%2Fjohn_contoso_com%2F_layouts%2F15%2Fguestaccess.aspx%3Fshare%3DERGZUIZ8E0pAuC1oJtwz4dQB23IabPgbMtiVe0OLPtMybw

Pour déterminer le type spécifique du lien, inspectez les champs IsSharingLink et IsAnonymous dans la réponse de l’API GetSharingLinkData (remplacez GetFileByUrl par GetSharingLinkData dans les exemples). Employez cette méthode au lieu de rechercher des jetons dans les URL, tels que guestaccess.aspx.

Modèle CSOM SharePoint

Le modèle CSOM n’a aucun moyen pris en charge d’interagir avec les liens entrés par l’utilisateur. Certaines applications ouvrent un objet ClientContext et interrogent les métadonnées du fichier en tronquant successivement les segments de chemin d’accès du lien SharePoint jusqu’à ce que le constructeur ClientContext réussisse. Cette approche ne fonctionne plus avec le nouveau format d’URL.

Pour contourner ce problème :

  1. Ouvrez un objet ClientContext sur le site racine (scheme://hostname).

  2. Appelez Web.WebUrlFromPageUrlDirect() pour obtenir l’URL web du lien.

  3. Ouvrez un nouvel objet ClientContext à l’aide de cette URL web pour effectuer des demandes supplémentaires.

Remarque

Cette approche n’est pas prise en charge.