プレイスの公開に関するガイド

*このコンテンツは、ベータ版のAI（人工知能）を使用して翻訳されており、エラーが含まれている可能性があります。このページを英語で表示するには、こちらをクリックしてください。

プレイス公開APIは、StudioでのRobloxへの公開と同様の機能を提供し、継続的リリースワークフローにおける追加の権限管理と自動化を実現します。このAPIを使用して、ゲームの既存のプレイスを新しいバージョンに更新することができるため、公開ワークフローの自動化に役立ちます。たとえば、このAPIをGitHubアクションから呼び出し、統合テストが成功した後にバイナリプレイスファイルをRobloxに自動的にプッシュすることができます。

制限事項

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

Robloxのプレイス

Robloxのゲームは複数のプレイスを持つことができ、1つのスタートプレイスがゲームのユーザーエントリーポイントとして機能し、オプションの他のプレイス間でユーザーをテレポートできます。APIを使用して、スタートプレイスまたはゲームの他のプレイスをバージョン管理で公開できます。

ゲームの既存のプレイスを更新するには、プレイスのPlace IDとゲームのUniverse IDが必要です。Place IDはプレイスを特定し、Universe IDはゲームを特定します。どちらも、一つのプレイスしかないゲームでもユニークです。

プレイスを公開する

Place Publishing APIを使用して、ゲームの既存のプレイスを公開するには：

Creator DashboardでAPIキーを作成します。次の設定を行うことを確認してください：
1. アクセス権限にuniverse-placesを追加します。
2. 選択したゲームに書き込み操作を追加します。
プレイスを公開したいゲームのUniverse IDを取得します。
1. Creator Dashboardに移動します。
2. 更新したいプレイスを含むゲームを見つけます。
3. ゲームのサムネイルにカーソルを合わせ、**…**ボタンをクリックし、Copy Universe IDを選択します。
更新したいプレイスのPlace IDを取得します。
1. Creator DashboardのCreationsページに留まり、ターゲットゲームのサムネイルをクリックします。
2. 左側のナビゲーションメニューで、プレイスタブをクリックします。
3. 更新したいプレイスを見つけて、そのサムネイルをクリックします。
4. Place IDはリダイレクトされたURLにあります。たとえば、URL https://create.roblox.com/dashboard/creations/experiences/0000000/places/111111/configure,では、**Place ID**は111111` です。

APIへのPOSTリクエストのx-api-keyヘッダーに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}を実際のゲームとプレイスのUniverse IDおよびPlace IDに置き換えます。

リクエストを正しく送信すると、以下の形式でプレイスのバージョン番号を含む成功レスポンスボディを受け取ります：
```
例レスポンスボディ
{ "versionNumber": 7 }
```
（オプション）StudioまたはCreator Dashboardでアップロードを確認します。

日本語