共用方式為

X

X，以前稱為 Twitter，是一種在線社交網絡服務，使用戶能夠發送和接收短帖子。 連接到 X 來管理您的貼文。 您可以執行各種操作，例如發送帖子、搜索、查看關注者等。

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

服務 Class Regions
副駕駛工作室 標準 除下列區域外的所有 Power Automate 區域 ：
     - 由 21Vianet 營運的中國雲
邏輯應用程式 標準 所有 Logic Apps 區域， 但下列區域除外：
     - Azure 中國區域
     - 美國國防部 （DoD）
Power Apps 標準 除下列區域外的所有 Power Apps 區域 ：
     - 由 21Vianet 營運的中國雲
Power Automate（自動化服務） 標準 除下列區域外的所有 Power Automate 區域 ：
     - 由 21Vianet 營運的中國雲
連絡人​​
名稱 Microsoft
URL Microsoft LogicApps 支援
Microsoft Power Automate 支援
Microsoft Power Apps 支援
連接器中繼資料
Publisher Microsoft
網站 https://x.com/
隱私策略 https://x.com/privacy

驗證和自備應用程式

這很重要

預設共用應用程式 （由 Microsoft 維護的 Twitter 用戶端應用程式） 不再可用。 連接器現在僅支援一種驗證類型 - 自備應用程式。 自 2023 年 6 月起，它需要付費的企業層應用程式。 然而，Twitter 的定價政策可能會繼續改變。

透過「自備應用程式」選項，您可以使用自己的 Twitter OAuth 用戶端應用程式。 這可讓您控制權限，並啟用連接器使用的某些限制。

若要搭配 Twitter 連接器使用您自己的 Twitter OAuth 用戶端應用程式，您必須執行下列步驟：

  1. 使用 Twitter 開發人員頁面 （https://developer.twitter.com） 建立 OAuth 用戶端應用程式
  2. 在 Twitter 連接器中使用應用程式

在 Twitter 中建立 OAuth 用戶端應用程式

若要建立您自己的 Twitter OAuth 用戶端應用程式，您必須先登入 https://developer.twitter.com。 導航到“項目和應用程序”部分，您可以在其中管理和創建 Twitter 應用程序。 Twitter 的 Twitter 開發者指南中解釋了此過程。 在開發者頁面上創建 Twitter 應用程序後，需要執行以下步驟才能正確設置：

  • 選擇您的 Twitter 應用程序
  • 編輯應用程式權限以啟用讀取和寫入。
  • 編輯驗證設定
    • 啟用第三方驗證
    • 新增 https://global.consent.azure-apim.net/redirect 回呼 URL（注意： 如果您使用的是 Fairfax 訂閱或 GCC 環境，請查看「Fairfax 和 GCC 回呼」部分）
    • 設定「網站網址」（必填欄位，但其值不會影響流程）

Fairfax 和 GCC 回呼

如果您使用 Fairfax 訂閱或 GCC 環境，請為 Twitter 應用程式的回呼 URL 新增下列網址：

  • 對於費爾法克斯：
    • https://logic-apis-usgovvirginia.consent.azure-apihub.us/redirect
    • https://logic-apis-usgovtexas.consent.azure-apihub.us/redirect
    • https://logic-apis-usgovarizona.consent.azure-apihub.us/redirect
  • 對於海灣合作委員會：
    • https://power-apis-usgov001-public.consent.azure-apihub.us/redirect

完成後，選擇您的 Twitter 應用程式並導航至「金鑰和令牌」頁面。 在「取用者金鑰」部分中，按一下「檢視金鑰」按鈕，以取得應用程式的 API 金鑰 和 API 金鑰秘密 。 您現在可以在 Twitter 連線中使用這些值。

在 Twitter 連接器中使用您自己的應用程式

建立 Twitter OAuth 用戶端應用程式後，您可以在建立 Twitter 連線時使用它。

  • 選取 [自備應用程式]。
  • 從您的應用程式指定用戶端 ID 和用戶端密碼值。 （使用您的 Twitter 應用程序的 API 密鑰 和 API 密鑰 秘密）

點擊登入 以 登入您的 Twitter 帳戶。 這將提示您登錄您的 Twitter 帳戶，然後授權訪問您在上面創建的 Twitter 應用程序。

限制

以下是一些限制和限制：

  1. 每個使用者的連線數上限：2
  2. POST 作業的 API 呼叫速率限制：每小時 12 次
  3. 其他作業的 API 呼叫速率限制：每小時 600 次
  4. 觸發輪詢頻率：1小時
  5. 圖片上傳大小上限：5 MB
  6. 影片上傳大小上限：15 MB
  7. 搜尋結果數量上限：100
  8. 在一個輪詢間隔內追蹤的新推文數量上限：5
  9. 允許的「搜尋文字」參數值長度上限為 470

Twitter API 的限制

  1. 搜尋 API 會針對過去 7 天內最近發佈的推文樣本進行搜尋
  2. 標準搜尋 API 著重於相關性，而不是完整性。 這意味著搜尋結果中可能會缺少某些推文和用戶

POST 作業的其他限制

不支持在發布推文時提及。@user 具體來說，發布推文時將剝離“@”字符。

一般限制

名稱 價值觀
每個帳戶的連線數 2

正在建立連線

連接器支援下列驗證類型：
自備應用程式 使用您自己的 Twitter 應用程序登錄。 如需詳細資訊，請參閱本頁的「驗證和自備應用程式」一節。 所有區域 不可共享
預設值 [已棄用] 此選項僅適用於沒有明確驗證類型的舊連線，並且僅用於回溯相容性。 所有區域 不可共享

自備應用程式

身份驗證 ID：byoa

適用：所有地區

使用您自己的 Twitter 應用程序登錄。 如需詳細資訊，請參閱本頁的「驗證和自備應用程式」一節。

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

名稱 類型 Description 為必填項目
消費者金鑰 字串 Twitter 應用程式的取用者金鑰 對
消費者秘密 securestring Twitter 應用程式的用戶端密碼 對

預設值 [已棄用]

適用：所有地區

此選項僅適用於沒有明確驗證類型的舊連線，並且僅用於回溯相容性。

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

動作

取得使用者

此作業會取得指定使用者的設定檔詳細資料，例如使用者名稱、描述、追蹤者計數等。
取得使用者時間表

此作業會取得指定使用者張貼的最新推文清單。
回家時間表

此操作獲取我和我的關注者發布的最新推文和轉發推文。
搜尋推文

此作業會取得符合搜尋查詢的相關推文清單。
獲得我的追蹤者

此作業會取得追蹤我的使用者清單。
獲得我的追蹤者

此作業會取得我追蹤的使用者清單。
獲得關注

此作業會取得指定使用者所追蹤的人員清單。
獲得關注者

此作業會取得追蹤指定使用者的使用者清單。
發布推文

此操作發布了一條新推文。
轉發

此操作會轉發一條推文。

取得使用者

作業識別碼：
User

此作業會取得指定使用者的設定檔詳細資料，例如使用者名稱、描述、追蹤者計數等。

參數

名稱 機碼 必要 類型 Description
使用者名
 userName True string

X 句柄。

傳回

代表使用者。

身體
UserDetailsModel

取得使用者時間表

作業識別碼：
UserTimeline

此作業會取得指定使用者張貼的最新推文清單。

參數

名稱 機碼 必要 類型 Description
使用者名
 userName True string

X 句柄。
最大結果
 maxResults integer

要返回的推文數量上限。

傳回

response
array of TweetModel

回家時間表

作業識別碼：
HomeTimeline

此操作獲取我和我的關注者發布的最新推文和轉發推文。

參數

名稱 機碼 必要 類型 Description
最大結果
 maxResults integer

要返回的推文數量上限。

傳回

response
array of TweetModel

搜尋推文

作業識別碼：
SearchTweet

此作業會取得符合搜尋查詢的相關推文清單。

參數

名稱 機碼 必要 類型 Description
搜尋文字
 searchQuery True string

搜索詞，如“歡樂時光”、#haiku、from：@username、愛或恨。
最大結果
 maxResults integer

要返回的推文數量上限。
sinceId
 sinceId string

在指定的推文 ID 之後返回推文。

傳回

response
array of TweetModel

獲得我的追蹤者

作業識別碼：
MyFollowers

此作業會取得追蹤我的使用者清單。

參數

名稱 機碼 必要 類型 Description
最大結果
 maxResults integer

要取得的使用者數目上限。

傳回

response
array of UserDetailsModel

獲得我的追蹤者

作業識別碼：
MyFollowing

此作業會取得我追蹤的使用者清單。

參數

名稱 機碼 必要 類型 Description
最大結果
 maxResults integer

要返回的使用者數目上限。

傳回

response
array of UserDetailsModel

獲得關注

作業識別碼：
Following

此作業會取得指定使用者所追蹤的人員清單。

參數

名稱 機碼 必要 類型 Description
使用者名
 userName True string

X 句柄。
最大結果
 maxResults integer

要返回的使用者數目上限。

傳回

response
array of UserDetailsModel

獲得關注者

作業識別碼：
Followers

此作業會取得追蹤指定使用者的使用者清單。

參數

名稱 機碼 必要 類型 Description
使用者名
 userName True string

X 句柄。
最大結果
 maxResults integer

要返回的使用者數目上限。

傳回

response
array of UserDetailsModel

發布推文

作業識別碼：
Tweet

此操作發布了一條新推文。

參數

名稱 機碼 必要 類型 Description
推文文字
 tweetText string

要發布的文本。
媒體
 body binary

媒體待發布。

傳回

代表推文貼文的回應。

身體
TweetResponseModel

轉發

作業識別碼：
Retweet

此操作會轉發一條推文。

參數

名稱 機碼 必要 類型 Description
推文ID
 tweetId True string

推文被轉發。
修剪使用者
 trimUser boolean

布林值，以指出是否要修剪使用者資訊。

傳回

代表推文貼文的回應。

身體
TweetResponseModel

觸發程序

發布新推文時

此作業會在張貼符合指定搜尋查詢的新推文時觸發流程。

發布新推文時

作業識別碼：
OnNewTweet

此作業會在張貼符合指定搜尋查詢的新推文時觸發流程。

參數

名稱 機碼 必要 類型 Description
搜尋文字
 searchQuery True string

搜索詞，如“歡樂時光”、#haiku、from：@username、愛或恨。

傳回

代表批次觸發程式回應的包裝函式物件

身體
TriggerBatchResponse[TweetModel]

定義

推文模型

代表推文貼文。

名稱 路徑 類型 Description
推文文字
 TweetText string

推文文字內容
推文ID
 TweetId string

推文的 ID
建立時間
 CreatedAtIso string

推文發布的時間
轉發次數
 RetweetCount integer

該推文的轉發總數
推文
 TweetedBy string

發布推文的用戶名稱
媒體網址
 MediaUrls array of string

與推文一起發布的媒體網址
推文語言
 TweetLanguageCode string

推文的語言代碼
in_reply_to_user_id
 TweetInReplyToUserId string

目前推文所回覆的推文作者的使用者識別碼
收藏夾
 Favorited boolean

指出推文是否標示為我的最愛
用戶提及
 UserMentions array of UserMentionsModel

推文中提到的用戶列表
原創推文
 OriginalTweet OriginalTweetModel

代表原始推文貼文。
使用者詳細資訊
 UserDetails UserDetailsModel

代表使用者。

使用者提及模型

代表推文中提到的使用者。

名稱 路徑 類型 Description
提及的使用者 ID
 Id integer

使用者的 X id（句柄）
提及的使用者全名
 FullName string

使用者的全名
提及的使用者名稱
 UserName string

使用者的螢幕名稱

原創推文模型

代表原始推文貼文。

名稱 路徑 類型 Description
推文原文
 TweetText string

原始檢索推文的文字內容
原始推文 ID
 TweetId string

原始推文的 ID
原始推文創建於
 CreatedAtIso string

原始推文發布的時間
原始推文轉發次數
 RetweetCount integer

此原始推文的轉發總數
原始推文由
 TweetedBy string

發布原始推文的人的用戶名
原始推文媒體網址
 MediaUrls array of string

與原始推文一起發布的媒體網址
原始推文語言
 TweetLanguageCode string

原始推文的語言代碼
原始推文in_reply_to_user_id
 TweetInReplyToUserId string

目前原始推文是回覆的推文作者的使用者識別碼
收藏原創推文
 Favorited boolean

指出原始推文是否標示為我的最愛
原始推文用戶提及
 UserMentions array of OriginalTweetUserMentionsModel

推文中提到的用戶列表
使用者詳細資訊
 UserDetails OriginalTweetUserDetailsModel

代表發布原始推文的用戶

使用者詳細資料模型

代表使用者。

名稱 路徑 類型 Description
名稱
 FullName string

用戶的名稱
地點
 Location string

使用者的位置
使用者識別碼
 Id integer

使用者的 X id（句柄）
使用者名
 UserName string

使用者的螢幕名稱
追蹤者數
 FollowersCount integer

追蹤者數量
Description
 Description string

用戶描述
狀態計算
 StatusesCount integer

使用者狀態計數
朋友數
 FriendsCount integer

好友人數
收藏夾計數
 FavouritesCount integer

使用者收藏的推文數量
個人資料圖片網址
 ProfileImageUrl string

個人資料圖片的網址

OriginalTweetUserMentions模型

代表原始推文中提及的使用者。

名稱 路徑 類型 Description
原始推文提到用戶 ID
 Id integer

使用者的 X id（句柄）
原始推文提到了用戶全名
 FullName string

使用者的全名
原始推文提到了用戶名
 UserName string

使用者的螢幕名稱

OriginalTweetUserDetails模型

代表發布原始推文的用戶

名稱 路徑 類型 Description
原始推文用戶全名
 FullName string

用戶的名稱
原始推文用戶位置
 Location string

使用者的位置
原始推文用戶 ID
 Id integer

使用者的 X id（句柄）
原始推文用戶名
 UserName string

使用者的螢幕名稱
原始推文用戶關注者統計
 FollowersCount integer

追蹤者數量
原始推文用戶描述
 Description string

用戶描述
原始推文用戶狀態計算在內
 StatusesCount integer

使用者狀態計數
原創推文用戶好友數
 FriendsCount integer

好友人數
原始推文用戶收藏夾計數
 FavouritesCount integer

使用者收藏的推文數量
原始推文用戶個人資料圖片網址
 ProfileImageUrl string

個人資料圖片的網址

TweetResponseModel

代表推文貼文的回應。

名稱 路徑 類型 Description
推文ID
 TweetId string

發布推文的 ID

觸發批次回應[Tweet模型]

代表批次觸發程式回應的包裝函式物件

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

回應物件清單