第23章 Twitter への接続
インテグレーションで Twitter に接続するための主なステップは次のとおりです。
Fuse Online 環境から Twitter へのアクセスを承認するため、Twitter 開発者アカウントが必要です。Twitter 開発者アカウントを持っていない場合は、https://apps.twitter.com にアクセスし、Twitter にログインしてから Apply for a developer account をクリックします。you@gmail.com
のような個人アドレスではなく、me@redhat.com
のような企業のアドレスを提供すると、迅速に開発者アカウントを取得できます。
23.1. Fuse Online を Twitter クライアントアプリケーションとして登録
インテグレーションで Twitter に接続するには、最初に Fuse Online 環境を Twitter にアクセスできるクライアントアプリケーションとして登録する必要があります。これにより、Twitter に接続するインテグレーションをいくつでも作成することができます。そのため、特定の Fuse Online 環境を 1 度だけ Twitter に登録する必要があります。
Fuse Online を Twitter クライアントアプリケーションとして登録できるのは、Fuse Online 環境ごとに 1 回のみです。しかし、各 Twitter コネクションは同じ登録を使用しますが、異なるユーザークレデンシャルを使用することができます。
前提条件
Fuse Online にログインしている必要があります。Fuse Online にアクセスできる URL は、Red Hat Fuse Online Evaluation プログラムのウェルカムメールメッセージにあります。
手順
Fuse Online で以下を行います。
- 左側のパネルで Settings をクリックします。
-
Settings ページで、上部付近にあるコールバック URL の右側で
をクリックし、Fuse Online インストールのコールバック URL をクリップボードにコピーします。この手順の後半でこの URL が必要になります。
- Twitter エントリーの右側にある Register をクリックし、Consumer API Key および ConsumerAPI Secret Key フィールドを表示します。
別のブラウザータブで、Twitter 開発者アカウント にアクセスし、必要な場合はログインしてから以下を行います。
- 右上で、開発者プロジェクトの名前の横にある下向きのキャレットをクリックし、Apps をクリックします。
- 右上の Create an app をクリックします。
- App name フィールドに My Fuse Online Client などの名前を入力します。
- Application description フィールドに、For leveraging tweets などのヒントを入力します。
-
Website URL フィールドに、この手順の最初でコピーした URL を貼り付け、URL の最後にある
api/v1/credentials/callback
を削除します。 - Enable Sign in with Twitter を選択します。
-
Callback URLs フィールドに URL を再度貼り付けます。
https://app-proj912876.7b63.fuse-ignite.openshiftapps.com/api/v1/credentials/callback
のようになるはずです。 -
このアプリの使用目的を 100 文字以内で説明する必要があります。
This is a demo application so that I can evaluate how to integrate Twitter with my enterprise applications.
をコピーし、貼り付けてもいいでしょう。 - Create をクリックします。
- 再度 Create をクリックし、開発者規約を読んだことを確認します。
- 作成したアプリのページ上部にある Keys and tokens タブをクリックします。
- コンシューマー API キーをコピーします。
- Fuse Online の Settings ページに戻り、Twitter のコンシューマー API キーを Fuse Online の Twitter Consumer API Key フィールドに貼り付けます。
- Twitter の Keys and tokens タブに戻り、コンシューマー API シークレットキーをコピーします。
- Fuse Online の Settings ページに戻り、Twitter のコンシューマー API シークレットキーを Fuse Online の Twitter Consumer API Secret Key フィールドに貼り付けます。
- Save をクリックし、Ok をクリックします。
23.2. Twitter コネクションの作成
Twitter からデータを取得するインテグレーションを作成するには、最初に Twitter コネクションを作成する必要があります。Twitter コネクションを作成した後、任意の数のインテグレーションで使用できます。
前提条件
- Fuse Online にログインしている必要があります。Fuse Online にアクセスできる URL は、Red Hat Fuse Online Evaluation プログラムのウェルカムメールメッセージにあります。
- Fuse Online がウェブブラウザーで開かれている必要があります。
- Fuse Online 環境が Twitter にアクセスできるアプリケーションとして登録されている必要があります。
- Fuse Online の Settings ページで登録した後に受け取った Twitter コンシューマー API キーおよびコンシューマー API シークレットキーが追加済みである必要があります。
手順
- Fuse Online の左パネルで Connections をクリックし、利用可能なコネクションを表示します。
- 右上の Create Connection をクリックし、利用可能なコネクターを表示します。コネクターは、1 つ以上のコネクションを作成するために使用するテンプレートです。
- Twitter コネクターをクリックします。
Connect Twitter をクリックし、Twitter の承認ページを表示します。承認ページを表示するには Twitter にログインする必要があることがあります。
Connect Twitter が表示されない場合、Fuse Online 環境は Twitter クライアントアプリケーションとして登録されていません。「Fuse Online を Twitter クライアントアプリケーションとして登録」を参照してください。Twitter コネクションの作成時に Fuse Online 環境が Twitter クライアントアプリケーションとして登録されていない場合、Fuse Online は承認情報を要求する複数のフィールドを表示します。これらのフィールドに値を入力して Twitter コネクションを作成することはできますが、推奨されません。
- Authorize app をクリックし、Fuse Online に戻ります。
-
Connection Name フィールドに、このコネクションを別のコネクションと区別するために使用する名前を入力します。たとえば、
Twitter Connect 1
を入力します。 -
Description は任意のフィールドで、このコネクションに関する便利な情報を入力します。たとえば、
Sample Twitter connection that uses my Twitter login credentials.
を入力します。 - 右上にある Create をクリックし、作成したコネクションが利用可能になったことを確認します。上記の例の名前を入力した場合は、インテグレーションに追加できるコネクションとして Twitter Connect 1 が表示されます。
23.3. Twitter コネクションを追加してインテグレーションの実行をトリガー
インテグレーションでは、ツイートに Twitter ハンドル名や指定のテキストが含まれている場合に Twitter へのコネクションはインテグレーションの実行をトリガーすることができます。Twitter へのコネクションはインテグレーションの最初のコネクションである必要があります。
前提条件
- Twitter コネクションが作成されている必要があります。
- インテグレーションを作成または編集することになります。Fuse Online は最初のコネクションの選択を要求します。
手順
- インテグレーションに追加する Twitter コネクションをクリックします。インテグレーションが Twitter にコネクションするために選択したコネクションを使用する場合、Fuse Online はそのコネクションに定義されたクレデンシャルを使用します。
選択したコネクションが実行するアクションをクリックします。インテグレーションに追加した Twitter コネクションは選択したアクションのみを実行します。
- Mention は、ツイートにハンドル名が含まれる場合にインテグレーションの実行をトリガーします。
- Search はツイートに指定のテキストが含まれる場合にインテグレーションの実行をトリガーします。
- 任意で、Fuse Online が要求する設定情報を入力します。たとえば、Search アクションは、検索の頻度と検索するキーワードを指定するよう要求します。
- Done をクリックしてコネクションをインテグレーションに追加します。
結果
インテグレーションフローの最初にコネクションが表示されます。