場所公開の使用ガイド

場所公開 API は、Studio で Roblox への公開と同様の機能を提供し、追加の権限制御と連続リリースワークフローの自動化を提供します。この API を使用して、エクスペリエンスの既存の場所を新しいバージョンにアップデートし、パブリッシングワークフローを自動化するのに便利になります。たとえば、GitHub アクションからこの API を呼び出し、成功した統合テスト後にバイナリの場所ファイルを自動的に Roblox に押すことができます。

制限

この API は HTTPS リクエストのみをサポートします。
場所公開 API は、特定のインスタンスタイプを更新しません。エクスペリエンスに EditableImage、EditableMesh、PartOperation、SurfaceAppearance、または BaseWrap インスタンスが含まれている場合は、修正後、Studioから公開します。

Roblox の場所

Roblox の経験は、1つの開始場所をユーザーの経験の入り口として、そして経験のテレポート可能な他の場所をオプションとして持つことができます。API を使用して、バージョン管理で始まる場所またはエクスペリエンスの他の場所を公開できます。

エクスペリエンスの既存の場所を更新する前に、場所のプレースID とエクスペリエンスのユニバースID が必要です。場所ID は場所を識別し、宇宙ID はエクスペリエンスを識別します。経験が 1 場所しかなくても、それぞれがユニークです。

場プレースを公開する

エクスペリエンスの既存の場所を公開するには、場所公開 APIで：

クリエイターダッシュボード上で APIキーを作成。以下の設定を行ってください:
1. ユニバースプレースをアクセス権限に追加します。
2. 選択したエクスペリエンスに書き込み操作を追加します。
ユニバースID を取得して、場プレースを公開したい経験の宇宙を取得します。
1. ナビゲート to the クリエイターダッシュボード.
2. 更アップデートしたい場所でエクスペリエンスを見つけます。
3. エクスペリエンスのサムネイルにカーソルを置き、 ⋯ ボタンをクリックし、ユニバースIDをコピーを選択します。
更アップデートしたい場所の場所ID を取得します。
1. クリエイターダッシュボードのクリエーションページに残り、ターゲットのエクスペリエンスのサムネイルをクリックします。
2. 左側のナビゲーションメニューで、場所タブをクリックします。
3. 更新したい場所を見つけて、サムネイルをクリックします。
4. プレースID は、リダイレクトされた URLにあります。たとえば、URL https://create.roblox.com/dashboard/creations/experiences/0000000/places/111111/configure では、プレースID は111111。

API キーを x-api-key ヘッダーの POST リクエストにAPIに追加します。次の 2つの例のリクエストは、Roblox XML 場所ファイル ( .rbxlx ) とバイナリ場所ファイル ( .rbxl ) を参照しています。

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} を実際のユニバースID とプレースID の経験と交換し、公開したい場所に配置します。

要求を正しく送信すると、次の形式で場所バージョン番号を含む成功応答体を受け取ります：
```
応答体の例
{ "versionNumber": 7 }
```
(オプション) Studio またはクリエイターダッシュボードでアップロードを確認します。

制限

Roblox の場所

場プレースを公開する

ページ内容