Sociabble (預覽版)
Sociabble 為員工宣傳、社交銷售、內部溝通和員工敬業度提供頂級的企業社交媒體解決方案。 員工獲得更好的信息,改善他們的數字足跡。
此連接器適用於以下產品和區域:
| 服務 | 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.sociabble.com |
| support@sociabble.com |
| 連接器中繼資料 | |
|---|---|
| Publisher | Sociabble |
| 網站 | https://www.sociabble.com |
| 隱私策略 | https://www.sociabble.com/fr/privacy-policy/ |
| 類別 | 網站 |
Sociabble 為員工宣傳、社交銷售、內部溝通和員工敬業度提供頂級的企業社交媒體解決方案。 員工獲得更好的信息,改善他們的數字足跡。
Sociabble 連接器允許您在 Sociabble 中訪問數據並執行操作。 您可以輕鬆地將其集成到 Power Automate 中,以創建內容、獎勵平台上的用戶等。
先決條件
若要使用連接器,您必須訂閱 Sociabble 才能取得 API 金鑰。 如需詳細資訊,請參閱 https://www.sociabble.com。
如何取得認證
一旦您訪問了您的 Sociabble 平台,您需要轉到管理部分,然後轉到 API。 在此頁面上,您可以看到您有權存取的所有產品 API 金鑰。
開始使用連接器
在內容建立案例期間,您應該使用內容產品 API 金鑰。 在遊戲化案例 (例如指派徽章或自訂動作) 期間,您應該使用遊戲化產品 API 金鑰。
正在建立連線
連接器支援下列驗證類型:
| 預設值 | 建立連線的參數。 | 所有區域 | 不可共享 |
預設
適用:所有地區
建立連線的參數。
這不是可共用的連線。 如果 Power App 與其他使用者共用,系統會明確提示其他使用者建立新連線。
| 名稱 | 類型 | Description | 為必填項目 |
|---|---|---|---|
| API 金鑰 | securestring | Sociabble 訂閱金鑰 | 對 |
節流限制
| 名稱 | 呼叫 | 續約期間 |
|---|---|---|
| 每個連線的 API 呼叫 | 100 | 60 秒 |
動作
| 上傳媒體 (已淘汰) [已淘汰] |
上傳媒體(表單資料中的媒體或mediaUrl)以在建立內部新聞期間使用(已淘汰) - Sociabble Basic |
| 傳送快訊給對象或使用者 |
傳送快訊給目標對象或使用者 - Sociabble Standard |
| 取得 Media Drive 資料夾 |
取得 Media Drive 資料夾 - Sociabble Standard |
| 取得媒體磁碟機資料夾 (已淘汰) [已淘汰] |
取得媒體磁碟機資料夾 (已棄用)。 - 社交標準 |
| 取得徽章等級 |
取得徽章等級 - Sociabble Basic |
| 取得所有徽章 |
取得所有徽章 - Sociabble Basic |
| 取得所有目標對象 |
取得所有目標對象 - Sociabble Basic |
| 取得頻道 |
取得頻道 - Sociabble Basic |
| 將媒體從 URL 上傳到媒體磁碟機的資料夾中 |
將媒體從 URL 上傳到媒體磁碟機的資料夾中,並在建立內容時使用 - Sociabble Standard |
| 將媒體從檔案上傳到媒體磁碟機的資料夾中 |
將檔案中的媒體上傳到媒體磁碟機的資料夾中,並在建立內容時使用 - Sociabble Standard |
| 將徽章指派給使用者 |
將徽章指派給使用者 - Sociabble Basic |
| 將檔案上傳至媒體磁碟機資料夾 [已棄用] |
將檔案上傳至媒體雲端硬碟資料夾 - Sociabble Standard |
| 將自訂動作指派給使用者 |
將自訂動作指派給使用者 - Sociabble Basic |
| 建立內部新聞 |
創建內部新聞 - Sociabble Basic |
| 建立外部內容 |
建立外部內容 - Sociabble Basic |
| 建立行動呼籲,建議使用者安裝行動應用程式 |
建立行動呼籲,建議使用者安裝行動應用程式。 - 社交基礎 |
| 建立行動呼籲,建議使用者建立內容 |
建立行動呼籲,建議使用者建立內容 - Sociabble Basic |
| 建立行動呼籲,建議使用者邀請其他使用者 |
建立行動呼籲,建議使用者邀請其他使用者。 - 社交基礎 |
| 建立行動呼籲,通知使用者事件 |
建立行動呼籲,通知使用者事件 - Sociabble Basic |
| 從 URL 上傳媒體 |
從網址上傳媒體,以便在建立內容時使用 - Sociabble Basic |
| 從檔案上傳媒體 |
從檔案上傳媒體以在建立內容時使用 - Sociabble Basic |
| 獲取所有類別 |
獲取所有類別 - Sociabble Basic |
上傳媒體 (已淘汰) [已淘汰]
上傳媒體(表單資料中的媒體或mediaUrl)以在建立內部新聞期間使用(已淘汰) - Sociabble Basic
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
媒體可見性
|
mediaVisibility | True | string |
這代表媒體的可見性。 如果媒體不打算公開可見(例如鏈接到無法共享的內部新聞),則該值應該是私人的 |
|
媒體網址
|
mediaUrl | string |
要上傳的媒體 URL。 您可以指定 media 或 mediaUrl,但不能同時指定兩者 |
|
|
資料夾識別碼
|
folderId | string |
媒體應上傳到的媒體磁碟機資料夾的唯一識別碼。 此參數是選擇性的,且僅適用於標準訂閱 |
|
|
媒體
|
media | file |
要上傳的媒體。 您可以指定 media 或 mediaUrl,但不能同時指定兩者 |
傳回
傳送快訊給對象或使用者
傳送快訊給目標對象或使用者 - Sociabble Standard
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
警示文字
|
alertText | True | string |
警示的文字 |
|
警示標題
|
alertTitle | True | string |
警示的標題 |
|
開始日期
|
startDate | date-time |
警示的傳送日期 |
|
|
結束日期
|
endDate | date-time |
警示不應再顯示的日期 |
|
|
觀眾
|
audienceId | string |
對象的唯一識別碼(如果您願意將警示傳送給許多使用者) |
|
|
用戶名稱
|
username | string |
使用者的使用者名稱 (如果您想要將警示傳送給一個使用者) |
|
|
是強制性的嗎?
|
isMandatory | boolean |
如果您想要使用者確認他們已閱讀警示 |
|
|
發送短信?
|
sendSMS | boolean |
如果您想向用戶發送短信。此參數是選用的,只有進階訂閱才能存取 |
取得 Media Drive 資料夾
取得 Media Drive 資料夾 - Sociabble Standard
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
文化特性
|
culture | string |
傳回標籤的語言 |
傳回
取得媒體磁碟機資料夾 (已淘汰) [已淘汰]
取得媒體磁碟機資料夾 (已棄用)。 - 社交標準
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
文化特性
|
culture | string |
您要傳回預設資料夾的文化特性 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
資料夾
|
folders | array of object |
資料夾 |
|
Id
|
folders.id | string |
資料夾的唯一識別碼 |
|
名稱
|
folders.name | string |
資料夾的名稱 |
取得徽章等級
取得徽章等級 - Sociabble Basic
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
徽章 ID
|
badgeId | True | string |
徽章的唯一識別碼 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
|
array of object | ||
|
徽章 ID
|
badgeId | string |
徽章Id |
|
Level
|
level | integer |
水平儀 |
|
名稱
|
name | string |
名稱 |
取得所有徽章
取得所有徽章 - Sociabble Basic
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
|
array of object | ||
|
Id
|
id | string |
識別碼 |
|
名稱
|
name | string |
名稱 |
取得所有目標對象
取得所有目標對象 - Sociabble Basic
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
|
array of object | ||
|
Id
|
id | string |
識別碼 |
|
名稱
|
name | string |
名稱 |
取得頻道
取得頻道 - Sociabble Basic
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
|
array of object | ||
|
Id
|
id | string |
識別碼 |
|
名稱
|
name | string |
名稱 |
將媒體從 URL 上傳到媒體磁碟機的資料夾中
將媒體從 URL 上傳到媒體磁碟機的資料夾中,並在建立內容時使用 - Sociabble Standard
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
媒體可見性
|
mediaVisibility | True | string |
這代表媒體的可見性。 如果媒體不打算公開可見(例如鏈接到無法共享的內部新聞),則該值應該是私人的 |
|
資料夾識別碼
|
folderId | True | string |
媒體應上傳到的媒體磁碟機資料夾的唯一識別碼。 此參數是選擇性的,且僅適用於標準訂閱 |
|
媒體網址
|
mediaUrl | True | string |
要上傳的媒體 URL。 |
傳回
將媒體從檔案上傳到媒體磁碟機的資料夾中
將檔案中的媒體上傳到媒體磁碟機的資料夾中,並在建立內容時使用 - Sociabble Standard
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
媒體可見性
|
mediaVisibility | True | string |
這代表媒體的可見性。 如果媒體不打算公開可見(例如鏈接到無法共享的內部新聞),則該值應該是私人的 |
|
資料夾識別碼
|
folderId | True | string |
媒體應上傳到的媒體磁碟機資料夾的唯一識別碼。 此參數是選擇性的,且僅適用於標準訂閱 |
|
媒體
|
media | True | file |
要上傳的媒體串流。 |
傳回
將徽章指派給使用者
將徽章指派給使用者 - Sociabble Basic
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
用戶名稱
|
username | True | string |
使用者的使用者名稱 |
|
徽章
|
badgeId | True | string |
要指派的徽章 |
|
Level
|
level | True | integer |
要指派的徽章層級 |
將檔案上傳至媒體磁碟機資料夾 [已棄用]
將檔案上傳至媒體雲端硬碟資料夾 - Sociabble Standard
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
媒體
|
media | True | file |
要上傳的媒體 |
|
資料夾
|
folderId | True | string |
選擇資料夾 |
將自訂動作指派給使用者
將自訂動作指派給使用者 - Sociabble Basic
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
用戶名稱
|
username | True | string |
使用者的使用者名稱 |
|
有吸引力嗎?
|
isEngaging | boolean |
如果自訂動作應被視為吸引人,請選擇 yes |
|
|
是內部的?
|
isInternal | boolean |
如果自訂動作應被視為內部動作,請選擇 yes |
|
|
Points
|
points | integer |
用戶獲得的積分數 |
|
|
語言
|
language | True | string |
內容的語言。 |
|
是預設語言嗎?
|
isDefault | True | boolean |
如果此語言是預設語言,請選擇 yes |
|
Title
|
title | True | string |
撰寫自訂動作的標題 |
|
Description
|
description | string |
撰寫自訂動作的簡短描述 |
|
|
Notification
|
notificationText | True | string |
編寫要作為通知發送給用戶的小文本 |
建立內部新聞
創建內部新聞 - Sociabble Basic
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Channel
|
channelIds | True | array of string | |
|
類別
|
categoryIds | array of string | ||
|
對象ID
|
audienceId | string |
對象的唯一識別碼 |
|
|
出版開始日期
|
publicationStartDate | date-time |
內容應顯示的日期 |
|
|
出版結束日期
|
publicationEndDate | date-time |
內容不應再顯示的日期 |
|
|
我的新聞顯示
|
myNewsDisplay | string |
定義有關在「我的新聞」中顯示內容的行為 |
|
|
應該固定在“我的新聞”的頂部嗎?
|
shouldPinTopOfMyNews | boolean |
如果您希望將內容釘選在「我的新聞」頂部,請選擇「是」 |
|
|
「我的新聞」頂端的開始日期圖釘
|
pinOfMyNewsStartDate | date-time |
您希望將內容釘選在「我的新聞」頂端的日期 |
|
|
「我的新聞」頂端的結束日期圖釘
|
pinOfMyNewsEndDate | date-time |
您希望從「我的新聞」中取消釘選內容的日期 |
|
|
應該固定在所選頻道的頂部嗎?
|
shouldPinTopOfSelectedChannels | boolean |
如果您想要將內容釘選在所選頻道的頂端,請選擇 [是] |
|
|
所選頻道頂端的開始日期釘選
|
pinTopOfSelectedChannelsStartDate | date-time |
您要將內容釘選在所選頻道頂端的日期 |
|
|
所選頻道頂端的結束日期釘選
|
pinTopOfSelectedChannelsEndDate | date-time |
您要從所選頻道取消釘選內容的日期 |
|
|
語言
|
language | True | string |
內容的語言。 |
|
是預設語言嗎?
|
isDefault | True | boolean |
如果應將語言視為預設語言,請選擇 yes |
|
Title
|
title | True | string |
標題 |
|
總結
|
summary | True | string |
內容簡要摘要 |
|
Description
|
description | True | string |
內容 |
|
mediaIds
|
mediaIds | array of string |
包含先前上傳之媒體的唯一識別碼的陣列,這些媒體連結至內容 |
|
|
評論是否授權?
|
areCommentsAuthorized | boolean |
如果內容可以註解,請選擇 [是] |
|
|
應該通知用戶嗎?
|
shouldNotifyUsers | boolean |
如果應該在內容可用時傳送通知給使用者,請選擇 [是] |
|
|
是必讀的嗎?
|
isMustReadContent | boolean |
如果您希望使用者明確將內容標示為已讀,請選擇 [是] |
傳回
代表內部新聞
建立外部內容
建立外部內容 - Sociabble Basic
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Channel
|
channelIds | True | array of string | |
|
類別
|
categoryIds | array of string | ||
|
對象ID
|
audienceId | string |
對象的唯一識別碼 |
|
|
出版開始日期
|
publicationStartDate | date-time |
內容應顯示的日期 |
|
|
出版結束日期
|
publicationEndDate | date-time |
內容不應再顯示的日期 |
|
|
我的新聞顯示
|
myNewsDisplay | string |
定義有關在「我的新聞」中顯示內容的行為 |
|
|
應該固定在“我的新聞”的頂部嗎?
|
shouldPinTopOfMyNews | boolean |
如果您希望將內容釘選在「我的新聞」頂部,請選擇「是」 |
|
|
「我的新聞」頂端的開始日期圖釘
|
pinOfMyNewsStartDate | date-time |
您希望將內容釘選在「我的新聞」頂端的日期 |
|
|
「我的新聞」頂端的結束日期圖釘
|
pinOfMyNewsEndDate | date-time |
您希望從「我的新聞」中取消釘選內容的日期 |
|
|
應該固定在所選頻道的頂部嗎?
|
shouldPinTopOfSelectedChannels | boolean |
如果您想要將內容釘選在所選頻道的頂端,請選擇 [是] |
|
|
所選頻道頂端的開始日期釘選
|
pinTopOfSelectedChannelsStartDate | date-time |
您要將內容釘選在所選頻道頂端的日期 |
|
|
所選頻道頂端的結束日期釘選
|
pinTopOfSelectedChannelsEndDate | date-time |
您要從所選頻道取消釘選內容的日期 |
|
|
語言
|
language | True | string |
內容的語言。 |
|
語言是默認的嗎?
|
isDefault | True | boolean |
如果應將語言視為預設語言,請選擇 yes |
|
Title
|
title | True | string |
標題 |
|
Description
|
description | True | string |
內容 |
|
建議的評論
|
proposedCommentForSharing | string |
分享時會向使用者提出的評論 |
|
|
媒體 ID
|
mediaId | string |
先前上傳的媒體應連結至內容的唯一識別碼 |
|
|
內容網址
|
contentUrl | True | string |
指向外部來源的連結 |
|
內容可共享嗎?
|
isShareable | boolean |
如果內容可以在外部網路上共用,請選擇 [是] |
|
|
是官方內容嗎?
|
isOfficialContent | boolean |
如果內容應被視為官方內容,請選擇 yes |
|
|
評論是否授權?
|
areCommentsAuthorized | boolean |
如果內容可以註解,請選擇 [是] |
|
|
應該通知用戶嗎?
|
shouldNotifyUsers | boolean |
如果應該在內容可用時傳送通知給使用者,請選擇 [是] |
|
|
是必讀內容嗎?
|
isMustReadContent | boolean |
如果您希望使用者明確將內容標示為已讀,請選擇 [是] |
傳回
建立行動呼籲,建議使用者安裝行動應用程式
建立行動呼籲,建議使用者安裝行動應用程式。 - 社交基礎
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Channel
|
channelIds | True | array of string | |
|
類別
|
categoryIds | array of string | ||
|
對象ID
|
audienceId | string |
對象的唯一識別碼 |
|
|
出版開始日期
|
publicationStartDate | date-time |
內容應顯示的日期 |
|
|
出版結束日期
|
publicationEndDate | date-time |
內容不應再顯示的日期 |
|
|
我的新聞顯示
|
myNewsDisplay | string |
定義有關在「我的新聞」中顯示內容的行為 |
|
|
應該固定在“我的新聞”的頂部嗎?
|
shouldPinTopOfMyNews | boolean |
如果您希望將內容釘選在「我的新聞」頂部,請選擇「是」 |
|
|
「我的新聞」頂端的開始日期圖釘
|
pinOfMyNewsStartDate | date-time |
您希望將內容釘選在「我的新聞」頂端的日期 |
|
|
「我的新聞」頂端的結束日期圖釘
|
pinOfMyNewsEndDate | date-time |
您希望從「我的新聞」中取消釘選內容的日期 |
|
|
應該固定在所選頻道的頂部嗎?
|
shouldPinTopOfSelectedChannels | boolean |
如果您想要將內容釘選在所選頻道的頂端,請選擇 [是] |
|
|
所選頻道頂端的開始日期釘選
|
pinTopOfSelectedChannelsStartDate | date-time |
您要將內容釘選在所選頻道頂端的日期 |
|
|
所選頻道頂端的結束日期釘選
|
pinTopOfSelectedChannelsEndDate | date-time |
您要從所選頻道取消釘選內容的日期 |
|
|
語言
|
language | True | string |
內容的語言。 |
|
是默認語言嗎?
|
isDefault | True | boolean |
如果內容語言應該是預設值,請選擇 [是] |
|
Title
|
title | True | string |
行動呼籲的標題 |
|
總結
|
summary | string |
行動呼籲摘要 |
|
|
設定您的影像
|
mediaId | uuid |
先前上傳的媒體應連結至內容的唯一識別碼 |
|
|
標題/摘要前景色
|
titleForegroundColor | string |
標題的前景色 |
|
|
背景色彩
|
backgroundColor | string |
行動呼籲的背景顏色 |
傳回
建立行動呼籲,建議使用者建立內容
建立行動呼籲,建議使用者建立內容 - Sociabble Basic
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Channel
|
channelIds | True | array of string | |
|
類別
|
categoryIds | array of string | ||
|
對象ID
|
audienceId | string |
對象的唯一識別碼 |
|
|
出版開始日期
|
publicationStartDate | date-time |
內容應顯示的日期 |
|
|
出版結束日期
|
publicationEndDate | date-time |
內容不應再顯示的日期 |
|
|
我的新聞顯示
|
myNewsDisplay | string |
定義有關在「我的新聞」中顯示內容的行為 |
|
|
應該固定在“我的新聞”的頂部嗎?
|
shouldPinTopOfMyNews | boolean |
如果您希望將內容釘選在「我的新聞」頂部,請選擇「是」 |
|
|
「我的新聞」頂端的開始日期圖釘
|
pinOfMyNewsStartDate | date-time |
您希望將內容釘選在「我的新聞」頂端的日期 |
|
|
「我的新聞」頂端的結束日期圖釘
|
pinOfMyNewsEndDate | date-time |
您希望從「我的新聞」中取消釘選內容的日期 |
|
|
應該固定在所選頻道的頂部嗎?
|
shouldPinTopOfSelectedChannels | boolean |
如果您想要將內容釘選在所選頻道的頂端,請選擇 [是] |
|
|
所選頻道頂端的開始日期釘選
|
pinTopOfSelectedChannelsStartDate | date-time |
您要將內容釘選在所選頻道頂端的日期 |
|
|
所選頻道頂端的結束日期釘選
|
pinTopOfSelectedChannelsEndDate | date-time |
您要從所選頻道取消釘選內容的日期 |
|
|
語言
|
language | True | string |
內容的語言。 |
|
是默認語言嗎?
|
isDefault | True | boolean |
如果內容語言應該是預設值,請選擇 [是] |
|
Title
|
title | True | string |
行動呼籲的標題 |
|
總結
|
summary | string |
行動呼籲摘要 |
|
|
設定您的影像
|
mediaId | uuid |
先前上傳的媒體應連結至內容的唯一識別碼 |
|
|
標題/摘要前景色
|
titleForegroundColor | string |
標題的前景色 |
|
|
背景色彩
|
backgroundColor | string |
行動呼籲的背景顏色 |
傳回
建立行動呼籲,建議使用者邀請其他使用者
建立行動呼籲,建議使用者邀請其他使用者。 - 社交基礎
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Channel
|
channelIds | True | array of string | |
|
類別
|
categoryIds | array of string | ||
|
對象ID
|
audienceId | string |
對象的唯一識別碼 |
|
|
出版開始日期
|
publicationStartDate | date-time |
內容應顯示的日期 |
|
|
出版結束日期
|
publicationEndDate | date-time |
內容不應再顯示的日期 |
|
|
我的新聞顯示
|
myNewsDisplay | string |
定義有關在「我的新聞」中顯示內容的行為 |
|
|
應該固定在“我的新聞”的頂部嗎?
|
shouldPinTopOfMyNews | boolean |
如果您希望將內容釘選在「我的新聞」頂部,請選擇「是」 |
|
|
「我的新聞」頂端的開始日期圖釘
|
pinOfMyNewsStartDate | date-time |
您希望將內容釘選在「我的新聞」頂端的日期 |
|
|
「我的新聞」頂端的結束日期圖釘
|
pinOfMyNewsEndDate | date-time |
您希望從「我的新聞」中取消釘選內容的日期 |
|
|
應該固定在所選頻道的頂部嗎?
|
shouldPinTopOfSelectedChannels | boolean |
如果您想要將內容釘選在所選頻道的頂端,請選擇 [是] |
|
|
所選頻道頂端的開始日期釘選
|
pinTopOfSelectedChannelsStartDate | date-time |
您要將內容釘選在所選頻道頂端的日期 |
|
|
所選頻道頂端的結束日期釘選
|
pinTopOfSelectedChannelsEndDate | date-time |
您要從所選頻道取消釘選內容的日期 |
|
|
語言
|
language | True | string |
內容的語言。 |
|
是默認語言嗎?
|
isDefault | True | boolean |
如果內容語言應該是預設值,請選擇 [是] |
|
Title
|
title | True | string |
行動呼籲的標題 |
|
總結
|
summary | string |
行動呼籲摘要 |
|
|
設定您的影像
|
mediaId | uuid |
先前上傳的媒體應連結至內容的唯一識別碼 |
|
|
標題/摘要前景色
|
titleForegroundColor | string |
標題的前景色 |
|
|
背景色彩
|
backgroundColor | string |
行動呼籲的背景顏色 |
傳回
建立行動呼籲,通知使用者事件
建立行動呼籲,通知使用者事件 - Sociabble Basic
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Channel
|
channelIds | True | array of string | |
|
對象ID
|
audienceId | string |
對象的唯一識別碼 |
|
|
類別
|
categoryIds | array of string | ||
|
網站連結
|
link | string |
指向外部來源的連結 |
|
|
獎金發放
|
awardedBonus | integer |
使用者按一下行動呼籲所能獲得的點數 |
|
|
語言
|
language | True | string |
內容的語言。 |
|
是默認語言嗎?
|
isDefault | True | boolean |
如果內容語言應該是預設值,請選擇 [是] |
|
標題文字
|
headerText | string |
行動號召的標頭文字 |
|
|
Title
|
title | True | string |
行動呼籲的標題 |
|
總結
|
summary | string |
行動呼籲摘要 |
|
|
按鈕文字
|
buttonText | True | string |
按鈕的文字 |
|
設定您的影像
|
mediaId | uuid |
先前上傳的媒體應連結至內容的唯一識別碼 |
|
|
標頭前景色
|
headerForegroundColor | string |
標頭的前景色 |
|
|
標題背景顏色
|
headerBackgroundColor | string |
標題的背景顏色 |
|
|
標題前景色
|
titleForegroundColor | string |
標題的前景色 |
|
|
摘要前景色
|
summaryForegroundColor | string |
摘要的前景色 |
|
|
背景色彩
|
backgroundColor | string |
行動呼籲的背景顏色 |
|
|
按鈕背景顏色
|
buttonForegroundColor | string |
按鈕的前景色 |
|
|
按鈕背景顏色
|
buttonBackgroundColor | string |
按鈕的前景色 |
|
|
應該顯示標題嗎?
|
shouldDisplayTitle | boolean |
這表示標題是否應該可見 |
|
|
應該顯示按鈕嗎?
|
shouldDisplayButton | boolean |
這表示按鈕是否應該可見 |
|
|
出版開始日期
|
publicationStartDate | date-time |
內容應顯示的日期 |
|
|
出版結束日期
|
publicationEndDate | date-time |
內容不應再顯示的日期 |
|
|
我的新聞顯示
|
myNewsDisplay | string |
定義有關在「我的新聞」中顯示內容的行為 |
|
|
應該固定在“我的新聞”的頂部嗎?
|
shouldPinTopOfMyNews | boolean |
如果您希望將內容釘選在「我的新聞」頂部,請選擇「是」 |
|
|
「我的新聞」頂端的開始日期圖釘
|
pinOfMyNewsStartDate | date-time |
您希望將內容釘選在「我的新聞」頂端的日期 |
|
|
「我的新聞」頂端的結束日期圖釘
|
pinOfMyNewsEndDate | date-time |
您希望從「我的新聞」中取消釘選內容的日期 |
|
|
應該固定在所選頻道的頂部嗎?
|
shouldPinTopOfSelectedChannels | boolean |
如果您想要將內容釘選在所選頻道的頂端,請選擇 [是] |
|
|
所選頻道頂端的開始日期釘選
|
pinTopOfSelectedChannelsStartDate | date-time |
您要將內容釘選在所選頻道頂端的日期 |
|
|
所選頻道頂端的結束日期釘選
|
pinTopOfSelectedChannelsEndDate | date-time |
您要從所選頻道取消釘選內容的日期 |
傳回
從 URL 上傳媒體
從網址上傳媒體,以便在建立內容時使用 - Sociabble Basic
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
媒體可見性
|
mediaVisibility | True | string |
這代表媒體的可見性。 如果媒體不打算公開可見(例如鏈接到無法共享的內部新聞),則該值應該是私人的 |
|
媒體網址
|
mediaUrl | True | string |
要上傳的媒體 URL。 |
傳回
從檔案上傳媒體
從檔案上傳媒體以在建立內容時使用 - Sociabble Basic
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
媒體可見性
|
mediaVisibility | True | string |
這代表媒體的可見性。 如果媒體不打算公開可見(例如鏈接到無法共享的內部新聞),則該值應該是私人的 |
|
媒體
|
media | True | file |
要上傳的媒體串流。 |
傳回
獲取所有類別
獲取所有類別 - Sociabble Basic
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
|
array of object | ||
|
Id
|
id | string |
類別的唯一識別碼 |
|
名稱
|
name | string |
類別名稱 |
|
背景色彩
|
backgroundColor | string |
類別的背景色彩 |
|
文字色彩
|
textColor | string |
類別的文字色彩 |
|
Shoud 填充背景
|
shouldFillBackground | boolean |
如果背景顏色應該填滿所有背景,則值為 true。 如果背景顏色應該在僅邊框模式下使用,則值為 false |
定義
語言行為
內容類型鑑別器
代表內容的類型
成員:
- 無 — 型別未定義,當引進新型別內容但尚不支援時,可能會發生這種情況
- InternalNews - 這代表內部新聞
- 測驗 - 這代表測驗
- 問卷 - 這代表問卷
- ContentForSharing - 這代表與多個內容共用的內容
- CTA - 這代表號召性用語
- 直播 - 這代表直播視頻
- SocialNetworkContent - 這代表從社交網路擷取的內容
- AdminExternalContent - 這代表從系統管理員建立的 Web 連結擷取的內容
- PersonalisedTile - 這代表個人化 (html) 磚
- 投票 - 這代表使用者建立的調查
- UserContent - 這代表使用者建立的內容
- SupportMyCause - 這代表一個支持我的事業的項目
代表內容的類型
成員:
- 無 — 型別未定義,當引進新型別內容但尚不支援時,可能會發生這種情況
- InternalNews - 這代表內部新聞
- 測驗 - 這代表測驗
- 問卷 - 這代表問卷
- ContentForSharing - 這代表與多個內容共用的內容
- CTA - 這代表號召性用語
- 直播 - 這代表直播視頻
- SocialNetworkContent - 這代表從社交網路擷取的內容
- AdminExternalContent - 這代表從系統管理員建立的 Web 連結擷取的內容
- PersonalisedTile - 這代表個人化 (html) 磚
- 投票 - 這代表使用者建立的調查
- UserContent - 這代表使用者建立的內容
- SupportMyCause - 這代表一個支持我的事業的項目
CtaContentTypeDiscriminator
代表行動呼籲內容的類型
成員:
- None - 類型未定義,不應使用
- SuggestContent - 這代表建議使用者建立內容的行動號召
- 行動裝置 - 這代表行動號召,建議使用者安裝行動應用程式
- 邀請 - 這代表建議使用者邀請其他使用者的行動號召
- 事件 — 這代表行動號召,建議使用者簽出外部連結(例如:外部事件)
代表行動呼籲內容的類型
成員:
- None - 類型未定義,不應使用
- SuggestContent - 這代表建議使用者建立內容的行動號召
- 行動裝置 - 這代表行動號召,建議使用者安裝行動應用程式
- 邀請 - 這代表建議使用者邀請其他使用者的行動號召
- 事件 — 這代表行動號召,建議使用者簽出外部連結(例如:外部事件)
內容類別
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
類別識別碼
|
id | string |
類別的唯一識別碼 |
|
類別名稱
|
name | string |
類別名稱 |
|
類別背景顏色
|
backgroundColor | string |
類別的背景色彩 |
|
類別文字顏色
|
textColor | string |
類別的文字色彩 |
|
應該填滿背景
|
shouldFillBackground | boolean |
如果背景顏色應該填滿所有背景,則值為 true。 如果背景顏色應該在僅邊框模式下使用,則值為 false |
內容頻道
代表與內容相關聯的頻道
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
管道識別碼
|
id | string |
通道的唯一識別碼 |
|
頻道名稱
|
name | string |
頻道的名稱 |
|
頻道圖片
|
image | string |
頻道的影像網址 |
|
頻道背景顏色
|
backgroundColor | string |
頻道的背景顏色,以防沒有圖像 |
內容圖片
代表與內容相關聯的影像
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
內容影像識別碼
|
id | string |
影像的唯一識別碼 |
|
內容圖片簡短
|
short | string |
可用來詢問影像轉換的簡短雜湊 |
|
內容圖片網址
|
url | string |
影像網址 |
|
內容影像順序
|
order | integer |
如果有多個影像與內容相關聯,則可以指定順序 |
內部內容
代表內部新聞
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
鑒別器
|
discriminator | ContentTypeDiscriminator |
代表內容的類型 成員:
|
|
Id
|
id | string |
內容的唯一識別碼 |
|
出版日期
|
date | date-time |
內容的發佈日期 |
|
內部網址
|
internalUrl | string |
檢視內容的網址 |
|
channelIds
|
channelIds | array of string |
包含內容顯示之頻道的所有唯一識別碼的陣列。 已棄用:應改用 Channels 屬性 |
|
渠道
|
channels | array of ContentChannel |
包含內容顯示的所有通道的陣列 |
|
對象ID
|
audienceId | string |
對象的不重複識別碼已棄用:此屬性一律為空白或空值 |
|
類別
|
categories | array of ContentCategory |
與內容相關聯的類別 |
|
喜歡的數字
|
likeNumber | integer |
用戶點擊“贊”的次數 |
|
評論編號
|
commentNumber | integer |
用戶留言的次數 |
|
點擊編號
|
clickNumber | integer |
使用者點選內容的次數 |
|
內容已閱讀
|
hasBeenRead | boolean |
如果內容已讀取,則值為 yes |
|
內容
|
contents | array of LocalizedInternalContent |
包含不同語言內容的陣列 |
外部內容
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
鑒別器
|
discriminator | ContentTypeDiscriminator |
代表內容的類型 成員:
|
|
Id
|
id | string |
內容的唯一識別碼 |
|
出版日期
|
date | date-time |
內容的發佈日期 |
|
內部網址
|
internalUrl | string |
檢視內容的網址 |
|
channelIds
|
channelIds | array of string |
包含內容顯示之頻道的所有唯一識別碼的陣列。 已棄用:應改用 Channels 屬性 |
|
渠道
|
channels | array of ContentChannel |
包含內容顯示的所有通道的陣列 |
|
對象ID
|
audienceId | string |
對象的唯一識別碼。 已棄用:此屬性一律為空或空值 |
|
類別
|
categories | array of ContentCategory |
與內容相關聯的類別 |
|
喜歡的數字
|
likeNumber | integer |
用戶點擊“贊”的次數 |
|
評論編號
|
commentNumber | integer |
用戶留言的次數 |
|
點擊編號
|
clickNumber | integer |
使用者點選內容的次數 |
|
內容已閱讀
|
hasBeenRead | boolean |
如果內容已讀取,則值為 yes |
|
內容
|
contents | array of LocalizedExternalContent |
包含不同語言內容的陣列 |
|
內容網址
|
contentUrl | string |
指向外部來源的連結 |
|
內容可共享嗎?
|
isShareable | boolean |
如果內容可以在外部網路上共用,請選擇 [是] |
|
內容是官方的嗎?
|
isOfficialContent | boolean |
如果內容應被視為官方內容,請選擇 yes |
|
評論是否授權?
|
areCommentsAuthorized | boolean |
如果內容可以註解,請選擇 [是] |
本地化外部內容
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
語言
|
language | LanguageBehavior |
內容的語言。 |
|
是預設語言嗎?
|
isDefault | boolean |
如果應將語言視為預設語言,請選擇 yes |
|
Title
|
title | string |
標題 |
|
Description
|
description | string |
內容 |
|
建議的評論
|
proposedCommentForSharing | string |
分享時會向使用者提出的評論 |
|
媒體 ID
|
mediaId | string |
先前上傳的媒體應連結至內容的唯一識別碼 |
|
圖片
|
image | ContentImage |
代表與內容相關聯的影像 |
本地化內部內容
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
語言
|
language | string |
內容的語言 |
|
是預設語言嗎?
|
isDefault | boolean |
如果應將語言視為預設語言,請選擇 yes |
|
Title
|
title | string |
標題 |
|
總結
|
summary | string |
內容簡要摘要 |
|
Description
|
description | string |
內容 |
|
mediaIds
|
mediaIds | array of string |
包含先前上傳之媒體的唯一識別碼的陣列,這些媒體連結至內容。 已棄用:應改用 Medias 屬性 |
|
媒體
|
medias | array of ContentImage |
內容的圖像 |
本地化BaseCtaContent
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
語言
|
language | string |
號召性用語的語言 |
|
isDefault
|
isDefault | boolean |
如果內容語言是預設值,則值為 true |
|
title
|
title | string |
行動呼籲的標題 |
|
摘要
|
summary | string |
行動呼籲摘要 |
|
圖片
|
image | ContentImage |
代表與內容相關聯的影像 |
|
標題ForegroundColor
|
titleForegroundColor | string |
標題的前景色 |
|
背景顏色
|
backgroundColor | string |
行動呼籲的背景顏色 |
本地化CtaEvent內容
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
語言
|
language | string |
號召性用語的語言 |
|
isDefault
|
isDefault | boolean |
如果內容語言是預設值,則值為 true |
|
title
|
title | string |
行動呼籲的標題 |
|
摘要
|
summary | string |
行動呼籲摘要 |
|
圖片
|
image | ContentImage |
代表與內容相關聯的影像 |
|
標題ForegroundColor
|
titleForegroundColor | string |
標題的前景色 |
|
背景顏色
|
backgroundColor | string |
行動呼籲的背景顏色 |
|
標題文字
|
headerText | string |
標頭的文字 |
|
按鈕文字
|
buttonText | string |
按鈕的文字 |
|
headerForegroundColor
|
headerForegroundColor | string |
標頭的前景色 |
|
headerBackgroundColor
|
headerBackgroundColor | string |
標題的背景顏色 |
|
按鈕前景色
|
buttonForegroundColor | string |
按鈕的前景色 |
|
按鈕背景顏色
|
buttonBackgroundColor | string |
按鈕的背景顏色 |
|
summaryForegroundColor
|
summaryForegroundColor | string |
摘要的前景色 |
GetFolders回應
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
資料夾
|
folders | array of MediaFolder |
媒體資料夾陣列 |
媒體資料夾
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
資料夾識別碼
|
id | string |
資料夾的唯一識別碼 |
|
資料夾名稱
|
name | string |
資料夾的名稱 |
|
可以上傳到資料夾
|
canUploadInto | boolean |
如果可以上傳此資料夾中的檔案,則值為「是」 |
|
可以上傳到文件夾
|
isGeneratedFolder | boolean |
如果資料夾是由系統產生,則值為 yes |
上傳媒體回應
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
媒體 ID
|
mediaId | string |
媒體的唯一識別碼 |
|
媒體網址
|
url | string |
媒體網址 |
Cta建議內容
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
cta鑑別器
|
ctaDiscriminator | CtaContentTypeDiscriminator |
代表行動呼籲內容的類型 成員:
|
|
鑒別器
|
discriminator | ContentTypeDiscriminator |
代表內容的類型 成員:
|
|
識別碼
|
id | uuid |
內容的唯一識別碼 |
|
date
|
date | date-time |
內容的發佈日期 |
|
內部網址
|
internalUrl | string |
檢視內容的網址 |
|
channelIds
|
channelIds | array of uuid |
包含內容顯示之頻道的所有唯一識別碼的陣列 已棄用:應改用 Channels 屬性 |
|
通道
|
channels | array of ContentChannel |
包含內容顯示的所有通道的陣列 |
|
audienceId
|
audienceId | uuid |
對象的唯一識別碼 已棄用:此屬性一律為空或空值 |
|
categories
|
categories | array of ContentCategory |
與內容相關聯的類別 |
|
喜歡的號碼
|
likeNumber | integer |
用戶點擊“贊”的次數 |
|
評論編號
|
commentNumber | integer |
用戶留言的次數 |
|
點擊編號
|
clickNumber | integer |
使用者點選內容的次數 |
|
已閱讀
|
hasBeenRead | boolean |
如果內容已讀取,則值為 yes |
|
內容
|
contents | array of LocalizedBaseCtaContent |
包含不同語言行動號召的陣列 |
Cta邀請內容
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
cta鑑別器
|
ctaDiscriminator | CtaContentTypeDiscriminator |
代表行動呼籲內容的類型 成員:
|
|
鑒別器
|
discriminator | ContentTypeDiscriminator |
代表內容的類型 成員:
|
|
識別碼
|
id | uuid |
內容的唯一識別碼 |
|
date
|
date | date-time |
內容的發佈日期 |
|
內部網址
|
internalUrl | string |
檢視內容的網址 |
|
channelIds
|
channelIds | array of uuid |
包含內容顯示之頻道的所有唯一識別碼的陣列 已棄用:應改用 Channels 屬性 |
|
通道
|
channels | array of ContentChannel |
包含內容顯示的所有通道的陣列 |
|
audienceId
|
audienceId | uuid |
對象的唯一識別碼 已棄用:此屬性一律為空或空值 |
|
categories
|
categories | array of ContentCategory |
與內容相關聯的類別 |
|
喜歡的號碼
|
likeNumber | integer |
用戶點擊“贊”的次數 |
|
評論編號
|
commentNumber | integer |
用戶留言的次數 |
|
點擊編號
|
clickNumber | integer |
使用者點選內容的次數 |
|
已閱讀
|
hasBeenRead | boolean |
如果內容已讀取,則值為 yes |
|
內容
|
contents | array of LocalizedBaseCtaContent |
包含不同語言行動號召的陣列 |
CtaMobile內容
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
cta鑑別器
|
ctaDiscriminator | CtaContentTypeDiscriminator |
代表行動呼籲內容的類型 成員:
|
|
鑒別器
|
discriminator | ContentTypeDiscriminator |
代表內容的類型 成員:
|
|
識別碼
|
id | uuid |
內容的唯一識別碼 |
|
date
|
date | date-time |
內容的發佈日期 |
|
內部網址
|
internalUrl | string |
檢視內容的網址 |
|
channelIds
|
channelIds | array of uuid |
包含內容顯示之頻道的所有唯一識別碼的陣列 已棄用:應改用 Channels 屬性 |
|
通道
|
channels | array of ContentChannel |
包含內容顯示的所有通道的陣列 |
|
audienceId
|
audienceId | uuid |
對象的唯一識別碼 已棄用:此屬性一律為空或空值 |
|
categories
|
categories | array of ContentCategory |
與內容相關聯的類別 |
|
喜歡的號碼
|
likeNumber | integer |
用戶點擊“贊”的次數 |
|
評論編號
|
commentNumber | integer |
用戶留言的次數 |
|
點擊編號
|
clickNumber | integer |
使用者點選內容的次數 |
|
已閱讀
|
hasBeenRead | boolean |
如果內容已讀取,則值為 yes |
|
內容
|
contents | array of LocalizedBaseCtaContent |
包含不同語言行動號召的陣列 |
CtaEvent內容
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
鑒別器
|
discriminator | ContentTypeDiscriminator |
代表內容的類型 成員:
|
|
識別碼
|
id | uuid |
內容的唯一識別碼 |
|
date
|
date | date-time |
內容的發佈日期 |
|
內部網址
|
internalUrl | string |
檢視內容的網址 |
|
channelIds
|
channelIds | array of uuid |
包含內容顯示之頻道的所有唯一識別碼的陣列 已棄用:應改用 Channels 屬性 |
|
通道
|
channels | array of ContentChannel |
包含內容顯示的所有通道的陣列 |
|
audienceId
|
audienceId | uuid |
對象的唯一識別碼 已棄用:此屬性一律為空或空值 |
|
categories
|
categories | array of ContentCategory |
與內容相關聯的類別 |
|
喜歡的號碼
|
likeNumber | integer |
用戶點擊“贊”的次數 |
|
評論編號
|
commentNumber | integer |
用戶留言的次數 |
|
點擊編號
|
clickNumber | integer |
使用者點選內容的次數 |
|
已閱讀
|
hasBeenRead | boolean |
如果內容已讀取,則值為 yes |
|
授予獎金
|
awardedBonus | integer |
使用者按一下行動呼籲所能獲得的點數 |
|
連結
|
link | string |
指向外部來源的連結 |
|
應該顯示按鈕
|
shouldDisplayButton | boolean |
這表示按鈕是否應該可見 |
|
應該顯示標題
|
shouldDisplayTitle | boolean |
這表示標題是否應該可見 |
|
cta鑑別器
|
ctaDiscriminator | CtaContentTypeDiscriminator |
代表行動呼籲內容的類型 成員:
|
|
內容
|
contents | array of LocalizedCtaEventContent |
包含不同語言行動號召的陣列 |