Twitter

Twitter では、Twitter アカウントからツイートの投稿、ツイート、タイムライン、フレンド、フォロワーの取得を行うことができます。

こうした情報を、アプリのラベルに表示できます。 たとえば、入力テキスト ボックスを追加し、ユーザーにツイート テキストの入力を要求し、ツイートを "投稿" するボタンを追加することができます。 同様の方法で、ツイートを取得または検索し、アプリのラベルまたはギャラリー コントロールにテキストを表示できます。

このトピックでは、Twitter 接続の作成方法とアプリでの Twitter 接続の使用方法を説明し、使用可能な関数の一覧を示します。

 

前提条件

Twitter への接続

  1. PowerApps を開き、[新規] を選んで [空のアプリ] を作成します。 携帯電話またはタブレットのレイアウトを選択します。 タブレットのレイアウトの方がワークスペースが広くなります。

    空のアプリを開く

  2. 右のウィンドウで [データ ソース] タブを開き、[データソースの追加] を選択します。

  3. [接続の追加][Twitter] の順に選択します。

    Twitter への接続

    Twitter への接続

  4. [接続] を選び、Twitter サインイン用の資格情報を入力して、[Authorize app (アプリの承認)] を選びます。

  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 テキスト ボックスに、satyanadella などの Twitter ハンドルを入力します (引用符と @ 記号は除去します)。

      ギャラリー コントロールで、Items プロパティを次の式に設定します。

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

      ギャラリー コントロールに、入力した Twitter ハンドルのツイートが自動的に表示されます。

    ヒント これらの式の一部では、maxResults 引数を使って、タイムラインで最新 x 個のツイートを表示しています。

  3. ギャラリーの Items プロパティを Twitter.HomeTimeline() に設定します。

    ギャラリーを選択すると、右側のペインにそのギャラリーのオプションが表示されます。

  4. 1 番目のリストで [TweetText]、2 番目のリストで [TweetedBy]、3 番目のリストで [CreatedAt] を選択します。

    ギャラリーに、選択したプロパティの値が表示されるようになります。

フォロワーを表示する

  1. テキスト付きギャラリーを使って、フォロワーの一部を表示します。

    • 現在のユーザーのフォロワーを表示するには、ギャラリーの Items プロパティを次の式に設定します。

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

    • 別のユーザーのフォロワーを表示するには、ギャラリーの Items プロパティを次の式に設定します。

      Twitter.Followers( *TwitterHandle* )

      二重引用符で囲んだ Twitter ハンドルまたは同等の値を入力します。 たとえば、"satyanadella" または "powerapps" と式に直接入力します。

    • Tweep という名前のテキスト入力コントロールを追加し、Default プロパティを Tweep.Text に設定します。 Tweep テキスト ボックスに、satyanadella などの Twitter ハンドルを入力します (引用符と @ 記号は除去します)。

      ギャラリー コントロールで、Items プロパティを次の式に設定します。

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

      ギャラリー コントロールに、入力した Twitter ハンドルをフォローしているユーザーが自動的に表示されます。

    ヒント これらの式の一部では、maxResults 引数を使って、タイムラインで最新 x 個のツイートを表示しています。

  2. ギャラリーの Items プロパティを Twitter.MyFollowers() に設定します。

    ギャラリーを選択すると、右側のペインにそのギャラリーのオプションが表示されます。

  3. 2 番目のリストで [UserName] を選択し、3 番目のリストで [FullName] を選択します。

    ギャラリーに、選択したプロパティの値が表示されるようになります。

フォローされているユーザーを表示する

  1. テキスト付きギャラリーを使って、フォローされているユーザーの一部を表示します。

    • 現在のユーザーがフォローしているユーザーを表示するには、ギャラリーの Items プロパティを次の式に設定します。

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

    • 別のユーザーがフォローしているユーザーを表示するには、ギャラリーの Items プロパティを次の式に設定します。

      Twitter.Following( *TwitterHandle* )

      二重引用符で囲んだ Twitter ハンドルまたは同等の値を入力します。 たとえば、"satyanadella" または "powerapps" と式に直接入力します。

    • Tweep という名前のテキスト入力コントロールを追加し、Default プロパティを Tweep.Text に設定します。 Tweep テキスト ボックスに、satyanadella などの Twitter ハンドルを入力します (引用符と @ 記号は除去します)。

      ギャラリー コントロールで、Items プロパティを次の式に設定します。

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

      ギャラリー コントロールに、自分がフォローして他のハンドルが自動的に表示されます。

    ギャラリーを選択すると、右側のペインにそのギャラリーのオプションが表示されます。

  2. [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 ハンドルを入力することもできます。

ツイートを検索する

  1. テキスト付きギャラリーを使用し、その Items プロパティを次の式に設定します。

    Twitter.SearchTweet( *SearchTerm* ).TweetText

    SearchTerm は、二重引用符で囲んで入力するか、同等の値を参照します。 たとえば、"PowerApps" または "microsoft" と式に直接入力します。

    または、このトピックで行っているように、入力テキスト コントロールを使って検索語句を指定することもできます。

    ヒント maxResults を使って最初の 5 つの結果を表示します。

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

  2. ギャラリーの Items プロパティを Twitter.SearchTweet(SearchTerm.Text, {maxResults:5}) に設定します。

    ギャラリーを選択すると、右側のペインにそのギャラリーのオプションが表示されます。

  3. 1 番目のリストで [TweetText]、2 番目のリストで [TweetedBy]、3 番目のリストで [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 string はい Twitter ハンドルです
maxResults 整数 いいえ 取得するツイートの最大数です (例: {maxResults:5})

出力プロパティ

プロパティ名 データ型 必須 説明
TweetText string はい
TweetId string いいえ
CreatedAt string いいえ
RetweetCount 整数 はい
TweetedBy string はい
MediaUrls 配列 いいえ

HomeTimeline

ホーム タイムラインを取得する: 最近のツイートを取得し、自分と自分のフォロワーに投稿をリツイートします

入力プロパティ

名前 データ型 必須 説明
maxResults 整数 いいえ 取得するツイートの最大数です (例: {maxResults:5})

出力プロパティ

プロパティ名 データ型 必須 説明
TweetText string はい
TweetId string いいえ
CreatedAt string いいえ
RetweetCount 整数 はい
TweetedBy string はい
MediaUrls 配列 いいえ

SearchTweet

ツイートを検索する: 指定したクエリに一致する、関連するツイートのコレクションを取得します

入力プロパティ

名前 データ型 必須 説明
searchQuery string はい クエリ テキストです (Twitter でサポートされている任意のクエリ演算子を使用できます: http://www.twitter.com/search)
maxResults 整数 いいえ 取得するツイートの最大数です (例: {maxResults:5})

出力プロパティ

プロパティ名 データ型 必須 説明
TweetText string はい
TweetId string いいえ
CreatedAt string いいえ
RetweetCount 整数 はい
TweetedBy string はい
MediaUrls 配列 いいえ

Followers

フォロワーを取得する: 指定したユーザーをフォローしているユーザーを取得します

入力プロパティ

名前 データ型 必須 説明
userName string はい ユーザーの Twitter ハンドルです
maxResults 整数 いいえ 取得するユーザーの最大数です (例: {maxResults:5})

出力プロパティ

プロパティ名 データ型 必須 説明
FullName string はい
場所 string はい
Id 整数 いいえ
UserName string はい
FollowersCount 整数 いいえ
説明 string はい
StatusesCount 整数 いいえ
FriendsCount 整数 いいえ

MyFollowers

自分のフォロワーを取得する: 自分をフォローしているユーザーを取得します

入力プロパティ

名前 データ型 必須 説明
maxResults 整数 いいえ 取得するユーザーの最大数です (例: {maxResults:5})

出力プロパティ

プロパティ名 データ型 必須 説明
FullName string はい
場所 string はい
Id 整数 いいえ
UserName string はい
FollowersCount 整数 いいえ
説明 string はい
StatusesCount 整数 いいえ
FriendsCount 整数 いいえ

Following

フォローしているユーザーを取得する: 指定したユーザーがフォローしているユーザーを取得します

入力プロパティ

名前 データ型 必須 説明
userName string はい ユーザーの Twitter ハンドルです
maxResults 整数 いいえ 取得するユーザーの最大数です (例: {maxResults:5})

出力プロパティ

プロパティ名 データ型 必須 説明
FullName string はい
場所 string はい
Id 整数 いいえ
UserName string はい
FollowersCount 整数 いいえ
説明 string はい
StatusesCount 整数 いいえ
FriendsCount 整数 いいえ

MyFollowing

自分がフォローしているユーザーを取得する: 自分がフォローしているユーザーを取得します

入力プロパティ

名前 データ型 必須 説明
maxResults 整数 いいえ 取得するユーザーの最大数です (例: {maxResults:5})

出力プロパティ

プロパティ名 データ型 必須 説明
FullName string はい
場所 string はい
Id 整数 いいえ
UserName string はい
FollowersCount 整数 いいえ
説明 string はい
StatusesCount 整数 いいえ
FriendsCount 整数 いいえ

User

ユーザーを取得する: 指定したユーザーに関する詳細情報を取得します (例: ユーザー名、説明、フォロワー数など)

入力プロパティ

名前 データ型 必須 説明
userName string はい ユーザーの Twitter ハンドルです

出力プロパティ

プロパティ名 データ型 必須 説明
FullName string はい
場所 string はい
Id 整数 いいえ
UserName string はい
FollowersCount 整数 いいえ
説明 string はい
StatusesCount 整数 いいえ
FriendsCount 整数 いいえ

ツイートします

新しいツイートを投稿する: ツイートします

入力プロパティ

名前 データ型 必須 説明
tweetText string いいえ 投稿するテキストです (例: {tweetText:"こんにちは"}
body string いいえ 投稿するメディアです

出力プロパティ

プロパティ名 データ型 必須 説明
TweetId string はい

OnNewTweet

新しいツイートがあったときの処理: 検索クエリに一致するツイートが新しく投稿されたときに、ワークフローをトリガーします

入力プロパティ

名前 データ型 必須 説明
searchQuery string はい クエリ テキストです (Twitter でサポートされている任意のクエリ演算子を使用できます: http://www.twitter.com/search)

出力プロパティ

プロパティ名 データ型 必須 説明
配列 いいえ

便利なリンク

利用可能な接続をすべて表示する。
アプリに接続を追加する方法を確認する。