从 Power Apps 连接到 Twitter
可以通过 Twitter 发布推文,并获取 Twitter 帐户的推文、时间线、好友和关注者。
可以在应用上的标签中显示此信息。 例如,可以添加一个输入文本框,要求用户输入一些推文文本,然后添加用于“发布”推文的按钮。 可以使用类似的方法来获取推文或搜索推文,然后在应用中的标签或库控件中显示文本。
本主题演示如何创建 Twitter 连接,如何在应用中使用 Twitter 连接,并列出可用的函数。
先决条件
- 对 Power Apps 的访问权限
- 添加连接
- 通过模板、数据或者从头创建应用程序
连接到 Twitter
首先创建空白区域应用。
在左侧窗格中,选择数据 > 添加数据。
选择新建连接,然后选择 Twitter:
从默认共享应用程序中选择,或选择自己的应用程序(以及消费者密钥/消费者机密)。
选择连接。
选择或输入 Twitter 登录凭据,然后选择授权应用。
选择添加数据源。 连接显示在数据源下:
Twitter 连接已创建并已添加到您的应用。 现在可供使用。
在应用中使用 Twitter 连接
显示时间线
在插入菜单上,选择库,然后添加任意带有文本的库。
我们来看一些时间线:
若要显示当前用户的时间线,将库的 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 数量。
将库的 Items 属性设置为
Twitter.HomeTimeline()
。选择库后,右侧窗格显示该库的选项。
在第一个列表中选择 TweetText,在第二个列表中选择 TweetedBy,然后在第三个列表中选择 CreatedAt。
库现在显示所选属性的值。
显示关注者
通过使用带有文本的库,可以显示部分关注者:
若要显示当前用户的关注者,将库的 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 数量。
将库的 Items 属性设置为
Twitter.MyFollowers()
。选择库后,右侧窗格显示该库的选项。
在第二个列表中选择 UserName,在第三个列表中选择 FullName。
库现在显示所选属性的值。
显示关注的用户
通过使用带有文本的库,可以显示一些关注的用户:
若要显示当前用户关注了哪些用户,将库的 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})
库控件自动显示您正在关注的其他用户名。
选择库后,右侧窗格显示该库的选项。
在 Body1 列表中选择 Description,在 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 句柄,如本主题中所述。
搜索推文
添加带有文本的库,将其 Items 属性设置为下列公式:
Twitter.SearchTweet( *SearchTerm* ).TweetText
输入用双引号括住的 SearchTerm 或引用等效值。 例如,直接在公式中输入
"PowerApps"
或"microsoft"
。或者,可以使用输入文本控件指定搜索项,如本主题中所述。
提示
使用 maxResults 可显示前五个结果:
Twitter.SearchTweet(SearchTerm.Text, {maxResults:5}).TweetText
将库的 Items 属性设置为
Twitter.SearchTweet(SearchTerm.Text, {maxResults:5})
。选择库后,右侧窗格显示该库的选项。
在第一个列表中选择 TweetText,第二个列表中选择 TweetedBy,然后在第三个列表中选择 CreatedAt。
库现在显示所选属性的值。
发送推文
- 添加一个文本输入控件,然后将其重命名为 MyTweet。
- 添加按钮,然后将其 OnSelect 属性设置为以下公式:
Twitter.Tweet("",{tweetText: MyTweet.Text})
示例:Twitter.Tweet("",{tweetText:"Sample tweet!"})
- 按 F5 或选择“预览”按钮 ()。 在 MyTweet 中输入一些文本,然后选择按钮来推送您输入的文本。
- 按 Esc 返回默认工作区。
查看可用函数
此连接包括以下函数:
函数名称 | 描述 |
---|---|
UserTimeline | 检索指定用户发布的最新推文的集合 |
HomeTimeline | 检索我和我的关注者发布的最新推文和转发的推文 |
SearchTweet | 检索与指定查询匹配的相关推文的集合 |
Followers | 检索关注指定用户的用户 |
MyFollowers | 检索关注我的用户 |
跟踪 | 检索指定用户正在关注的用户 |
MyFollowing | 检索我正在关注的用户 |
User | 检索指定用户的详细信息(例如:用户名、说明、关注者数量等。) |
Tweet | 推文 |
OnNewTweet | 发布与搜索查询匹配的新推文时触发工作流 |
UserTimeline
获取用户时间线:检索指定用户发布的最新推文的集合
输入属性
客户 | 数据类型 | 必选 | 描述 |
---|---|---|---|
userName | string | 是 | Twitter 句柄 |
maxResults | integer | 否 | 要检索的推文的最大数量,例如,{maxResults:5} |
输出属性
属性名称 | 数据类型 | 必选 | 描述 |
---|---|---|---|
TweetText | string | 是 | |
TweetId | string | 否 | |
CreatedAt | string | 否 | |
RetweetCount | integer | 是 | |
TweetedBy | string | 是 | |
MediaUrls | 数组 | 否 |
HomeTimeline
获取主页时间线:检索我和我的关注者发布的最新推文和转发的推文
输入属性
客户 | 数据类型 | 必选 | 描述 |
---|---|---|---|
maxResults | integer | 否 | 要检索的推文的最大数量,例如,{maxResults:5} |
输出属性
属性名称 | 数据类型 | 必选 | 描述 |
---|---|---|---|
TweetText | string | 是 | |
TweetId | string | 否 | |
CreatedAt | string | 否 | |
RetweetCount | integer | 是 | |
TweetedBy | string | 是 | |
MediaUrls | 数组 | 否 |
SearchTweet
搜索推文:检索与指定查询匹配的相关推文的集合
输入属性
客户 | 数据类型 | 必选 | 描述 |
---|---|---|---|
searchQuery | string | 是 | 查询文本(可以使用 Twitter 支持的任何查询运算符:https://www.twitter.com/search) |
maxResults | integer | 否 | 要检索的推文的最大数量,例如,{maxResults:5} |
输出属性
属性名称 | 数据类型 | 必选 | 描述 |
---|---|---|---|
TweetText | string | 是 | |
TweetId | string | 否 | |
CreatedAt | string | 否 | |
RetweetCount | integer | 是 | |
TweetedBy | string | 是 | |
MediaUrls | 数组 | 否 |
Followers
获取关注者:检索关注指定用户的用户
输入属性
客户 | 数据类型 | 必选 | 描述 |
---|---|---|---|
userName | string | 是 | 用户的 Twitter 用户名 |
maxResults | integer | 否 | 要检索的用户的最大数量,例如,{maxResults:5} |
输出属性
属性名称 | 数据类型 | 必选 | 描述 |
---|---|---|---|
FullName | string | 是 | |
Location | string | 是 | |
编号 | integer | 否 | |
UserName | string | 是 | |
FollowersCount | integer | 否 | |
描述 | string | 是 | |
StatusesCount | integer | 否 | |
FriendsCount | integer | 否 |
MyFollowers
获取我的关注者:检索关注我的用户
输入属性
客户 | 数据类型 | 必选 | 描述 |
---|---|---|---|
maxResults | integer | 否 | 要检索的用户的最大数量,例如,{maxResults:5} |
输出属性
属性名称 | 数据类型 | 必选 | 描述 |
---|---|---|---|
FullName | string | 是 | |
Location | string | 是 | |
编号 | integer | 否 | |
UserName | string | 是 | |
FollowersCount | integer | 否 | |
描述 | string | 是 | |
StatusesCount | integer | 否 | |
FriendsCount | integer | 否 |
跟踪
获取关注的人:检索指定用户正在关注的用户
输入属性
客户 | 数据类型 | 必选 | 描述 |
---|---|---|---|
userName | string | 是 | 用户的 Twitter 用户名 |
maxResults | integer | 否 | 要检索的用户的最大数量,例如,{maxResults:5} |
输出属性
属性名称 | 数据类型 | 必选 | 描述 |
---|---|---|---|
FullName | string | 是 | |
Location | string | 是 | |
编号 | integer | 否 | |
UserName | string | 是 | |
FollowersCount | integer | 否 | |
描述 | string | 是 | |
StatusesCount | integer | 否 | |
FriendsCount | integer | 否 |
MyFollowing
获取我关注的人:检索我正在关注的用户
输入属性
客户 | 数据类型 | 必选 | 描述 |
---|---|---|---|
maxResults | integer | 否 | 要检索的用户的最大数量,例如,{maxResults:5} |
输出属性
属性名称 | 数据类型 | 必选 | 描述 |
---|---|---|---|
FullName | string | 是 | |
Location | string | 是 | |
编号 | integer | 否 | |
UserName | string | 是 | |
FollowersCount | integer | 否 | |
描述 | string | 是 | |
StatusesCount | integer | 否 | |
FriendsCount | integer | 否 |
User
获取用户:检索指定用户的详细信息(例如:用户名、说明、关注者数量等。)
输入属性
客户 | 数据类型 | 必选 | 描述 |
---|---|---|---|
userName | string | 是 | 用户的 Twitter 用户名 |
输出属性
属性名称 | 数据类型 | 必选 | 描述 |
---|---|---|---|
FullName | string | 是 | |
Location | string | 是 | |
编号 | integer | 否 | |
UserName | string | 是 | |
FollowersCount | integer | 否 | |
描述 | string | 是 | |
StatusesCount | integer | 否 | |
FriendsCount | integer | 否 |
Tweet
发布新推文:推文
输入属性
客户 | 数据类型 | 必选 | 描述 |
---|---|---|---|
tweetText | string | 否 | 要发布的文本,例如,{tweetText:"hello"} |
正文 | string | 否 | 要发布的媒体 |
输出属性
属性名称 | 数据类型 | 必选 | 描述 |
---|---|---|---|
TweetId | string | 是 |
OnNewTweet
显示新推文时:发布与搜索查询匹配的新推文时触发工作流
输入属性
客户 | 数据类型 | 必选 | 描述 |
---|---|---|---|
searchQuery | string | 是 | 查询文本(可以使用 Twitter 支持的任何查询运算符:https://www.twitter.com/search) |
输出属性
属性名称 | 数据类型 | 必选 | 描述 |
---|---|---|---|
值 | 数组 | 否 |