場所公開のガイド | 文書 - Roblox クリエーターハブ

場所公開API は、同じ機能をパブリッシュを Roblox に Studio の追加のパーミッションコントロールと自動制御を含め、公開ワークフローのコンテンツを更新します。この API 操作使用して、エクスペリエンスの既存の場所を新しいバージョンに更新

この API は、HTTPS リクエストのみをサポートします。

Roblox の場所

Roblox のエクスペリエンスには、複数の場所があり、ユーザーのエクスペリエンスの 1つの開始場所としてユーザーのエントリポイントとオプションの他の場所を含みます。 API を使用して、開始場所またはエクスペリエンスの他の場所をバージョンコントロールでテレポートユーザー間で公開できます。

エクスペリエンスの既存の場所を更新する前に、プレース所の場所 ID とエクスペリエンスのユニバース ID が必要です。場所 ID は、場所とエクスペリエンスの 2>ユニバース ID2> を識別します。それぞれがユニークで、エクスペリエンスが 1 つの場プレースの

場所を公開する

エクスペリエンスの既存の場所を公開するには、Place API 公開機能を使用して：

クリエイターダッシュボードで API キーを作成。以下の設定を実行してください：
1. Add universe-places to Access Permissions .
2. 選択したエクスペリエンスに書き込みオペレーションを追加します。
公開する場プレースを公開するエクスペリエンスの宇宙ID を取得します。
1. ナビゲート to the クリエイターダッシュボード。
2. 更アップデートしたい場所のエクスペリエンスを見つけます。
3. ターゲットエクスペリエンスのサムネイルにカーソルを置き、 ⋯ ボタンをクリックしてオプションのリストを表示し、リストからコピーユニバース ID を選択します。
アップデートしたい場所の場所 ID を取得します。
1. クリエイターダッシュボードのクリエーションページに移動し、ターゲットエクスペリエンスのサムネイルをクリックします。
2. 左のナビゲーションメニューで、 Places タブをクリックします。
3. 更新したい場所を見つけ、サムネイルをクリックします。
4. 場所ID は、リダイレクトされた URL の中にあります。たとえば、https://create.roblox.com/dashboard/creations/experiences/0000000/places/111111/configure の、場所ID は、1>1111111> です。

API のキーを POST ヘッダーの 8> POST リクエストに追加する。次の 2つの例のリクエストは、Roblox XML 場所ファイル ( 1> .rbxlx1> ) とバイナリ場所ファイル ( 4> .rbxl4> ) を参照しています。

XML 場所ファイルリクエスト
$ curl --verbose --location POST 'https://apis.roblox.com/universes/v1/{universeId}/places/{placeId}/versions?versionType=Published' \
--header 'x-api-key: <your-api-key>' \
--header 'Content-Type: application/xml' \
--data-binary @/home/placefiles/place1.rbxlx

バイナリプレースファイルリクエスト
$ curl --verbose --location POST 'https://apis.roblox.com/universes/v1/{universeId}/places/{placeId}/versions?versionType=Published' \
--header 'x-api-key: <your-api-key>' \
--header 'Content-Type: application/octet-stream' \
--data-binary @/home/placefiles/place1.rbxl

コマンドを実行するには、{universeId} と{placeId} をエクスペリエンスと場所の公開先の実際の universeID と 1>placeID1> で交換します。

リクエストを正しく送信すると、次の形式で場所バージョン番号が含まれる成功の返信ボディを受信します：
```
レポートボディの例
{ "versionNumber": 7 }
```
(オプション) Studio またはクリエイターダッシュボードでアップロードを確認します。