Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
73 changes: 40 additions & 33 deletions social/twitter/locales/ja/27-twitter.html
Original file line number Diff line number Diff line change
@@ -1,41 +1,48 @@
<!-- Source revision: https://github.com/node-red/node-red-nodes/commit/425f5c151fa35b8f4a4df3956fbc3ac07e74f195 -->

<script type="text/x-red" data-help-name="twitter-credentials">
<p>Twitter APIの認証</p>
<p>初期のバージョンのノードは、1クリック認証を提供していました。Twitterは、2018年6月にこの機能を削除しました。現在は、<a href="https://developer.twitter.com/">Twitter</a>に自身のアプリケーションを登録し、自身のaccess tokenを生成する必要があります。</p>
</script>

<script type="text/x-red" data-help-name="twitter in">
<p>twitter inputノード。以下を検索するために利用します:
<p>twitter入力ノード。以下を検索するために利用します:
<ul><li>指定した検索語を含む公開ストリームのツイート</li>
<li>認証したユーザがフォローしているアカウントからの全てのツイート</li>
<li>指定したユーザの全てのツイート</li>
<li>認証したユーザがフォローしているアカウントからのツイート</li>
<li>指定したユーザのツイート</li>
<li>認証したユーザが受け取ったダイレクトメッセージ</li>
</ul></p>
<p>複数の検索語を指定する場合、スペース文字で<i>and</i>、コンマ「,」
で<i>or</i>を表します。検索語を<code>msg.payload</code>で渡す場合、
<b>for</b>フィールドは空としてください。</p>
<p><i>ツイート</i>を<code>msg.topic</code>にセットし、送信者のスク
リーンネームを付加します。</p>
<p>ツイートの送信者の位置情報が既知の場合、
<code>msg.location</code>に設定します。</p>

<p>返却値がイベントの場合、<code>msg.payload</code>にtwitterイベントを設定します。
詳細については、
<a href="https://dev.twitter.com/streaming/overview/messages-types#Events_event"
target="_new">Twitterのドキュメント</a>を参照してください。</p>
<p>tweetオブジェクトを<code>msg.tweet</code>に設定します。詳細
は<a href="https://dev.twitter.com/overview/api/tweets"
target="_new">Twitterのドキュメント</a>を参照してください。</p>

<p><b>注</b>: このノードはFireHouseに接続はしないため、@idや#ハッ
シュタグに対する全ツイートを100%返すことは保証しません。</p>
<p><b>注:</b> 特定のユーザ、もしくは、自身に対するダイレクトメッセー
ジをフォローする場合、Twitter APIのレート制限の対象となります。
そのため、フローのデプロイを15分のうちに複数回行うと、制限に引っ
かかってノード実行がエラーとなるかもしれません。このエラーは15分
経過すれば自動的に解消します。</p>
<h3>出力</h3>
<dl class="message-properties">
<dt>payload <span class="property-type">文字列</span></dt>
<dd>ツイートの本文</dd>
<dt>topic <span class="property-type">文字列</span></dt>
<dd><code>tweets/<i>screen_name</i></code>に設定</dd>
<dt>tweet <span class="property-type">オブジェクト</span></dt>
<dd>Twitter APIから返された完全なツイートオブジェクト</dd>
<dt>location <span class="property-type">オブジェクト</span></dt>
<dd>存在する場合、ツイートと関連付けされた位置情報</dd>
</dl>
<h3>詳細</h3>
<p>複数の検索語を指定する場合、スペース文字で<i>and</i>、コンマ「,」で<i>or</i>を表します。検索語を<code>msg.payload</code>で渡す場合、<b>for</b>フィールドは空としてください。</p>
<p>完全なツイートオブジェクトについては、<a href="https://developer.twitter.com/en/docs/tweets/data-dictionary/overview/tweet-object" target="_new">ここ</a>にドキュメントがあります。</p>
<p><b>注:</b> 本ノードはTwitter APIの流量制限に依存します。本ノードは更新のために1分に1回、APIをポーリングします。もし、頻繁にデプロイする場合、この制限を超えることがあります。本ノードは、流量制限がなくなるまで自動的にポーリングを遅延させます。</p>
</script>

<script type="text/x-red" data-help-name="twitter out">
<p>twitter outノード。<code>msg.payload</code>をツイートします。</p>
<p>ダイレクトメッセージ(DM)を送るには、"D {ユーザ名} {メッセージ}"
形式のペイロードを用います。</p>
<p><code>msg.media</code>にBufferオブジェクトを指定すると、その値
を画像としてツイートに付け加えます。</p>
<p><code>msg.params</code>に「名前:値」の組みからなるオブジェクト
を指定すると、更新リクエストのパラメータとして用います。</p>
<p>ツイートやダイレクトメッセージを送信します。</p>
<h3>入力</h3>
<dl class="message-properties">
<dt>payload <span class="property-type">文字列</span></dt>
<dd>送信するツイートの本体。ダイレクトメッセージを送信する方法は以下を参照してください。</dd>
<dt class="optional">media <span class="property-type">バッファ</span></dt>
<dd>ツイートに添付する画像のバッファ</dd>
<dt class="optional">params <span class="property-type">オブジェクト</span></dt>
<dd>Twitterの状態更新APIに渡すための追加パラメータ</dd>
</dl>
<h3>詳細</h3>
<p><code>msg.media</code>にバッファオブジェクトを指定すると、その値を画像としてツイートに付け加えます。</p>
<p>ダイレクトメッセージ(DM)を送るには、"D {ユーザ名} {メッセージ}"形式のペイロードを用います。</p>
<p>ダイレクトメッセージに画像を添付することはできません。</p>
<p><code>msg.params</code>に「名前:値」の組みからなるオブジェクトを指定すると、Twitter APIの更新リクエストのパラメータとして用います。利用できる値については、<a href="https://developer.twitter.com/en/docs/tweets/post-and-engage/api-reference/post-statuses-update#parameters" target="_new">ここ</a>にドキュメントがあります。</p>
</script>
14 changes: 9 additions & 5 deletions social/twitter/locales/ja/27-twitter.json
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,14 @@
"followers": "followed by",
"tweetslabel": "tweets",
"eventslabel": "events",
"clickhere": "Twitterの認証を行うため、ここをクリックしてください"
"create": "次のURLから自身のアプリケーションを作成",
"copy-consumer": "'Keys and tokens'セクションからConsumer APIキーをコピー",
"consumer_key": "API key",
"consumer_secret": "API secret key",
"copy-accessToken": "新たに'Access token & access token secret'を作成し、コピー",
"access_key": "Access token",
"access_secret": "Access token secret",
"enter-id": "Twitter IDを設定"
},
"placeholder": {
"for": "@ids, #tagsはコンマ区切りで入力",
Expand Down Expand Up @@ -41,10 +48,7 @@
"missingcredentials": "Twitterが認証されていません",
"truncated": "280文字を超えるツイートが切り捨てられました",
"sendfail": "ツイートの投稿が失敗: __error__",
"nopayload": "ツイートするペイロードがありません",
"oauthbroke": "something in twitter oauth broke.",
"oautherror": "<html><head></head><body><p>認証処理で問題が生じました。以下のエラーが返されました:</p><p><b>__statusCode__</b>: __errorData__</p><p>Node-REDが動いているシステムの時刻が正しく設定されていないことが、このエラーの原因の1つです。</p></body></html>",
"authorized": "<html><head></head><body><p>認証されました - このウィンドウを閉じて、Node-REDへ戻ることができます。</p></body></html>"
"nopayload": "ツイートするペイロードがありません"
}
}
}