このページは機械翻訳を使用して翻訳されました。元の英語を参照するには、ここをクリックします。
ThingTweet アプリ
ThingTweet アプリを使用して、Twitter® アカウントを ThingSpeak™ アカウントにリンクさせます。デバイスおよびチャネルは、TweetControl API を使用して Twitter 経由で更新できます。たとえば、温室の温度が下がったときやデバイスのバッテリーが少なくなっているときに、デバイスにツイートさせることができます。
Twitter アカウントと ThingSpeak アカウントの関連付け
Twitter アカウントにログインしている場合は、使用可能な Twitter アカウントが、ThingTweet によって自動的に ThingSpeak ユーザー アカウントに関連付けられます。別のアカウントを関連付ける場合は Twitter からログアウトします。
Sign In を ThingSpeak に。
Apps 、 ThingTweet を選択します。
Link Twitter Account をクリックします。
Twitter にリダイレクトされます。ThingTweet によるアカウントの使用を許可するように求められたら、次を行います。
Twitter のユーザー名とパスワードを入力します。
Authorize app をクリックします。
Twitterアカウントを確認したら、リンクBack to ThingTweetをクリックしてThingTweetアプリのページに戻ります。
Twitter アカウントが ThingSpeak にリンクされていることを確認してください。
アプリにより ThingTweet API キーが生成されます。この API キーとメッセージを使用して、要求を ThingTweet に送信します。メッセージは Twitter に中継されます。メッセージの送信では、Twitter API のすべてのパラメーターを使用できます。詳細については、Twitterを参照してください。各ThingTweetアプリのThingTweet API キーを表示するには、 Apps 、 ThingTweetを選択します。
Twitter ステータスの更新
ThingTweetでTwitterステータスを更新するには、 ThingTweet API キーとステータス メッセージを使用して HTTP POST またはGET を送信します。
タイトル | Twitterステータスを更新するための HTTP要求 |
---|---|
《URL》 | https://api.thingspeak.com/apps/thingtweet/1/statuses/update |
《HTTPメソッド》 | POST またはGET |
POST HTTPヘッダー | X-THINGSPEAKAPIKEY=XXXXXXXXXXXXXXX |
データパラメーター | api_key=XXXXXXXXXXXXXXXstatus=I just posted this from my Thing at %%datetime%% |
≪成功時の応答≫ | 1 |
「エラー応答」 | –1 |
POST HTTP 呼び出しのサンプル | POST /apps/thingtweet/1/statuses/update HTTP/1.1 Host: api.thingspeak.com Content-Type: application/x-www-form-urlencoded Cache-Control: no-cacheapi_key=YOUR_THINGTWEET_API_KEYstatus=I+just+posted+this+from+my+Thing+at+%25%25datetime%25%25 |
GET HTTP 呼び出しのサンプル | https://api.thingspeak.com/apps/thingtweet/1/statuses/update?api_key=XXXXXXXXXXXXXXXX&status=HeyWorld |
"ノート" | ThingTweet API キーは、HTTP ヘッダーまたは POST のbodyセクションのいずれかに指定する必要があります。あるいは、両方に指定することもできます。 |
POSTMAN 要求の例
POSTMANを使用すると、 ThingSpeakの RESTful API を使用した HTTP要求を試すことができます。要求のBody をx-www-form-urlencodedとして選択します。次のように POSTMAN を構成して、ツイートの要求をテストします。
Twitter ステータスをチャネルの最後の値で更新
チャネルのデータを Twitter メッセージに含めることができます。ThingTweet は "%%channel_CHANNEL-ID_field_FIELD-NUMBER%%"
を、指定されたチャネルおよびフィールドの最後の値に置き換えます。チャネル 1417 の field1
の最後の値で Twitter ステータスを更新するには、HTTP POST を送信します。
タイトル | Twitter ステータスをチャネル フィールドの最後の値で更新する HTTP POST 要求 |
---|---|
《URL》 | https://api.thingspeak.com/apps/thingtweet/1/statuses/update |
《HTTPメソッド》 | POST |
HTTPヘッダー | X-THINGSPEAKAPIKEY=XXXXXXXXXXXXXXX |
データパラメーター | api_key=XXXXXXXXXXXXXXXXstatus=The current CheerLights color is %%channel_1417_field_1%% at %%datetime%% |
≪成功時の応答≫ | 1 |
「エラー応答」 | –1 |
HTTP 呼び出しのサンプル | POST /apps/thingtweet/1/statuses/updateHTTP/1.1 Host: api.thingspeak.com Content-Type: application/x-www-form-urlencoded Cache-Control: no-cacheapi_key=YOUR_THINGTWEET_API_KEYstatus=The+current+CheerLights+color+is+%25%25channel_1417_field_1%25%25+at+%25%25datetime%25%25 |
"ノート" | ThingTweet API キーは、HTTP の header セクションと body セクションのどちらかになければなりませんが、両方に追加することはできます。 |
POSTMAN 要求の例
POSTMANを使用すると、 ThingSpeakの RESTful API を使用した HTTP要求を試すことができます。POSTMAN を使用し、次のように構成して、ツイートの要求をテストします。
チャネルを更新し、同時にデバイスからツイートをポストするには、Write Dataを参照してください。
置き換えキー
置換キーを使用してデータをアプリに渡すことができます。次の表は、使用可能な標準とカスタムの置き換えキーをまとめています。一部のキーは特定タイプの要求に固有のものであり、最後の列に示されています。
キー | 説明 | 例 | 使用対象 |
---|---|---|---|
%%YOUR_CUSTOM_LABEL%% | ThingHTTP はこのカスタムの置き換え値を、"YOUR_CUSTOM_LABEL" のラベルをもつトリガー要求のデータに置き換えます。 | field1=%%YOUR_CUSTOM_LABEL%% POST データ: YOUR_CUSTOM_LABEL=1234 .RESULT: field1=1234 。 | 任意の要求 |
%%channel_CHANNEL_ID_field_FIELD_NUMBER%% | 指定されたチャネルおよびフィールドの最後の値。ThingHTTP 要求と同じユーザーが所有していないプライベート チャネルへの置き換え要求には、空白の値が返されます。 | The latest value is %%channel_12_field_1%%。結果: The latest value is 2.5。 | 任意の要求 |
%%datetime%% | TimeControl または React が実行されたときの完全な日付と時刻。 | The date and time the event occurred is %%datetime%%。結果: The date and time the event occurred is 2014-09-24 5:32 pm。 | TimeControl または React |
%%day%% | TimeControl が実行されたときの曜日の名前。 | The day the event occurred is %%day%%。結果: The day the event occurred is 水曜日。 | TimeControl |
%%day_index%% | 日曜日から始まる 0 ベースの曜日インデックス。 | The number of days used this week is %%day_index%%。結果: The number of days used this week is 3。 | TimeControl |
%%hour%% | TimeControl が実行された時数。 | The hour that the event occurred is %%hour%%。結果: The hour that the event occurred is 5。 | TimeControl |
%%minute%% | TimeControl が実行された分数。 | The minute the event occurred is %%分%%。結果: The minute the event occurred is 30。 | TimeControl |
%%trigger%% | React をトリガーした値。 | It is way too hot in here at %%trigger%% C .RESULT: It is way too hot in here at 40 C 。 | React |
%%channel_id%% | React をトリガーしたチャネルの ID。 | The channel that tweets is %%channel_id%%。結果: The channel that tweets is 1256。 | React |