Panduan penggunaan untuk penerbitan tempat

The tempat penerbitan API menawarkan fungsionalitas serupa ke penerbitan ke Roblox di Studio, dengan kontrol izin tambahan dan otomatisasi dalam alur kerja rilis terus menerus.Anda dapat menggunakan API ini untuk memperbarui tempat-tempat eksisting dari pengalaman ke versi baru, sehingga berguna untuk otomatisasi alur kerja penerbitan Anda.Misalnya, Anda dapat memanggil API ini dari tindakan GitHub dan memilikinya secara otomatis mendorong file tempat biner ke Roblox setelah pengujian integrasi berhasil.

Keterbatasan

• API ini hanya mendukung permintaan HTTPS.
• Tempat penerbitan API tidak memperbarui jenis instans tertentu.Jika pengalaman Anda berisi EditableImage , EditableMesh , PartOperation , SurfaceAppearance , atau BaseWrap contoh, publikasikan dari Studio setelah memodifikasinya.

Tempat di Roblox

Pengalaman di Roblox dapat memiliki banyak tempat, dengan satu tempat awal sebagai titik masuk pengguna pengalaman Anda dan tempat lain opsional yang dapat Anda teleportkan pengguna di antara .Anda dapat menggunakan API untuk mempublikasikan tempat awal atau tempat lain pengalaman Anda dengan kontrol versi.

Sebelum Anda dapat memperbarui tempat yang ada dari pengalaman, Anda membutuhkan ID Tempat tempat dan ID Alam Semesta pengalaman.ID Tempat mengidentifikasi tempat dan ID Alam Semesta mengidentifikasi pengalaman.Masing-masing unik bahkan jika pengalaman Anda hanya memiliki satu tempat.

Publikasikan tempat

Untuk mempublikasikan tempat yang ada dari pengalaman dengan API Penerbitan Tempat :

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

   1. Tambahkan tempat-tempat alam semesta ke Izin Akses .
   2. Tambahkan Tulis operasi ke pengalaman yang dipilih Anda.

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

   1. Navigasikan ke Dashboard Pencipta.

   2. Temukan pengalaman dengan tempat yang ingin Anda update.

   3. Pasang mouse di atas thumbnail pengalaman, klik tombol ⋯ dan pilih Copy Universe ID .

      

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

   1. Tetap di halaman Kreasi pada Dashboard Pencipta dan klik thumbnail pengalaman target.
   2. Di menu navigasi kiri, klik tab Tempat .
   3. Temukan tempat yang ingin Anda perbarui dan klik thumbnailnya.
   4. ID Tempat ada di URL yang di redirect For example, in the URL https://create.roblox.com/dashboard/creations/experiences/0000000/places/111111/configure , the ID Tempat is 111111 .

4. Tambahkan Kunci API di x-api-key kepala permintaan POST ke API.Dua contoh permintaan berikut merujuk pada file tempat XML Roblox ( .rbxlx ) dan file tempat biner ( .rbxl ).

   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 menjalankan perintah, ganti {universeId} dan {placeId} dengan ID Alam Semesta dan ID Tempat dari pengalaman dan tempat yang ingin Anda publikasikan.

5. Jika Anda mengirim permintaan Anda dengan benar, Anda menerima tubuh respons sukses dengan nomor versi tempat dalam format berikut:

   Contoh Tubuh Respon
   { "versionNumber": 7 }

6. (Opsi) Verifikasi upload di Studio atau di Dashboard Pencipta.