Diritto all'oblio (RTBF) per i data store | Documentazione

Diritto all'oblio (RTBF) per i data store consente di dichiarare quali chiavi e data store contengono i dati di un utente. Quando Roblox elabora una richiesta di RTBF per il tuo gioco, il sistema utilizza quei modelli per rimuovere automaticamente i dati corrispondenti. Puoi configurare i modelli visivamente tramite il Data Stores Manager nel Creator Hub, oppure programmaticamente tramite l'Open Cloud Configs API.

RTBF automatizzato

Per utilizzare l'elaborazione automatizzata del RTBF, devi definire modelli di eliminazione. Questi modelli dicono a Roblox quali data store o chiavi appartengono a un utente specifico. Puoi avere fino a 100 modelli per identificare i dati degli utenti.

Modelli di eliminazione

Il RTBF automatizzato funziona confrontando i modelli. Definisci un modello per i dati dell'utente usando un token {UserId}. Quando Roblox riceve una richiesta di diritto all'oblio, il sistema sostituisce quel token con l'ID reale di chi richiede e scansiona i tuoi data store in cerca di corrispondenze da eliminare.

Requisiti di idoneità

Affinché un'entrata sia idonea per l'eliminazione automatizzata, deve soddisfare i seguenti criteri:

Tipo di archiviazione — I dati degli utenti devono essere archiviati in un data store standard o in un data store ordinato. L'eliminazione dell'intero data store è supportata solo per i data store standard.
Identificatore — L'ID utente deve essere parte del Name o del Scope del data store o della chiave.
Formato — L'ID deve essere identificabile tramite un modello di stringa statica (per esempio, User_{UserId}).

Configura il RTBF automatizzato tramite il Data Stores Manager

Il Creator Hub fornisce un'interfaccia visiva per gestire i tuoi modelli RTBF senza utilizzare la riga di comando.

Per i giochi di gruppo, devi aggiungere il permesso Visualizza analisi per visualizzare le configurazioni e il permesso Modifica e pubblica l'esperienza per visualizzare, modificare e pubblicare le configurazioni. Inoltre, l'utente deve essere idoneo a pubblicare giochi.

Naviga al Creator Hub.
Seleziona il gioco che desideri configurare.
Nel menu di navigazione a sinistra, vai su Configura ⟩ Data Stores Manager.
Seleziona la scheda Eliminazione RTBF.
Clicca su Crea modello.
Seleziona il Tipo (Data Store standard, Chiave standard o Chiave ordinata).
Inserisci i campi corrispondenti con il tuo modello utilizzando il token {UserId} (per esempio, PlayerInventory_{UserId}). Questo token è sensibile al maiuscolo/minuscolo.
Controlla l'output di esempio e clicca su Crea.

Configura il RTBF automatizzato tramite l'API Configs

Puoi anche gestire i modelli RTBF programmaticamente utilizzando l'Open Cloud Configs API. Questo è utile per l'automazione o per gestire modelli su larga scala.

Nel Creator Dashboard, crea o modifica una chiave API per includere i permessi universe:read e universe:write per ogni universo in cui desideri automatizzare l'eliminazione del RTBF. Per maggiori dettagli, consulta Gestisci chiavi API.

I modelli vengono memorizzati come una configurazione JSON denominata user_data_templates. Ci sono due tipi principali:

Modello di chiave — Identifica chiavi specifiche. Richiede data_store_type (STANDARD o ORDERED), data_store_name e key_pattern. scope_pattern è opzionale ma consigliato.
Modello di data store — Identifica un intero data store. Richiede data_store_type (attualmente supporta solo STANDARD) e data_store_pattern.

Per entrambi i tipi di modello, il token {UserId} viene sostituito con l'ID dell'utente quando viene elaborata una richiesta di RTBF.

Esempio di configurazione
{
	"user_data_templates": [
		{
			"key_template": {
				"data_store_type": "STANDARD",
				"data_store_name": "PlayerInventory",
				"key_pattern": "User_{UserId}",
				"scope_pattern": "Scope_{UserId}"
			}
		},
		{
			"key_template": {
				"data_store_type": "ORDERED",
				"data_store_name": "PlayerLeaderboard",
				"key_pattern": "User_{UserId}",
				"scope_pattern": "global"
			}
		},
		{
			"data_store_template": {
				"data_store_type": "STANDARD",
				"data_store_pattern": "Player_{UserId}_Save"
			}
		}
	]
}

Il token {UserId} è sensibile al maiuscolo/minuscolo. Se scope_pattern è omesso o vuoto, di default è impostato su global.

Successivamente, invia tramite l'Open Cloud Configs API. Negli esempi seguenti, sostituisci <API_KEY> e <UNIVERSE_ID> in ogni richiesta e invia tutte le richieste al repository DataStoresConfig.

Per ulteriori endpoint e comportamenti, consulta il riferimento API Cloud e la guida sulle configurazioni delle esperienze.

Crea una bozza tramite una richiesta PUT che definisce la tua configurazione. Se esiste già una bozza, questa richiesta la sovrascrive.


curl --location --request PUT 'https://apis.roblox.com/creator-configs-public-api/v1/configs/universes/<UNIVERSE_ID>/repositories/DataStoresConfig/draft:overwrite' \
	--header 'x-api-key: <API_KEY>' \
	--header 'Content-Type: application/json' \
	--data-raw '{
	"entries": {
		"user_data_templates": [
			{
				"key_template": {
					"data_store_type": "STANDARD",
					"data_store_name": "PlayerInventory",
					"key_pattern": "User_{UserId}",
					"scope_pattern": "Scope_{UserId}"
				}
			},
			{
				"key_template": {
					"data_store_type": "ORDERED",
					"data_store_name": "PlayerLeaderboard",
					"key_pattern": "User_{UserId}",
					"scope_pattern": "global"
				}
			},
			{
				"data_store_template": {
					"data_store_type": "STANDARD",
					"data_store_pattern": "Player_{UserId}_Save"
				}
			}
		]
	}
}'

Verifica la tua bozza tramite una richiesta GET per recuperare e rivedere la bozza prima che vada online.


curl --location --request GET 'https://apis.roblox.com/creator-configs-public-api/v1/configs/universes/<UNIVERSE_ID>/repositories/DataStoresConfig/draft' \
	--header 'x-api-key: <API_KEY>'

Dopo la verifica, invia questa richiesta POST per pubblicare. L'unico modo per annullare questa azione è ripristinare una versione precedente. Questa azione richiede inoltre che l'account associato alla chiave API sia idoneo a pubblicare giochi.


curl --location --request POST 'https://apis.roblox.com/creator-configs-public-api/v1/configs/universes/<UNIVERSE_ID>/repositories/DataStoresConfig/publish' \
	--header 'x-api-key: <API_KEY>' \
	--header 'Content-Type: application/json' \
	--data-raw '{
	"deploymentStrategy": "Immediate"
}'

Dopo la pubblicazione, conferma che la configurazione è attiva con questa richiesta GET.


curl --location --request GET 'https://apis.roblox.com/creator-configs-public-api/v1/configs/universes/<UNIVERSE_ID>/repositories/DataStoresConfig/full' \
	--header 'x-api-key: <API_KEY>'

Migliori pratiche

Sensibilità al maiuscolo/minuscolo — Utilizza esattamente il token {UserId} nei tuoi modelli. Varianti come {userId} non sono accettate.
Verifica manuale — Confronta i tuoi modelli con il tuo utilizzo attuale di Luau utilizzando il Data Stores Manager nel Creator Hub prima di pubblicare la configurazione.
Ambiti predefiniti — Se un data store utilizza l'ambito predefinito, imposta scope_pattern su "global" nel modello di chiave.
Testa il flusso end-to-end su un gioco di prova — Per una convalida completa dei tuoi modelli, considera di creare un gioco di prova e un account fittizio, popolandolo con dati fittizi per l'ID utente di quell'account, richiedendo il RTBF per l'account fittizio e assicurandoti che i dati siano eliminati una volta che l'account è stato elaborato.
Conferma le eliminazioni — Dopo l'onboarding sul tuo gioco attivo, quando appare una richiesta di RTBF nei tuoi messaggi Roblox, verifica che i dati corrispondenti siano stati rimossi entro 30 giorni.