Skip to main content

はじめに

Square Cloud で を開発してホストするには、構成と前提条件の体系的な手順に従うことが不可欠です。この技術ガイドでは、初期セットアップから本番環境へのデプロイまで、プロセス全体を解説します。

前提条件

  • Square Cloud アカウント: 登録ページからメールアドレスを使って登録します。
  • 有効な有料プラン: アプリケーションに専用リソースと最適化されたパフォーマンスを提供します。利用可能なプランを確認し、ニーズに最も適したものを選択してください。

プロジェクトの作成

認証とボットの動作には、アクティブな X (Twitter) アカウントが必要です。アカウントをお持ちでない場合は、X 公式サイトで登録してください。
API にアクセスするには、X Developer アカウントも必要です。X Developer Portal からアクセスをリクエストしてください。

X 上でのボットアプリケーション

1

Developer Portal へのアクセス

  1. X Developer Portal にアクセスします。
  2. X (Twitter) アカウントでログインします。
  3. 初めての場合は、開発者アクセスのリクエスト手続きを完了してください。
2

プロジェクトの作成

  1. ダッシュボードで「Create Project」をクリックします。
  2. プロジェクトの名前を選びます(例: 「Square Cloud Bot」)。
  3. 最も適切なユースケースを選択します(例: 「Making a bot」)。
  4. ボットの詳細な説明を入力します。
  5. プロジェクトの作成を確定します。
3

アプリケーションのセットアップ

  1. 作成したプロジェクト内で「Create App」をクリックします。
  2. アプリケーションに一意の名前を定義します。
  3. アプリケーションの作成を確定します。
  4. 生成された App ID を今後の参照用に記録しておきます。
4

API キーの生成

  1. アプリケーションの「Keys and tokens」セクションに移動します。
  2. 「Consumer Keys」セクションで「Regenerate」をクリックして、以下を生成します:
    • API Key (Consumer Key)
    • API Secret Key (Consumer Secret)
  3. 重要: これらのキーは再表示できないため、すぐにコピーして保存してください。
5

権限の設定

  1. 「App permissions」セクションに移動します。
  2. 「Edit」をクリックして権限を変更します。
  3. ボットがツイートを投稿できるように「Read and write」を選択します。
  4. 必要に応じて、DM 機能のために「Read and write and Direct message」を選択します。
  5. 変更を保存します。
6

アクセストークンの生成

  1. 「Keys and tokens」セクションに戻ります。
  2. 「Access Token and Secret」セクションで「Generate」をクリックします。
  3. トークンの生成を確定します。
  4. 以下をコピーして保存します:
    • Access Token
    • Access Token Secret
  5. 警告: これらのトークンはページを閉じた後は再表示できません。
7

認証情報の確認

  1. 必要な 4 つの認証情報がすべて揃っていることを確認します:
    • API Key (Consumer Key)
    • API Secret Key (Consumer Secret)
    • Access Token
    • Access Token Secret
  2. これらの認証情報を安全な場所に保管します
  3. 重要: これらの認証情報を公開したり共有したりしないでください

プロジェクトの開発

  1. Node.js の確認: Node.js がシステムにインストールされていることを確認してください。ない場合は、Node.js 公式サイトからダウンロードしてください。
  2. プロジェクトの初期化: 次のコマンドを実行して、新しい Node.js プロジェクトを作成します:
Terminal
  1. 依存関係のインストール: ボットに必要なライブラリをインストールします:
Terminal
  1. 環境変数のセットアップ: 認証情報を安全に保存するために .env ファイルを作成します:
.env
  1. メインファイルの作成: ボットの基本構造を含む index.js ファイルを作成します:
index.js

デプロイ

プロジェクトファイルの準備が完了したら、それらを Square Cloud にアップロードしてプロジェクトをホスティングできます。 そのためには、すべてのプロジェクトファイルを含む ZIP ファイルを作成してください。
セキュリティ: API 認証情報をコードに直接記述しないでください。Square Cloud では必ず環境変数を使用してください。
Square Cloud では、コントロールパネルから次の環境変数を設定します:
  • API_KEY: あなたの X API キー
  • API_SECRET_KEY: あなたの X API シークレットキー
  • ACCESS_TOKEN: あなたのアクセストークン
  • ACCESS_TOKEN_SECRET: あなたのアクセストークンシークレット

ダッシュボード経由

1

アップロードページにアクセス

アップロードページにアクセスし、プロジェクトの zip ファイルをアップロードします。
2

環境を設定

zip をアップロードした後、プロジェクトの名前、メインファイルまたはランタイム環境、その他の設定を構成する必要があります。
ウェブプロジェクトをアップロードする場合は、必ず「Web Publication」を選択し、プロジェクトにサブドメインを設定してください。
3

プロジェクトをデプロイ

最後に「Deploy」ボタンをクリックして、プロジェクトを Square Cloud にホストします。
デプロイ後、ダッシュボードからプロジェクトのステータスとログを監視できます。
Square Cloud へのアプリケーションのアップロード
4

アプリが稼働していることを確認

最初のデプロイは、通常 1 分もかからずに完了します。ダッシュボードでアプリケーションのステータスが running になるのを待ち、起動時のエラーがないかログを確認してください。
ウェブサイトや API をデプロイした場合は、ブラウザで https://<your-subdomain>.squareweb.app を開き、アプリケーションが応答することを確認してください。ボットをデプロイした場合は、コマンドを送信してオンラインになっていることを確認してください。
アプリが起動しませんか?よくある原因と修正方法はトラブルシューティングガイドを参照してください。

CLI 経由

この方法を使用するには、プロジェクトのルートディレクトリに squarecloud.app という名前の設定ファイルを作成する必要があります。このファイルには、プロジェクトに必要な設定が含まれます。

設定ファイルガイド

アプリケーションの環境を定義する squarecloud.app 設定ファイルの作成方法を学びます。
1

CLI をインストール

まず、環境に CLI がインストールされている必要があります。まだの場合は、ターミナルで次のコマンドを実行してください:
すでにお持ちの場合は、更新することを推奨します。更新するには、ターミナルで次のコマンドを実行してください:
2

認証

次に、認証して他の CLI コマンドを使用するには、こちらで「Request API Key」をクリックして認証キーを取得します。認証キーを取得したら、次のコマンドを実行してください:
3

プロジェクトをアップロード

最後に、CLI を使用してアプリケーションを Square Cloud にデプロイするには、次のコマンドを実行する必要があります:
または、zip を手動で作成した場合は、次を使用できます:
4

アプリが稼働していることを確認

最初のデプロイは、通常 1 分もかからずに完了します。ターミナルから直接、アプリケーションのステータスとログを確認してください。
ウェブサイトや API をデプロイした場合は、ブラウザで https://<your-subdomain>.squareweb.app を開き、アプリケーションが応答することを確認してください。ボットをデプロイした場合は、コマンドを送信してオンラインになっていることを確認してください。
アプリが起動しませんか?よくある原因と修正方法はトラブルシューティングガイドを参照してください。

ボットのテスト

デプロイ後、Square Cloud ダッシュボードでアプリケーションのログを確認し、Bot successfully initialized! メッセージが表示されてボットが正しく認証されたことを確認してください。次に、ボットのツイートの 1 つに !ping と返信し、数分以内に X 上で Pong! 🤖 X Bot working correctly! と返信されることを確認してください。

追加リソース

twitter-api-v2 を使用した X ボット開発についてさらに理解を深めるには、twitter-api-v2 公式ライブラリのドキュメントを確認してください。このドキュメントでは、詳細なガイド、高度なチュートリアル、そして実装を最大化するための完全な API リファレンスを提供しています。 以下も参照してください:

ハッシュタグの監視

投稿のスケジュール設定

レート制限

X (Twitter) には厳格なレート制限があります。これらの制限を超えないように制御を実装してください:

エラー処理

お問い合わせ

技術的な問題が解決しない場合は、専門のサポートチームがお手伝いします。お問い合わせいただければ、どのような問題でも喜んで解決をサポートいたします — サポートの質の高さも、開発者が Google と Trustpilot で Square Cloud に402 件のレビューで 4.9/5という評価をつけている理由の 1 つです。