Twitter

Twitter 可讓您從您的 Twitter 帳戶張貼推文並取得推文、時間軸、朋友和跟隨者。

您可以在您應用程式的標籤中顯示此資訊。 例如,您可以新增輸入文字方塊,要求使用者輸入一些推文文字,然後新增「張貼」推文的按鈕。 您可以使用類似的方法,以取得推文或搜尋推文,然後在應用程式中的標籤或資源庫控制項顯示文字。

本主題說明如何建立 Twitter 連線、在應用程式中使用 Twitter 連線,並且列出可用的函式。

 

開始使用的必要條件

連線至 Twitter

  1. 開啟 PowerApps,選取 [新增],然後建立空白應用程式。 選擇手機或平板電腦版面配置。 平板電腦版面配置可給予您更多工作區︰

    開啟空白應用程式

  2. 在右側窗格中,按一下或點選 [資料] 索引標籤,然後按一下或點選 [新增資料來源]。

  3. 選取 [新增連接],然後選取 [Twitter]:

    連線至 Twitter

    連線至 Twitter

  4. 選取 [連接]、輸入 Twitter 登入認證,然後選取 [授權應用程式]。

  5. 選取 [新增資料來源]。 您的連線會出現在 [資料來源] 底下:
    關閉選項窗格

Twitter 連線已建立並新增至您的應用程式。 現在已備妥可供使用。

在您的應用程式中使用 Twitter 連線

顯示時間軸

  1. 在 [插入] 功能表上,選取 [資源庫],並新增任何使用文字資源庫。
  2. 我們會示範一些時間軸︰

    • 若要顯示目前使用者的時間軸,請將資源庫的 Items 屬性設為下列公式︰

      Twitter.HomeTimeline().TweetText
      Twitter.HomeTimeline({maxResults:3}).TweetText

    • 若要顯示其他使用者的時間軸,請將資源庫的 Items 屬性設為下列公式︰

      Twitter.UserTimeline( *TwitterHandle* ).TweetText

      在雙引號或相等的值中輸入 Twitter 控制代碼。 例如,直接在公式運算式中輸入 "satyanadella""powerapps"

    • 新增名為 Tweep 的文字輸入控制項,並將其 Default 屬性設定為 Tweep.Text。 在 Tweep 文字方塊中,輸入 Twitter 控制代碼,例如 satyanadella (沒有引號且沒有 @ 符號)。

      在資源庫控制項中,將 Items 屬性設定為下列公式︰

      Twitter.UserTimeline(Tweep.Text, {maxResults:5}).TweetText

      資源庫控制項會自動顯示您輸入之 Twitter 處理常式的推文。

    提示某些公式使用 maxResults 引數,以在時間軸中顯示最新的 x 則推文。

  3. 將資源庫的 Items 屬性設定為 Twitter.HomeTimeline()

    選取資源庫後,右窗格會顯示該資源庫的選項。

  4. 在第一個清單中選取 TweetText,在第二個清單中選取 TweetedBy,在第三個清單中選取 CreatedAt

    資源庫現在會顯示您選擇的屬性值。

顯示跟隨者

  1. 使用使用文字資源庫,我們會示範一些跟隨者︰

    • 若要顯示目前使用者的跟隨者,請將資源庫的 Items 屬性設為下列公式︰

      Twitter.MyFollowers()
      Twitter.MyFollowers({maxResults:3})

    • 若要顯示其他使用者的跟隨者,請將資源庫的 Items 屬性設為下列公式︰

      Twitter.Followers( *TwitterHandle* )

      在雙引號或相等的值中輸入 Twitter 控制代碼。 例如,直接在公式運算式中輸入 "satyanadella""powerapps"

    • 新增名為 Tweep 的文字輸入控制項,並將其 Default 屬性設定為 Tweep.Text。 在 Tweep 文字方塊中,輸入 Twitter 控制代碼,例如 satyanadella (沒有引號且沒有 @ 符號)。

      在資源庫控制項中,將 Items 屬性設定為下列公式︰

      Twitter.Followers(Tweep.Text, {maxResults:5})

      資源庫控制項會自動顯示誰在跟隨您輸入的 Twitter 處理常式。

    提示某些公式使用 maxResults 引數,以在時間軸中顯示最新的 x 則推文。

  2. 將資源庫的 Items 屬性設定為 Twitter.MyFollowers()

    選取資源庫後,右窗格會顯示該資源庫的選項。

  3. 在第二個清單中選取 UserName,在第三個清單中選取 FullName

    資源庫現在會顯示您選擇的屬性值。

顯示已跟隨的使用者

  1. 使用使用文字資源庫,我們會示範一些已跟隨的使用者︰

    • 若要顯示目前使用者正在關注那些使用者,請將資源庫的 Items 屬性設為下列公式︰

      Twitter.MyFollowing()
      Twitter.MyFollowing({maxResults:3})

    • 若要顯示其他使用者正在關注那些使用者,請將資源庫的 Items 屬性設為下列公式︰

      Twitter.Following( *TwitterHandle* )

      在雙引號或相等的值中輸入 Twitter 控制代碼。 例如,直接在公式運算式中輸入 "satyanadella""powerapps"

    • 新增名為 Tweep 的文字輸入控制項,並將其 Default 屬性設定為 Tweep.Text。 在 Tweep 文字方塊中,輸入 Twitter 控制代碼,例如 satyanadella (沒有引號且沒有 @ 符號)。

      在資源庫控制項中,將 Items 屬性設定為下列公式︰

      Twitter.Following(Tweep.Text, {maxResults:5})

      資源庫控制項會自動顯示您正在關注的其他控制代碼。

    選取資源庫後,右窗格會顯示該資源庫的選項。

  2. Body1 清單中選取 [描述],在 Heading1 清單中選取 [UserName],以及在 Subtitle1 清單中選取 [FullName]。

    資源庫現在會顯示您選擇的屬性值。

顯示使用者的相關資訊

新增標籤,然後將其 Text 屬性設定為下列其中一個公式︰

  • twitter.User( *TwitterHandle* ).Description
  • twitter.User( *TwitterHandle* ).FullName
  • twitter.User( *TwitterHandle* ).Location
  • twitter.User( *TwitterHandle* ).UserName
  • twitter.User( *TwitterHandle* ).FollowersCount
  • twitter.User( *TwitterHandle* ).FriendsCount
  • twitter.User( *TwitterHandle* ).Id
  • twitter.User( *TwitterHandle* ).StatusesCount

在雙引號或相等的值中輸入 Twitter 控制代碼。 例如,直接在公式運算式中輸入 "satyanadella""powerapps"

或者,您可以使用輸入文字控制項以輸入 Twitter 控制代碼,就像我們在本主題中所做的一樣。

搜尋推文

  1. 使用使用文字資源庫,將其 Items 屬性設定為下列公式:

    Twitter.SearchTweet( *SearchTerm* ).TweetText

    在雙引號中輸入 *SearchTerm*,或參考相等的值。 例如,直接在公式中輸入 "PowerApps""microsoft"

    或者,您可以使用輸入文字控制項以指定搜尋詞彙,就像我們在本主題中所做的一樣。

    提示使用 maxResults 顯示前五個結果︰

    Twitter.SearchTweet(SearchTerm.Text, {maxResults:5}).TweetText

  2. 將資源庫的 Items 屬性設定為 Twitter.SearchTweet(SearchTerm.Text, {maxResults:5})

    選取資源庫後,右窗格會顯示該資源庫的選項。

  3. 在第一個清單中選取 TweetText,在第二個清單中選取 TweetedBy,在第三個清單中選取 CreatedAt

    資源庫現在會顯示您選擇的屬性值。

傳送推文

  1. 新增文字輸入控制項,然後重新命名為 MyTweet

  2. 新增按鈕,然後將其 OnSelect 屬性設定為下列公式:
    Twitter.Tweet({tweetText: MyTweet.Text})

  3. 按下 F5 鍵,或選取 [預覽] 按鈕 ( )。 輸入一些文字到 MyTweet,然後選取按鈕,將您輸入的文字發佈推文。

  4. 按 Esc 鍵返回預設工作區。

檢視可用的函式

此連線包含下列函式︰

函式名稱 說明
UserTimeline 擷取指定使用者張貼的最新推文集合
HomeTimeline 擷取我和我的跟隨者張貼的最新推文和回推
SearchTweet 擷取符合指定查詢的相關推文集合
Followers 擷取跟隨指定使用者的使用者
MyFollowers 擷取跟隨我的使用者
Following 擷取指定使用者關注的使用者
MyFollowing 擷取我正在關注的使用者
User 擷取指定使用者的相關詳細資料 (範例︰使用者名稱、描述、跟隨者計數等。)
Tweet 推文
OnNewTweet 張貼的新推文符合您的搜尋查詢時,會觸發工作流程

UserTimeline

取得使用者時間軸:擷取指定使用者張貼的最新推文集合

輸入屬性

名稱 資料類型 必要 說明
userName 字串 Twitter 控制代碼
maxResults 整數 要擷取的推文數目最大值,例如 {maxResults:5}

輸出屬性

屬性名稱 資料類型 必要 說明
TweetText 字串
TweetId 字串
CreatedAt 字串
RetweetCount 整數
TweetedBy 字串
MediaUrls 陣列

HomeTimeline

取得首頁時間軸:擷取我和我的跟隨者張貼的最新推文和回推

輸入屬性

名稱 資料類型 必要 說明
maxResults 整數 要擷取的推文數目最大值,例如 {maxResults:5}

輸出屬性

屬性名稱 資料類型 必要 說明
TweetText 字串
TweetId 字串
CreatedAt 字串
RetweetCount 整數
TweetedBy 字串
MediaUrls 陣列

SearchTweet

搜尋推文:擷取符合指定查詢的相關推文集合

輸入屬性

名稱 資料類型 必要 說明
searchQuery 字串 查詢文字 (您可以使用任何 Twitter 支援的查詢運算子︰http://www.twitter.com/search)
maxResults 整數 要擷取的推文數目最大值,例如 {maxResults:5}

輸出屬性

屬性名稱 資料類型 必要 說明
TweetText 字串
TweetId 字串
CreatedAt 字串
RetweetCount 整數
TweetedBy 字串
MediaUrls 陣列

Followers

取得跟隨者:擷取跟隨指定使用者的使用者

輸入屬性

名稱 資料類型 必要 說明
userName 字串 使用者的 Twitter 控制代碼
maxResults 整數 要擷取的使用者數目最大值,例如 {maxResults:5}

輸出屬性

屬性名稱 資料類型 必要 說明
FullName 字串
位置 字串
識別碼 整數
UserName 字串
FollowersCount 整數
說明 字串
StatusesCount 整數
FriendsCount 整數

MyFollowers

取得我的跟隨者:擷取跟隨我的使用者

輸入屬性

名稱 資料類型 必要 說明
maxResults 整數 要擷取的使用者數目最大值,例如 {maxResults:5}

輸出屬性

屬性名稱 資料類型 必要 說明
FullName 字串
位置 字串
識別碼 整數
UserName 字串
FollowersCount 整數
說明 字串
StatusesCount 整數
FriendsCount 整數

Following

取得關注:擷取指定使用者關注的使用者

輸入屬性

名稱 資料類型 必要 說明
userName 字串 使用者的 Twitter 控制代碼
maxResults 整數 要擷取的使用者數目最大值,例如 {maxResults:5}

輸出屬性

屬性名稱 資料類型 必要 說明
FullName 字串
位置 字串
識別碼 整數
UserName 字串
FollowersCount 整數
說明 字串
StatusesCount 整數
FriendsCount 整數

MyFollowing

取得我的關注:擷取我正在關注的使用者

輸入屬性

名稱 資料類型 必要 說明
maxResults 整數 要擷取的使用者數目最大值,例如 {maxResults:5}

輸出屬性

屬性名稱 資料類型 必要 說明
FullName 字串
位置 字串
識別碼 整數
UserName 字串
FollowersCount 整數
說明 字串
StatusesCount 整數
FriendsCount 整數

User

取得使用者:擷取指定使用者的相關詳細資料 (範例︰使用者名稱、描述、跟隨者計數等。)

輸入屬性

名稱 資料類型 必要 說明
userName 字串 使用者的 Twitter 控制代碼

輸出屬性

屬性名稱 資料類型 必要 說明
FullName 字串
位置 字串
識別碼 整數
UserName 字串
FollowersCount 整數
說明 字串
StatusesCount 整數
FriendsCount 整數

推文

張貼新推文︰推文

輸入屬性

名稱 資料類型 必要 說明
tweetText 字串 要張貼的文字,例如 {tweetText:"hello"}
body 字串 要張貼的媒體

輸出屬性

屬性名稱 資料類型 必要 說明
TweetId 字串

OnNewTweet

新推文的顯示時機:張貼的新推文符合您的搜尋查詢時,會觸發工作流程

輸入屬性

名稱 資料類型 必要 說明
searchQuery 字串 查詢文字 (您可以使用任何 Twitter 支援的查詢運算子︰http://www.twitter.com/search)

輸出屬性

屬性名稱 資料類型 必要 說明
陣列

有用連結

查看所有可用連線
了解如何將連線新增到您的應用程式。