OAuth 2.0 アプリを登録すると、Roblox のリソースにアクセスできるようになります。登録後、Roblox はアプリにユニークなクライアント ID と秘密を割り当て、ユーザーからの認可を得るために使用できるオプションを提供します。
アプリの登録
アプリを登録するには:
- In the クリエイターダッシュボード , go to the OAuth 2.0 Apps page.
- クリックする OAuth 2.0 アプリを作成する ボタン。
- 有効でグローバルユニークな アプリケーション名 を入力します。
- Roblox の 「利用規約」を読んで同意し、Create をクリックします。
- コピーして クライアント ID と 秘密 を安全な場プレースに保存します。ページを閉じると、秘密にアクセスできなくなり、新しいを生成できます。アプリを登録した後、アプリの他のプロパティにアクセスできます。
- クリックしてください 編集を続ける をクリックして、次のセクションで説明されているように、アプリを構成します。
一般情報の構成
アプリを 登録 した後、一般情報を構成する必要があります。これには、次の内容が含まれます:
- Roblox コミュニティのすべての人に見える説詳細。
- アプリのサムネイル画像。最適なファイルサイズは、150x150ピクセル以上です。
- アプリのエントリーリンク として、アプリのエントリーポイントとして、例えばアプリのウェブサイトのホームページなど。
- プライバシー条款 URL と サービスの利用規約 URL を端アプリユーザーが読む前に読む必要があります。各 URL はHTTPSであり、256文字以内です。
権限を追加する
アプリ内で適切なアクセスコントロールとセキュリティを保証するには、 パーミッションスコープ を追加する必要があります。パーミッションスコープは 2種類あります:
- ユーザーIDの場合は openid などのアイデンティティスコープ で認証、ユーザーの場合は Profile などの完全プロフィールで選択する必要があります。openid を選択すると、profile のスコープを選択する必要が
- API 特定の権限範囲 、例えば asset:read の読み取り権限の権限範囲。アプリの必要な最小数のスコープ のみを選択します。
リダイレクト URL を追加する
URLをリダイレクトする は、ユーザーがアプリの権限を終了したときに移動するアプリのリエントリポイントです。確認するには、リダイレクト URL が次の要件を満たしていることを確認してください:
- すべてのリダイレクト URL は、次の形式の 1つになければなりません:
- プレーンな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¶m2=value2
- リダイレクト URL の最大長度は 256 文字です。
- 最大 10 個のリダイレクト URL を追加できます。複数のリダイレクト URL を持つと、テスト環境を構築し、ユーザーが 2 サイト間を移行できるようになります。
レビューに送信
コミュニティに悪意のあるアプリがダメージを与える可能性を最小限に抑えるために、アプリを登録すると、公開されることはありません。代わりに、100人の認可されたユーザーの制限付きで プライベートモード にあります。このモードは、チーム内でテストおよびデバッグするのに便利です。
アプリのユーザーベースを拡張したい場合は、レビューモードで公開することでベースを公開する必要があります:
- Go to the OAuth 2.0 Apps page.
- 公開するアプリの 編集と公開 ボタンをクリックします。
- 必要な情報をすべて入力し、 レビューと公開 ボタンをクリックします。待っているレビュー期間中のアプリの許可に制限付きのメッセージが表示されます。
- クリックしてください レビューに送信する 。
アプリのレビューが承保留中または拒否されるまで、他のリクエストを編集または送信できません。アプリはレビューの承認または拒否を待っている間、プライベートモードで保持されます。アプリが承認されると、プライベートモードに戻り、プライベートモードに戻ります。
アプリが承認されるかどうかにかかわらず、レビューが完了したときに結果のメール通知を受信します。
アプリの編集と削除
レビュー中でない場合は、次のステップを使用してアプリを編集または削除できます:
Go to the OAuth 2.0 Apps page.
必要なアプリの場合は、 編集 または 削除 をクリックします。
- アプリを編集する場合は、登録 の同じステップと要件を実行してください。
- アプリを削除することを選択すると、 はい、削除 をクリックして、削除を確認します。アプリを削除すると、取り戻すことはできません。
アプリの一般情報を変更またはリダイレクトする場合、ユーザーはアプリを再作成する必要はありません。しかし、パーミッションスコープを追加または変更する場合、ユーザーからの新しいパーミッションの許可を取得する必要があります。新しいスコープの許可を取得しないと、既存のトークンのセットを使用してア
私たちのシステムは、あなたのユーザーと編集を自動的に更新します。公開モードのアプリは、編集をレビューするためにアプリを再び送信する必要があります。そうでない場合、システムは公開された変更を保存し、コミュニティに公開することなく編集を保存します。