OAuth 2.0 アプリ登録

OAuth 2.0 アプリを登録すると、Roblox 資源にアクセスできるようになります。登録後、Roblox はアプリにユニークなクライアント IDと秘密を割り当て、ユーザーからロブロックス情報とリソースへのアクセス権を取得するために使用できます。

アプリを登録する

アプリを登録するには：

1. In the クリエイターダッシュボード , go to the OAuth 2.0 アプリ page.
2. クリックする OAuth 2.0 アプリを作成 ボタン。
3. 有効でグローバルにユニークな アプリケーション名 を入力します。
4. Read and agree to the Roblox 利用規約 を読み、同意し、 作成 をクリックします。
5. クライアント ID と秘密 を安全な場プレースにコピーして保存するページを閉じた後、秘密にアクセスできなくなり、新しいもののみを生成できます。アプリを登録した後でも、アプリの他のプロパティにアクセスして編集できます。
6. クリック 次へ編集 で、次のセクションで説明されているアプリを構成します。

一般情報を構成する

アプリを登録したら、注册 したアプリの一般情報を構成する必要があります。それには以下を含みます：

• Roblox コミュニティのすべての人に表示される説詳細。
• アプリのサムネイル画像。推奨されるファイルサイズは 150x150 ピクセル以上です。
• アプリの入り口として、アプリのウェブサイトホームページなどの エントリリンク 。
• A プライバシー条件 URL と A サービス条件 URL で、アプリを認可する前に最終ユーザーが読む。各 URL は HTTPS であり、256 文字以上である必要があります。

許可を追加

アプリ内で適切なアクセス制御とセキュリティを確保するには、 許可スコープ を追加する必要があります。利用可能な権限スコープの種類は 2つあります：

• アイデンティティスコープ 認証用、例えばユーザーIDの openid およびフルプロフィールの profile。If you select the profile scope, you must also select openid .
• API 固有の許可範囲 、例えば、アセットの読み取り権限のための asset:read。アプリに必要な最小数のスコープのみを選択します。

リダイレクト URL を追加

リダイレクト URL は、アプリの認可を完了したユーザーがリダイレクトされるアプリの再入りポイントです。リダイレクト URL が次の要件を満たしていることを確認してください：

• すべてのリダイレクト URLは、次の形式のいずれかになければなりません：

  • 例えば、プレーンな HTTPS: https://www.example.com。
  • ローカルホスト上のパスは、HTTP または HTTPS (自己署名証明書) でローカルデバッグ目的、例えば:

    • http://localhost:80
    • https://localhost:80
  • 特定のアプリケーションや目的のためのカスタムスキーム、例えば:

    • my-app-scheme:/
    • my-app-scheme://foo/bar/...
    • my-app://action?param1=value1&param2=value2
• リダイレクト URL の最大長は 256 文字です。
• 最大 10個のリダイレクトURLを追加できます。複数のリダイレクト URL では、テスト環境を持ち、ユーザーがダウンタイムなしで 2 サイト間を移行できます。

レビューのために送レビューする

悪意のあるアプリがコミュニティに損害を与える可能性を最小限に抑えるために、アプリの登録は広くアクセスできるようにはしません。代わりに、10のユニークなユーザーの制限で プライベートモード に残ります。このモードは、チーム内でのテストとデバッグに役立ちます。

アプリのユーザーベースを拡大したい場合は、レビューのために提出して公開モードで公開する必要があります：

1. OAuth 2.0 アプリ ページに移動します。
2. 公開したいアプリの 編集と公開 ボタンをクリックします。
3. 必要な情報をすべて記入し、 レビューと公開 ボタンをクリックします。保留中のレビュー期間中にアプリの許可に制限があるメッセージが表示されます。
4. クリック レビューのために送信 。

アプリレビューが保留中の間、現在のレビューリクエストが承認または拒否されるまで、別のリクエストを編集したり、送信したりすることはできません。レビューするビュー中にアプリはプライベートモードで残ります。アプリが承認されると、公開モードに移行し、プライベートモードに戻すことはできません。

アプリが承認されたか拒否されたかにかかわらず、レビューが完了したときに結果のメール通知を受け取ります。

アプリを編集し削除する

レビュー中でない場合は、次の手順でアプリを編集または削除できます：

1. OAuth 2.0 アプリ ページに移動します。

2. 必要なアプリの 編集 または 削除 をクリックします。

   • アプリを編集することを選択した場合は、登録 の同じ手順と要件に従ってください。
   • アプリを削除することを選択した場合は、 はい、削除 をクリックして削除を確認します。アプリを削除した後は、回復できません。

アプリの一般情報またはリダイレクト URLを変更するには、ユーザーがアプリを再認可する必要はありません。しかし、許可スコープを追加または変更する場合は、ユーザーから新しい権限の承認を得て、新しいトークンセットを取得する必要があります。新しいスコープに対する認可を得ない場合、アプリは既存のトークンを使用し続けることができますが、前のスコープに制限されます。

プライベートモードのアプリでは、システムが自動的に編集内容をユーザーと同期します。パブリックモードのアプリの場合、これらの変更を反映するには、アプリを再度レビューに提出する必要があります。そうでない場合、システムは変更を保存し、コミュニティにリリースせずに保存します。