OneDrive 動作

動作:取得使用者

輸入欄位

屬性說明類型
ID要擷取詳細資料的使用者專屬 ID 或使用者主要名稱 (UPN)。也是 Users 中的 ID 欄位。string

輸出變數

屬性說明類型
實體與使用者相關的實體清單。string
LinkedadhocCalls使用者臨時通話的連結。string
LinkedagreementAcceptances使用者接受協議的連結。string
LinkedappRoleAssignments使用者應用程式角色指派的連結。string
Linkedauthentication使用者驗證詳細資料的連結。string
Linkedcalendar使用者日曆的連結。string
LinkedcalendarGroups使用者日曆群組的連結。string
LinkedcalendarView使用者日曆檢視畫面的連結。string
已連結的日曆使用者日曆的連結。string
已連結的對話使用者對話的連結。string
LinkedcloudClipboard使用者雲端剪貼簿的連結。string
LinkedcloudPCs使用者雲端電腦的連結。string
LinkedcontactFolders使用者聯絡人資料夾的連結。string
Linkedcontacts使用者聯絡人的連結。string
LinkedcreatedObjects使用者建立的物件連結。string
LinkeddataSecurityAndGovernance使用者資料安全性與管理設定的連結。string
LinkeddeviceManagementTroubleshootingEvents使用者裝置管理疑難排解事件的連結。string
LinkeddirectReports使用者直屬部屬的連結。string
Linkeddrive使用者雲端硬碟的連結。string
Linkeddrives使用者雲端硬碟的連結。string
LinkedemployeeExperience使用者員工體驗資料的連結。string
Linkedevents使用者活動的連結。string
Linkedextensions使用者擴充功能的連結。string
LinkedfollowedSites使用者追蹤的網站連結。string
LinkedinferenceClassification使用者推論分類設定的連結。string
Linkedinsights使用者洞察資料的連結。string
LinkedjoinedTeams使用者加入的團隊連結。string
LinkedlicenseDetails使用者授權詳細資料的連結。string
LinkedmailFolders使用者郵件資料夾的連結。string
LinkedmanagedAppRegistrations使用者受管理應用程式註冊的連結。string
LinkedmanagedDevices使用者受管理裝置的連結。string
Linkedmanager使用者主管的連結。string
LinkedmemberOf使用者所屬群組的連結。string
Linkedmessages使用者訊息的連結。string
Linkedoauth2PermissionGrants使用者的 OAuth 2.0 權限授予連結。string
LinkedonPremisesSyncBehavior使用者地端部署同步行為的連結。string
Linkedonenote使用者 OneNote 的連結。string
LinkedonlineMeetings使用者線上會議的連結。string
Linkedoutlook使用者 Outlook 設定的連結。string
LinkedownedDevices使用者擁有的裝置連結。string
LinkedownedObjects使用者擁有的物件連結。string
已連結的使用者與使用者相關聯的人員連結。string
LinkedpermissionGrants授予使用者權限的連結。string
Linkedphoto使用者相片的連結。string
Linkedphotos使用者相片的連結。string
Linkedplanner使用者規劃工具的連結。string
Linkedpresence使用者狀態資訊的連結。string
LinkedregisteredDevices使用者註冊裝置的連結。string
LinkedscopedRoleMemberOf使用者範圍角色成員資格的連結。string
Linkedsettings使用者設定的連結。string
Linkedsolutions與使用者相關的解決方案連結。string
Linkedsponsors使用者贊助者的連結。string
Linkedteamwork使用者團隊合作設定的連結。string
Linkedtodo使用者待辦事項清單的連結。string
LinkedtransitiveMemberOf使用者遞移群組成員資格的連結。string
accountEnabled指出使用者帳戶是否已啟用。boolean
assignedLicenses指派給使用者的授權清單。string
authorizationInfo_certificateUserIds授權用的憑證使用者 ID。string
businessPhones使用者的商家電話號碼。string
city使用者所在位置的城市。string
companyName使用者公司的名稱。string
country使用者所在國家/地區。string
createdDateTime使用者帳戶的建立日期和時間。string
deletedDateTime使用者帳戶遭刪除的日期和時間。string
部門使用者的部門。string
displayName使用者的顯示名稱。string
employeeHireDate使用者受聘的日期。string
employeeId使用者的員工 ID。string
employeeLeaveDateTime使用者離職的日期和時間。string
employeeOrgData_costCenter與使用者相關聯的成本中心。string
employeeOrgData_division與使用者相關聯的部門。string
employeeType員工類型 (例如:全職、兼職)。string
givenName使用者的名字。string
id使用者的專屬 ID。string
身分使用者的身分。string
imAddresses使用者的即時通訊地址。string
isManagementRestricted指出使用者是否受到管理限制。boolean
isResourceAccount指出使用者是否為資源帳戶。boolean
jobTitle使用者的職稱。string
lastPasswordChangeDateTime使用者上次變更密碼的日期和時間。string
mail使用者的電子郵件地址。string
mailNickname使用者的郵件暱稱。string
mobilePhone使用者的手機號碼。string
officeLocation使用者的辦公室位置。string
onPremisesDistinguishedName使用者的地端部署辨別名稱。string
onPremisesDomainName使用者的地端部署網域名稱。string
onPremisesExtensionAttributes_extensionAttribute1地端部署延伸屬性 1。string
onPremisesExtensionAttributes_extensionAttribute10地端部署擴充功能屬性 10。string
onPremisesExtensionAttributes_extensionAttribute11地端部署擴充功能屬性 11。string
onPremisesExtensionAttributes_extensionAttribute12地端部署擴充功能屬性 12。string
onPremisesExtensionAttributes_extensionAttribute13地端部署擴充功能屬性 13。string
onPremisesExtensionAttributes_extensionAttribute14地端部署擴充功能屬性 14。string
onPremisesExtensionAttributes_extensionAttribute15地端部署擴充功能屬性 15。string
onPremisesExtensionAttributes_extensionAttribute2地端部署擴充屬性 2。string
onPremisesExtensionAttributes_extensionAttribute3地端部署擴充功能屬性 3。string
onPremisesExtensionAttributes_extensionAttribute4地端部署擴充功能屬性 4。string
onPremisesExtensionAttributes_extensionAttribute5地端部署擴充屬性 5。string
onPremisesExtensionAttributes_extensionAttribute6地端部署擴充功能屬性 6。string
onPremisesExtensionAttributes_extensionAttribute7地端部署擴充功能屬性 7。string
onPremisesExtensionAttributes_extensionAttribute8地端部署擴充功能屬性 8。string
onPremisesExtensionAttributes_extensionAttribute9地端部署擴充功能屬性 9。string
onPremisesImmutableId使用者的地端部署固定 ID。string
onPremisesLastSyncDateTime上次與地端部署同步處理資料的日期和時間。string
onPremisesProvisioningErrors使用者的地端部署佈建錯誤。string
onPremisesSamAccountName使用者的地端部署 SAM 帳戶名稱。string
onPremisesSecurityIdentifier使用者的地端部署安全性 ID。string
onPremisesSyncEnabled指出使用者是否已啟用地端部署同步功能。boolean
onPremisesUserPrincipalName使用者的地端部署使用者主體名稱。string
otherMails使用者的其他電子郵件地址。string
passwordProfile_forceChangePasswordNextSignIn指出使用者是否必須在下次登入時變更密碼。boolean
passwordProfile_forceChangePasswordNextSignInWithMfa指出使用者是否必須在下次使用多重驗證登入時變更密碼。boolean
passwordProfile_password使用者密碼設定檔的密碼。string
postalCode使用者所在位置的郵遞區號。string
preferredLanguage使用者的偏好語言。string
securityIdentifier使用者的安全 ID。string
serviceProvisioningErrors使用者服務佈建錯誤。string
state使用者所在位置的州別。string
streetAddress使用者所在位置的街道地址。string
姓氏使用者的姓氏。string
userPrincipalName使用者的使用者主體名稱。string
userType使用者類型 (例如:成員、訪客)。string

動作:取得雲端硬碟

輸入欄位

屬性說明類型
ID要擷取的雲端硬碟專屬 ID。這會對應到雲端硬碟中的 Id 欄位。string

輸出變數

屬性說明類型
實體使用者定義或系統產生的說明,提供商品相關背景資訊string
ID系統產生的專屬字串,用於識別雲端硬碟中的項目。string
LinkedbundlesLinkedbundlesstring
Linkedfollowing使用者主動追蹤更新或協作的 OneDrive 項目或資料夾超連結。string
LinkeditemsOneDrive 中資料夾或父項項目所含子項目的超連結。string
Linkedlist超連結,可前往包含目前項目的 SharePoint 清單。string
Linkedroot雲端硬碟根目錄的超連結,代表頂層資料夾或進入點。string
Linkedspecial系統定義的特殊資料夾 (包括「文件」、「相片」、「相機膠卷」或類似資料夾) 的超連結。string
名稱檔案或資料夾在 OneDrive 中的名稱,包括原始大小寫和格式。string
driveType指定 OneDrive 磁碟機的分類,例如 personal、business 或 documentLibrary。string
owner_application_displayName擁有或建立雲端硬碟的應用程式名稱 (使用者可理解)。string
owner_application_id指派給擁有或管理雲端硬碟的應用程式的專屬 ID。string
owner_user_id擁有或建立雲端硬碟執行個體的 OneDrive 使用者專屬 ID。string
quota_deleted仍保留在資源回收筒或復原資料夾中的已刪除項目所使用的位元組總數。integer
quota_remaining雲端硬碟中仍可使用的位元組總數。integer
quota_state雲端硬碟儲存空間的目前狀態,例如正常、即將用盡或已滿。string
quota_storagePlanInformation_upgradeAvailable根據可用的層級,指定使用者是否符合升級目前儲存空間方案的資格。boolean
quota_total使用者儲存空間方案中分配給雲端硬碟的位元組數上限。integer
quota_used雲端硬碟使用的位元組總數,包括有效和已刪除的內容。integer
sharePointIds_listId與目前項目相關聯的 SharePoint 清單 ID (如有)。string
sharePointIds_listItemIdSharePoint 清單中特定項目的專屬數字 ID。string
sharePointIds_listItemUniqueId指派給 SharePoint 環境中清單項目的全域唯一 ID。string
sharePointIds_siteId包含與目前項目相關聯的清單或程式庫的 SharePoint 網站 ID。string
sharePointIds_siteUrl代管相關聯清單或文件庫的 SharePoint 網站完整網址。string
sharePointIds_tenantId擁有儲存清單或項目的 SharePoint 網站的 Microsoft 365 租戶 ID。string
sharePointIds_webId包含相關聯清單或項目的 SharePoint 網站 (子網站) ID。string

動作:列出雲端硬碟

輸入欄位

屬性說明類型
篩選子句要套用至清單的篩選子句。這應該是類似 SQL 的有效條件,其中欄值使用單引號。您可以視需要決定是否啟用。string
頁面大小每個頁面要傳回的項目數。您可以視需要決定是否啟用。integer
頁面權杖結果下一頁的符記。您可以視需要決定是否啟用。string

輸出變數

屬性說明類型
實體使用者定義或系統產生的說明,提供商品相關背景資訊string
ID系統產生的專屬字串,用於識別雲端硬碟中的項目。string
LinkedbundlesLinkedbundlesstring
Linkedfollowing使用者主動追蹤更新或協作的 OneDrive 項目或資料夾超連結。string
LinkeditemsOneDrive 中資料夾或父項項目所含子項目的超連結。string
Linkedlist超連結,可前往包含目前項目的 SharePoint 清單。string
Linkedroot雲端硬碟根目錄的超連結,代表頂層資料夾或進入點。string
Linkedspecial系統定義的特殊資料夾 (包括「文件」、「相片」、「相機膠卷」或類似資料夾) 的超連結。string
名稱檔案或資料夾在 OneDrive 中的名稱,包括原始大小寫和格式。string
driveType指定 OneDrive 磁碟機的分類,例如 personal、business 或 documentLibrary。string
owner_application_displayName擁有或建立雲端硬碟的應用程式名稱 (使用者可理解)。string
owner_application_id指派給擁有或管理雲端硬碟的應用程式的專屬 ID。string
owner_user_id擁有或建立雲端硬碟執行個體的 OneDrive 使用者專屬 ID。string
quota_deleted仍保留在資源回收筒或復原資料夾中的已刪除項目所使用的位元組總數。integer
quota_remaining雲端硬碟中仍可使用的位元組總數。integer
quota_state雲端硬碟儲存空間的目前狀態,例如正常、即將用盡或已滿。string
quota_storagePlanInformation_upgradeAvailable根據可用的層級,指定使用者是否符合升級目前儲存空間方案的資格。boolean
quota_total使用者儲存空間方案中分配給雲端硬碟的位元組數上限。integer
quota_used目前雲端硬碟使用的位元組總數,包括有效和已刪除的內容。integer
sharePointIds_listId與目前項目相關聯的 SharePoint 清單 ID (如有)。string
sharePointIds_listItemIdSharePoint 清單中特定項目的專屬數字 ID。string
sharePointIds_listItemUniqueId指派給 SharePoint 環境中清單項目的全域唯一 ID。string
sharePointIds_siteId包含與目前項目相關聯的清單或程式庫的 SharePoint 網站 ID。string
sharePointIds_siteUrl代管相關聯清單或文件庫的 SharePoint 網站完整網址。string
sharePointIds_tenantId擁有儲存清單或項目的 SharePoint 網站的 Microsoft 365 租戶 ID。string
sharePointIds_webId包含相關聯清單或項目的 SharePoint 網站 (子網站) ID。string

動作:建立資料夾

輸入欄位

屬性說明類型
資料夾名稱輸入新資料夾的名稱 (例如:度假照片)。必填。string
上層資料夾輸入父項資料夾的名稱 (選填)。string
磁碟機名稱輸入目標雲端硬碟名稱 (選填)。string
雲端硬碟 ID可搜尋 (OneDrive 雲端硬碟)。要建立新資料夾的目標雲端硬碟專屬 ID。必填。string
Rename if Exists如果已有同名資料夾,系統會自動重新命名。boolean

輸出變數

屬性說明類型
回應資料夾的專屬 ID。string

動作:下載檔案

輸入欄位

屬性說明類型
雲端硬碟 ID檔案所在雲端硬碟的專屬 ID。如果檔案已共用或不在使用者的雲端硬碟中,則必須執行這項操作。string
磁碟機名稱檔案所在磁碟機的名稱。只有在檔案位於使用者雲端硬碟以外的雲端硬碟時,才需要執行這項操作。string
Has Bytes設為 true,即可將檔案內容以位元組形式傳回。boolean
資源 ID要下載的檔案專屬 ID。請提供這項或「資源路徑」。如果提供這項屬性,則必須一併指定 ResourceName。string
資源名稱要下載的檔案名稱。請提供這項或「資源路徑」。如果提供這項屬性,則必須一併指定 ResourceId。範例:document.docxstring
資源路徑要下載的檔案完整路徑 (例如:/documents/report.pdf)。string
使用者 ID建立檔案版本的使用者專屬 ID。只有在下載特定非最新版本時才需要 (即指定版本時)。string
使用者名稱建立檔案版本的使用者名稱。只有在下載特定非最新版本時 (即指定版本時),才需要提供這項資訊。string
版本要下載的檔案特定版本 ID。如果省略這項元素,則系統會下載最新版本。string
Download To Local Dir只有在使用者明確要求儲存、存放或下載檔案時,才將這項政策設為 True。如果下載只是分析檔案、讀取內容或回答問題的中間步驟,且不需要永久儲存於本機,請設為 False。boolean

輸出變數

屬性說明類型
回應下載檔案的內容,通常是字串。string
ContentBytes下載檔案的 Base64 編碼內容。string
FileName下載檔案的名稱。string
HasBytes指出檔案內容是否以位元組形式傳回 ContentBytes 欄位。boolean
MIMEType下載檔案的 MIME 類型 (例如:application/pdf)。string
成功指出下載作業是否成功。boolean

動作:列出檔案

輸入欄位

屬性說明類型
搜尋查詢 (query)輸入 KQL 搜尋查詢。例如:filename:report.pdf AND author:John Doe。必填。string
頁面大小每頁最多顯示的結果數 (例如:25)。integer
結果偏移分頁的從零開始計算的偏移。integer

搜尋篩選器

篩選器運算子說明
作者包含比對所選可搜尋 OneDrive 使用者建立的檔案。
檔案名稱包含比對檔案名稱中的字詞。
標題包含比對檔案標題中的字詞。
路徑包含符合所選可搜尋 OneDrive 資料夾路徑的檔案。
雲端硬碟包含比對所選可搜尋 OneDrive 雲端硬碟中的檔案。

輸出變數

屬性說明類型
結果符合搜尋條件的檔案清單。string
url_for_connector檔案的網址連結。string
rank檔案在搜尋結果中的排名。integer
snippet檔案的簡短摘要。string
title檔案標題。string
description檔案說明。string
created_on檔案的建立日期和時間。string
url檔案的網址。string
last_modified檔案上次修改的日期和時間。string
id檔案的專屬 ID。string
file_size檔案大小,以位元組為單位。integer
owner_name檔案擁有者的名稱。string
driveId檔案所在雲端硬碟的專屬 ID。string

動作:上傳檔案

輸入欄位

屬性說明類型
目標資料夾 ID可搜尋 (OneDrive 資料夾)。檔案應上傳至目的地資料夾的專屬 ID。必填。string
目的地檔案名稱輸入 OneDrive 中的檔案名稱 (例如:report.docx)。這是必填欄位。string
目的地資料夾名稱輸入目的地資料夾名稱 (例如「文件」)。string
來源檔案名稱輸入要上傳的檔案名稱。string
文字內容在這裡輸入文字內容 (選填)。string
二進位內容 (Base64)在此輸入 Base64 編碼的內容 (選用)。string
Has Bytes勾選上傳二進位內容 (Base64)。boolean
磁碟機名稱輸入硬碟名稱 (選填)。string

輸出變數

屬性說明類型
id上傳檔案的專屬 ID。string

動作:複製檔案

輸入欄位

屬性說明類型
目標資料夾 ID可搜尋 (OneDrive 資料夾)。資源要複製到的目標資料夾專屬 ID。必填。string
目標資料夾例如「文件」或「共用/專案」。string
新檔案名稱例如:Annual Report (Copy).docx。必填。string
來源檔案名稱例如:Q1.docx。string
來源檔案路徑例如:Documents/Q1.docx。string
來源雲端硬碟 ID可搜尋 (OneDrive 雲端硬碟)。資源目前所在來源雲端硬碟的專屬 ID。string
來源雲端硬碟例如「我的雲端硬碟」。string
目的地雲端硬碟 ID可搜尋 (OneDrive 雲端硬碟)。資源要複製到的目標雲端硬碟專屬 ID。string
目標雲端硬碟例如:行銷團隊雲端硬碟。string

輸出變數

屬性說明類型
id複製檔案的專屬 ID。string

動作:列出資料夾

輸入欄位

屬性說明類型
寄件者結果的起始偏移量 (從零開始)。預設值為 0。integer
查詢使用 SharePoint KQL 語法搜尋雲端硬碟項目的 KQL 查詢字串。string
大小要為頁面傳回的結果數。預設值為 25。integer

輸出變數

屬性說明類型
結果符合搜尋條件的資料夾清單。string
擁有者資料夾擁有者的名稱。string
description資料夾說明。string
created_on資料夾的建立日期和時間。string
url資料夾的網址。string
driveId資料夾所在雲端硬碟的專屬 ID。string
file_size資料夾大小 (以位元組為單位)。string
rank資料夾的搜尋結果排名。string
url_for_connector資料夾的網址連結。integer
id資料夾的專屬 ID。string
title資料夾名稱。string

動作:取得檔案

輸入欄位

屬性說明類型
寄件者結果的起始偏移量 (從零開始)。預設值為 0。integer
查詢使用 SharePoint KQL 語法搜尋特定雲端硬碟項目的 KQL 查詢字串。這會與篩選器合併,只搜尋檔案。主要功能:1) **重要**:請勿在查詢中使用雙引號,即使是詞組或完全相符的查詢也一樣。2) 支援任意文字關鍵字和屬性限制。string
大小要傳回的結果數。預設值為 1。integer

輸出變數

屬性說明類型
結果符合搜尋條件的檔案。string
url_for_connector檔案的網址連結。string
rank檔案在搜尋結果中的排名。integer
snippet檔案的簡短摘要。string
title檔案標題。string
description檔案說明。string
created_on檔案的建立日期和時間。string
url檔案的網址。string
last_modified檔案上次修改的日期和時間。string
id檔案的專屬 ID。string
file_size檔案大小,以位元組為單位。integer
owner_name檔案擁有者的名稱。string
driveId檔案所在雲端硬碟的專屬 ID。string

動作:取得資料夾

輸入欄位

屬性說明類型
寄件者結果的起始偏移量 (從零開始)。預設值為 0。integer
查詢使用 SharePoint KQL 語法搜尋特定雲端硬碟項目的 KQL 查詢字串。設定 IsDocument:false 時,系統會自動篩選,只搜尋資料夾。主要功能:- **重要事項**:請勿在查詢中使用雙引號,即使是片語或完全相符的結果也不例外。- 支援任意文字關鍵字和房源限制。string
大小要傳回的結果數。預設值為 1。integer

輸出變數

屬性說明類型
結果符合搜尋條件的資料夾。string
created_on資料夾的建立日期和時間。string
url_for_connector資料夾的網址連結。string
description資料夾說明。string
driveId資料夾所在雲端硬碟的專屬 ID。string
file_size資料夾大小 (以位元組為單位)。number
snippet資料夾的簡短摘要。string
rank資料夾的搜尋結果排名。integer
擁有者資料夾擁有者的名稱。string
id資料夾的專屬 ID。string
title資料夾名稱。string

觸發條件:建立或更新檔案時

觸發條件篩選器

篩選器運算子說明
作者包含比對所選可搜尋 OneDrive 使用者建立的檔案。
檔案名稱包含比對檔案名稱中的字詞。
標題包含比對檔案標題中的字詞。
路徑包含符合所選可搜尋 OneDrive 資料夾路徑的檔案。
雲端硬碟包含比對所選可搜尋 OneDrive 雲端硬碟中的檔案。