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

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

自動RTBF

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

削除テンプレート

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

対象要件

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

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

データストアマネージャーを介して自動RTBFを構成する

クリエイターハブは、コマンドラインを使用せずにRTBFテンプレートを管理するための視覚的インターフェースを提供します。

1. クリエイターダッシュボードでゲームを選択します。

2. 左側のナビゲーションで、Configurations > Data stores managerに移動します。

3. RTBF Deletionタブを選択します。

4. Create Templateをクリックします。

5. Type（Standard Data Store、Standard Key、またはOrdered Key）を選択します。

6. {UserId}トークンを使用してテンプレートに対応するフィールドを入力します（例：PlayerInventory_{UserId}）。このトークンは大文字と小文字を区別します。

7. サンプル出力を再確認し、Createをクリックします。

   

Configs APIを介して自動RTBFを構成する

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

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

2. テンプレートは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になります。

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

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

   1. 構成を定義する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"
      				}
      			}
      		]
      	}
      }'

   2. ドラフトを確認するために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>'

   3. 確認後、この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"
      }'

   4. 公開後、この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日以内に削除されていることを確認してください。