X

  • リファレンス

以前は Twitter と呼ばれていた X は、ユーザーがショート投稿を送受信できるようにするオンライン ソーシャル ネットワーク サービスです。 X に接続して投稿を管理します。 投稿の送信、検索、フォロワーの表示など、さまざまなアクションを実行できます。

このコネクタは、次の製品および地域で利用可能です:

Service クラス 地域
Logic Apps 標準 以下を除くすべての Logic Apps 地域 :
     -   Azure 中国の地域
     -   国防総省 (DoD)
Power Automate 標準 以下を除くすべての Power Automate 地域 :
     -   21 Vianet が運用する中国のクラウド
Power Apps 標準 以下を除くすべての Power Apps 地域 :
     -   21 Vianet が運用する中国のクラウド
連絡先
件名 Microsoft
URL Microsoft LogicApps サポート
Microsoft Power Automate サポート
Microsoft Power Apps サポート
コネクタ メタデータ
公開元 Microsoft
Web サイト https://x.com/
プライバシー ポリシー https://x.com/privacy

認証および独自のアプリケーションの導入

重要

共有済みの既定アプリケーション (Microsoft が管理する Twitter クライアント アプリケーション) は使用できなくなりました。 コネクタは現在、1 つの認証の種類 (独自のアプリケーションを導入する) のみをサポートしています。 2023 年 6 月の時点では、有料の Enterprise 層アプリケーションが必要です。 ただし、Twitter の価格ポリシーは今後も変更される可能性があります。

[独自のアプリケーションを導入する] オプションを使用すると、独自の Twitter OAuth クライアント アプリケーションを使用できます。 これにより、アクセス許可を制御し、コネクタの使用に関する特定の制限を有効にすることができます。

Twitter コネクタで独自の Twitter OAuth クライアント アプリケーションを使用するには、次の手順を実行する必要があります。

  1. Twitter 開発者ページを使用して OAuth クライアント アプリケーションを作成する (https://developer.twitter.com)
  2. Twitter コネクタでアプリケーションを使用する

Twitter で OAuth クライアント アプリケーションを作成する

独自の Twitter OAuth クライアント アプリケーションを作成するには、まず https://developer.twitter.com にサインインする必要があります。 Twitter アプリケーションを管理および作成できる「プロジェクトとアプリ」セクションに移動します。 このプロセスについては、Twitter の Twitter 開発者ガイド で説明されています。 開発者ページ で Twitter アプリを作成した後、適切にセットアップするには、次の手順が必要です。

  • Twitter アプリを選択する
  • アプリのアクセス許可を編集して、読み取りと書き込みを有効にします。
  • 認証設定を編集する
    • サードパーティ認証を有効にする
    • コールバック URL に 「https://global.consent.azure-apim.net/redirect」を追加する (注意: Fairfax サブスクリプションまたは GCC 環境を使用している場合は、「Fairfax および GCC コールバック」 セクションを参照してください)
    • 「Web サイトの URL」 を設定する (必須フィールドですが、値はフローに影響しません)

Fairfax と GCC のコールバック

Fairfax サブスクリプションまたは GCC 環境を使用している場合は、Twitter アプリのコールバック URL に次の URL を追加します。

完了したら、Twitter アプリを選択し、「キーとトークン」 ページに移動します。 「コンシューマー キー」 セクションで、「キーの表示」ボタンをクリックして、アプリの API キーと API キー シークレットを取得します。 これらの値を Twitter 接続で使用できるようになりました。

Twitter コネクタで独自のアプリケーションを使用する

Twitter OAuth クライアント アプリケーションを作成すると、Twitter 接続の作成中に使用できます。

  • 独自のアプリケーションを導入するを選択する。
  • アプリケーションからクライアント ID とクライアント シークレットの値を指定する。 (Twitter アプリの API キーと API キー シークレットを使用してください)

サインインをクリックして Twitter アカウントにサインインします。 これにより、Twitter アカウントにサインインし、上記で作成した Twitter アプリへのアクセスを承認するよう求めるメッセージが表示されます。

制限

制限や制約は以下の通りです。

  1. ユーザあたりの最大接続数: 2
  2. POST 操作の API 呼び出しレート制限: 1 時間あたり 12 回
  3. その他の操作の API 呼び出しレート制限: 1 時間あたり 600 回
  4. トリガー ポーリングの頻度: 1 時間
  5. 画像アップロードの最大サイズ: 5 MB
  6. 動画アップロードの最大サイズ: 15 MB
  7. 検索結果の最大数: 100
  8. 1 つのポーリング間隔内で追跡される新しいツイートの最大数: 5
  9. 最大許容「検索テキスト」 パラメーター値の長さは 470 です

Twitter API の制限

  1. 検索 API は、過去 7 日間に公開された最新のツイートのサンプリングに対して検索を行います
  2. 標準の検索 API は、完全性ではなく関連性に重点を置いています。 これは、一部のツイートとユーザーが検索結果に表示されない可能性があることを意味します

POST 操作の追加の制限

ツイートの投稿中に @user に言及することはサポートされていません。 具体的には、ツイートの投稿時に「@」の文字が削除されます。

一般的な制限

件名 値
アカウントごとの接続 2

接続の作成

コネクタは、次の認証タイプをサポートしています:
独自のアプリケーションを導入する 独自の Twitter アプリを使用してサインインします。 詳細については、このページの「認証および独自のアプリケーションの導入」セクションを参照してください。 すべての地域 共有不可
既定 [非推奨] このオプションは、明示的な認証の種類を持たない古い接続専用に対してのみ使用され、下位互換性を保つためにのみ提供されます。 すべての地域 共有不可

独自のアプリケーションを導入する

認証 ID: byoa

適用できるもの: すべての領域

独自の Twitter アプリを使用してサインインします。 詳細については、このページの「認証および独自のアプリケーションの導入」セクションを参照してください。

これは共有可能な接続ではありません。 パワー アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。

件名 タイプ 内容 必要
コンシューマー キー 文字列 Twitter アプリケーションのコンシューマー キー 真
顧客シークレット securestring Twitter アプリケーションのクライアント シークレット True

既定 [非推奨]

適用可能: すべての領域

このオプションは、明示的な認証の種類を持たない古い接続専用に対してのみ使用され、下位互換性を保つためにのみ提供されます。

これは共有可能な接続ではありません。 Power App が別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。

アクション

ツイートの投稿

この操作では、新しいツイートが投稿されます。
ツイートを検索する

この操作では、検索クエリに一致する関連するツイートの一覧を取得します。
フォロワーの取得

この操作では、特定のユーザーをフォローしているユーザーの一覧を取得します。
フォローの取得

この操作は、特定のユーザーがフォローしているユーザーの一覧を取得します。
ホーム タイムラインの取得

この操作では、自分と自分のフォロワーによって投稿された最新のツイートとリツイートを取得します。
ユーザー タイムラインを取得する

この操作では、特定のユーザーによって投稿された最新のツイートの一覧を取得します。
ユーザーの取得

この操作では、ユーザー名、説明、フォロワー数など、特定ユーザーのプロファイルの詳細を取得します。
リツイート

この操作では、新しいツイートがリツイートされます。
自分のフォロワーを取得する

この操作では、自分をフォローしているユーザーの一覧を取得します。
自分のフォローを取得する

この操作では、自分がフォローしているユーザーの一覧を取得します。

ツイートの投稿

操作 ID:
Tweet

この操作では、新しいツイートが投稿されます。

パラメーター

名前 キー 必須 型 説明
ツイート テキスト
 tweetText string

投稿するテキスト。
メディア
 body binary

投稿するメディア。

戻り値

ツイート投稿の応答を表します。

本文​​
TweetResponseModel

ツイートを検索する

操作 ID:
SearchTweet

この操作では、検索クエリに一致する関連するツイートの一覧を取得します。

パラメーター

名前 キー 必須 型 説明
検索テキスト
 searchQuery True string

「ハッピー アワー」、#haiku、from:@username、love OR hate のような検索語句です。
結果の最大件数
 maxResults integer

返すツイートの最大数。
sinceId
 sinceId string

指定されたツイート ID 以降のツイートを返します。

戻り値

応答
array of TweetModel

フォロワーの取得

操作 ID:
Followers

この操作では、特定のユーザーをフォローしているユーザーの一覧を取得します。

パラメーター

名前 キー 必須 型 説明
User name
 userName True string

ユーザーの X ハンドルです。
結果の最大件数
 maxResults integer

返すユーザーの最大数。

戻り値

応答
array of UserDetailsModel

フォローの取得

操作 ID:
Following

この操作は、特定のユーザーがフォローしているユーザーの一覧を取得します。

パラメーター

名前 キー 必須 型 説明
User name
 userName True string

ユーザーの X ハンドルです。
結果の最大件数
 maxResults integer

返すユーザーの最大数。

戻り値

応答
array of UserDetailsModel

ホーム タイムラインの取得

操作 ID:
HomeTimeline

この操作では、自分と自分のフォロワーによって投稿された最新のツイートとリツイートを取得します。

パラメーター

名前 キー 必須 型 説明
結果の最大件数
 maxResults integer

返すツイートの最大数。

戻り値

応答
array of TweetModel

ユーザー タイムラインを取得する

操作 ID:
UserTimeline

この操作では、特定のユーザーによって投稿された最新のツイートの一覧を取得します。

パラメーター

名前 キー 必須 型 説明
User name
 userName True string

ユーザーの X ハンドルです。
結果の最大件数
 maxResults integer

返すツイートの最大数。

戻り値

応答
array of TweetModel

ユーザーの取得

操作 ID:
User

この操作では、ユーザー名、説明、フォロワー数など、特定ユーザーのプロファイルの詳細を取得します。

パラメーター

名前 キー 必須 型 説明
User name
 userName True string

ユーザーの X ハンドルです。

戻り値

ユーザーを表します。

Body
UserDetailsModel

リツイート

操作 ID:
Retweet

この操作では、新しいツイートがリツイートされます。

パラメーター

名前 キー 必須 型 説明
ツイート ID
 tweetId True string

リツイートされるツイート。
ユーザーのトリミング
 trimUser boolean

ユーザー情報をトリミングするかどうかを示すブール値です。

戻り値

ツイート投稿の応答を表します。

本文​​
TweetResponseModel

自分のフォロワーを取得する

操作 ID:
MyFollowers

この操作では、自分をフォローしているユーザーの一覧を取得します。

パラメーター

名前 キー 必須 型 説明
結果の最大件数
 maxResults integer

取得するユーザーの最大数。

戻り値

応答
array of UserDetailsModel

自分のフォローを取得する

操作 ID:
MyFollowing

この操作では、自分がフォローしているユーザーの一覧を取得します。

パラメーター

名前 キー 必須 型 説明
結果の最大件数
 maxResults integer

返すユーザーの最大数。

戻り値

応答
array of UserDetailsModel

トリガー

新しいツイートが投稿されたとき

この操作は、特定の検索クエリに一致する新しいツイートが投稿されたときにフローをトリガーします。

新しいツイートが投稿されたとき

操作 ID:
OnNewTweet

この操作は、特定の検索クエリに一致する新しいツイートが投稿されたときにフローをトリガーします。

パラメーター

名前 キー 必須 型 説明
検索テキスト
 searchQuery True string

「ハッピー アワー」、#haiku、from:@username、love OR hate のような検索語句です。

戻り値

バッチ トリガー応答のラッパー オブジェクトを表します

Body
TriggerBatchResponse[TweetModel]

定義

TweetModel

ツイート投稿を表します。

名前 パス 型 説明
ツイート テキスト
 TweetText string

ツイートのテキスト コンテンツ
ツイート ID
 TweetId string

ツイートの ID
作成場所
 CreatedAtIso string

ツイートが投稿された時刻
リツイート数
 RetweetCount integer

ツイートのリツイートの合計数
ツイート作成者
 TweetedBy string

ツイートを投稿したユーザーの名前
メディア URL
 MediaUrls array of string

ツイートと一緒に投稿されたメディアの URL
ツイート言語
 TweetLanguageCode string

ツイートの言語コード
in_reply_to_user_id
 TweetInReplyToUserId string

現在のツイートの返信先であるツイート作成者のユーザー ID
お気に入り
 Favorited boolean

ツイートがお気に入りとしてマークされているかどうかを示します
ユーザーの言及
 UserMentions array of UserMentionsModel

ツイートで言及されているユーザーの一覧
OriginalTweet
 OriginalTweet OriginalTweetModel

元のツイート投稿を表します。
UserDetails
 UserDetails UserDetailsModel

ユーザーを表します。

UserMentionsModel

ツイートで言及されたユーザーを表します。

名前 パス 型 説明
言及されたユーザー ID
 Id integer

ユーザーの X ID (ハンドル)
言及されたユーザーの氏名
 FullName string

ユーザーの氏名
言及されたユーザー名
 UserName string

ユーザーの画面名

OriginalTweetModel

元のツイート投稿を表します。

名前 パス 型 説明
元のツイート テキスト
 TweetText string

取得した元のツイートのテキスト コンテンツ
元のツイート ID
 TweetId string

元のツイートの ID
元のツイートの作成時刻
 CreatedAtIso string

元のツイートが投稿された時刻
元のツイートのリツイート数
 RetweetCount integer

元のツイートのリツイートの合計数
元のツイートの作成者
 TweetedBy string

元のツイートを投稿したユーザーのユーザー名
元のツイートのメディア URL
 MediaUrls array of string

元のツイートと一緒に投稿されたメディアの URL
元のツイート言語
 TweetLanguageCode string

元のツイートの言語コード
元のツイートの in_reply_to_user_id
 TweetInReplyToUserId string

現在の元のツイートが返信先であるツイート作成者のユーザー ID
お気に入りの元のツイート
 Favorited boolean

元のツイートがお気に入りとしてマークされているかどうかを示します
元のツイートのユーザーの言及
 UserMentions array of OriginalTweetUserMentionsModel

ツイートで言及されているユーザーの一覧
UserDetails
 UserDetails OriginalTweetUserDetailsModel

元のツイートを投稿したユーザーを表します

UserDetailsModel

ユーザーを表します。

名前 パス 型 説明
件名
 FullName string

ユーザーの名前
場所
 Location string

ユーザーの場所
ユーザー ID
 Id integer

ユーザーの X ID (ハンドル)
User name
 UserName string

ユーザーの画面名
フォロワー数
 FollowersCount integer

フォロワーの数
内容
 Description string

ユーザーの説明
状態数
 StatusesCount integer

ユーザー状態の数
フレンド数
 FriendsCount integer

フレンドの数
お気に入り数
 FavouritesCount integer

ユーザーがお気に入りに追加したツイートの数
プロファイル画像 URL
 ProfileImageUrl string

プロファイル画像の URL

OriginalTweetUserMentionsModel

元のツイートで言及されたユーザーを表します。

名前 パス 型 説明
元のツイートで言及されたユーザー ID
 Id integer

ユーザーの X ID (ハンドル)
元のツイートで言及されたユーザーの氏名
 FullName string

ユーザーの氏名
元のツイートで言及されたユーザー名
 UserName string

ユーザーの画面名

OriginalTweetUserDetailsModel

元のツイートを投稿したユーザーを表します

名前 パス 型 説明
元のツイートのユーザーの氏名
 FullName string

ユーザーの名前
元のツイートのユーザーの場所
 Location string

ユーザーの場所
元のツイートのユーザー ID
 Id integer

ユーザーの X ID (ハンドル)
元のツイートのユーザー名
 UserName string

ユーザーの画面名
元のツイートのユーザーのフォロワー数
 FollowersCount integer

フォロワーの数
元のツイートのユーザーの説明
 Description string

ユーザーの説明
元のツイートのユーザーの状態数
 StatusesCount integer

ユーザー状態の数
元のツイートのユーザーのフレンド数
 FriendsCount integer

フレンドの数
元のツイートのユーザーのお気に入り数
 FavouritesCount integer

ユーザーがお気に入りに追加したツイートの数
元のツイートのユーザー プロファイル画像の URL
 ProfileImageUrl string

プロファイル画像の URL

TweetResponseModel

ツイート投稿の応答を表します。

名前 パス 型 説明
ツイート ID
 TweetId string

投稿されたツイートの ID

TriggerBatchResponse[TweetModel]

バッチ トリガー応答のラッパー オブジェクトを表します

名前 パス 型 説明
値
 value array of TweetModel

応答オブジェクトの一覧