次の方法で共有

X

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

このコネクタは、次の製品とリージョンで使用できます。

サービス クラス リージョン
コピロット スタジオ Standard 次を除くすべての Power Automate リージョン :
     - 21Vianet が運営する China Cloud
ロジック アプリ Standard 次を除くすべての Logic Apps リージョン :
     - Azure China リージョン
     - 米国国防総省 (DoD)
Power Apps Standard 次を除くすべての Power Apps リージョン :
     - 21Vianet が運営する China Cloud
Power Automate Standard 次を除くすべての Power Automate リージョン :
     - 21Vianet が運営する China Cloud
お問い合わせ
名前 Microsoft
URL Microsoft LogicApps のサポート
Microsoft Power Automate のサポート
Microsoft Power Apps のサポート
コネクタ メタデータ
Publisher Microsoft
Web サイト https://x.com/
プライバシー ポリシー https://x.com/privacy

認証と Bring Your Own アプリケーション

Important

既定の共有アプリケーション (Microsoft が管理する Twitter クライアント アプリケーション) は使用できなくなりました。 コネクタでサポートされている認証の種類は 1 つだけです。Bring Your Own アプリケーションです。 2023 年 6 月の時点で、有料の Enterprise レベル アプリケーションが必要です。 ただし、Twitter の価格ポリシーは引き続き変更される可能性があります。

[Bring your own application]\(独自のアプリケーションを持ち込む\) オプションを使用すると、独自の 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 を追加します。

  • Fairfax の場合:
    • 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
  • GCC の場合:
    • https://power-apis-usgov001-public.consent.azure-apihub.us/redirect

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

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

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

  • [ Bring your own application]\(独自のアプリケーションを持ち込む\) を選択
  • アプリケーションのクライアント 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. 過去 7 日間に公開された最近のツイートのサンプリングに対する検索 API 検索
  2. Standard Search API は関連性に重点を置き、完全性に重点を置いていません。 これは、一部のツイートとユーザーが検索結果に表示されない可能性があることを意味します

POST 操作に関する追加の制限事項

ツイートの投稿中に @user にメンションすることはサポートされていません。 具体的には、ツイートの投稿中に "@" 文字が削除されます。

一般的な制限

名前 価値
アカウントあたりの接続数 2

接続を作成する

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

独自のアプリケーションを持ち込む

認証 ID: byoa

適用対象: すべてのリージョン

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

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

名前 タイプ Description 必須
コンシューマー キー 文字列 Twitter アプリケーションのコンシューマー キー 正しい
コンシューマー シークレット securestring Twitter アプリケーションのクライアント シークレット 正しい

既定 [非推奨]

適用対象: すべてのリージョン

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

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

アクション

つぶやき

この操作は、ツイートをリツイートします。
ツイートを投稿する

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

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

この操作では、特定のユーザーの後に続くユーザーの一覧を取得します。
フォロワーを取得する

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

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

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

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

操作は、指定されたユーザーがフォローしているユーザーの一覧を取得します。
次の情報を取得する

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

つぶやき

操作 ID:
Retweet

この操作は、ツイートをリツイートします。

パラメーター

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

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

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

戻り値

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

Body
TweetResponseModel

ツイートを投稿する

操作 ID:
Tweet

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

パラメーター

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

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

投稿するメディア。

戻り値

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

Body
TweetResponseModel

ツイートを検索する

操作 ID:
SearchTweet

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

パラメーター

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

"happy hour"、#haiku、from:@username、Love OR hate などの検索用語。
最大結果
 maxResults integer

返されるツイートの最大数。
sinceId
 sinceId string

指定したツイート ID の後にツイートを返します。

戻り値

response
array of TweetModel

フォロワーを取得する

操作 ID:
Followers

この操作では、特定のユーザーの後に続くユーザーの一覧を取得します。

パラメーター

名前 キー 必須 型 説明
ユーザー名
 userName True string

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

返されるユーザーの最大数。

戻り値

response
array of UserDetailsModel

フォロワーを取得する

操作 ID:
MyFollowers

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

パラメーター

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

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

戻り値

response
array of UserDetailsModel

ホーム タイムラインを取得する

操作 ID:
HomeTimeline

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

パラメーター

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

返されるツイートの最大数。

戻り値

response
array of TweetModel

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

操作 ID:
UserTimeline

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

パラメーター

名前 キー 必須 型 説明
ユーザー名
 userName True string

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

返されるツイートの最大数。

戻り値

response
array of TweetModel

ユーザーを取得する

操作 ID:
User

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

パラメーター

名前 キー 必須 型 説明
ユーザー名
 userName True string

ユーザーの X ハンドル。

戻り値

ユーザーを表します。

Body
UserDetailsModel

次の情報を取得する

操作 ID:
Following

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

パラメーター

名前 キー 必須 型 説明
ユーザー名
 userName True string

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

返されるユーザーの最大数。

戻り値

response
array of UserDetailsModel

次の情報を取得する

操作 ID:
MyFollowing

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

パラメーター

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

返されるユーザーの最大数。

戻り値

response
array of UserDetailsModel

トリガー

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

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

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

操作 ID:
OnNewTweet

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

パラメーター

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

"happy hour"、#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 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 OriginalTweetUserDetailsModel

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

UserDetailsModel

ユーザーを表します。

名前 パス 型 説明
名前
 FullName string

ユーザーの名前
ロケーション
 Location string

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

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

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

フォロワーの数
Description
 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
 value array of TweetModel

応答オブジェクトの一覧