なにこれ?
リンクされたロールと接続の一般的な概要についてはこちらをご覧ください。
接続機能を持つアプリを構築するには、まず開発者ポータルで設定されたアプリケーションとBotユーザー、対象の接続、およびリンクされたロールが必要です。このページではこれらのコンポーネントについて順を追って説明します。
アプリの例や各ステップの詳細についてはデベロッパードキュメントをご覧ください:
https://discord.com/developers/docs/tutorials/configuring-app-metadata-for-linked-roles
ウォークスルー
まず始めに、開発者ポータルで選択した接続とつながるためのBotユーザーを作成してください。また、OAuth2フロー用のリダイレクトURLも必要です。リダイレクトURLはサーバやアプリのホスティング方法によって異なります。
なお、開発者ポータルでリンクされたロールの、カスタムエンドポイントURLを設定する必要があります。
さらに、SteamなどのAPIから情報を取得するには、そのAPIの開発者向けドキュメントを参照して、そのAPIにHTTPリクエストを設定および送信する必要があります。
リンクされたロール
最後に設定するのはリンクされたロールそのものです。アプリが管理するスラッシュコマンドを登録するのと同様に、APIへのPUTリクエストでリンクされたロールのメタデータを設定し登録することが可能です。このメタデータはユーザーがリンクされたロールを取得するために満たすべき要件として使用されます。
注: 認証にはユーザートークンではなくBotトークンを使用してください。
最後に、サーバー設定に移動してロールを作成します。リンクタブでロールの要件を追加することができます。これで設定完了です。
ユーザーが自分のアカウントを接続したい場合、左上のサーバー名をクリックしアプリで管理されているリンク先のロールを探してください。