Recht auf Vergessenwerden (RTBF) für Datenspeicher | Dokumentation

Recht auf Vergessenwerden (RTBF) für Datenspeicher ermöglicht es Ihnen, zu erklären, welche Schlüssel und Datenspeicher die Daten eines Benutzers enthalten. Wenn Roblox eine RTBF-Anfrage für Ihr Spiel bearbeitet, verwendet das System diese Vorlagen, um die entsprechenden Daten automatisch zu entfernen. Sie können Vorlagen visuell über den Datenspeichermanager im Creator Hub oder programmgesteuert über die Open Cloud Configs API konfigurieren.

Automatisiertes RTBF

Um die automatisierte RTBF-Verarbeitung zu nutzen, müssen Sie Löschvorlagen definieren. Diese Vorlagen geben Roblox an, welche Datenspeicher oder Schlüssel zu einem bestimmten Benutzer gehören. Sie können bis zu 100 Vorlagen haben, um Ihre Benutzerdaten zu identifizieren.

Löschvorlagen

Automatisiertes RTBF funktioniert durch das Abgleichen von Mustern. Sie definieren eine Vorlage für Ihre Benutzerdaten mithilfe eines {UserId}-Tokens. Wenn Roblox eine Anfrage auf Vergessenwerden erhält, ersetzt das System dieses Token durch die tatsächliche ID des Anfragenden und durchsucht Ihre Datenspeicher nach Übereinstimmungen zum Löschen.

Anforderungen an die Berechtigung

Damit ein Eintrag für die automatisierte Löschung berechtigt ist, muss er die folgenden Kriterien erfüllen:

Speichertyp — Benutzerdaten sollten in einem standardmäßigen Datenspeicher oder in einem geordneten Datenspeicher gespeichert werden. Die Löschung eines gesamten Datenspeichers wird nur für standardmäßige Datenspeicher unterstützt.
Identifikator — Die Benutzer-ID muss Teil des Name oder des Scope des Datenspeichers oder Schlüssels sein.
Format — Die ID muss über ein statisches Zeichenfolgenmuster identifizierbar sein (zum Beispiel User_{UserId}).

Automatisiertes RTBF über den Datenspeichermanager konfigurieren

Der Creator Hub bietet eine visuelle Oberfläche, um Ihre RTBF-Vorlagen zu verwalten, ohne die Befehlszeile zu verwenden.

Für Gruppenspiele müssen Sie die Berechtigung Analytics anzeigen hinzufügen, um Konfigurationen anzuzeigen, und die Berechtigung Erfahrung bearbeiten und veröffentlichen, um Konfigurationen anzuzeigen, zu bearbeiten und zu veröffentlichen. Zusätzlich muss der Benutzer selbst berechtigt sein, Spiele zu veröffentlichen.

Navigieren Sie zum Creator Hub.
Wählen Sie das Spiel aus, das Sie konfigurieren möchten.
Gehen Sie im linken Navigationsmenü zu Konfigurieren ⟩ Datenspeichermanager.
Wählen Sie die Registerkarte RTBF-Löschung.
Klicken Sie auf Vorlage erstellen.
Wählen Sie den Typ (Standard-Datenspeicher, Standard-Schlüssel oder Geordneter Schlüssel).
Geben Sie die entsprechenden Felder mit Ihrer Vorlage unter Verwendung des {UserId}-Tokens ein (zum Beispiel PlayerInventory_{UserId}). Dieses Token ist groß-/kleinschreibungsempfindlich.
Überprüfen Sie das Beispielausgabe und klicken Sie auf Erstellen.

Automatisiertes RTBF über die Configs API konfigurieren

Sie können RTBF-Vorlagen auch programmgesteuert über die Open Cloud Configs API verwalten. Dies ist nützlich für die Automatisierung oder das Verwalten von Vorlagen im großen Maßstab.

Erstellen oder bearbeiten Sie im Creator Dashboard einen API-Schlüssel, um die Berechtigungen universe:read und universe:write für jedes Universum einzuschließen, in dem Sie die RTBF-Löschung automatisieren möchten. Für weitere Details siehe API-Schlüssel verwalten.

Vorlagen werden als JSON-Konfiguration mit dem Namen user_data_templates gespeichert. Es gibt zwei Haupttypen:

Schlüsselvorlage — Identifiziert spezifische Schlüssel. Benötigt data_store_type (STANDARD oder ORDERED), data_store_name und key_pattern. scope_pattern ist optional, wird aber empfohlen.
Datenspeicher-Vorlage — Identifiziert einen gesamten Datenspeicher. Benötigt data_store_type (derzeit nur STANDARD unterstützt) und data_store_pattern.

Für beide Vorlagenarten wird das {UserId}-Token ersetzt, wenn eine RTBF-Anfrage bearbeitet wird.

Beispielkonfiguration
{
	"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"
			}
		}
	]
}

Das {UserId}-Token ist groß-/kleinschreibungsempfindlich. Wenn scope_pattern weggelassen oder leer gelassen wird, wird es standardmäßig auf global gesetzt.

Als Nächstes senden Sie über die Open Cloud Configs API eine Anfrage. Ersetzen Sie in den folgenden Beispielen <API_KEY> und <UNIVERSE_ID> in jeder Anfrage und senden Sie alle Anfragen an das Repository DataStoresConfig.

Für zusätzliche Endpunkte und Verhaltensweisen siehe die Cloud API-Referenz und den Leitfaden zu Erfahrungs-Konfigurationen.

Erstellen Sie einen Entwurf über eine PUT-Anfrage, die Ihre Konfiguration definiert. Wenn bereits ein Entwurf vorhanden ist, wird diese Anfrage überschrieben.


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"
				}
			}
		]
	}
}'

Überprüfen Sie Ihren Entwurf über eine GET-Anfrage, um den Entwurf abzurufen und zu überprüfen, bevor er live geht.


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>'

Nach der Überprüfung senden Sie diese POST-Anfrage, um zu veröffentlichen. Die einzige Möglichkeit, diese Aktion rückgängig zu machen, besteht darin, eine vorherige Version wiederherzustellen. Diese Aktion erfordert auch, dass das mit dem API-Schlüssel verbundene Konto berechtigt ist, Spiele zu veröffentlichen.


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"
}'

Nach der Veröffentlichung bestätigen Sie, dass die Konfiguration live ist, indem Sie diese GET-Anfrage senden.


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>'

Best Practices

Groß-/Kleinschreibung — Verwenden Sie das genaue {UserId}-Token in Ihren Mustern. Varianten wie {userId} werden nicht akzeptiert.
Manuelle Überprüfung — Vergleichen Sie Ihre Muster mit Ihrer Live-Luau-Nutzung über den Datenspeichermanager im Creator Hub, bevor Sie die Konfiguration veröffentlichen.
Standardbereiche — Wenn ein Datenspeicher den Standardbereich verwendet, setzen Sie scope_pattern auf "global" in der Schlüsselvorlage.
End-to-End-Flow in einem Testspiel testen — Für die vollständige Validierung Ihrer Vorlagen sollten Sie in Betracht ziehen, ein Testspiel und ein Dummy-Konto zu erstellen, es mit Dummy-Daten für die Benutzer-ID dieses Kontos zu füllen, RTBF für das Dummy-Konto anzufordern und sicherzustellen, dass die Daten gelöscht werden, sobald das Konto bearbeitet wird.
Löschungen bestätigen — Nach der Einarbeitung in Ihrem Live-Spiel, wenn eine RTBF-Anfrage in Ihren Roblox-Nachrichten erscheint, überprüfen Sie, dass die entsprechenden Daten innerhalb von 30 Tagen entfernt werden.