Microsoft Graph REST API を介した SharePoint REST 操作
従来の SharePoint REST API ドキュメントを探している場合は、「SharePoint REST エンドポイントを使用して基本的な操作を完了する」を参照してください。
SharePoint Onlineの場合、SharePoint に対して REST API を使用するイノベーションは、Microsoft Graph REST API を介して推進されます。 ソリューションが SharePoint コンテンツにアクセスするために利用可能なアクセス トークンを既に持っているシナリオでは、Microsoft Graph API 経由で呼び出す代わりに、SharePoint 内で REST API へとネイティブにアクセスすることができます。
以下は、SharePoint Online によってサポートされる Microsoft Graph エンドポイントのセットの概要を示す表です。
| Graph URL | SharePoint URL |
|---|---|
https://graph.microsoft.com/v1.0/sites |
https://{tenant-name}.sharepoint.com/_api/v2.0/sites |
https://graph.microsoft.com/v1.0/drives |
https://{tenant-name}.sharepoint.com/_api/v2.0/drives |
https://graph.microsoft.com/v1.0/drive |
https://{tenant-name}.sharepoint.com/_api/v2.0/drive |
https://graph.microsoft.com/v1.0/lists |
https://{tenant-name}.sharepoint.com/_api/v2.0/lists |
ソリューションで既に他の Microsoft Graph REST API を使用している場合、コード管理を容易にするために、Microsoft Graph REST エンドポイントを介して API を呼び出すことをお勧めします。
Microsoft Graph REST API 呼び出しが SharePoint Online によってサポートされているかどうかを判断するには、クエリの最後に$whatifを追加して、基になる SharePoint URLを出力します。