データストアの忘れられる権利 (RTBF) | 文書

**データストアの忘れられる権利 (RTBF)**は、ユーザーのデータを保持しているキーやデータストアを宣言することができます。Robloxがあなたのゲームに対するRTBFリクエストを処理する際、システムはそれらのテンプレートを使って一致するデータを自動的に削除します。テンプレートは、クリエイターハブのデータストアマネージャーを通じてビジュアルに構成するか、Open Cloud Configs APIを通じてプログラム的に構成できます。

自動RTBF

自動RTBF処理を使用するには、削除テンプレートを定義する必要があります。これらのテンプレートは、Robloxに特定のユーザーに属するデータストアやキーを伝えます。ユーザーデータを識別するために、最大100のテンプレートを持つことができます。

削除テンプレート

自動RTBFはパターンをマッチングすることによって機能します。ユーザーデータのテンプレートを{UserId}トークンを使用して定義します。Robloxが忘れられる権利リクエストを受け取ると、そのシステムはリクエスターの実際のIDにそのトークンを置き換え、一致するデータストアをスキャンして削除します。

対象要件

エントリーが自動削除の対象となるには、以下の基準を満たす必要があります。

ストレージタイプ — ユーザーデータは標準データストアまたは順序付きデータストアに保存されている必要があります。全体のデータストアの削除は標準データストアのみサポートされています。
識別子 — ユーザーIDはデータストアまたはキーのNameまたはScopeの一部でなければなりません。
フォーマット — IDは静的文字列パターンで識別可能でなければなりません（例えば、User_{UserId}のように）。

データストアマネージャーを介した自動RTBFの構成

クリエイターハブは、コマンドラインを使用することなくRTBFテンプレートを管理するためのビジュアルインターフェースを提供します。

グループゲームの場合、設定を表示するにはAnalytics表示の権限を追加し、設定を表示、編集、および公開するにはエクスペリエンスの編集と公開の権限が必要です。さらに、ユーザー本人もゲームを公開する資格がある必要があります。

クリエイターハブに移動します。
設定したいゲームを選択します。
左側のナビゲーションメニューで、設定 ⟩ データストアマネージャーに進みます。
RTBF削除タブを選択します。
テンプレートを作成をクリックします。
タイプ (標準データストア, 標準キー, または順序付きキー)を選択します。
{UserId}トークンを使用して対応するフィールドに入力します（例: PlayerInventory_{UserId}）。このトークンは大文字小文字を区別します。
サンプル出力を再確認し、作成をクリックします。

Configs APIを介した自動RTBFの構成

Open Cloud Configs APIを使用して、RTBFテンプレートをプログラム的に管理することもできます。これは自動化やスケールでのテンプレート管理に便利です。

クリエイターダッシュボードで、すべてのユニバースでRTBF削除を自動化するために**universe:readとuniverse:write**の権限を含むAPIキーを作成または編集します。詳細については、APIキーの管理を参照してください。

テンプレートはuser_data_templatesという名前のJSON構成として保存されます。主に2つのタイプがあります：

キーのテンプレート — 特定のキーを識別します。data_store_type（STANDARDまたはORDERED）、data_store_name、およびkey_patternが必要です。scope_patternは任意ですが推奨されます。
データストアのテンプレート — 全体のデータストアを識別します。data_store_type（現在はSTANDARDのみサポート）およびdata_store_patternが必要です。

両方のテンプレートの種類については、RTBFリクエストが処理されるときに{UserId}トークンがユーザーのIDに置き換えられます。

例の構成
{
	"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"
			}
		}
	]
}

{UserId}トークンは大文字小文字を区別します。scope_patternが省略されるか空白である場合、デフォルトはglobalになります。

次に、Open Cloud Configs APIを介して送信します。以下の例では、リクエストごとに<API_KEY>および<UNIVERSE_ID>を置き換え、すべてのリクエストをDataStoresConfigリポジトリに送信します。

追加のエンドポイントや動作については、Cloud APIリファレンスおよびエクスペリエンス設定ガイドを参照してください。

設定を定義するPUTリクエストを介してドラフトを作成します。ドラフトがすでに存在する場合、このリクエストはそれを上書きします。


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

ドラフトを確認するためにGETリクエストを送信して、ドラフトがライブになる前に確認します。


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

確認後、このPOSTリクエストを送信して公開します。このアクションを元に戻す唯一の方法は、以前のバージョンを復元することです。このアクションは、APIキーに関連付けられたアカウントがゲームを公開する資格がある必要があります。


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

公開後、この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>'

ベストプラクティス

大文字小文字の区別 — パターン内で正確な{UserId}トークンを使用してください。{userId}などの変種は受け入れられません。
手動確認 — 設定を公開する前に、クリエイターハブのデータストアマネージャーを使用して、パターンをライブのLuau使用と比較してください。
デフォルトスコープ — データストアがデフォルトスコープを使用している場合、キーのテンプレートでscope_patternを"global"に設定します。
テストゲームでのエンドツーエンドフローのテスト — テンプレートの完全な検証のために、テストゲームとダミーアカウントを作成し、そのアカウントのユーザーIDにダミーデータでポピュレートし、ダミーアカウントでRTBFを要求し、アカウントが処理された後にデータが削除されることを確認します。
削除の確認 — ライブゲームでオンボーディングした後、RobloxメッセージにRTBFリクエストが表示されたとき、対応するデータが30日以内に削除されたことを確認してください。