SharePoint 嵌入式

Microsoft SharePoint Embedded 是一款基於雲端的檔案與文件管理系統，適用於任何應用程式。 SharePoint Embedded 是一款僅支援 API 的解決方案，讓應用程式開發者能善用 Microsoft 365 檔案與文件儲存平台的強大功能，適用於任何應用程式，適合企業建置業務線應用程式及 ISV 建置多租戶應用。

此連接器適用於以下產品和區域：

服務	Class	Regions
副駕駛工作室	標準	除下列區域外的所有 Power Automate 區域： - 美國政府（GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部（DoD）
邏輯應用程式	標準	所有 Logic Apps 區域，但下列區域除外： - Azure Government 區域 - Azure 中國區域 - 美國國防部（DoD）
Power Apps	標準	除下列區域外的所有 Power Apps 區域： - 美國政府（GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部（DoD）
Power Automate（自動化服務）	標準	除下列區域外的所有 Power Automate 區域： - 美國政府（GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部（DoD）

連絡人
名稱	Microsoft
URL	https://learn.microsoft.com/en-us/sharepoint/dev/embedded/overview
Email	spe-connector@service.microsoft.com

連接器中繼資料
Publisher	Microsoft
網站	https://learn.microsoft.com/en-us/sharepoint/dev/embedded/overview
隱私策略	https://privacy.microsoft.com/
類別	內容和文件

使用者入門

在你能使用 SharePoint Embedded 連接器之前，你需要建立一個 SharePoint Embedded 應用程式。請參閱 SharePoint 嵌入式文件以了解更多並開始使用。

授權存取 SharePoint 嵌入式連接器

為了讓 SharePoint Embedded 連接器能與租戶中的檔案儲存容器和內容互動，你需要在該租戶的 SharePoint containerTypeRegistration Embedded 連接器應用程式上建立一個applicationPermissionGrant。這讓 SharePoint Embedded 連接器能夠存取租戶中應用程式特定的容器類型。

授予 full 使用 Microsoft Graph API 呼叫的 SharePoint Embedded 連接器應用程式 ID e8e1b0bf-140f-4b8b-8e94-fbe8937fad04delegated 權限。

PUT /storage/fileStorage/containerTypeRegistrations/{containerTypeId}/applicationPermissionGrants/e8e1b0bf-140f-4b8b-8e94-fbe8937fad04
Content-Type: application/json
{
  "delegatedPermissions": ["full"],
  "applicationPermissions": ["none"]
}

請參考 Create fileStorageContainerTypeAppPermissionGrant API 參考文章以了解更多。

已知問題和限制

建立檔案任務的最大支援檔案大小為 10MB
連接器無法建立容器
只支援委派授權

動作

列出回收容器	列出回收容器
列出回收物品	此操作列出 SharePoint 嵌入式容器回收筒中的項目。
列出容器	列出容器
列出容器欄位	列出定義容器結構的欄位
列出容器權限	在容器上列出權限
列表檔案欄位	此操作取得與 SharePoint Embedded 容器中檔案相關的清單項目欄位（元資料）。
列表檔案版本	此操作會列出 SharePoint Embedded 容器中檔案的先前版本。
列表縮圖	此操作會列出 SharePoint Embedded 容器中檔案的可用縮圖。
刪除分享權限	此操作會刪除 SharePoint Embedded 容器中檔案的特定分享權限。
刪除回收容器	永久刪除回收容器
刪除回收物品	此操作會永久刪除 SharePoint 嵌入式容器的回收站中一個或多個回收項目。
刪除容器	刪除容器
刪除容器欄位	刪除定義容器結構的欄位
刪除容器權限	刪除容器上的權限
刪除檔案	此操作會刪除 SharePoint 內嵌容器中的檔案。
刪除檔案版本	此操作會刪除 SharePoint Embedded 容器中特定版本的檔案。
取出檔案	此操作會檢查 SharePoint Embedded 容器中的檔案，防止他人編輯該文件。
取得分享權限	此操作會獲得 SharePoint Embedded 容器中檔案的特定分享權限。
取得容器欄	拿一欄容器
取得容器自訂屬性	取得容器的自訂屬性
取得檔案內容	此作業會取得檔案的內容。
取得檔案屬性	此操作取得 SharePoint Embedded 容器中檔案的屬性。
取得檔案版本	此操作會取得 SharePoint Embedded 容器中特定版本的檔案。
取得縮圖	此操作會獲得 SharePoint Embedded 容器中檔案的特定縮圖。
啟動容器	啟動一個容器
回收容器修復	修復回收容器
回收物品的回收	此操作會從 SharePoint 嵌入式容器的回收站中恢復一個或多個回收項目。
容器中的項目清單	此操作取得容器中檔案與子資料夾的清單。
建立分享連結	此操作會為 SharePoint Embedded 容器中的檔案建立分享連結。
建立容器欄位	建立一欄來定義容器的結構
建立容器權限	在容器上建立權限
建立檔案	此操作建立檔案並回傳 driveItem 的元資料。
建立檔案預覽	此操作會在 SharePoint Embedded 容器中建立檔案預覽。
建立資料夾	此操作會在 SharePoint Embedded 容器中建立一個新資料夾，該資料夾可位於根目錄層或其他資料夾中。
找一個容器	找一個容器
捨棄簽出	此操作會捨棄 SharePoint Embedded 容器中檔案的借出。
更新容器	更新容器
更新容器權限	更新容器的權限
更新容器自訂屬性	更新容器的自訂屬性
更新檔案內容	此操作會更新檔案內容。
清單項目共享權限	此操作列出 SharePoint Embedded 容器中項目的共享權限。
發送分享邀請	此操作會發送一份分享邀請，邀請 SharePoint Embedded 容器中的檔案。
簽入檔案	這個操作會檢查一個已經在 SharePoint Embedded 容器中被借出的檔案。
設定檔案欄位	此操作更新與 SharePoint Embedded 容器中檔案相關的清單項目欄位（元資料）。使用空值來清除欄位值。
重新命名檔案	此操作將 SharePoint Embedded 容器中的檔案重新命名。

列出回收容器

作業識別碼：: ListRecycledContainers

列出回收容器

參數

名稱	機碼	必要	類型	Description
容器類型識別碼	containerType	True	string	列出指定容器類型的回收容器

傳回

身體: FileStorageContainer.List

列出回收物品

作業識別碼：: ListRecycledFiles

此操作列出 SharePoint 嵌入式容器回收筒中的項目。

參數

名稱	機碼	必要	類型	Description
容器識別碼	container-id	True	string	容器的唯一識別碼

傳回

回收桶裡的物品集合

身體: RecycleBinItemCollection

列出容器

作業識別碼：: ListContainers

列出容器

參數

名稱	機碼	必要	類型	Description
容器類型識別碼	containerType	True	string	列出指定容器類型的容器

傳回

身體: FileStorageContainer.List

列出容器欄位

作業識別碼：: ListContainerColumns

列出定義容器結構的欄位

參數

名稱	機碼	必要	類型	Description
容器識別碼	container-id	True	string	容器識別碼
Filter	$filter		string	對結果套用的過濾器

傳回

身體: FileStorageContainer.Columns.List

列出容器權限

作業識別碼：: ListPermissions

在容器上列出權限

參數

名稱	機碼	必要	類型	Description
容器識別碼	container-id	True	string	容器識別碼

傳回

身體: FileStorageContainer.Permissions.List

列表檔案欄位

作業識別碼：: ListFileFields

此操作取得與 SharePoint Embedded 容器中檔案相關的清單項目欄位（元資料）。

參數

名稱	機碼	必要	類型	Description
容器識別碼	container-id	True	string	容器的唯一識別碼
檔案識別碼	file-id	True	string	檔案的唯一識別碼

傳回

名稱	路徑	類型	Description
Etag	@odata.etag	string	場的ETag值

列表檔案版本

作業識別碼：: ListFileVersions

此操作會列出 SharePoint Embedded 容器中檔案的先前版本。

參數

名稱	機碼	必要	類型	Description
容器識別碼	container-id	True	string	容器的唯一識別碼
檔案識別碼	file-id	True	string	檔案的唯一識別碼

傳回

代表檔案版本的集合

身體: FileVersions

列表縮圖

作業識別碼：: ListFileThumbnails

此操作會列出 SharePoint Embedded 容器中檔案的可用縮圖。

參數

名稱	機碼	必要	類型	Description
容器識別碼	container-id	True	string	容器的唯一識別碼
檔案識別碼	file-id	True	string	檔案的唯一識別碼

傳回

代表一組縮圖集合

身體: ThumbnailSets

刪除分享權限

作業識別碼：: DeleteSharingPermission

此操作會刪除 SharePoint Embedded 容器中檔案的特定分享權限。

參數

名稱	機碼	必要	類型	Description
容器識別碼	container-id	True	string	容器的唯一識別碼
檔案識別碼	file-id	True	string	檔案的唯一識別碼
許可識別碼	permission-id	True	string	刪除權限的唯一識別碼

刪除回收容器

作業識別碼：: DeleteContainer

永久刪除回收容器

參數

名稱	機碼	必要	類型	Description
容器識別碼	container-id	True	string	容器識別碼

刪除回收物品

作業識別碼：: PermanentDeleteRecycledFiles

此操作會永久刪除 SharePoint 嵌入式容器的回收站中一個或多個回收項目。

參數

名稱	機碼	必要	類型	Description
容器識別碼	container-id	True	string	容器的唯一識別碼
項目 ID	ids	True	array of string	回收物品 ID 陣列以永久刪除

刪除容器

作業識別碼：: RecycleContainer

刪除容器

參數

名稱	機碼	必要	類型	Description
容器識別碼	container-id	True	string	容器識別碼

刪除容器欄位

作業識別碼：: DeleteContainerColumn

刪除定義容器結構的欄位

參數

名稱	機碼	必要	類型	Description
容器識別碼	container-id	True	string	容器識別碼
欄位識別碼	column-id	True	string	欄位識別碼

刪除容器權限

作業識別碼：: DeletePermission

刪除容器上的權限

參數

名稱	機碼	必要	類型	Description
容器識別碼	container-id	True	string	容器識別碼
許可識別碼	permission-id	True	string	權限ID

刪除檔案

作業識別碼：: DeleteFile

此操作會刪除 SharePoint 內嵌容器中的檔案。

參數

名稱	機碼	必要	類型	Description
容器識別碼	container-id	True	string	容器的唯一識別碼
檔案識別碼	file-id	True	string	檔案的唯一識別碼

刪除檔案版本

作業識別碼：: DeleteFileVersion

此操作會刪除 SharePoint Embedded 容器中特定版本的檔案。

參數

名稱	機碼	必要	類型	Description
容器識別碼	container-id	True	string	容器的唯一識別碼
檔案識別碼	file-id	True	string	檔案的唯一識別碼
版本識別碼	version-id	True	string	要刪除版本的唯一識別碼

取出檔案

作業識別碼：: CheckOutFile

此操作會檢查 SharePoint Embedded 容器中的檔案，防止他人編輯該文件。

參數

名稱	機碼	必要	類型	Description
容器識別碼	container-id	True	string	容器的唯一識別碼
檔案識別碼	file-id	True	string	檔案的唯一識別碼

取得分享權限

作業識別碼：: GetSharingPermission

此操作會獲得 SharePoint Embedded 容器中檔案的特定分享權限。

參數

名稱	機碼	必要	類型	Description
容器識別碼	container-id	True	string	容器的唯一識別碼
檔案識別碼	file-id	True	string	檔案的唯一識別碼
許可識別碼	permission-id	True	string	權限的唯一識別碼

傳回

代表檔案或資料夾的權限

身體: SharingPermissionResponse

取得容器欄

作業識別碼：: GetContainerColumn

拿一欄容器

參數

名稱	機碼	必要	類型	Description
容器識別碼	container-id	True	string	容器識別碼
欄位識別碼	column-id	True	string	欄位識別碼

傳回

身體: FileStorageContainer.Column

取得容器自訂屬性

作業識別碼：: GetContainerCustomProperties

取得容器的自訂屬性

參數

名稱	機碼	必要	類型	Description
容器識別碼	container-id	True	string	容器識別碼

傳回

身體: FileStorageContainer.CustomProperties

取得檔案內容

作業識別碼：: GetFileContent

此作業會取得檔案的內容。

參數

名稱	機碼	必要	類型	Description
檔案識別碼	file-id	True	string	檔案的唯一識別碼
容器識別碼	container-id	True	string	容器的唯一識別碼

取得檔案屬性

作業識別碼：: GetFileProperties

此操作取得 SharePoint Embedded 容器中檔案的屬性。

參數

名稱	機碼	必要	類型	Description
容器識別碼	container-id	True	string	容器的唯一識別碼
檔案識別碼	file-id	True	string	檔案的唯一識別碼

傳回

驅動項目元資料

身體: DriveItem

取得檔案版本

作業識別碼：: GetFileVersion

此操作會取得 SharePoint Embedded 容器中特定版本的檔案。

參數

名稱	機碼	必要	類型	Description
容器識別碼	container-id	True	string	容器的唯一識別碼
檔案識別碼	file-id	True	string	檔案的唯一識別碼
版本識別碼	version-id	True	string	版本的唯一識別碼

傳回

代表檔案的一個版本

身體: FileVersion

取得縮圖

作業識別碼：: GetFileThumbnail

此操作會獲得 SharePoint Embedded 容器中檔案的特定縮圖。

參數

名稱	機碼	必要	類型	Description
容器識別碼	container-id	True	string	容器的唯一識別碼
檔案識別碼	file-id	True	string	檔案的唯一識別碼
縮圖 ID	thumbnail-id	True	string	縮圖集的唯一識別碼
大小	size	True	string	縮圖大小

傳回

代表單一縮圖

身體: Thumbnail

啟動容器

作業識別碼：: ActivateContainer

啟動一個容器

參數

名稱	機碼	必要	類型	Description
容器識別碼	container-id	True	string	容器識別碼

回收容器修復

作業識別碼：: RestoreContainer

修復回收容器

參數

名稱	機碼	必要	類型	Description
容器識別碼	container-id	True	string	容器識別碼

傳回

身體: FileStorageContainer

回收物品的回收

作業識別碼：: RestoreRecycledFiles

此操作會從 SharePoint 嵌入式容器的回收站中恢復一個或多個回收項目。

參數

名稱	機碼	必要	類型	Description
容器識別碼	container-id	True	string	容器的唯一識別碼
項目 ID	ids	True	array of string	回收物品 ID 陣列用來還原

傳回

名稱	路徑	類型	Description
value	value	array of object
項目 ID	value.id	string	還原物品的識別碼

容器中的項目清單

作業識別碼：: ListContainerFiles

此操作取得容器中檔案與子資料夾的清單。

參數

名稱	機碼	必要	類型	Description
容器識別碼	container-id	True	string	容器的唯一識別碼
父資料夾識別碼	parentId	True	string	列出項目的父資料夾的 ID。使用「root」來取得容器根層級的項目，或提供特定的資料夾 ID 來取得該資料夾的項目
Filter	$filter		string	結果的篩選條件（OData 格式）例如：parentReference/id eq '{{folderId}}' AND contains（listitem/fields/FileLeafRef， {{user_name_string}}）
選擇	$select		string	結果中應包含的性質（逗號分隔）
展開	$expand		string	相關資源可供擴充回應
頂端	$top		integer	回傳結果數量
排序方式	$orderby		string	欄位與排序方向

傳回

代表一頁磁碟項目。

身體: DriveItemCollectionPage

建立分享連結

作業識別碼：: CreateSharingLink

此操作會為 SharePoint Embedded 容器中的檔案建立分享連結。

參數

名稱	機碼	必要	類型	Description
容器識別碼	container-id	True	string	容器的唯一識別碼
檔案識別碼	file-id	True	string	檔案的唯一識別碼
連結類型	type	True	string	分享連結的類型。
連結範圍	scope		string	分享連結的範圍
到期日期	expirationDateTime		date-time	連結到期的日期和時間（yyyy-mm-ddTHH：mm：ssZ）

傳回

代表檔案或資料夾的分享連結

身體: SharingLink

建立容器欄位

作業識別碼：: CreateContainerColumn

建立一欄來定義容器的結構

參數

名稱	機碼	必要	類型	Description
容器識別碼	container-id	True	string	容器識別碼
			object

傳回

身體: FileStorageContainer.Column

建立容器權限

作業識別碼：: CreatePermission

在容器上建立權限

參數

名稱	機碼	必要	類型	Description
容器識別碼	container-id	True	string	容器識別碼
權限角色	roles	True	array of string	將被賦予使用者的角色
使用者主體名稱	userPrincipalName	True	string	身份使用者主體名稱

傳回

身體: FileStorageContainer.Permission

建立檔案

作業識別碼：: CreateFile

此操作建立檔案並回傳 driveItem 的元資料。

參數

名稱	機碼	必要	類型	Description
父 ID	parent-id	True	string	磁碟項目的 ID 是父資料夾，也就是「根目錄」
容器識別碼	container-id	True	string	容器的唯一識別碼
檔案名稱	file-name	True	string	檔名
檔案內容（Base64）	body	True	byte	Base64 編碼的檔案內容

傳回

驅動項目元資料

身體: DriveItem

建立檔案預覽

作業識別碼：: CreateFilePreview

此操作會在 SharePoint Embedded 容器中建立檔案預覽。

參數

名稱	機碼	必要	類型	Description
容器識別碼	container-id	True	string	容器的唯一識別碼
檔案識別碼	file-id	True	string	檔案的唯一識別碼
頁面	page		integer	指定文件的頁碼以供預覽
縮放等級	zoom		float	指定文件預覽的縮放等級（例如 0.5、1.0、1.5）

傳回

名稱	路徑	類型	Description
取得網址	getUrl	string	一個可以用來透過 GET 請求取得預覽的 URL
貼文參數	postParameters	string	可搭配 postUrl 屬性，透過 POST 請求取得預覽的參數
貼文網址	postUrl	string	一個可用來使用 POST 請求取得預覽的 URL

建立資料夾

作業識別碼：: CreateFolder

此操作會在 SharePoint Embedded 容器中建立一個新資料夾，該資料夾可位於根目錄層或其他資料夾中。

參數

名稱	機碼	必要	類型	Description
容器識別碼	container-id	True	string	容器的唯一識別碼
父資料夾識別碼	parent-id	True	string	新資料夾將建立的父資料夾的 ID。使用「root」在容器根層建立資料夾，或提供特定的資料夾 ID 來建立巢狀資料夾。
資料夾名稱	name	True	string	要建立資料夾的名稱
衝突行為	@microsoft.graph.conflictBehavior		string	如果已經有同名資料夾存在，該怎麼辦

傳回

驅動項目元資料

身體: DriveItem

找一個容器

作業識別碼：: GetContainer

找一個容器

參數

名稱	機碼	必要	類型	Description
容器識別碼	container-id	True	string	容器識別碼

傳回

身體: FileStorageContainer

捨棄簽出

作業識別碼：: DiscardCheckOut

此操作會捨棄 SharePoint Embedded 容器中檔案的借出。

參數

名稱	機碼	必要	類型	Description
容器識別碼	container-id	True	string	容器的唯一識別碼
檔案識別碼	file-id	True	string	檔案的唯一識別碼

更新容器

作業識別碼：: UpdateContainer

更新容器

參數

名稱	機碼	必要	類型	Description
容器識別碼	container-id	True	string	容器識別碼
Description	description		string	容器說明
顯示名稱	displayName		string	容器名稱
啟用 OCR	isOcrEnabled		boolean	容器是否啟用光學字元辨識（OCR）
項目小版本限制	itemMinorVersionLimit		integer	容器中物品可保留的最小版本數量
啟用項目版本控制	isItemVersioningEnabled		boolean	容器是否啟用了項目版本控制

傳回

身體: FileStorageContainer

更新容器權限

作業識別碼：: UpdatePermission

更新容器的權限

參數

名稱	機碼	必要	類型	Description
容器識別碼	container-id	True	string	容器識別碼
許可識別碼	permission-id	True	string	權限ID
權限角色	roles	True	array of string	將被賦予使用者的角色

傳回

身體: FileStorageContainer.Permission

更新容器自訂屬性

作業識別碼：: UpdateContainerCustomProperties

更新容器的自訂屬性

參數

名稱	機碼	必要	類型	Description
容器識別碼	container-id	True	string	容器識別碼
			object

傳回

身體: FileStorageContainer.CustomProperties

更新檔案內容

作業識別碼：: UpdateFileContent

此操作會更新檔案內容。

參數

名稱	機碼	必要	類型	Description
檔案識別碼	file-id	True	string	檔案的唯一識別碼
容器識別碼	container-id	True	string	容器的唯一識別碼
檔案內容（Base64）	body	True	byte	Base64 編碼的檔案內容

傳回

檔案的內容

檔案內容: binary

清單項目共享權限

作業識別碼：: ListSharingPermissions

此操作列出 SharePoint Embedded 容器中項目的共享權限。

參數

名稱	機碼	必要	類型	Description
容器識別碼	container-id	True	string	容器的唯一識別碼
項目 ID	file-id	True	string	項目的唯一識別碼

傳回

代表檔案或資料夾的權限清單

身體: SharingPermissionsList

發送分享邀請

作業識別碼：: SendSharingInvitation

此操作會發送一份分享邀請，邀請 SharePoint Embedded 容器中的檔案。

參數

名稱	機碼	必要	類型	Description
容器識別碼	container-id	True	string	容器的唯一識別碼
檔案識別碼	file-id	True	string	檔案的唯一識別碼
要求登入	requireSignIn	True	boolean	指示邀請收件人是否必須登入才能查看該共享項目
角色	roles	True	array of string	分享邀請收件人所獲得的權限
Email	email		string	收件者的電子郵件地址
Alias	alias		string	收件人的別名（以 Microsoft 365 接收者為例）
物件識別碼	objectId		string	Azure Active Directory 中接收者的唯一識別碼
Message	message	True	string	作為分享邀請函一部分的自訂訊息
傳送邀請	sendInvitation	True	boolean	若屬實，會發送分享連結給收件人。若錯誤，則會建立權限但不會發送邀請訊息。

傳回

代表檔案或資料夾的權限清單

身體: SharingPermissionsList

簽入檔案

作業識別碼：: CheckInFile

這個操作會檢查一個已經在 SharePoint Embedded 容器中被借出的檔案。

參數

名稱	機碼	必要	類型	Description
容器識別碼	container-id	True	string	容器的唯一識別碼
檔案識別碼	file-id	True	string	檔案的唯一識別碼
評論	comment		string	一個與該版本相關的簽到留言
簽入身分	checkInAs		string	報到後的文件狀態（公開或次要）

設定檔案欄位

作業識別碼：: UpdateFileFields

此操作更新與 SharePoint Embedded 容器中檔案相關的清單項目欄位（元資料）。使用空值來清除欄位值。

參數

名稱	機碼	必要	類型	Description
容器識別碼	container-id	True	string	容器的唯一識別碼
檔案識別碼	file-id	True	string	檔案的唯一識別碼
			object

傳回

名稱	路徑	類型	Description
Etag	@odata.etag	string	場的ETag值

重新命名檔案

作業識別碼：: RenameFile

此操作將 SharePoint Embedded 容器中的檔案重新命名。

參數

名稱	機碼	必要	類型	Description
容器識別碼	container-id	True	string	容器的唯一識別碼
檔案識別碼	file-id	True	string	檔案的唯一識別碼
名稱	name		string	檔案的新名稱

傳回

驅動項目元資料

身體: DriveItem

觸發程序

監控容器中的物品變更

當 SharePoint Embedded 容器中新增、修改或刪除項目時觸發

監控容器中的物品變更

作業識別碼：: GetChangesContainer

當 SharePoint Embedded 容器中新增、修改或刪除項目時觸發

參數

名稱	機碼	必要	類型	Description
容器識別碼	container-id	True	string	要監控的容器 ID
投票間隔（秒）	pollingInterval		integer	檢查變更的頻率（60-3600秒，預設：300秒）

傳回

名稱	路徑	類型	Description
value	value	array of DriveItem	變更項目清單
@odata.deltaLink	@odata.deltaLink	string	下一輪輪詢請求的 Delta 連結
@odata.上下文	@odata.context	string	@odata.context

定義

檔案儲存容器

名稱	路徑	類型	Description
容器識別碼	id	string	容器識別碼
容器類型識別碼	containerTypeId	string	該容器所屬容器類型的 ID
Description	description	string	容器說明
顯示名稱	displayName	string	容器名稱
創建時間	createdDateTime	date-time	容器建立日期與時間
customProperties	customProperties	FileStorageContainer.CustomProperties
使用權限	permissions	FileStorageContainer.Permissions
狀態	status	string	貨櫃狀態

FileStorageContainer.List

名稱	路徑	類型	Description
value	value	array of FileStorageContainer

FileStorageContainer.Permissions

名稱	路徑	類型	Description
物品		FileStorageContainer.Permission

FileStorageContainer.Permission

名稱	路徑	類型	Description
許可識別碼	id	string	權限ID
權限角色	roles	FileStorageContainer.Permission.Roles	將被賦予使用者的角色
顯示名稱	grantedToV2.user.displayName	string	身份顯示名稱
Email	grantedToV2.user.email	string	身份電子郵件
使用者主體名稱	grantedToV2.user.userPrincipalName	string	身份使用者主體名稱

FileStorageContainer.Permission.Roles

將被賦予使用者的角色

名稱	路徑	類型	Description
物品		string

FileStorageContainer.Permissions.List

名稱	路徑	類型	Description
value	value	FileStorageContainer.Permissions

FileStorageContainer.CustomProperties

FileStorageContainer.Column

名稱	路徑	類型	Description
欄位識別碼	id	string	欄位的唯一識別碼
欄位名稱	name	string	該柱的展示名稱
Description	description	string	柱狀描述
強制執行獨特價值	enforceUniqueValues	boolean	欄位值是否必須唯一
隱藏	hidden	boolean	欄位是否顯示在使用者介面中
已編製索引	indexed	boolean	欄位是否被索引
為必填項目	required	boolean	欄位是否必要
唯讀	readOnly	boolean	欄位值是否可以被修改
柱群	columnGroup	string	本欄所屬的群組
顯示名稱	displayName	string	該柱的展示名稱
是可刪除的嗎	isDeletable	boolean	表示此欄位是否可刪除。
是否可重新排序	isReorderable	boolean	表示此欄位是否可重新排序。
已封存	isSealed	boolean	規定欄位是否可更改。
傳播變更	propagateChanges	boolean	若為真，該欄位的變更將被傳播至實作該欄位的清單。
預設值欄位 - 公式	defaultValue.formula	string	計算該欄位預設值的公式。
預設值欄位 - 值	defaultValue.value	string	欄位預設值的直接值。
文字欄 - 最大長度	text.maxLength	integer	文字最大長度
文字欄 - 允許多行	text.allowMultipleLines	boolean	是否允許多行文字
文字欄 - 附加變更	text.appendChangesToExistingText	boolean	本專欄的更新是否應該附加於現有文字中
文字欄 - 編輯行數	text.linesForEditing	integer	編輯控制中顯示的文字行數
文字欄 - 文字類型	text.textType	string	所儲存的文字類型
數字欄 - 小數點	number.decimalPlaces	string	顯示多少小數點
數字欄 - 顯示為	number.displayAs	string	如何顯示數字
數字欄 - 最大值	number.maximum	number	最大允許值
編號欄 - 最低值	number.minimum	number	最低允許價值
布爾值	boolean	object	布林欄位設定
DateTime 欄位 - 顯示為	dateTime.displayAs	string	如何顯示日期與時間
DateTime 專欄 - 格式	dateTime.format	string	是否要在日期中加入時間
選擇欄 - 允許文字輸入	choice.allowTextEntry	boolean	是否可以輸入自訂值
選擇欄 - 選擇	choice.choices	array of string	本欄的選擇列表
選擇欄 - 顯示為	choice.displayAs	string	如何顯示選項
查詢欄位 - 允許多個值	lookup.allowMultipleValues	boolean	是否可以選擇多個值
查詢欄位 - 允許無限長度	lookup.allowUnlimitedLength	boolean	欄位中的值是否應該能超過標準的 255 字元限制。
查詢欄位 - List ID	lookup.listId	string	這個查詢的列表ID是從哪裡取得資訊的
查詢欄位 - 主要查詢欄位 ID	lookup.primaryLookupColumnId	string	用來取得資訊的欄位 ID
貨幣欄 - 地點	currency.locale	string	貨幣的發行地
PersonOrGroup 欄位 - 允許多重選擇	personOrGroup.allowMultipleSelection	boolean	是否可以選擇多個人或多個團體
PersonOrGroup 欄位 - 選擇類型	personOrGroup.chooseFromType	string	可以選擇的人群或團體類型
PersonOrGroup 欄位 - 顯示為	personOrGroup.displayAs	string	如何展示人物或團體
超連結或圖片專欄 - 圖片	hyperlinkOrPicture.isPicture	boolean	超連結是否為圖片
計算欄位 - 公式	calculated.formula	string	計算公式
計算欄位 - 輸出類型	calculated.outputType	string	輸出類型
計算欄位 - 格式	calculated.format	string	是否要在日期中加入時間
地理定位柱	geolocation	object	位置欄位設定
縮圖欄位屬性	thumbnail	object	縮圖欄位設定
內容審核狀態欄位屬性	contentApprovalStatus	object	本欄儲存內容審核狀態。
詞彙欄位 - 允許多個值	term.allowMultipleValues	boolean	是否可以選擇多個值
術語欄 - 顯示完全合格的名稱	term.showFullyQualifiedName	boolean	指定顯示整個詞語路徑還是僅顯示詞語標籤。
內容類型識別碼	sourceContentType.id	string	內容類型的 ID。
內容類型名稱	sourceContentType.name	string	內容類型的名稱。

FileStorageContainer.Columns.List

名稱	路徑	類型	Description
value	value	array of FileStorageContainer.Column

DriveItemCollectionPage（車載物品收藏頁）

代表一頁磁碟項目。

名稱	路徑	類型	Description
value	value	array of DriveItem	收集驅動物品。
@odata.next連結	@odata.nextLink	string	可用來擷取下一頁的URL。

驅動物品

驅動項目元資料

名稱	路徑	類型	Description
下載 URL	@microsoft.graph.downloadUrl	string	一個可以用來下載此項目內容的網址
下載網址（無認證）	@microsoft.graph.downloadUrlNoAuth	string	一個可以用來下載此物品內容而無需驗證的網址
ID	id	string	檔案或資料夾的唯一識別碼
名稱	name	string	檔案或資料夾名稱
大小	size	integer	檔案或資料夾大小（位元組）
網址	webUrl	string	顯示該項目的網址
創建時間	createdDateTime	date-time	檔案或資料夾建立的日期與時間
上次修改時間	lastModifiedDateTime	date-time	檔案或資料夾最後修改的日期與時間
Etag	eTag	string	檔案或資料夾的標籤
CTag	cTag	string	一個標籤表示內容已變更
磁碟機類型	parentReference.driveType	string	包含該物品的硬碟類型
磁碟機識別碼	parentReference.driveId	string	包含該物品的硬碟識別碼
父 ID	parentReference.id	string	父資料夾的識別碼
父名稱	parentReference.name	string	父資料夾名稱
父路徑	parentReference.path	string	父資料夾路徑
站台識別碼	parentReference.siteId	string	包含該物品的網站識別碼
應用程式識別碼	createdBy.application.id	string	建立該項目的應用程式識別碼
應用程式名稱	createdBy.application.displayName	string	建立該項目的應用程式顯示名稱
使用者識別碼	createdBy.user.id	string	創建該物品的使用者識別碼
使用者名	createdBy.user.displayName	string	建立該項目的使用者顯示名稱
應用程式識別碼	lastModifiedBy.application.id	string	最後修改該項目的應用程式識別碼
應用程式名稱	lastModifiedBy.application.displayName	string	最後修改該項目的應用程式顯示名稱
使用者識別碼	lastModifiedBy.user.id	string	最後修改該物品的使用者 ID
使用者名	lastModifiedBy.user.displayName	string	最後修改該項目的使用者顯示名稱
MIME 類型	file.mimeType	string	檔案的 MIME 類型
QuickXor 雜湊	file.hashes.quickXorHash	string	檔案的 QuickXor 雜湊
創建時間	fileSystemInfo.createdDateTime	date-time	檔案或資料夾在檔案系統中建立的日期與時間
上次修改時間	fileSystemInfo.lastModifiedDateTime	date-time	檔案或資料夾在檔案系統上最後一次修改的日期與時間
子計數	folder.childCount	integer	資料夾中的項目數量
共享範圍	shared.scope	string	分享範圍（使用者、組織或任何人）

分享連結

代表檔案或資料夾的分享連結

名稱	路徑	類型	Description
連結ID	id	string	分享連結的唯一識別碼
連結類型	link.type	string	分享連結的類型（檢視、編輯、嵌入）
連結範圍	link.scope	string	分享連結的範圍
網址	link.webUrl	string	分享連結的網址
顯示名稱	link.application.displayName	string	應用程式的顯示名稱
識別碼	link.application.id	string	應用程式的唯一識別碼

共享權限回應

代表檔案或資料夾的權限

名稱	路徑	類型	Description
許可識別碼	id	string	權限的唯一識別碼
角色	roles	array of string	此許可所授予的角色
分享ID	shareId	string	一個獨特的憑證，可以透過 Shares API 存取這個共享項目
顯示名稱	grantedTo.user.displayName	string	使用者的顯示名稱
Email	grantedTo.user.email	string	使用者的電子郵件地址
使用者識別碼	grantedTo.user.id	string	使用者的唯一識別碼
連結範圍	link.scope	string	連結的範圍
連結類型	link.type	string	連結的類型
網址	link.webUrl	string	連結網址
Email	invitation.email	string	邀請函寄到的電子郵件地址
需登入	invitation.signInRequired	boolean	是否需要登入才能存取共享項目
到期日期時間	expirationDateTime	date-time	許可到期的日期與時間
賦予身份	grantedToIdentities	array of object	在指定時，僅限制分享給列出的使用者
顯示名稱	grantedToIdentities.user.displayName	string	使用者的顯示名稱
Email	grantedToIdentities.user.email	string	使用者的電子郵件地址
使用者識別碼	grantedToIdentities.user.id	string	使用者的唯一識別碼

共享權限清單

代表檔案或資料夾的權限清單

名稱	路徑	類型	Description
value	value	array of SharingPermissionResponse

FileVersion

代表檔案的一個版本

名稱	路徑	類型	Description
版本識別碼	id	string	版本的識別碼
修改者	lastModifiedBy.user.displayName	string	修改版本的使用者姓名
使用者識別碼	lastModifiedBy.user.id	string	修改版本的使用者 ID
上次修改	lastModifiedDateTime	date-time	此版本最後修改的日期與時間
大小	size	integer	版本大小（位元組）
出版層級	publication.level	string	本版本的出版層級（已出版或借閱）
版本識別碼	publication.versionId	string	即將發佈版本的識別碼

檔案版本

代表檔案版本的集合

名稱	路徑	類型	Description
value	value	array of FileVersion	檔案版本的收集

縮圖集

代表一組檔案的縮圖

名稱	路徑	類型	Description
縮圖集 ID	id	string	縮圖集的唯一識別碼
大型	large	Thumbnail	代表單一縮圖
適中	medium	Thumbnail	代表單一縮圖
小	small	Thumbnail	代表單一縮圖
來源	source	Thumbnail	代表單一縮圖

縮圖

代表單一縮圖

名稱	路徑	類型	Description
高度	height	integer	縮圖高度，以像素為單位
寬度	width	integer	縮圖寬度，以像素為單位
URL	url	string	縮圖網址

縮圖集

代表一組縮圖集合

名稱	路徑	類型	Description
value	value	array of ThumbnailSet	縮圖集

回收桶項目

代表回收桶中的一項物品

名稱	路徑	類型	Description
ID	id	string	回收物品的唯一識別碼
名稱	name	string	回收物品名稱
大小	size	integer	項目大小（位元組）
刪除日期	deletedDateTime	date-time	項目被刪除的日期與時間
已從位置刪除	deletedFromLocation	string	原始物品所在地點的相對網址
Title	title	string	回收物品的標題
刪除者	deletedBy.user.displayName	string	刪除該項目的使用者顯示名稱
Email	deletedBy.user.email	string	刪除該項目的使用者電子郵件
使用者識別碼	deletedBy.user.id	string	刪除該項目的使用者唯一識別碼

回收箱項目收藏

回收桶裡的物品集合

名稱	路徑	類型	Description
value	value	array of RecycleBinItem	回收桶裡的物品收集

二進位

這是基本資料類型「二進位」。

共用方式為

SharePoint 嵌入式

使用者入門

授權存取 SharePoint 嵌入式連接器

已知問題和限制

動作

列出回收容器

參數

傳回

列出回收物品

參數

傳回

列出容器

參數

傳回

列出容器欄位

參數

傳回

列出容器權限

參數

傳回

列表檔案欄位

參數

傳回

列表檔案版本

參數

傳回

列表縮圖

參數

傳回

刪除分享權限

參數

刪除回收容器

參數

刪除回收物品

參數

刪除容器

參數

刪除容器欄位

參數

刪除容器權限

參數

刪除檔案

參數

刪除檔案版本

參數

取出檔案

參數

取得分享權限

參數

傳回

取得容器欄

參數

傳回

取得容器自訂屬性

參數

傳回

取得檔案內容

參數

取得檔案屬性

參數

傳回

取得檔案版本

參數

傳回

取得縮圖

參數

傳回

啟動容器

參數

回收容器修復

參數

傳回

回收物品的回收

參數

傳回

容器中的項目清單

參數

傳回

建立分享連結