共用方式為

HubSpot 檔案 v2（獨立發行商）（預覽版）

透過易於使用的HubSpot CRM，您永遠不必手動更新報告，也不必想知道您的團隊如何追蹤配額。 在視覺化儀表板上即時檢視整個銷售管道。 HubSpot CRM 將在整潔的時間軸中自動組織、豐富和追蹤每個聯絡人。

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

服務 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）
連絡人​​
名稱 特洛伊·泰勒
URL https://www.hitachisolutions.com
Email ttaylor@hitachisolutions.com
連接器中繼資料
Publisher 特洛伊·泰勒
網站 https://www.hubspot.com/
隱私策略 https://legal.hubspot.com/privacy-policy
類別 內容和文件;銷售和客戶關係管理

正在建立連線

連接器支援下列驗證類型：
預設值 建立連線的參數。 所有區域 不可共享

預設

適用：所有地區

建立連線的參數。

這不是可共用的連線。 如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。

名稱 類型 Description 為必填項目
存取權杖 （以「持有人YOUR_TOKEN」的形式） securestring 此 API 的存取權杖 （以「持有人YOUR_TOKEN」的形式） 對

節流限制

名稱 呼叫 續約期間
每個連線的 API 呼叫 100 60 秒

動作

上傳檔案

上傳在請求內文中指定內容的單一檔案。
以非同步方式匯入檔案

以非同步方式將指定 URL 的檔案匯入檔案管理員。
依路徑取得檔案

依路徑位址擷取檔案。
刪除 GDRP 的檔案

刪除 GDRP 的檔案。
刪除檔案

依 ID 刪除檔案。
刪除資料夾

按 ID 刪除資料夾。
取得檔案

依 ID 擷取檔案。
取得資料夾

依 ID 取得資料夾。
建立資料夾

建立資料夾。
搜尋檔案

在檔案管理員中搜尋檔案。 不顯示隱藏或封存的檔案。
搜尋資料夾

搜尋資料夾。 不包含隱藏或封存的資料夾。
更新檔案

以新的檔案資料取代現有的檔案資料。 可用於更改圖像內容，而無需上傳新文件並更新所有參考。
更新檔案屬性

依 ID 更新檔案的屬性。
更新資料夾屬性

按給定 ID 更新文件夾的屬性。 此動作會以非同步方式進行，也會更新資料夾的所有子項。
檢查匯入狀態

檢查請求匯入的狀態。
檢查資料夾更新

檢查資料夾更新的狀態。 資料夾更新會以非同步方式進行。
產生連結

產生允許暫時存取私人檔案的已簽署 URL。

上傳檔案

作業識別碼：
Post-_files_v3_files_upload

上傳在請求內文中指定內容的單一檔案。

參數

名稱 機碼 必要 類型 Description
檔案
 file True file

要上傳的檔案。
資料夾 ID
 folderId string

需要 'folderId' 或 'folderPath'。 folderId 是檔案將上傳到的資料夾的 ID。
資料夾路徑
 folderPath string

需要 'folderPath' 或 'folderId'。 此欄位代表上傳檔案的目的地資料夾路徑。 如果路徑不存在，系統會嘗試建立路徑。
檔案名稱
 fileName True string

上傳檔案的所需名稱。
字元集
 charsetHunch string

上傳檔案的字元集。
存取選項
 options.access True string

上傳檔案的存取層級。
TTL 選項
 options.ttl integer

上傳檔案的存留時間。

傳回

檔案。

檔案
File

以非同步方式匯入檔案

作業識別碼：
Post-_files_v3_files_import-from-url_async_importFromUrl

以非同步方式將指定 URL 的檔案匯入檔案管理員。

參數

名稱 機碼 必要 類型 Description
資料夾路徑
 folderPath string

folderPath 或 folderId 之一是必需的。 上傳檔案的目的地資料夾路徑。 如果資料夾路徑不存在，則會嘗試建立資料夾路徑。
交通方式1
 access True string

PUBLIC_INDEXABLE：任何擁有 URL 的人都可以公開存取檔案。 搜尋引擎可以索引檔案。 PUBLIC_NOT_INDEXABLE：任何擁有該 URL 的人都可以公開存取檔案。 搜尋引擎 無法索引 檔案。 PRIVATE：檔案無法公開存取。 需要已簽署的 URL 才能查看內容。 搜尋引擎 無法索引 檔案。
重複驗證範圍
 duplicateValidationScope string

ENTIRE_PORTAL：在整個帳戶中尋找重複檔案。 EXACT_FOLDER：在提供的資料夾中尋找重複檔案。
名稱
 name string

名稱，在檔案管理員中提供產生的檔案。
重複驗證策略
 duplicateValidationStrategy string

NONE：請勿執行任何重複驗證。 拒絕：如果找到重複項，則拒絕上傳。 RETURN_EXISTING：如果找到重複文件，請不要上傳新文件，而是返回找到的重複文件。
TTL
 ttl string

活著的時候了。 如果指定，則會在指定的時間範圍後刪除檔案。 如果未設定，檔案將無限期存在。
改寫
 overwrite boolean

如果為true，則如果給定資料夾中存在具有相同名稱和副檔名的檔案，則會覆寫現有檔案。 被覆蓋的檔案將被刪除，上傳的檔案將以新 ID 取代。 如果未設定或設定為 false，則會更新新檔案的名稱，以防止與現有檔案衝突（如果存在具有相同路徑、名稱和副檔名的檔案）
URL
 url True string

下載新檔案的URL。
資料夾 ID
 folderId string

folderId 或 folderPath 之一是必需的。 Destination folderId 上傳檔案的檔案。

傳回

有關已啟動的工作的信息，以及檢查其狀態的位置。

ImportFromUrlTaskLocator
ImportFromUrlTaskLocator

依路徑取得檔案

作業識別碼：
Get-_files_v3_files_stat_path_getMetadata

依路徑位址擷取檔案。

參數

名稱 機碼 必要 類型 Description
路徑
 path True string

路徑。
屬性
 properties array

屬性。

傳回

檔案統計
FileStat

刪除 GDRP 的檔案

作業識別碼：
Delete-_files_v3_files_fileId_gdpr-delete_archiveGDPR

刪除 GDRP 的檔案。

參數

名稱 機碼 必要 類型 Description
檔案 ID
 fileId True string

要刪除 GDPR 的檔案 ID。

刪除檔案

作業識別碼：
Delete-_files_v3_files_fileId_archive

依 ID 刪除檔案。

參數

名稱 機碼 必要 類型 Description
檔案 ID
 fileId True string

FileId 來刪除。

刪除資料夾

作業識別碼：
Delete-_files_v3_folders_folderId_archive

按 ID 刪除資料夾。

參數

名稱 機碼 必要 類型 Description
資料夾 ID
 folderId True string

要刪除的資料夾 ID。

取得檔案

作業識別碼：
Get_files_v3_files_fileId_getById

依 ID 擷取檔案。

參數

名稱 機碼 必要 類型 Description
檔案 ID
 fileId True string

所需檔案的 ID。
屬性
 properties string

屬性。

傳回

檔案。

檔案
File

取得資料夾

作業識別碼：
Get-_files_v3_folders_folderId_getById

依 ID 取得資料夾。

參數

名稱 機碼 必要 類型 Description
資料夾 ID
 folderId True string

所需資料夾的 ID。
屬性
 properties array

要在傳回資料夾上設定的屬性。

傳回

資料夾
Folder

建立資料夾

作業識別碼：
Post-_files_v3_folders_create

建立資料夾。

參數

名稱 機碼 必要 類型 Description
父資料夾識別碼
 parentFolderId string

FolderId 所建立資料夾的父系。 如果未指定，則會在根層級建立資料夾。 parentFolderId 和 parentFolderPath 無法同時設定。
父路徑
 parentPath string

已建立資料夾父項的路徑。 如果未指定，則會在根層級建立資料夾。 parentFolderPath 和 parentFolderId 無法同時設定。
名稱
 name True string

資料夾的所需名稱。

傳回

資料夾
Folder

搜尋檔案

作業識別碼：
Get-_files_v3_files_search_doSearch

在檔案管理員中搜尋檔案。 不顯示隱藏或封存的檔案。

參數

名稱 機碼 必要 類型 Description
屬性
 properties array

傳回物件中所需的檔案屬性。
之後
 after string

指定搜尋的項目偏移量上限為 10000。 如果您達到此限制，請縮小搜尋範圍。
之前
 before string

以前。
限制
 limit integer

要退回的項目數量。 上限為 100。
排序
 sort array

依指定欄位排序檔案。
ID
 id string

按給定 ID 搜索文件。
創建於
 createdAt string

按創建時間搜索文件。
在 LTE 創建
 createdAtLte string

在小於或等於的時間創建。
在 GTE 創建
 createdAtGte string

創造於大於或等於。
更新於
 updatedAt string

按最新更新時間搜索文件。
在 LTE 更新
 updatedAtLte string

更新時間晚於或等於。
GTE 更新
 updatedAtGte string

更新為大於或等於。
名稱
 name string

搜尋包含給定名稱的檔案。
路徑
 path string

依路徑搜尋檔案。
父資料夾識別碼
 parentFolderId integer

搜尋指定 folderId 內的檔案。
大小
 size integer

依檔案大小查詢。
高度
 height integer

按圖像或視頻的高度搜索文件。
寬度
 width integer

按圖像或視頻的寬度搜索文件。
編碼
 encoding string

搜尋具有指定編碼的檔案。
類型
 type string

按提供的檔案類型進行篩選。
Extension
 extension string

按給定的擴展名搜索文件。
URL
 url string

搜尋指定的URL。
在內容中可用
 isUsableInContent boolean

如果為true，則會顯示已標示為用於新內容的檔案。 它 false 顯示不應在新內容中使用的檔案。
允許匿名訪問
 allowsAnonymousAccess boolean

如果 'true' 將顯示私人檔案;如果 'false' 將顯示公共檔案。

傳回

檔案集合。

集合回應檔案
CollectionResponseFile

搜尋資料夾

作業識別碼：
Get-_files_v3_folders_search_doSearch

搜尋資料夾。 不包含隱藏或封存的資料夾。

參數

名稱 機碼 必要 類型 Description
屬性
 properties array

應包含在傳回資料夾中的屬性。
之後
 after string

指定搜尋的項目偏移量上限為 10000。 如果您達到此限制，請縮小搜尋範圍。
之前
 before string

以前。
限制
 limit integer

要傳回的結果限制。 上限為 100。
排序
 sort array

按給定屬性對結果進行排序。 例如，-name 依名稱欄位遞減排序，名稱依名稱欄位遞增排序。
ID
 id string

按給定 ID 搜索文件夾。
創建於
 createdAt string

搜尋具有指定建立時間戳記的資料夾。
在 LTE 創建
 createdAtLte string

在小於或等於的時間創建。
在 GTE 創建
 createdAtGte string

創造於大於或等於。
更新於
 updatedAt string

在給定的更新時間戳記搜尋資料夾。
在 LTE 更新
 updatedAtLte string

更新時間晚於或等於。
GTE 更新
 updatedAtGte string

更新為大於或等於。
名稱
 name string

搜尋包含指定名稱的資料夾。
路徑
 path string

依路徑搜尋資料夾。
父資料夾識別碼
 parentFolderId integer

搜尋具有指定父項 folderId 的資料夾。

傳回

集合回應資料夾
CollectionResponseFolder

更新檔案

作業識別碼：
Put-_files_v3_files_fileId_replace

以新的檔案資料取代現有的檔案資料。 可用於更改圖像內容，而無需上傳新文件並更新所有參考。

參數

名稱 機碼 必要 類型 Description
檔案 ID
 fileId True string

所需檔案的 ID。
檔案
 file file

將取代檔案管理員中現有檔案的檔案資料。
字元集
 charsetHunch string

給定檔案資料的字元集。
選項
 options string

代表 FileReplaceOptions 的 JSON 字串。

傳回

檔案。

檔案
File

更新檔案屬性

作業識別碼：
Patch-_files_v3_files_fileId_updateProperties

依 ID 更新檔案的屬性。

參數

名稱 機碼 必要 類型 Description
檔案 ID
 fileId True string

要更新的檔案識別碼。
交通方式2
 access string

NONE：請勿執行任何重複驗證。 拒絕：如果找到重複項，則拒絕上傳。 RETURN_EXISTING：如果找到重複文件，請不要上傳新文件，而是返回找到的重複文件。
父資料夾識別碼
 parentFolderId string

FolderId 檔案應該移至的位置。folderId 和 folderPath 參數無法同時設定。
名稱
 name string

檔案的新名稱。
父資料夾路徑
 parentFolderPath string

檔案應移至的資料夾路徑。folderId 和 folderPath 參數無法同時設定。
在上下文中可用
 isUsableInContent boolean

標記檔案是否應用於新內容。
過期時間
 expiresAt integer

到期時。

傳回

檔案。

檔案
File

更新資料夾屬性

作業識別碼：
Post-_files_v3_folders_update_async_updateProperties

按給定 ID 更新文件夾的屬性。 此動作會以非同步方式進行，也會更新資料夾的所有子項。

參數

名稱 機碼 必要 類型 Description
父資料夾識別碼
 parentFolderId integer

新的父 folderId。 如果更改，該文件夾及其所有子項將移動到指定的文件夾中。 parentFolderId 和 parentFolderPath 無法同時指定。
名稱
 name string

新名稱。 如果指定，資料夾的名稱和 fullPath 將會變更。 資料夾的所有子項都會相應更新。
ID
 id True string

要變更的資料夾 ID。

傳回

有關已啟動的工作的信息，以及檢查其狀態的位置。

FolderUpdateTask定位器
FolderUpdateTaskLocator

檢查匯入狀態

作業識別碼：
Get-_files_v3_files_import-from-url_async_tasks_taskId_status_checkImport

檢查請求匯入的狀態。

參數

名稱 機碼 必要 類型 Description
工作識別碼
 taskId True string

依 URL 工作 ID 匯入。

傳回

FileAction回應
FileActionResponse

檢查資料夾更新

作業識別碼：
Get-_files_v3_folders_update_async_tasks_taskId_status_checkUpdateStatus

檢查資料夾更新的狀態。 資料夾更新會以非同步方式進行。

參數

名稱 機碼 必要 類型 Description
工作識別碼
 taskId True string

資料夾更新的 TaskId。

傳回

FolderAction回應
FolderActionResponse

產生連結

作業識別碼：
Get-_files_v3_files_fileId_signed-url_getSignedUrl

產生允許暫時存取私人檔案的已簽署 URL。

參數

名稱 機碼 必要 類型 Description
檔案 ID
 fileId True string

檔案 ID。
大小
 size string

對於影像檔案。 這會在共享之前將圖像大小調整為所需的大小。 不影響原始文件，只影響此已簽署URL所提供的文件。
Expiration
 expirationSeconds integer

連結將提供對檔案的存取權（以秒為單位）的時間。
高檔
 upscale boolean

如果提供大小，這會放大影像以符合大小尺寸。

傳回

已簽署的 Url 物件，其中包含所要求檔案的選用輔助中繼資料。

已簽署網址
SignedUrl

定義

標準錯誤

名稱 路徑 類型 Description
子類別
 subCategory object

子類別。
上下文
 context object

上下文。
Links
 links object

鏈接。
ID
 id string

識別碼。
類別
 category string

類別。
Message
 message string

訊息。
Errors
 errors array of ErrorDetail

錯誤。
地位
 status string

狀態。

FolderAction回應

名稱 路徑 類型 Description
資料夾
 result Folder
完成時間
 completedAt string

當要求的變更完成時。
錯誤數
 numErrors integer

所要求變更所導致的錯誤數目。
請求時間
 requestedAt string

時間戳記，代表請求任務的時間。
開始於
 startedAt string

時間戳記，代表工作啟動的時間。
Links
 links object

用於檢查任務狀態的連結。
Errors
 errors array of StandardError

任務導致的詳細錯誤。
工作識別碼
 taskId string

任務的 ID。
地位
 status Status

任務的當前狀態。

Paging

名稱 路徑 類型 Description
下一頁
 next NextPage
上一頁
 prev PreviousPage

資料夾

名稱 路徑 類型 Description
創建於
 createdAt string

建立資料夾的時間戳記。
存檔於
 archivedAt string

資料夾刪除的時間戳記。
Archived
 archived boolean

標記資料夾是否已刪除。
路徑
 path string

檔案管理員中資料夾的路徑。
父資料夾識別碼
 parentFolderId string

父資料夾的識別碼。
名稱
 name string

資料夾的名稱。
ID
 id string

資料夾的識別碼。
更新於
 updatedAt string

資料夾最新更新的時間戳記。

集合回應檔案

檔案集合。

名稱 路徑 類型 Description
Paging
 paging Paging
results
 results array of File

錯誤詳細資訊

名稱 路徑 類型 Description
子類別
 subCategory string

包含錯誤更具體詳細資料的特定類別。
Code
 code string

與錯誤詳細資料相關聯的狀態碼。
Description
 in string

找到錯誤的欄位或參數名稱。
上下文
 context object

錯誤狀況的相關內容。
Message
 message string

描述錯誤的人類可讀訊息，以及適當的補救步驟。

FileAction回應

名稱 路徑 類型 Description
檔案
 result File

檔案。
完成時間
 completedAt string

任務完成時間。
錯誤數
 numErrors integer

工作所產生的錯誤數目。
請求時間
 requestedAt string

請求任務的時間戳記。
開始於
 startedAt string

工作啟動時間戳記。
Links
 links object

用於檢查所請求任務狀態的連結。
Errors
 errors array of StandardError

描述性錯誤訊息。
工作識別碼
 taskId string

所要求工作的識別碼。
地位
 status Status

任務的當前狀態。

集合回應資料夾

名稱 路徑 類型 Description
Paging
 paging Paging
results
 results array of Folder

檔案統計

名稱 路徑 類型 Description
檔案
 file File

檔案。
資料夾
 folder Folder

已簽署網址

已簽署的 Url 物件，其中包含所要求檔案的選用輔助中繼資料。

名稱 路徑 類型 Description
Extension
 extension string

所要求檔案的延伸模組。
大小
 size integer

所要求檔案的大小 （以位元組為單位）。
名稱
 name string

所要求檔案的名稱。
寬度
 width integer

對於圖像和視頻文件。 檔案的寬度。
類型
 type string

檔案類型。 可以是 IMG、DOCUMENT、AUDIO、MOVIE 或其他。
過期時間
 expiresAt string

URL 不再授予檔案存取權的時間戳記。
URL
 url string

可存取指定檔案的已簽署 URL。 擁有此 URL 的任何人都可以存取該檔案，直到檔案過期。
高度
 height integer

對於圖像和視頻文件。 檔案的高度。

上一頁

名稱 路徑 類型 Description
之前
 before string

以前。
Link
 link string

鏈接。

ImportFromUrlTaskLocator

有關已啟動的工作的信息，以及檢查其狀態的位置。

名稱 路徑 類型 Description
Links
 links object

用於檢查與任務相關資訊的位置的連結。 此 status 連結提供檢查任務狀態的URL。
ID
 id string

任務的 ID。

檔案

檔案。

名稱 路徑 類型 Description
Extension
 extension string

檔案的副檔名。 例如：.jpg、.png、.gif、.pdf等。
存取權
 access Access

檔案存取。 可以是PUBLIC_INDEXABLE、PUBLIC_NOT_INDEXABLE、私人的。
父資料夾識別碼
 parentFolderId string

檔案所在資料夾的識別碼。
編碼
 encoding string

檔案的編碼。
類型
 type string

檔案類型。 可以是 IMG、DOCUMENT、AUDIO、MOVIE 或其他。
在上下文中可用
 isUsableInContent boolean

之前已「存檔」。 指出在建立網頁等新內容時是否應該使用該檔案。
URL
 url string

指定檔案的 URL。 此 URL 可能會根據帳戶的網域設定而變更。 將使用選取的檔案託管網域。
過期時間
 expiresAt integer

到期時。
創建於
 createdAt string

檔案物件的建立時間。
存檔於
 archivedAt string

檔案物件的刪除時間。
Archived
 archived boolean

如果檔案已刪除。
路徑
 path string

檔案管理員中檔案的路徑。
大小
 size integer

以位元組為單位的檔案大小。
名稱
 name string

檔案名稱。
寬度
 width integer

對於影像和視訊檔案，內容的寬度。
ID
 id string

檔案 ID。
預設託管 URL
 defaultHostingUrl string

檔案的預設裝載 URL。 這將使用HubSpot提供的URL之一來提供檔案。
更新於
 updatedAt string

檔案最新更新的時間戳記。
高度
 height integer

對於影像和視訊檔案，內容的高度。

下一頁

名稱 路徑 類型 Description
Link
 link string

鏈接。
之後
 after string

之後。

FolderUpdateTask定位器

有關已啟動的工作的信息，以及檢查其狀態的位置。

名稱 路徑 類型 Description
Links
 links object

用於檢查與任務相關資訊的位置的連結。 此 status 連結提供檢查任務狀態的URL。
ID
 id string

任務的 ID。

存取權

檔案存取。 可以是PUBLIC_INDEXABLE、PUBLIC_NOT_INDEXABLE、私人的。

檔案存取。 可以是PUBLIC_INDEXABLE、PUBLIC_NOT_INDEXABLE、私人的。

存取權
string

地位

任務的當前狀態。

任務的當前狀態。

地位
string