Guida all'uso per la pubblicazione di luoghi | Documentazione

L'API di pubblicazione dei luoghi offre funzionalità simili alla pubblicazione su Roblox in Studio, con ulteriore controllo dei permessi e automazione nel flusso di lavoro di rilascio continuo. Puoi utilizzare questa API per aggiornare luoghi esistenti di un gioco a una nuova versione, rendendola utile per automatizzare il tuo flusso di lavoro di pubblicazione. Ad esempio, puoi chiamare questa API da un'azione di GitHub e far sì che pubblichi automaticamente un file di luogo binario su Roblox dopo aver superato i test di integrazione.

Limitazioni

Questa API supporta solo richieste HTTPS.
L'API di pubblicazione dei luoghi non aggiorna determinati tipi di istanze. Se il tuo gioco contiene istanze EditableImage, EditableMesh, PartOperation, SurfaceAppearance o BaseWrap, pubblica da Studio dopo averle modificate.

Luoghi su Roblox

I giochi su Roblox possono avere più luoghi, con un luogo iniziale come punto di ingresso dell'utente nel tuo gioco e altri luoghi opzionali tra cui puoi teletrasportare gli utenti. Puoi utilizzare l'API per pubblicare sia il luogo iniziale che altri luoghi del tuo gioco con controllo delle versioni.

Prima di poter aggiornare un luogo esistente di un gioco, hai bisogno del Place ID del luogo e del Universe ID del gioco. Il Place ID identifica il luogo e il Universe ID identifica il gioco. Ciascuno è unico anche se il tuo gioco ha solo un luogo.

Pubblica un luogo

Per pubblicare un luogo esistente di un gioco con API di pubblicazione dei luoghi:

Crea una chiave API nella Dashboard del Creatore. Assicurati di eseguire le seguenti impostazioni:
1. Aggiungi universe-places a Permessi di accesso.
2. Aggiungi l'operazione Write al tuo gioco selezionato.
Ottieni il Universe ID del gioco in cui desideri pubblicare il luogo.
1. Naviga alla Dashboard del Creatore.
2. Trova il gioco con il luogo che desideri aggiornare.
3. Passa il mouse sopra la miniatura del gioco, fai clic sul pulsante ⋯ e seleziona Copia Universe ID.
Ottieni il Place ID del luogo che desideri aggiornare.
1. Resta sulla pagina Creazioni nella Dashboard del Creatore e fai clic sulla miniatura del gioco di destinazione.
2. Nel menu di navigazione a sinistra, fai clic sulla scheda Luoghi.
3. Trova il luogo che desideri aggiornare e fai clic sulla sua miniatura.
4. Il Place ID è nell'URL reindirizzato. Ad esempio, nell'URL https://create.roblox.com/dashboard/creations/experiences/0000000/places/111111/configure,il **Place ID** è111111`.

Aggiungi la chiave API nell'header x-api-key di una richiesta POST all'API. Le seguenti due richieste di esempio fanno riferimento a un file di luogo XML di Roblox (.rbxlx) e a un file di luogo binario (.rbxl).

Richiesta File Luogo 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

Richiesta File Luogo Binario
$ 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

Per eseguire i comandi, sostituisci {universeId} e {placeId} con il reale Universe ID e Place ID del gioco e del luogo che desideri pubblicare.

Se invii correttamente la tua richiesta, ricevi un corpo di risposta di successo con il numero della versione del luogo nel seguente formato:
```
Esempio Corpo di Risposta
{ "versionNumber": 7 }
```
(Opzionale) Verifica il caricamento in Studio o sulla Dashboard del Creatore.