Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die Links zu freigegebenen Dateien und Ordnern in OneDrive und SharePoint sind jetzt kürzer und verfügen über ein neues Format. Das folgende Beispiel zeigt das alte und neue Format für einen OneDrive-Link, der für jeden innerhalb der Organisation geeignet ist.
Hinweis
Links, die vor der Einführung dieser Änderung freigegeben wurden, sind von dieser Änderung nicht betroffen und funktionieren weiterhin.
Das neue Linkformat kann sich auf Anwendungen oder Dienste auswirken, die Abhängigkeiten von OneDrive- oder SharePoint-URL-Strukturen untersuchen oder annehmen, insbesondere wenn diese Anwendungen oder Dienste die Website-URL oder bestimmte Zeichenfolgen analysieren. Die neuen kurzen Links sind mit allen APIs kompatibel, die mit guestaccess.aspx
Links funktionieren.
Nachfolgend sind einige Szenarien aufgeführt, die von dieser Änderung betroffen sind:
Programme, die eine URL-Eingabe durch einen Endbenutzer analysieren, um die URL der Website zu erhalten und SharePoint-REST-API-Anforderungen, wie z. B. GetFileByUrl oder GetSharingLinkData, zu erstellen.
Programme, die die URL-Eingabe eines Endbenutzers übernehmen und CSOM verwenden, um Dateiinformationen abzurufen.
Programme, die die URL-Eingabe eines Endbenutzers analysieren, um festzustellen, ob es sich um einen anonymen oder einen ausschließlich internen Freigabelink handelt.
Apps, die Microsoft Graph für die Interaktion mit SharePoint-Links verwenden, funktionieren weiterhin. Weitere Informationen finden Sie unter Zugreifen auf freigegebene DriveItems.
REST-API für SharePoint
Die SharePoint-REST-API verfügt nicht über eine unterstützte Möglichkeit zur Interaktion mit Benutzereingabelinks. Es wird empfohlen, nach Möglichkeit zur Microsoft Graph-Freigabe-API zu migrieren.
Wenn Sie nicht zu Microsoft Graph migrieren können, können Sie die folgende Problemumgehung verwenden. Beachten Sie, dass diese Problemumgehung nicht unterstützt wird.
Bestimmen Sie die Basis-URL. Dies ist jetzt der Hostname des Links.
Erstellen Sie die API-Anfrage durch das Verketten der Basis-URL,
SP.RemoteWeb
, und eine bestimmte API-Methode, wie dargestellt.{hostname}/_api/SP.RemoteWeb(@a)/web/{specific_api_here}?@a='{url_encoded_link}'
Zum Beispiel für die folgende Eingabe-URL:
https://contoso-my.sharepoint.com/personal/john_contoso_com/_layouts/15/guestaccess.aspx?share=ERGZUIZ8E0pAuC1oJtwz4dQB23IabPgbMtiVe0OLPtMybw
Dies ist die ursprüngliche API-Anforderung:
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
Dies ist die neue API-Anforderung:
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
Um den spezifischen Linktyp zu bestimmen, überprüfen Sie die IsSharingLink
Felder und IsAnonymous
in der Antwort für die GetSharingLinkData-API (ersetzen Sie in den Beispielen GetFileByUrl durch GetSharingLinkData ). Verwenden Sie diese Methode, anstatt URLs für Token wie guestaccess.aspx
zu analysieren.
SharePoint-CSOM
CSOM verfügt nicht über eine unterstützte Möglichkeit zur Interaktion mit Benutzereingabelinks. Einige Anwendungen öffnen einen ClientContext und fragen die Dateimetadaten ab, indem pfadsegmente aus dem SharePoint-Link nacheinander abgeschnitten werden, bis der ClientContext-Konstruktor erfolgreich ist. Dieser Ansatz funktioniert nicht mehr mit dem neuen URL-Format.
So umgehen Sie dieses Problem:
Öffnen Sie einen ClientContext auf der Stammwebsite (scheme://hostname).
Rufen Sie
Web.WebUrlFromPageUrlDirect()
ab, um die Web-URL des Links zu erhalten.Öffnen Sie mit dieser Web-URL einen neuen ClientContext, um eine zusätzliche Anforderung auszuführen.
Hinweis
Dieser Ansatz wird nicht unterstützt.