Un `Logger` emette voci di log strutturate che sono contrassegnate con un nome gerarchico,
consentendo di raggruppare messaggi correlati per sottosistema o funzionalità. Ottieni un
logger di alto livello da `Class.LogService:GetLogger()`, quindi crea logger figli annidati
con `Class.Logger:GetLogger()`. Ogni logger ha un breve
`Class.Logger.Name` e un `Class.Logger.FullPath` unito da punti costruito dalla sua
ascendenza (ad esempio, un logger chiamato `Damage` creato da un logger chiamato
`Combat` ha il percorso completo `Combat.Damage`).

```lua
local LogService = game:GetService("LogService")

local combat = LogService:GetLogger("Combat")
local damage = combat:GetLogger("Damage")

print(damage.Name)      --> Damage
print(damage.FullPath)  --> Combat.Damage

damage:Info("Dealt {amount} damage to {target}", {amount = 25, target = "Goblin"})
```
I logger si comportano allo stesso modo dei metodi di logging strutturati su
`Class.LogService`: i messaggi fluiscono nella finestra **Output**, nella Console dello Sviluppatore,
e in `Class.LogService.MessageOut`, e sono inclusi in
`Class.LogService:GetLogHistory()` contrassegnati con il percorso completo del logger.

#### Gerarchia e Propagazione

Quando un messaggio viene registrato su un logger, il suo evento `Class.Logger.MessageOut`
fiamma su quel logger **e** su ogni antenato fino alla radice. Questo ti consente di
allegare un listener su un logger genitore per osservare tutti i messaggi emessi dai suoi
decendenti. Il messaggio viene emesso al sistema di output del motore esattamente
una volta, contrassegnato con il percorso completo del logger di origine.

#### Sintassi del Modello e Contesto

I metodi di logging accettano gli stessi segnaposto di modello `{key}` e
tabelle `context` come i metodi di logging strutturati su `Class.LogService`. Vedi
`Class.LogService` per dettagli sulla sintassi del modello e su come i valori di contesto sono
memorizzati.

#### Vita

Un logger rimane valido finché detieni un riferimento ad esso. Una volta che tutti
riferimenti a un logger (e ai suoi discendenti) vengono rilasciati, viene recuperato,
e chiamare qualsiasi metodo su un logger obsoleto genera un errore. Il numero di logger attivi
e la lunghezza del percorso completo di un logger sono entrambi limitati; superare
uno dei due limiti genera un errore da `Class.Logger:GetLogger()`.

#### Avviso

Questa classe potrebbe avere comportamenti inaspettati o inaffidabili e il contenuto potrebbe essere
troncato. Non fare affidamento sui contenuti di eventi e messaggi emessi dai logger
per alcuna logica di gioco importante.


Si attiva ogni volta che un messaggio viene registrato tramite questo logger o qualsiasi logger
sotto di esso nella gerarchia. Poiché un messaggio registrato attiva `MessageOut`
sul logger di origine e su ciascuno dei suoi antenati, un listener allegato
a un logger genitore osserva ogni messaggio emesso dai suoi discendenti. Il
parametro `message` contiene il testo completamente reso (segnaposto di modello
già sostituiti), e il parametro `context` trasporta le
coppie chiave-valore strutturate quando il messaggio è stato registrato con una tabella di contesto;
altrimenti è nil.

```lua
local LogService = game:GetService("LogService")
local combat = LogService:GetLogger("Combat")

combat.MessageOut:Connect(function(message, messageType, context)
	print("[Combat]", message)
end)

-- Un messaggio registrato su un discendente attiva anche il MessageOut del genitore.
combat:GetLogger("Damage"):Info("Hit for {amount}", {amount = 10})
-- Stampa: [Combat] Hit for 10
```


Logger.MessageOut

message

La stringa del messaggio completamente reso dopo qualsiasi sostituzione di segnaposto di modello.


messageType

Un valore `Enum.MessageType` che indica il livello di gravità del
messaggio.


context

Un dizionario di coppie chiave-valore fornito quando il messaggio è stato registrato,
o nil se non è stato fornito alcun contesto.


Si attiva quando un messaggio viene registrato tramite questo logger o uno dei suoi
decendenti.


Restituisce il logger figlio con il `name` dato, creandolo se non esiste
già. Chiamare questo con lo stesso nome ripetutamente restituisce la stessa
istanza di logger finché viene mantenuto un riferimento ad essa. Il `Class.Logger.FullPath`
del logger restituito è il percorso completo di questo logger seguito da
`.` e `name`.

Questo metodo genera un errore se il nome è vuoto, contiene un `.`, o
contiene caratteri di controllo, se il percorso completo risultante è troppo lungo, o se
il numero massimo di logger attivi è stato superato.

```lua
local LogService = game:GetService("LogService")

local network = LogService:GetLogger("Network")
local http = network:GetLogger("Http")

print(http.FullPath)  --> Network.Http
```


Logger:GetLogger

name

Il nome del logger figlio. Deve essere non vuoto, non deve contenere un
carattere `.` e non deve contenere caratteri di controllo.


Il `Class.Logger` figlio il cui percorso completo è il percorso completo di questo logger
seguito da `.name`.


Restituisce un logger figlio con il nome dato, creandolo se non esiste
già.


Registra un messaggio al livello `Enum.MessageType.MessageOutput`, contrassegnato con
il `Class.Logger.FullPath` di questo logger. Quando viene fornita una tabella `context`,
segnaposto di modello come `{key}` nel messaggio vengono sostituiti con i
valori di contesto corrispondenti, e il contesto è preservato come dati strutturati per la visualizzazione
nella Console dello Sviluppatore e nella finestra **Output** di Studio.

```lua
local LogService = game:GetService("LogService")
local logger = LogService:GetLogger("Shop")

logger:Output("Player {name} opened the shop", {name = "Alice"})
-- Output: "Player Alice opened the shop"
```


Logger:Output

La stringa del messaggio. Supporta i segnaposto di modello `{key}` quando viene fornita una
tabella di contesto.


Un dizionario opzionale di coppie chiave-valore. Quando fornito, i segnaposto `{key}`
nel messaggio vengono sostituiti con i valori corrispondenti.


Registra un messaggio al livello `Enum.MessageType.MessageOutput` con contesto
strutturato opzionale.


Registra un messaggio al livello `Enum.MessageType.MessageInfo`, contrassegnato con
il `Class.Logger.FullPath` di questo logger. Quando viene fornita una tabella `context`,
segnaposto di modello come `{key}` nel messaggio vengono sostituiti con i
valori di contesto corrispondenti.

```lua
local LogService = game:GetService("LogService")
local logger = LogService:GetLogger("Combat")

logger:Info("Dealt {amount} damage", {amount = 42})
-- Output: "Dealt 42 damage"
```


Logger:Info

Registra un messaggio al livello `Enum.MessageType.MessageInfo` con contesto
strutturato opzionale.


Registra un messaggio al livello `Enum.MessageType.MessageWarning`, contrassegnato con
il `Class.Logger.FullPath` di questo logger. Quando viene fornita una tabella `context`,
segnaposto di modello come `{key}` nel messaggio vengono sostituiti con i
valori di contesto corrispondenti.

```lua
local LogService = game:GetService("LogService")
local logger = LogService:GetLogger("Combat")

logger:Warn("Health low: {hp}", {hp = 5})
-- Output: "Health low: 5"
```


Logger:Warn

Registra un messaggio al livello `Enum.MessageType.MessageWarning` con
contesto strutturato opzionale.


Registra un messaggio al livello `Enum.MessageType.MessageError`, contrassegnato con
il `Class.Logger.FullPath` di questo logger. A differenza di `Class.LogService:Error()`,
questo metodo emette un'entrata di log di livello errore e restituisce normalmente; non fa
**non** lanciare. Quando viene fornita una tabella `context`, i segnaposto di modello
come `{key}` nel messaggio vengono sostituiti con i valori di contesto corrispondenti.

```lua
local LogService = game:GetService("LogService")
local logger = LogService:GetLogger("Network")

logger:Error("Request failed: {reason}", {reason = "timeout"})
-- Emissione di un log di livello errore; l'esecuzione continua.
```


Logger:Error

Registra un messaggio al livello `Enum.MessageType.MessageError` con contesto
strutturato opzionale.


Registra un messaggio al livello `Enum.MessageType` specificato, contrassegnato con il
`Class.Logger.FullPath` di questo logger. Questo è un metodo di uso generale che
combina `Class.Logger:Output()|Output()`, `Class.Logger:Info()|Info()`,
`Class.Logger:Warn()|Warn()`, e `Class.Logger:Error()|Error()` in una
singola chiamata con un parametro di tipo messaggio esplicito. A differenza di
`Class.LogService:Log()`, passando `Enum.MessageType.MessageError` emette un
log di livello errore e restituisce normalmente piuttosto che lanciare.

```lua
local LogService = game:GetService("LogService")
local logger = LogService:GetLogger("Combat")

logger:Log(Enum.MessageType.MessageInfo, "Event {action}", {action = "spawn"})
```


Logger:Log

L'`Enum.MessageType` che specifica il livello di log.


Registra un messaggio al livello specificato con contesto strutturato opzionale.


Logger

Il nome di questo logger come fornito a `Class.LogService:GetLogger()` o
`Class.Logger:GetLogger()`. Questo è un singolo segmento di percorso e non
contiene mai un carattere `.`. Usa `Class.Logger.FullPath` per il percorso completo
unito da punti.


Logger.Name

Il segmento di nome di questo logger all'interno del suo genitore.


Il percorso completo di questo logger, formato unendo il `Class.Logger.Name` di
ogni logger dalla radice fino a questo con separatori `.`. Per un logger di alto livello,
il percorso completo è uguale al suo nome. I messaggi registrati tramite
questo logger sono contrassegnati con questo percorso completo in
`Class.LogService:GetLogHistory()`.


Logger.FullPath

Il percorso unito da punti di questo logger dal logger radice.


Un logger nominato che emette voci di log strutturate scoperte a un percorso gerarchico.


`Object` è la classe base per tutte le classi nella gerarchia delle classi di Roblox.
Ogni altra classe definita dal motore Roblox eredita tutti i membri
di `Object`. Non è possibile creare direttamente un `Object`.


Questo esempio dimostra le sottigliezze dell'evento `Changed` su oggetti normali e oggetti `Value`.


Questo esempio di codice dimostra l'evento Changed che si attiva all'interno di un oggetto padre.


Questo evento si attiva immediatamente dopo che una proprietà di un oggetto è cambiata, con
alcune eccezioni (vedi sotto). Il nuovo valore di una proprietà cambiata è
**non** passato come parametro. Invece, puoi accedervi usando
`object[property]`:

```
object.Changed:Connect(function(property)
	print("Il nuovo valore della proprietà è", object[property])
end)
```

- Se sei interessato solo ad ascoltare i cambiamenti di una specifica
  proprietà, considera di utilizzare il
  `Class.Object:GetPropertyChangedSignal()|GetPropertyChangedSignal()`
  metodo invece.
- Per ascoltare i cambiamenti negli attributi, vedi
  `Class.Instance:GetAttributeChangedSignal()` e
  `Class.Instance.AttributeChanged`.
- Per rilevare quando i figli vengono aggiunti o rimossi, vedi
  `Class.Instance.ChildAdded` e `Class.Instance.ChildRemoved`.

Per gli oggetti `Class.ValueBase` come `Class.IntValue` e
`Class.StringValue`, questo evento si attiva solo quando la proprietà `Value`
dell'oggetto cambia. Per rilevare altri cambiamenti negli oggetti `Class.ValueBase`,
usa `Class.Object:GetPropertyChangedSignal()|GetPropertyChangedSignal()`.

#### Limitazioni

Questo evento **non** si attiva per cambiamenti relativi alla fisica, come quando le
proprietà `Class.BasePart.CFrame|CFrame`,
`Class.BasePart.AssemblyLinearVelocity|AssemblyLinearVelocity`,
`Class.BasePart.AssemblyAngularVelocity|AssemblyAngularVelocity`,
`Class.BasePart.Position|Position`, o
`Class.BasePart.Orientation|Orientation` di un `Class.BasePart`
cambiano a causa della gravità. Per rilevare cambiamenti in queste proprietà, considera
l'uso di un evento basato sulla fisica come `Class.RunService.PreSimulation`.
Allo stesso modo, l'evento `Changed` non si attiva quando
`Class.BasePart.AssemblyMass|AssemblyMass` si aggiorna a causa di un cambiamento nel
materiale, dimensione o densità per una parte saldata (ma l'evento si attiva per
`Class.BasePart.Mass|Mass` se modifichi la dimensione di una parte).

Per le proprietà che cambiano frequentemente, l'evento `Changed` potrebbe non attivarsi
per ogni modifica, o potrebbe non attivarsi affatto. **Se un cambiamento di proprietà
impatta la logica del tuo gioco, testa attentamente** per assicurarti che l'evento si
attivi come ti aspetti.


Object.Changed

property

Il nome della proprietà che è cambiata.


Si attiva immediatamente dopo che una proprietà dell'oggetto cambia, con alcune
limitazioni.


Questo esempio di codice dimostra come salvare un valore prima che si verifichi un evento di modifica
su di esso per ottenere maggiori informazioni su una modifica.


Questo esempio di codice dimostra l'equivalenza dell'evento `Changed` e dell'evento
restituito da `GetPropertyChangedSignal`.


Questo metodo restituisce un evento che si comporta esattamente come il
`Class.Object.Changed|Changed` evento, tranne per il fatto che si attiva solo quando la
data proprietà cambia. È generalmente una buona idea utilizzare questo metodo
invece di una connessione a `Class.Object.Changed|Changed` con una funzione
che controlla il nome della proprietà. Le chiamate successive a questo metodo sullo stesso
oggetto con lo stesso nome di proprietà restituiscono lo stesso evento.

Gli oggetti `Class.ValueBase`, come `Class.IntValue` e
`Class.StringValue`, utilizzano un evento `Class.Object.Changed|Changed` modificato
che si attiva con il contenuto della loro proprietà `Value`. Pertanto, questo
metodo fornisce un modo per rilevare cambiamenti in altre proprietà di quegli
oggetti.

Nota che questo evento non passerà alcun argomento a una funzione connessa,
quindi il valore della proprietà cambiata deve essere letto direttamente all'interno di uno
script.

#### Limitazioni

L'evento restituito da questo metodo **non** si attiva per cambiamenti relativi alla fisica,
come quando le proprietà `Class.BasePart.CFrame|CFrame`,
`Class.BasePart.AssemblyLinearVelocity|AssemblyLinearVelocity`,
`Class.BasePart.AssemblyAngularVelocity|AssemblyAngularVelocity`,
`Class.BasePart.Position|Position`, o
`Class.BasePart.Orientation|Orientation` di un `Class.BasePart`
cambiano a causa della gravità. Per rilevare cambiamenti in queste proprietà, considera
l'uso di un evento basato sulla fisica come `Class.RunService.PreSimulation`.

Inoltre, l'evento restituito potrebbe non attivarsi ad ogni modifica di
proprietà che cambiano molto frequentemente, e/o potrebbe non attivarsi affatto per tali
proprietà. Si raccomanda di testare attentamente i cambiamenti di proprietà che impattano la logica di gioco.


Object:GetPropertyChangedSignal

Un segnale che si attiva ogni volta che la proprietà cambia.


Ottiene un evento che si attiva quando una data proprietà dell'oggetto cambia.


Dimostra come determinare la classe di Workspace utilizzando `Class.Instance:IsA()`

Workspace è di classe 'Workspace', quindi la prima affermazione è vera. Workspace
non è di classe 'BasePart', quindi la seconda affermazione è falsa. Workspace
eredita da Instance e quindi è di classe 'Instance', quindi la terza
affermazione è vera.


IsA restituisce true se la classe dell'oggetto è **equivalente a** o una
**sottoclasse** di una classe data. Questa funzione è simile agli
operatori **instanceof** in altre lingue, ed è una forma di
[introspezione del tipo](https://en.wikipedia.org/wiki/Type_introspection). Per
ignorare l'ereditarietà delle classi, controlla direttamente la proprietà
`Class.Object.ClassName|ClassName`. Per controllare i tipi di dati nativi Luau (numero,
stringa, ecc.) usa le funzioni `type` e `typeof`.

Più comunemente, questa funzione viene utilizzata per testare se un oggetto è un certo tipo di
parte, come `Class.Part` o `Class.WedgePart`, che eredita da
`Class.BasePart` (una classe astratta). Ad esempio, se il tuo obiettivo è
cambiare tutti gli arti di un personaggio nello stesso colore, potresti usare
`Class.Instance:GetChildren()|GetChildren` per iterare sui figli,
poi usare IsA per filtrare gli oggetti non-`Class.BasePart` che mancano della
proprietà `Datatype.BrickColor`:

```lua
local Players = game:GetService("Players")

local function paintFigure(character, color)
	-- Itera sugli oggetti figli del personaggio
	for _, child in character:GetChildren() do
		-- Filtra gli oggetti non parte, come Camicia, Pantaloni e Umanoide
		-- R15 usa MeshPart e R6 usa Part, quindi usiamo BasePart qui per rilevare entrambi:
		if child:IsA("BasePart") then
			child.BrickColor = color
		end
	end
end
paintFigure(Players.Player.Character, BrickColor.new("Bright blue"))
```
Poiché tutte le classi ereditano da `Class.Object`, chiamare
`object:IsA("Object")` restituirà sempre true.


Object:IsA

className

La classe contro cui verrà controllata la classe dell'oggetto.
Sensibile al maiuscolo.


Descrive se la classe dell'oggetto corrisponde o è una sottoclasse della
classe data.


Restituisce true se la classe di un oggetto corrisponde o eredita da una classe data.


Object:isA

Object

Una stringa di sola lettura che rappresenta la classe a cui appartiene questo `Class.Object`.

Questa proprietà può essere utilizzata con varie altre funzioni che vengono utilizzate per
identificare oggetti per tipo, come `Class.Object:IsA()` o
`Class.Instance:FindFirstChildOfClass()`.

Nota che questa proprietà è di sola lettura e non può essere modificata dagli script.
Gli sviluppatori che desiderano cambiare la classe di un oggetto dovranno invece creare
un nuovo `Class.Object`.

A differenza di `Class.Object:IsA()`, ClassName può essere utilizzato per verificare se un oggetto
appartiene a una classe specifica ignorando l'ereditarietà delle classi. Ad esempio:


Object.ClassName

Una stringa di sola lettura che rappresenta la classe a cui appartiene questo `Class.Object`.


Object.className

`Object` è la classe base per tutte le classi nella gerarchia delle classi di Roblox.


Luau

Dictionary

Un logger nominato che emette voci di log strutturate scoperte a un percorso gerarchico.

Class

Categoria del messaggio e livello di gravità.

Enum

Enum.MessageType

Un oggetto che esegue funzioni connesse al verificarsi di un evento specifico.

Data Type

RBXScriptSignal

Tipo di dato che ha un valore di vero o falso.

boolean

Una sequenza di caratteri, come lettere, numeri e simboli.

string

Esperienze

Avatar

Risorse

Campioni e progetti

API Motore

Cloud API aperto

Studio

Analisi

Piattaforma

Tutorial

Programmi per creatori

Istruzione

Impara

Questo metodo è asincrono e restituisce un'"operazione", che rappresenta lo stato corrente della stessa. Contiene un percorso endpoint che è possibile sondare per ottenere la risposta reale e i metadati applicabili. Per ulteriori informazioni, consulta la [documentazione]({longRunningOperationsLink}) sulle operazioni di lunga durata.
            
Le sezioni seguenti descrivono gli oggetti di risposta e metadati forniti al completamento di un'operazione.

Gli endpoint beta sono pronti per l'uso del pubblico. Modifiche incompatibili sono possibili ma rare.

Queste pagine di documentazione di Open Cloud verranno rimosse il 31 marzo 2026. Verrai reindirizzato automaticamente alla nuova documentazione di Open Cloud in quel momento. {linkStart}Scopri di più{linkEnd}

Queste vecchie pagine di Open Cloud verranno rimosse e reindirizzate il 31 marzo 2026. {linkStart}Scopri di più{linkEnd}

Gli endpoint sperimentali sono pronti per l'uso pubblico, ma potrebbero subire modifiche incompatibili durante il processo di finalizzazione del contratto API.

Questo endpoint può essere chiamato in-experience tramite {httpServiceLinkStart}HttpService{httpServiceLinkEnd} con una chiave API.

Questo campo può essere impostato durante la creazione di una risorsa, ma non può essere modificato da richieste successive.

È possibile impostare questi campi durante la creazione di una risorsa, ma non modificarli in base a richieste successive.

Questo campo può essere fornito per le richieste, ma non verrà mai incluso nelle risposte.

Metodo di autenticazione legacy. Preferisci sempre l'utilizzo della chiave dell'API o OAuth 2.0 quando disponibile.

Per chiave API: {maxInPeriod} richieste ogni {periodInSeconds} secondi per indirizzo IP

Non richiede un'autenticazione. In genere ha limiti di velocità notevolmente ridotti. Se disponibile, è sempre meglio l'utilizzo della chiave dell'API o OAuth 2.0.

Per ogni raggruppamento, devi inserire solo uno dei campi seguenti nello schema. Gli altri possono essere ignorati.

Puoi riattivarle in qualsiasi momento. {linkStart}Lascia un feedback{linkEnd}.

Stai visualizzando i vecchi documenti. {linkStart}Lascia un feedback{linkEnd}.

Puoi disattivarle in qualsiasi momento e tornare alle vecchie pagine di riferimento. {linkStart}Lascia un feedback.{linkEnd}

Stai visualizzando i documenti rinnovati. {linkStart}Lascia un feedback{linkEnd}.

Questo campo può essere impostato per le risposte, ma verrà ignorato nelle richieste.

Nota: i limiti di velocità possono essere inferiori durante i periodi di traffico elevato. Alcuni endpoint ne hanno di aggiuntivi. [Scopri di più sui limiti di velocità]({link}).

{limit} richieste al giorno su tutte le chiavi dell'API per un utente o un gruppo

{limit} richieste all'ora su tutte le chiavi dell'API per un utente o un gruppo

{limit} richieste al minuto su tutte le chiavi dell'API per un utente o un gruppo

{limit} richieste al secondo su tutte le chiavi dell'API per un utente o un gruppo

{limit} richieste al minuto per proprietario della chiave dell'API

{limit} richieste al giorno per utente dell'app

{limit} richieste all'ora per utente dell'app

{limit} richieste al minuto per utente dell'app

{limit} richieste al secondo per utente dell'app

{limit} richiesta/e al secondo per proprietario della chiave dell'API

Gli obiettivi controllano le autorizzazioni delle tue credenziali. Le tue credenziali possono accedere solo agli endpoint supportati dagli obiettivi selezionati.

Gli endpoint stabili sono pronti per la produzione e raramente subiscono modifiche significative nel corso del loro ciclo di vita.

Questo obiettivo consente di limitare l'accesso della chiave a {requiredParts}

Questo obiettivo consente di limitare l'accesso della chiave a {requiredParts} e {optionalParts}

I tipi di destinazione servono a limitare le risorse su cui le tue credenziali hanno permesso di agire. Solo le risorse selezionate possono essere utilizzate, anche se l'account ha permessi su risorse aggiuntive. Alcuni ambiti non includono parti di destinazione. In questi casi, tutte le risorse pertinenti possono essere utilizzate.

La parte di primo livello dell'universo non dovrebbe essere selezionata per le chiavi dell'API di proprietà dell'utente. In questo modo, la tua chiave dell'API potrà accedere a tutte le esperienze di proprietà dell'utente e del gruppo, a condizione che tu disponga dei permessi corretti per il gruppo.

Provalo non è ancora supportato per gli endpoint che richiedono la chiave dell'API o l'autenticazione OAuth 2.0

L'autenticazione dei cookie è disabilitata per le operazioni ad alto rischio per la sicurezza.

Gli endpoint critici sono altamente sensibili e Provalo è stato disabilitato per ragioni di sicurezza

Nota: le intestazioni di autenticazione non sono incluse in questo esempio di codice. Potrebbe essere necessario aggiungerne una affinché questo comando funzioni.

Questo è un endpoint ad alto rischio che potrebbe causare la modifica o la cancellazione di dati critici. Utilizza estrema cautela in fase di test.

Questo endpoint API è stato classificato come AD ALTO RISCHIO e può influire sui dati in tempo reale o sugli account utente.

Le richieste autenticate alle API ad alto rischio possono apportare modifiche irreversibili. Controlla attentamente i parametri della richiesta prima di procedere.

Effettua il login per utilizzare l'autenticazione tramite cookie

Questo è un endpoint a basso rischio per il recupero dati. Generalmente è sicuro in fase di test.

Questo è un endpoint a rischio medio per la modifica dei dati. Esegui il test con attenzione servendoti di account non critici, poiché le modifiche potrebbero essere permanenti.

Per proteggere il tuo account, non incollare mai qui il testo da altre fonti e non inviare informazioni da questa pagina ad altri.

Stai per testare gli endpoint API live utilizzando le credenziali del tuo account reale.

Procedi solo se comprendi le implicazioni delle chiamate API che stai per effettuare. Esamina attentamente la documentazione dell'API prima di eseguire il test.

Le chiamate API verranno effettuate utilizzando la tua sessione autenticata

Si tratta di chiamate API reali che potrebbero influire sul tuo account o sui tuoi dati

Si applicano limiti di velocità e altre restrizioni API

Alcune operazioni possono modificare o eliminare i dati

Questo endpoint è stato sostituito dai seguenti endpoint alternativi consigliati:

I seguenti ambiti sono necessari per chiamare questo endpoint. Per ulteriori informazioni sulla generazione di chiavi appropriate, consulta l'articolo [Gestire le chiavi API]({apiKeyReferenceDocLink}).

Per ulteriori informazioni sulla generazione di chiavi, consulta l'articolo [Gestire le chiavi API]({apiKeyReferenceDocLink}).

I seguenti endpoint sono disponibili nei percorsi relativi all'URL di base.

Questa stringa è formattata come [Timestamp](/cloud/reference/types#timestamp).

Un valore JSON può essere `null`, `boolean`, `string`, `number`, `array`, or `object`.

I seguenti ambiti sono necessari per l'applicazione OAuth 2.0 per utilizzare questo endpoint. Per ulteriori informazioni su come registrare un'applicazione OAuth 2.0, vedi [Registrazione e revisione dell'app]({oauth2ReferenceDocLink}).

Per ulteriori informazioni su come registrare un'applicazione OAuth 2.0, consulta l'articolo dedicato alla [registrazione e alla revisione dell'app]({oauth2ReferenceDocLink}).

Gli oggetti seguenti descrivono i payloads accettati o restituiti. Per maggiori informazioni su quando vengono utilizzati questi oggetti, consultare ogni singolo endpoint.

Per chiamare questo endpoint sono richiesti i seguenti ambiti.

Percorsi risorse

Per utilizzare questo endpoint sono necessari i seguenti ambiti per la tua applicazione OAuth 2.0. Per ulteriori informazioni su come registrare un'applicazione OAuth 2.0, vedere [Registrazione e revisione dell'app]({oauth2ReferenceDocLink}).

Non consigliato

Stai visualizzando la nuova versione del riferimento Open Cloud.

Hai disattivato il nuovo riferimento Open Cloud.

Visualizza i tuoi account di fatturazione pubblicitaria.

Consente di accedere per configurare gli account di fatturazione e acquistare credito pubblicitario.

Visualizza le tue campagne pubblicitarie e le loro prestazioni.

Crea, aggiorna e gestisci le tue campagne pubblicitarie.

Questo permette di visualizzare informazioni sui tuoi beni.

Questo permette di caricare e aggiornare gli asset su Roblox.

Consente di visualizzare permessi per le risorse ai soggetti (inclusi gruppi ed esperienze) o risorsa a cui il tuo account ha accesso.

Consente di concedere permessi per le risorse a qualsiasi soggetto (inclusi gruppi ed esperienze) o risorsa a cui il tuo account ha accesso.

Consente di visualizzare lo stato e i risultati delle attività di configurazione automatica dell'avatar per tuo conto.

Consente di creare e gestire attività di configurazione automatica dell'avatar per tuo conto.

Fornisce la possibilità di aggiornare i badge di proprietà dell'utente.

Consente di visualizzare informazioni sui tuoi articoli commerciali.

Consente di apportare modifiche ai tuoi articoli commerciali sincronizzati.

Ciò permette di visualizzare le informazioni sulle tue connessioni commerciali.

Consente la modifica delle tue connessioni commerciali.

Consente di visualizzare le informazioni sui tuoi prodotti del Creator Store.

Consente di modificare le informazioni sui tuoi prodotti del Creator Store.

Consente di visualizzare le informazioni sui tuoi prodotti del Negozio creatore.

Consente di modificare le informazioni sui tuoi salvataggi del Negozio creatore.

Consente l'accesso per creare data store per tuo conto.

Consente l'accesso per eliminare data store per tuo conto.

Consente l'accesso per leggere un elenco di data store.

Consente l'accesso per acquisire un'istantanea dei tuoi data store.

Consente l'accesso per creare voci nei tuoi data store.

Consente l'accesso per contrassegnare specifiche voci ed eliminarle.

Consente l'accesso all'elenco delle voci del tuo data store.

Consente l'accesso per leggere specifiche voci nei tuoi data store.

Consente l'accesso per aggiornare il valore, gli attributi e gli utenti di una voce.

Consente l'accesso per eliminare le revisioni delle voci del tuo data store.

Consente l'accesso alle revisioni dell'elenco delle voci del tuo data store.

Fornisce l'accesso per visualizzare i dettagli di configurazione dei developer product dell'utente autorizzato.

Fornisce l'accesso per modificare i developer product dell'utente autorizzato.

Questo permette di visualizzare informazioni sugli ambienti del tuo universo.

Questo permette di modificare gli ambienti del tuo universo.

Fornisce l'accesso per visualizzare i dettagli di configurazione dei pass di gioco dell'utente autorizzato.

Offre l'accesso per modificare i pass di gioco dell'utente autorizzato.

Offre l'accesso per visualizzare le informazioni sul forum della community per il tuo account.

Offre l'accesso per gestire le informazioni sul forum della community per il tuo account.

Consente di vedere le informazioni sulle tue community.

Consente di gestire le richieste di adesione alla community e gli aggiornamenti dei ruoli dei membri della community di rango inferiore per il tuo account.

Consente di visualizzare i dati delle proprietà di un'istanza.

Consente di modificare i dati delle proprietà delle istanze (attualmente supporta solo script).

Consente l'accesso per gestire le risorse dell'utente.

Offre l'accesso per gestire i tuoi badge.

Offre l'accesso per gestire i tuoi badge e spendere Robux.

Offre l'accesso per aggiornare i badge dell'utente autorizzato.

Consente l'accesso per gestire i tuoi prodotti per sviluppatori.

Consente l'accesso per leggere le informazioni sulle esperienze per le quali hai ricevuto notifiche.

Consente l'accesso per attivare o disattivare le notifiche sulle esperienze per tuo conto.

Consente l'accesso per gestire le tue community.

Fornisce il permesso di leggere le informazioni sulla community.

Concede le autorizzazioni di gestione della community.

Consente l'accesso per leggere e scrivere le tue tabelle di localizzazione

Consente l'accesso per gestire la collaborazione in team per tutte le tue esperienze.

Consente l'accesso per gestire le tue esperienze e determinate informazioni associate alle tue esperienze (ad esempio, informazioni sulla localizzazione).

Offre l'accesso per leggere le informazioni sulla localizzazione delle tue esperienze.

Consente l'accesso per modificare le preferenze di localizzazione delle tue esperienze.

Consente l'accesso per gestire il tuo account utente.

Consente l'accesso per modificare le preferenze di localizzazione dell'utente.

Consente di visualizzare lo stato, i registri e i risultati delle attività di esecuzione Luau per il luogo associato.

Consente di creare nuove attività di esecuzione Luau per il luogo associato.

Concede l'accesso per svuotare in modo asincrono tutte le strutture dati nell'universo.

Consente l'accesso per creare nuovi elementi della coda.

Consente l'accesso per scartare gli elementi letti davanti alla coda.

Consente l'accesso agli elementi letti davanti alla coda.

Consente l'accesso per leggere gli elementi del tuo memory store.

Consente l'accesso per leggere gli elementi della mappa.

Consente l'accesso per creare, aggiornare ed eliminare elementi della mappa.

Ciò garantisce la possibilità di pubblicare messaggi per conto degli utenti.

Consente di inviare notifiche dalla tua esperienza agli utenti.

(Obsoleto) Consente l'accesso per leggere un elenco di voci in un data store ordinato.

(Obsoleto) Consente l'accesso per creare una nuova voce in un data store ordinato.

Consente l'accesso alle voci di elenco da un data store ordinato.

Consente l'accesso per creare voci in un data store ordinato.

Questo permette di elencare i segreti associati alla tua esperienza.

Ciò consente di creare e aggiornare i segreti associati alla tua esperienza.

Questa autorizzazione consente di inviare un lavoro di valutazione e visualizzarne il risultato.

Consente l'accesso per leggere i tuoi prodotti in abbonamento.

Consente di leggere le informazioni sulle miniature per tuo conto.

Offre la possibilità di leggere gli avvisi delle analitiche.

Offre la possibilità di creare o modificare gli avvisi delle analitiche.

Offre la possibilità di leggere le analitiche del gioco.

Offre la possibilità di scrivere risorse relative alle analitiche del gioco.

Offre la possibilità di leggere le informazioni sul posto.

Offre la possibilità di modificare le informazioni sul posto.

Permette di pubblicare nuove versioni di esperienze su Roblox.

Ciò ti consente di leggere le miniature e le impostazioni di personalizzazione delle miniature per le tue esperienze.

Ciò ti consente di caricare ed eliminare le miniature e gestire le impostazioni di personalizzazione delle miniature per le tue esperienze.

Offre la possibilità di leggere le informazioni sull'esperienza.

Offre l'accesso per modificare le esperienze dell'utente autorizzato.

Consente di visualizzare le restrizioni degli utenti nell'esperienza.

Ciò consente di visualizzare le notifiche inviate al tuo account.

Offre la possibilità di leggere lo stato premium e verificato dell'utente autorizzato.

Consente di visualizzare gli account social dell'utente autorizzato.

Offre la possibilità di leggere gli eventi di un gioco.

Offre la possibilità di modificare gli eventi del gioco

Questa operazione abilita la funzionalità Single Sign-On.

Consente l'accesso alla lettura delle informazioni del tuo profilo.

Riepilogo