Unutulma Hakkı (RTBF) Veri Deposu | Dokümantasyon

Veri depoları için unutulma hakkı (RTBF), hangi anahtarların ve veri depolarının bir kullanıcının verilerini tuttuğunu beyan etmenizi sağlar. Roblox, oyununuz için bir RTBF talebini işlediğinde, bu şablonları kullanarak eşleşen verileri otomatik olarak siler. Şablonları Veri Depoları Yöneticisi üzerinden görsel olarak veya Açık Bulut Yapılandırmalar API'si aracılığıyla programatik olarak yapılandırabilirsiniz.

Otomatik RTBF

Otomatik RTBF işlemeyi kullanmak için silme şablonları tanımlamanız gerekmektedir. Bu şablonlar, Roblox'a hangi veri depolarının veya anahtarların belirli bir kullanıcıya ait olduğunu belirtir. Kullanıcı verilerinizi tanımlamak için en fazla 100 şablonunuz olabilir.

Silme şablonları

Otomatik RTBF, desenleri eşleştirerek çalışır. Kullanıcı verilerinizi tanımlamak için bir {UserId} belirteci kullanarak bir şablon tanımlarsınız. Roblox, unutulma hakkı talebini aldığında, sistem bu belirteci talep eden kişinin gerçek ID'si ile değiştirir ve silinmesi gereken eşleşmeleri bulmak için veri depolarınızı tarar.

Uygunluk gereksinimleri

Bir girişin otomatik silme için uygun olması için aşağıdaki kriterleri karşılaması gerekmektedir:

Depolama türü — Kullanıcı verileri, standart bir veri deposu veya sıralı bir veri deposunda saklanmalıdır. Bir veri deposunun tamamen silinmesi yalnızca standart veri depoları için desteklenmektedir.
Kimlik Belirleyici — Kullanıcı ID'si, veri deposunun veya anahtarın Ad veya Kapsam kısmında yer almalıdır.
Format — ID, sabit bir dize desenine göre tanımlanabilir olmalıdır (örneğin, User_{UserId}).

Veri Depoları Yöneticisi aracılığıyla otomatik RTBF yapılandırma

Yaratıcı Hub, komut satırını kullanmadan RTBF şablonlarınızı yönetmek için görsel bir arayüz sağlar.

Grup oyunları için, yapılandırmaları görmek adına Analitik Görüntüleme iznini eklemeniz ve yapılandırmaları görüntülemek, düzenlemek ve yayımlamak için Deneyimi düzenle ve yayımla iznini eklemeniz gerekir. Ayrıca, kullanıcının kendisinin de oyun yayımlamak için uygun olması gereklidir.

Yaratıcı Hub sayfasına gidin.
Yapılandırmak istediğiniz oyunu seçin.
Sol menüdeki Yapılandır ⟩ Veri Depoları Yöneticisi seçeneğine gidin.
RTBF Silme sekmesini seçin.
Şablon Oluştur butonuna tıklayın.
Tür ( Standart Veri Deposu, Standart Anahtar veya Sıralı Anahtar ) seçin.
{UserId} belirteci kullanarak şablonunuza karşılık gelen alanları doldurun (örneğin, PlayerInventory_{UserId}). Bu belirteç büyük/küçük harf duyarlıdır.
Örnek çıktıyı kontrol edin ve Oluştur butonuna tıklayın.

Configs API aracılığıyla otomatik RTBF yapılandırma

RTBF şablonlarını programatik olarak Açık Bulut Yapılandırmalar API'sini kullanarak da yönetebilirsiniz. Bu, otomasyon veya şablonları büyük ölçekte yönetmek için faydalıdır.

Yaratıcı Gösterge Tablosu'nda, bir API anahtarı oluşturun veya düzenleyin ve otomatik RTBF silme işlemi için istediğiniz her evrende universe:read ve universe:write izinlerini ekleyin. Daha fazla ayrıntı için API anahtarlarını yönetin.

Şablonlar, user_data_templates adlı bir JSON yapılandırması olarak saklanır. İki ana tür vardır:

Anahtar şablonu — Belirli anahtarları tanımlar. data_store_type (STANDARD veya ORDERED), data_store_name ve key_pattern gerektirir. scope_pattern isteğe bağlıdır ancak önerilir.
Veri deposu şablonu — Tüm bir veri deposunu tanımlar. data_store_type (şu anda yalnızca STANDARD destekler) ve data_store_pattern gerektirir.

Her iki şablon türü için, {UserId} belirteci, bir RTBF talebi işlendiğinde kullanıcının ID'si ile değiştirilir.

Örnek Yapılandırma
{
	"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} belirteci büyük/küçük harf duyarlıdır. Eğer scope_pattern belirtilmemiş veya boş bırakılmışsa, varsayılan olarak global olur.

Daha sonra, Açık Bulut Yapılandırmalar API'si aracılığıyla gönderim yapın. Aşağıdaki örneklerde <API_KEY> ve <UNIVERSE_ID> her istek için değiştirin ve tüm istekleri DataStoresConfig deposuna gönderin.

Ek uç noktalar ve davranışlar için Bulut API referansı ve deneyim yapılandırmaları kılavuzuna bakın.

Yapılandırmanızı tanımlayan bir PUT isteği ile bir taslak oluşturun. Eğer bir taslak zaten varsa, bu istek onu üzerine yazar.


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

Taslağınızı doğrulamak için bir GET isteği gönderin ve canlıya geçmeden önce taslağı inceleyin.


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

Doğrulamadan sonra, bunu yayımlamak için POST isteği gönderin. Bu işlemi geri almanın tek yolu, önceki bir versiyonu geri yüklemektir. Bu işlem ayrıca API anahtarı ile ilişkilendirilmiş hesabın oyun yayımlamak için uygun olması gerektiğini gerektirir.


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

Yayınladıktan sonra, bu GET isteği ile yapılandırmanın aktif olduğunu onaylayın.


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

En iyi uygulamalar

Büyük/küçük harf duyarlılığı — Desenlerinizde tam olarak {UserId} belirtecini kullanın. {userId} gibi varyantlar kabul edilmez.
Manuel doğrulama — Yapılandırmanızı yayımlamadan önce, canlı Luau kullanımınız ile desenlerinizi Veri Depoları Yöneticisi aracılığıyla karşılaştırın.
Varsayılan kapsamlar — Eğer bir veri deposu, varsayılan kapsamı kullanıyorsa, anahtar şablonunda scope_pattern değerini "global" olarak belirleyin.
Test oyunu üzerinde uçtan uca akışı test edin — Şablonlarınızı tam olarak doğrulamak için bir test oyunu yaratmayı ve dummy bir hesap ile o hesabın Kullanıcı ID’sine dummy veriler eklemeyi düşünün, dummy hesap için RTBF talep edip, hesabın işlenmesinin ardından verilerin silindiğinden emin olun.
Silmeleri onaylayın — Canlı oyununuzda bir RTBF talebi aldığınızda, ilgili verilerin 30 gün içinde silindiğini doğrulayın.