Compartir a través de

Formato de vínculo para compartir más corto en OneDrive y SharePoint

Los vínculos a archivos y carpetas compartidos en OneDrive y SharePoint ahora son más cortos y tienen un formato nuevo. Por ejemplo, a continuación se muestra el formato antiguo y nuevo de un vínculo de OneDrive que funciona para cualquier persona dentro de la organización.


Formato de vínculo anterior Nuevo formato de vínculo
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

Nota:

Los vínculos que se compartieron antes de introducir este cambio no se verán afectados y seguirán funcionando.

El nuevo formato de vínculo puede afectar a las aplicaciones o servicios que inspeccionan o toman dependencias en las estructuras de direcciones URL de OneDrive o SharePoint, especialmente si esas aplicaciones o servicios analizan la dirección URL del sitio o cadenas específicas. Los nuevos vínculos cortos son compatibles con todas las API que funcionan con guestaccess.aspx vínculos.

Estos son algunos escenarios afectados por este cambio:

  • Las aplicaciones que analizan una entrada de URL por un usuario final para obtener la URL del sitio con el fin de crear solicitudes API de REST de SharePoint, como GetFileByUrl o GetSharingLinkData.

  • Las aplicaciones que admiten la entrada de URL de un usuario final y usan CSOM para intentar consultar la información de un archivo.

  • Las aplicaciones que analizan una entrada de URL por un usuario final para determinar si es un vínculo para compartir anónimo o solo de uso interno.

Las aplicaciones que usan Microsoft Graph para interactuar con vínculos de SharePoint seguirán funcionando. Para obtener más información, vea Acceso a DriveItems compartidos.

API de REST de SharePoint

La API REST de SharePoint no tiene una manera compatible de interactuar con los vínculos de entrada de usuario. Se recomienda migrar a la API de recursos compartidos de Microsoft Graph si es posible.

Si no puede migrar a Microsoft Graph, puede usar la siguiente solución alternativa. Tenga en cuenta que esta solución alternativa no es compatible.

  1. Determine la dirección URL base. Este es ahora el nombre de host del vínculo.

  2. Para crear la solicitud API, concatene la URL base (SP.RemoteWeb) y un método API específico, como se muestra en el ejemplo.

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

Por ejemplo, para la siguiente URL de entrada:

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

Esta es la solicitud API original:

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

Esta es la nueva solicitud 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

Para determinar el tipo específico de vínculo, inspeccione los IsSharingLink campos y IsAnonymous de la respuesta para obtener la API GetSharingLinkData (reemplace GetFileByUrl por GetSharingLinkData en los ejemplos). Use este método en lugar de analizar direcciones URL para tokens como guestaccess.aspx.

CSOM de SharePoint

CSOM no tiene una manera compatible de interactuar con los vínculos de entrada de usuario. Algunas aplicaciones abren un ClientContext y consultan los metadatos del archivo truncando sucesivamente los segmentos de ruta de acceso desde el vínculo de SharePoint hasta que el constructor ClientContext se realice correctamente. Este enfoque ya no funciona con el nuevo formato de dirección URL.

Para solucionar este problema:

  1. Abra un elemento ClientContext en el sitio raíz (esquema://nombre de host).

  2. Realice una llamada a Web.WebUrlFromPageUrlDirect() para obtener la URL de web del vínculo.

  3. Abra un nuevo elemento ClientContext con esta URL de web para realizar solicitudes adicionales.

Nota:

Este método no recibe soporte técnico.