メインコンテンツまでスキップ

X との連携設定

X（旧 Twitter）のプロバイダ連携設定に関するドキュメントです。

注記

以下の手順に記載している画面スクリーンショットは 2023/05/11 時点のものです。操作のタイミングによっては、画面の内容に変更がある可能性もございます。

類似の操作で設定が進められない場合は、お手数ですが ソーシャルPLUS サポート窓口 へお問い合わせください。

ご注意: 2023年4月29日 X API プランの変更による影響​

（2023/6/15追記）公式発表は無いものの現状の発生ケースを見て内容を更新しました。

すでに X アプリをご利用中の X Developer アカウントでは以下の変更がありました。

  • 自動的に有料プラン（Basic）へ移行する。無料プラン（Free）の利用には操作が必要
  • 無料プランで利用可能な Production 用の X アプリは 1 件に制限
  • Standalone App を利用中の場合は Project への移行が必要（2023/6/15 追記）

これらの状況は X Developer Portal からご確認ください。確認のためには管理者の X アカウントでログインが必要です。

登録されている X アプリの件数と状態の確認​

登録されている X アプリは「Projects & Apps」メニュー内で確認可能です。

X Developer Portal - Projects & Apps 内のアプリ件数を確認

複数件の登録がある場合、いくつかの X アプリは "SUSPENDED"（停止）の状態になっていることがあります。停止されるアプリの基準は明確になっておらず、本番環境で利用中の X アプリが停止されることもあります。

基本的には 「X Developer アカウント 1 件につき、登録されている X アプリが 1 件」となるよう、X アプリの削除などを行っていただく 必要があります。登録されている X アプリが 1 件のみとなることで、そのアプリの "SUSPENDED"（停止）状態が解除され、再度利用可能になります。

（2023/6/15 追記）残す X アプリ 1 件が "Standalone Apps" 配下にある場合 に再度 "SUSPENDED"（停止）状態となるケースが報告されています。

"Project" を作成し、ご利用の X アプリをそちらに紐付け直すか、紐付け直しの操作ができない場合は作成した "Project" 配下に新規の X アプリを登録し直していただく 必要があります。X アプリを作成し直す場合、既存の X アプリを削除してから実施する必要がある場合があります（アプリ作成の上限数に引っかかるため）。

本番環境で利用中の X アプリが複数件ある場合

利用したい X アプリの数だけ、新規の X Developer アカウントをご用意ください。

「X ログイン」に利用する X アプリが切り替わりましても、引き続きユーザ認証が可能です（OAuth 1.0a の場合）。ただし、X アプリの切り替え後の初回ログイン時に一度だけ "同意画面" が表示されます。

「X ログイン」に利用する X アプリの切り替えは、ソーシャルログインマネージャー からご利用サービスの［プロバイダ設定］>［X］設定ページから「API Key」、「API Secret」（API Key Secret）を更新するのみとなります。念の為、更新前の値をお手元に控えて作業してください。

X Developer アカウントとして利用する X アカウントについて

2023年5月9日の報道によりますと X は「数年間、全く使用されていないアカウントを削除している」と発表されております。休眠アカウントの判断条件は明示されておりません。

管理者となる X アカウントでは、ある程度のログインや発言（ツイート）などを行うことを推奨いたします。ただし、こちらを自動化などされますと今度は bot と判断されアカウント停止となる可能性がございますのでご留意ください。

料金プランの確認と変更​

既存の X Developer アカウントは、自動的に有料プラン（Basic）に移行されます。多くの場合は支払い情報が未登録であるため、稼働中の X アプリに対して無料プランにおける制限が掛かり "SUSPENDED"（停止）などの状態になります。

ソーシャルPLUS の X ログインは X API の無料プラン（Free）で利用可能です。そのため、ご利用プランを無料プランへダウングレードする操作が必要 です。

ご利用プランを無料プラン（Free）にダウングレードするためには、事前に登録済みの X アプリ件数を 1 件とする必要があります。 X アプリが複数件存在する状態では無料プラン（Free）へのダウングレードボタンを押下出来ない状態になります。X アプリが 1 件の場合でも以下のように "Downgrade" ボタンが（アクティブ状態でも非アクティブ状態でも）表示されている場合は無料プランに移行されていません。必ずこの画面を確認して「Free」プランへの "Downgrade"（ダウングレード）ボタンを押下してください。

X Developer Portal - Products > X API v2 で料金プランを確認

注意事項は以上となります。

1. X 連携前の準備​

開発者登録の対象とする通常の X アカウントが必要です。個人のものでも、開発・テスト用に新規にアカウントを作成されても問題ありません。その X アカウントで、ブラウザから X にログインされている状態から操作を開始します。

すでに開発者登録されている場合は、この手順をスキップして手順 2. へ進みます。

1-1. X アカウントに電話番号を登録​

すでにご利用の X アカウントに電話番号を登録されている場合は、この手順をスキップして手順 1-2. へ進みます。

  1. X の設定 から［アカウント情報］>［電話］をクリック

  2. 次の画面が表示されます。［電話番号を追加］をクリック

    X - 電話番号を変更

  3. パスワードの再入力を求められるので、入力し、右上の［次へ］をクリック

    • 「新しいパスワード」とありますが、既存のパスワードの確認が行われます

    X - 新しいパスワードを再入力

  4. 次の画面が表示されます。［国番号］に +81 日本 を選択し、［電話番号］にショートメッセージ（SMS）を受信可能な電話番号を入力します。右上の［次へ］をクリック

    X - 電話番号を追加

  5. 次のダイアログが表示されます。内容を確認し［OK］をクリック

    X - 電話番号の認証

  6. 入力した電話番号宛てにショートメッセージ（SMS）で認証コードが届きます。次の画面に［認証コード］を入力し、右上の［認証］をクリック

    X - 認証コードを送信しました

  7. 登録された電話番号が確認できれば、電話番号の追加は終了です

    X - 電話番号を変更（登録済み）

つづいて、このアカウントを開発者として登録します。

1-2. X アカウントを開発者として登録​

X Developer（developer.x.com） から開発者登録を行います。

注記

X Developer のページに初めてアクセスする際には、Cookie の利用に関する同意が表示されますので、特に理由がない場合は同意のうえ［Accept］をクリックしてください。

X Developer - Cookie の利用に関する同意

  1. 管理アカウントとして利用したい X アカウントでログインしていることを確認します

    X Developer - Sign up

  2. ヘッダーメニューの［Developer Portal］を押下し、以下の画面へ遷移します。画面下部の［Sign up for Free Account］をクリック

    X Developer - Ready to build on X (1) X Developer - Ready to build on X (2)

  3. 次の画面が表示されます。入力項目はすべて必須です。内容を確認し、入力したら［Submit］ボタンをクリック

    X Developer - Ready to build on X (2)

以降は、画面の案内に沿って操作を完了してください。

備考

現在 X Developer 側の画面変更が頻繁にあるため、表示された画面の内容を確認しご対応いただきますようお願いいたします。

Chrome ブラウザなどの無料の日本語翻訳ツールをご利用いただくとスムーズです。

なおご不明点がある場合はお気軽にサポート窓口へお問い合わせください。

以上で開発者登録は完了です。

2. X アプリの準備​

開発者登録を完了すると、自動的に Project と X アプリ 1 件が作成されます。こちらを編集して、ソーシャルPLUS のソーシャルログインで利用できる状態にします。

X Developer Portal - Projects & Apps

2-1. X アプリの設定​

ソーシャルログインを利用するために、アプリの詳細設定を完了させます。ここで設定する内容はユーザーがログインする際に表示されます。

  1. アプリ設定のトップページから App Details の［Edit］をクリック

    X Developer Portal - App Details

  2. Edit App details の画面が表示されます。入力はすべて日本語で構いません。必要な内容を入力し［Save］をクリック

    • App name : アプリ名。ユーザに表示されるアプリの名称として変更します（サービス名、ブランド名など）
    • App icon : アプリアイコンの画像。ファイルサイズ上限 700 KB、ファイル形式 JPG、GIF、PNG のいずれかである必要があります
    • Description : アプリの説明。ユーザーが安心して利用に同意できるような説明をつけましょう（ユーザーに対してどのような目的/利点で作られたアプリなのか）

    X Developer Portal - Edit App Details

保存が完了するとアプリ設定のトップページに戻ります。

以上で、アプリの詳細設定は完了です。続けてログイン機能の有効化を行います。

2-2. X ログインの設定​

作成した X アプリに「X ログイン」を設定します。

ここでは、一部でソーシャルログインマネージャー上の情報が必要となります。ソーシャルログインマネージャーにアクセスし、ご利用のサービスを選択したあと［プロバイダ設定］>［X］のページを表示しておきます。

ソーシャルログインマネージャー - プロバイダ設定（X）

以下の手順を実施してください。

  1. アプリ設定のトップページから下にスクロールし、User authentication settings の［Set up］（または［Edit］）をクリック

    X Developer Portal - Set up

  2. User authentication settings のページが表示されます。［App permissions］の［Read］を選択

    • 個人情報としてメールアドレスを取得する場合 は［Request email address from users］のスイッチも有効化します

    X Developer Portal - User authentication settings (1)

  3. 同じ画面を下にスクロールし、［Type of App］の［Web App, Automated App or Bot］を選択

    X Developer Portal - User authentication settings (2)

  4. 同じ画面を下にスクロールし、表示されたフォームに必要な事項を入力します。以下の説明をもとに項目を埋め、最後に［Save］をクリック

    X Developer Portal - User authentication settings (3)

    (1) Callback URLs
    ソーシャルログインマネージャーの X 設定ページに表示された［Callback URL］をコピーして貼り付け

    (2) Website URL
    ソーシャルログインを導入する貴社サービスの URL

    (3) Organization name
    提供元の企業名（入力任意）

    (4) Organization URL
    提供元企業のサービス URL（入力任意）

    (5) Terms of service
    貴社サービスの利用規約ページ URL。メールアドレス取得の場合は入力必須

    (6) Privacy policy
    貴社のプライバシーポリシーページ URL。メールアドレス取得の場合は入力必須

  5. 保存が完了すると、アプリ設定のトップページへ戻ります。「User authentication set up（緑のチェックマーク）」になっていれば完了です

    X Developer Portal - Authentication settings

以上で、X ログインの設定は完了です。

2-3. API Key と API Key Secret の取得​

続けてソーシャルPLUS の利用に必要な API Key と API Key Secret の取得を行います。

  1. ［Keys and tokens］タブを表示し、［Consumer Keys］の［Regenerate］をクリック

    X Developer Portal - Keys and tokens (1)

  2. 確認モーダルで［Yes, regenerate］をクリック

    X Developer Portal - Keys and tokens (2)

  3. 表示された［API Key］と［API Key Secret］の値を取得

    X Developer Portal - Keys and tokens (3)

この値は 手順 3. で必要となります。上記の画面を閉じると、同じ値を再取得することはできませんので、ソーシャルPLUS 側の設定を行うまで手元に保存してください。値を失念された場合は、再度［Regenerate］を行ってください。

2-4. 利用プランの確認と変更​

開発者登録時に「Sign up for Free Account」で登録した場合は無料プラン（Free）の状態となります。

基本的にはそのまま操作不要で利用可能ですが、無料プラン（Free）のページに［Downgrade］ボタンが押下できる状態で表示されている場合は、念のため［Downgrade］ボタンを押下してください。

X Developer Portal - X API v2 - Free

ここまでで X Developer Portal 側の設定は完了です。続くソーシャルPLUS との連携設定で、手順 2-3. で取得した X アプリの情報が必要となります。

3. ソーシャルPLUS との連携設定​

X アプリの作成時に書き留めた「API key」と「API secret key」を、ソーシャルPLUS 側に登録します。

以下の手順を実施してください。

  1. ソーシャルログインマネージャーにアクセスし、ご利用のサービスを選択したあと［プロバイダ設定］>［X］のページを表示します

  2. X プロバイダ設定ページの内容を入力し、画面下部の［保存する］をクリック

    • ［Consumer Keys］>［API Key and Secret］
      • ［API Key］には、X アプリ設定の［API Key］の値を貼り付けます
      • ［API Key Secret］には、X アプリ設定の［API Key Secret］の値を貼り付けます
    • ［設定者情報］>［設定者のメールアドレス］
      • X Developer Portal の管理者として使用しているアカウントの「メールアドレス」を入力します（備忘用）

    ソーシャルログインマネージャー - X プロバイダ設定（Consumer Keys > API Key and Secret） ソーシャルログインマネージャー - X プロバイダ設定（Consumer Keys > API Key and Secret）

  3. 保存が完了後、以下の画面に戻ります。ラベルが［設定済］になっていれば問題ありません

    ソーシャルログインマネージャー - プロバイダ設定（X 設定済）

以上で、ソーシャルPLUS 側の連携設定は完了です。

X ログイン時の個人情報の取得については個人情報取得設定で設定します。

X には「X ログイン」を一般ユーザに利用できるようにするための "一般公開" などの手順はなく、上記までの手順で「X ログイン」をどなたでも利用可能な状態となります。

次のアクション​

タグ:
に最終更新