Petunjuk Penggunaan untuk Penemuan Tempat

Tempat Menempatkan API memenuhi fungsionalitas yang sama dengan Publish to Roblox di Studio plus kontrol izin ekstra dan otomatis dalam workflow pengiriman berkelanjutan. Anda dapat menggunakan API ini untuk memperbarui lokasi yang ada dari pengalaman ke versi baru, menjadikannya berguna untuk mengotomatisasi workflow

Tempat di Roblox

Pengalaman di Roblox dapat memiliki beberapa tempat, dengan satu tempat pemula sebagai titik pengguna entri Anda dan tempat lain yang dapat Anda teleportkan pengguna di antara. Anda dapat menggunakan API untuk menerbitkan salah satu tempat pemula atau tempat lain dari pengalaman Anda dengan kontrol versi.

Sebelum Anda dapat menyetujui tempat yang ada dari pengalaman, Anda memerlukan ID Tempat dan Pengalaman . The ID Tempat mengidentifikasi tempat dan 2> Pengalaman2> mengidentifikasi pengalaman. Setiap orang berbeda bahkan jika pengalaman Anda hanya memiliki satu tempat.

Menerbitkan Tempat

Untuk menerbitkan tempat yang sudah ada dari pengalaman dengan Tempat Menulis API :

1. Buat kunci API di Dashboard Pencipta . Pastikan Anda melakukan pengaturan berikut:

   1. Tambahkan alam semesta-tempat ke Izinkan Akses .
   2. Tambahkan Menulis operasi ke pengalaman yang Anda pilih.

2. Dapatkan ID Alam Semesta dari pengalaman di mana Anda ingin menempatkan tempat ini.

   1. Navigasikan ke Dashboard Pencipta.

   2. Temukan pengalaman dengan tempat yang ingin Anda update.

   3. Hover over the thumbnail of the target experience and click the ⋯ button to display a list of options, then select Copy Universe ID from the list.

      

3. Dapatkan Tempat ID dari tempat yang ingin Anda update.

   1. Tetap di halaman Karya pada Dashboard Pencipta dan klik gambaran miniatur pengalaman target.
   2. Pada menu navigasi kiri, klik tab Tempat .
   3. Temukan tempat yang ingin Anda update dan klik thumbnail-nya.
   4. ID Tempat adalah dalam URL yang dikirim ulang. Misalnya, dalam URL https://create.roblox.com/dashboard/creations/experiences/0000000/places/111111/configure, ID Tempat adalah 1> 1111111> .

4. Tambahkan Kunci API di x-api-key header dari permintaan POST ke API. Dua contoh permintaan berikut mengacu pada file tempat Roblox XML ( .rbxlx ) dan file tempat biner ( 2> .rbxl2> ).

   Permintaan File Tempat 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

   Permintaan File Tempat Biner
   $ 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

   Untuk mengeksekusi perintah, ganti {universeId} dan {placeId} dengan ID Universe dan 1>Place ID1> dari pengalaman dan tempat yang ingin Anda publikasikan.

5. Jika Anda mengirim permintaan Anda dengan benar, Anda menerima tubuh balasan kesuksesan dengan nomor tempat di format berikut:

   Contoh Tanggapan Tubuh
   { "versionNumber": 7 }

6. (Opsional) Verifikasi pengunggah di Studio atau di Creator Dashboard.