Download the source code of Delphi and a Demo app

Delphi用ソースコードおよびデモアプリをダウンロード

1. Start a Web Browser and access Twitter Developer Portal.


2. Click Get started at the bottom left.

1. ウェブブラウザを立ち上げ、Twitter Developer Portal にアクセスします。
   なお、現状では英語のページしかありません。
2. 左下の Free の下にある Get started をクリックします。

有料版へ誘導しようとしますから、必ず無料版 FREE を選択してください。

The default value of the app is Read-only. You won't be able to post Tweets with this.
Change to Read-Write in this setting screen.

Important
A screen to copy keys and tokens is displayed before this setting screen, and what is copied at that time is only read-only, and changing it here will not be a read-write.

1. Check Read and write under the App permissions caption.


2. Check Web App, Automated or Bot under the Type of App caption.


3. Under App info caption, type "https://twitter.com/home" in the Callback URI / Redirect URL and Website URL input boxes.


4. Click the Save button.

アプリの初期値はRead-onlyなっています。これではツイートは投稿できません。
この設定画面でRead-Writeに変更します、

重要
この設定画面の前にキーやトークンをコピーする画面が表示され、その時点でコピーしたものは、あくまでもRead-onlyであり、ここで変更しても、Read-writeにはなりません。

この設定画面で設定を済ませておき、次のステップで開発者用の各種キーおよびトークンをデモアプリ側にコピー&ペーストします

1. App permissions（アプリ許可）のRead and writeをチェックします。
2. Type of App（アプリのタイプ）のWeb App, Automated or Botをチェックします。
3. App info（アプリ情報）のCallback URI / Redirect URLおよび Website URLにそれぞれ https://twitter.com/home と入力します。


4. Save をクリックします。

Click the [Set tokens] tab in the Demo app.

［Set tokens］タブで、一括して各種キーおよびトークンを入力します。

In [Keys and tokens] screen, regenerate and copy

1. Consumer keys
   and
2. Client ID

then paste them in the Demo app.
After you paste all of them, click a Set button in the Demo app.



［Keys and tokens］画面で、

1. Consumer keys
   および
2. Client ID

を Regenerate （再生成）と Copy を行ない、 デモアプリの［Set Tokens］タブの対応する項目に「ペースト」します。


すべてをペーストした後、 Set ボタンをクリックして、v1ならびにv2のアプリ連携認証を行ないます。

procedure TTwitterBot2.Authorize_v1;
procedure TTwitterBot2.GetAccessToken_v1(Verifier: string);


To be able to upload a image from the BOT, start the v1 authentication.

1. Click [API 1.1 authentication] tab.


2. Click start 1.1 Auth button.


3. A Web Browser is displayed to authorize your app.


4. If you grant your App, a PIN is displayed and copy it.


5. Click a Paste button


6. Click a get access tokens button.


7. if a post tweets button is enabled, v1 Auth is successed.

BOTから画像ファイルをアップロードできるようにするために、API v1.1のTwitterアプリ認証を開始します。

1. ［API 1.1 authentication］タブをクリックし、API 1.1 authentication 画面を表示します。


2. start 1.1 Auth ボタンをクリックします。


3. ブラウザ・ウィンドウが表示され、連携アプリの許可を求められます。


4. 許可すると、PINが表示され、これを選択してコピーします。


5. Paste ボタンのをクリックしてPINをボックスにペーストします。


6. get access tokens ボタンをクリックします。


7. post tweets ボックスが有効になったらv1 認証は成功です。

procedure TTwitterBot2.Authorize_v2;
procedure TTwitterBot2.GetAccessToken_v2(Url: string);


To post a text form your BOT, start the API 2.0 Authentication.

1. Click a [API 2.0 Authentication] tab.


2. Click a start v2 Auth button.


3. A Web Browser is displayed to authorize your app.


4. If you grant your App, a CODE is pasted from the Browser URL.


5. Click a get access tokens button.


6. if a post tweets button is enabled, v2 Auth is successed.

BOTからテキストを投稿できるようにするために、API v2のTwitterアプリ認証を開始します。

1. ［API 2.0 Authentication］タブをクリックし、Twitter API 2.0画面を表示します。


2. start v2 Auth ボタンをクリックします。


3. ブラウザ・ウィンドウが表示され、連携アプリの許可を求められます。


4. 許可すると、デモアプリ側でトークンを取得するためのCodeが自動的にペーストされています。


5. get access tokens ボタンをクリックします。


6. post tweets ボックスが有効になったらv2 認証は成功です。

function TTwitterBot2.DoUploadImage_v1(Filename: string): string;
function TTwitterBot2.DoRefreshTokens_v2: string;
function TTwitterBot2.DoPostTweet_v2(Text: string; MediaID: string): string;


After your App is authorized, try to post a tweet with a image.

1. Clikc [Tools] tab.


2. Click a Open button to select a image file.


3. Type a text in a memo box to post.


4. Click a Post tweet button.

Hint

An access token / bearer token lifetime is 7200 seconds. Before you use an access token, check whether it is valid.
If it is not valid, you must obtain a new access token with a refresh token.
At this refreshing process, you get an new access token and a refresh token that you can use at the next refreshing process.


v1およびv2のアプリ連携認証が終わったら、いちどテストとして画像付きツイートを投稿してみましょう。

1. ［ツール］タブをクリックし、ツール画面を表示します。


2. 右端にある Open ボタンをクリックし、投稿する画像を選択します。


3. 投稿ボックスに適当なツイート文を入力します。


4. Post tweet ボタンをクリックします。


5. 投稿を確認するために、 Navigate ボタンをクリックします。


6. ブラウザで［プロフィール］をクリックすると、先ほど投稿したツイートが最上位に表示されるはずです。

ヒント

access token / bearer token の寿命は7200秒です。access tokenを使用する前に期限が切れてないかどうかチェックする必要があります。
期限切れであれば、refresh token を使って新しい access token を取得します。
このトークン更新プロセスでは、新しい access token および refresh token を取得できます。この refresh token は次回のトークン更新プロセスで使用します。