Smartsheet

Smartsheet 是一款功能強大的工作管理和協作工具，可讓您輕鬆跟踪和管理您的工作，讓您和您的團隊比以往任何時候都更有效率。 使用它與他人協作、跟踪任何項目的進度、自動化流程並更好地構建您的工作。

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

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

連絡人​​
名稱	Microsoft
URL	Microsoft LogicApps 支援 Microsoft Power Automate 支援 Microsoft Power Apps 支援

連接器中繼資料
Publisher	Microsoft
網站	https://www.smartsheet.com/
隱私策略	https://www.smartsheet.com/legal/privacy

要使用此集成，您需要訪問 Smartsheet 帳戶。 若要建立連線，請選取 [登入]。 系統將提示您提供您的 Smartsheet 帳戶信息，然後按照其餘屏幕創建連接。

您現在已準備好開始使用此整合。

節流限制

名稱	呼叫	續約期間
觸發輪詢的頻率	1	15 秒

動作

列出工作表	取得工作表清單。
取得一張工作表	取得特定工作表。
取得工作表的討論	取得特定工作表的討論。
取得工作表的資料行	取得特定工作表的欄。
取得工作表的資料行 （動態結構描述）	以動態結構描述格式獲取特定工作表的欄。
取得工作表資料 （動態結構描述）	取得特定的工作表資料。
取得資料夾的子資料夾	取得特定資料夾的子資料夾。
在討論中新增註解	將註解新增至現有的討論。
將討論新增至列	將討論新增至工作表中的特定列。
將討論新增至工作表	將討論新增至工作表
插入列	將資料列插入特定工作表。
進行討論	進行具體討論。

列出工作表

作業識別碼：

ListSheets

取得工作表清單。

參數

名稱	機碼	必要	類型	Description
資料夾識別碼 （預設為全部）	optionalFolderId		string	包含工作表之資料夾的唯一 ID。 如果未指定，則預設為全部。

傳回

從 Smartsheet 請求集合的常見模式。

身體

SmartsheetCollection[Sheet]

取得一張工作表

作業識別碼：

GetSheet

取得特定工作表。

參數

名稱	機碼	必要	類型	Description
工作表 ID	sheetId	True	string	工作表的唯一識別碼。
以逗號分隔的直欄傳回	columns		string	要傳回的資料行清單

傳回

具有列的 Smartsheet 工作表。

身體

SheetWithRows

取得工作表的討論

作業識別碼：

GetDiscussionsForSheet

取得特定工作表的討論。

參數

名稱	機碼	必要	類型	Description
工作表 ID	sheetId	True	string	工作表的唯一識別碼。

傳回

從 Smartsheet 請求集合的常見模式。

身體

SmartsheetCollection[GetDiscussionResponse]

取得工作表的資料行

作業識別碼：

GetColumns

取得特定工作表的欄。

參數

名稱	機碼	必要	類型	Description
工作表 ID	sheetId	True	string	工作表的唯一識別碼。

傳回

從 Smartsheet 請求集合的常見模式。

身體

SmartsheetCollection[Column]

取得工作表的資料行 （動態結構描述）

作業識別碼：

GetColumnsSchema

以動態結構描述格式獲取特定工作表的欄。

參數

名稱	機碼	必要	類型	Description
工作表 ID	sheetId	True	string	工作表的唯一識別碼。

取得工作表資料 （動態結構描述）

作業識別碼：

GetSheetData

取得特定的工作表資料。

參數

名稱	機碼	必要	類型	Description
工作表 ID	sheetId	True	string	工作表的唯一識別碼。
以逗號分隔的直欄傳回	columns		string	要傳回的資料行清單

傳回

此作業會輸出隨機的結果。

取得資料夾的子資料夾

作業識別碼：

ListSubFolders

取得特定資料夾的子資料夾。

參數

名稱	機碼	必要	類型	Description
資料夾識別碼	id	True	string	資料夾的 ID。

傳回

從 Smartsheet 請求集合的常見模式。

身體

SmartsheetCollection[Folder]

在討論中新增註解

作業識別碼：

AddCommentToDiscussion

將註解新增至現有的討論。

參數

名稱	機碼	必要	類型	Description
工作表 ID	sheetId	True	string	工作表的唯一識別碼。
討論	discussionId	True	string	要添加評論的討論。
文字	text		string	批註的文字。

傳回

建立註解的回應物件。

身體

CreateCommentResponse

將討論新增至列

作業識別碼：

AddDiscussionToRow

將討論新增至工作表中的特定列。

參數

名稱	機碼	必要	類型	Description
張	sheetId	True	string	工作表的唯一識別碼。
資料列識別碼	rowId	True	string	資料列的唯一識別碼。
Title	title		string	討論的標題。
文字	text		string	批註的文字。

傳回

建立討論的回應物件。

身體

DiscussionResponse

將討論新增至工作表

作業識別碼：

AddDiscussionToSheet

將討論新增至工作表

參數

名稱	機碼	必要	類型	Description
工作表 ID	sheetId	True	string	要新增討論的工作表
Title	title		string	討論的標題。
文字	text		string	批註的文字。

傳回

建立討論的回應物件。

身體

DiscussionResponse

插入列

作業識別碼：

InsertRow

將資料列插入特定工作表。

參數

名稱	機碼	必要	類型	Description
工作表 ID	sheetId	True	string	工作表的唯一識別碼。
Row	row	True	dynamic	要插入的資料列。

傳回

回應 InsertRow 作業。

身體

InsertRowResponse

進行討論

作業識別碼：

GetDiscussion

進行具體討論。

參數

名稱	機碼	必要	類型	Description
工作表 ID	sheetId	True	string	工作表的唯一識別碼。
討論 ID	discussionId	True	string	指定工作表上討論的唯一識別碼。

傳回

與所建立討論相關的資料。

身體

DiscussionData

觸發程序

將討論新增至工作表時	將討論新增至工作表時觸發。
將註解新增至工作表時	將註解新增至特定工作表時觸發。
將註解新增至討論時	將註解新增至特定討論時觸發。
建立新列時	在特定工作表中建立新列時觸發。
建立新圖紙時	建立新工作表時觸發。
更新任何工作表時	更新任何工作表時觸發。
更新工作表時	更新特定工作表時觸發。

將討論新增至工作表時

作業識別碼：

OnDiscussionCreated

將討論新增至工作表時觸發。

參數

名稱	機碼	必要	類型	Description
工作表 ID	sheetId	True	string	工作表的唯一識別碼。

傳回

從 Smartsheet 請求集合的常見模式。

身體

SmartsheetCollection[GetDiscussionResponse]

將註解新增至工作表時

作業識別碼：

OnNewComment

將註解新增至特定工作表時觸發。

參數

名稱	機碼	必要	類型	Description
工作表 ID	sheetId	True	string	工作表的唯一識別碼。

傳回

從 Smartsheet 請求集合的常見模式。

身體

SmartsheetCollection[DiscussionComment]

將註解新增至討論時

作業識別碼：

OnCommentAdded

將註解新增至特定討論時觸發。

參數

名稱	機碼	必要	類型	Description
工作表 ID	sheetId	True	string	工作表的唯一識別碼。
討論 ID	discussionId	True	string	討論的唯一 ID。

傳回

Comment 的回應物件。

身體

CommentResponse

建立新列時

作業識別碼：

OnRowCreated

在特定工作表中建立新列時觸發。

參數

名稱	機碼	必要	類型	Description
工作表 ID	sheetId	True	string	工作表的唯一識別碼。
Columns	columns		string	逗號分隔欄清單。

傳回

OnRowCreated 的回應物件。

身體

RowResponse

建立新圖紙時

作業識別碼：

OnNewSheet

建立新工作表時觸發。

參數

名稱	機碼	必要	類型	Description
資料夾識別碼 （預設為全部）	optionalFolderId		string	包含工作表之資料夾的唯一 ID。 如果未指定，則預設為全部。

傳回

從 Smartsheet 請求集合的常見模式。

身體

SmartsheetCollection[Sheet]

更新任何工作表時

作業識別碼：

OnUpdatedSheet

更新任何工作表時觸發。

參數

名稱	機碼	必要	類型	Description
資料夾 （預設為全部）	optionalFolderId		string	包含工作表之資料夾的唯一 ID。 如果未指定，則預設為全部。

傳回

從 Smartsheet 請求集合的常見模式。

身體

SmartsheetCollection[Sheet]

更新工作表時

作業識別碼：

OnUpdatedSpecificSheet

更新特定工作表時觸發。

參數

名稱	機碼	必要	類型	Description
工作表 ID	sheetId	True	string	工作表的唯一識別碼。
要傳回的欄	columns		string	逗號分隔要傳回的資料行清單。

傳回

從 Smartsheet 請求集合的常見模式。

身體

SmartsheetCollection[SheetWithRows]

定義

SmartsheetCollection[工作表]

從 Smartsheet 請求集合的常見模式。

名稱	路徑	類型	Description
資料	data	array of Sheet	Smartsheet 模型集合。

張

Smartsheet 工作表。

名稱	路徑	類型	Description
存取層級	accessLevel	string	工作表的存取層級。
Id	id	integer	工作表的唯一識別碼。
名稱	name	string	工作表的名稱。
網址	permalink	string	工作表的網址。
創建於	createdAt	date-time	建立工作表的日期時間。
修改時間	modifiedAt	date-time	修改工作表的日期時間。

SmartsheetCollection[討論評論]

從 Smartsheet 請求集合的常見模式。

名稱	路徑	類型	Description
資料	data	array of DiscussionComment	Smartsheet 模型集合。

討論評論

對討論的評論。

名稱	路徑	類型	Description
註解文字	text	string	批註的文字。
註解 ID	id	integer	註解的識別碼。
由...創建	createdBy	DiscussionCommentUser	建立註解的使用者。
創建於	createdAt	date-time	建立註解的日期時間。
修改時間	modifiedAt	date-time	修改註解的日期時間。

討論評論用戶

建立註解的使用者。

名稱	路徑	類型	Description
建立者 （名稱）	name	string	建立註解的使用者名稱。
建立者 （電子郵件）	email	string	建立註解之使用者的電子郵件。

工作表與列

具有列的 Smartsheet 工作表。

名稱	路徑	類型	Description
工作表 HTML	rowHTML	string	工作表的 HTML 表格表示法。
存取層級	accessLevel	string	工作表的存取層級。
Id	id	integer	工作表的唯一識別碼。
名稱	name	string	工作表的名稱。
網址	permalink	string	工作表的網址。
創建於	createdAt	date-time	工作表的建立日期時間。
修改時間	modifiedAt	date-time	修改工作表的日期時間。
Columns	columns	array of Column	資料行陣列。
Rows	rows	array of RowData	列陣列。

SmartsheetCollection[欄]

從 Smartsheet 請求集合的常見模式。

名稱	路徑	類型	Description
資料	data	array of Column	Smartsheet 模型集合

資料行

Smartsheet 資料行。

名稱	路徑	類型	Description
資料行識別碼	id	integer	資料行的唯一識別碼。
資料行索引	index	integer	資料行的序數位置。
Title	title	string	欄的標題。
數據類型	type	string	資料行的資料類型 （例如 text_number 或 datetime）。
是主要的	primary	boolean	布林值 （true、false） ，決定資料行是否為主要資料行。
寬度	width	integer	欄的寬度（以像素為單位），

插入行回應

回應 InsertRow 作業。

名稱	路徑	類型	Description
結果	result	InsertRowResponseResult

插入行回應結果

名稱	路徑	類型	Description
工作表 ID	sheetId	integer	已修改之工作表的識別碼。
列號	rowNumber	integer	新插入的列的列號。
創建於	createdAt	date-time	工作表的建立日期時間。
修改時間	modifiedAt	date-time	修改工作表的日期時間。

SmartsheetCollection[SheetWithRows]

從 Smartsheet 請求集合的常見模式。

名稱	路徑	類型	Description
資料	data	array of SheetWithRows	Smartsheet 模型集合。

SmartsheetCollection[資料夾]

從 Smartsheet 請求集合的常見模式。

名稱	路徑	類型	Description
資料	data	array of Folder	Smartsheet 模型集合。

資料夾

Smartsheet 資料夾。

名稱	路徑	類型	Description
Id	id	integer	資料夾的唯一識別碼。
名稱	name	string	資料夾的名稱。
網址	permalink	string	資料夾的 URL。

討論回應

建立討論的回應物件。

名稱	路徑	類型	Description
結果	result	DiscussionData	與所建立討論相關的資料。

討論數據

與所建立討論相關的資料。

名稱	路徑	類型	Description
討論的 Id	id	integer	討論的 ID。
討論標題	title	string	討論的標題。
評論	comments	array of DiscussionComment	討論中的評論。
由...創建	createdBy	DiscussionUser	建立討論的使用者。

討論用戶

建立討論的使用者。

名稱	路徑	類型	Description
建立者 （名稱）	name	string	建立討論的使用者名稱。
建立者 （電子郵件）	email	string	建立討論之使用者的電子郵件。

SmartsheetCollection[GetDiscussion回應]

從 Smartsheet 請求集合的常見模式。

名稱	路徑	類型	Description
資料	data	array of GetDiscussionResponse	Smartsheet 模型集合。

GetDiscussion回應

取得討論的回應物件。

名稱	路徑	類型	Description
討論 ID	id	integer	討論的唯一 ID。
討論標題	title	string	討論的標題。
由...創建	createdBy	DiscussionUser	建立討論的使用者。
存取層級	accessLevel	string	討論的存取層級。
父類型	parentType	string	討論的父類型。
是 Read-Only	readOnly	boolean	布林值 （true、false） ，決定此討論是否為唯讀。
最後評論時間	lastCommentedAt	date-time	最近註解的日期時間

RowResponse

OnRowCreated 的回應物件。

名稱	路徑	類型	Description
Rows	rows	array of RowData	已建立之列的內容。

資料列

一排

名稱	路徑	類型	Description
資料列識別碼	id	integer	資料列的唯一識別碼。
工作表 ID	sheetId	integer	新增資料列的工作表的 ID。
網址	permalink	string	新增資料列的工作表的 URL。
創建於	createdAt	date-time	建立資料列的日期時間。
修改時間	modifiedAt	date-time	修改資料列的日期時間。
列號	rowNumber	integer	列的編號。
細胞	cells	array of RowCell	列中的儲存格詳細資料。
列 HTML	rowHTML	string	新列的 HTML 表格表示法。

列單元格

一列中的儲存格

名稱	路徑	類型	Description
資料行識別碼	columnId	integer	此儲存格的資料行識別碼。
儲存格值	value		儲存格的值。
儲存格顯示值	displayValue	string	儲存格的顯示值。

CreateComment回應

建立註解的回應物件。

名稱	路徑	類型	Description
結果	result	DiscussionComment	對討論的評論。

評論回應

Comment 的回應物件。

名稱	路徑	類型	Description
評論	comments	array of DiscussionComment	本次討論中的評論。