*Bu içerik, yapay zekâ (beta) kullanılarak çevrildi ve hatalar içerebilir. Sayfayı İngilizce görüntülemek için buraya tıkla.

DataStoreEntry

Bir veri depolamasındaki anahtar-değer girişi.

KAYNAK YOLLARI
/cloud/v2/universes/{universe_id}/data-stores/{data_store_id}/entries
/cloud/v2/universes/{universe_id}/data-stores/{data_store_id}/scopes/{scope_id}/entries

Nitelikler

pathstring

Veri depolama girişinin kaynak yolu.

Formlar:

universes/{universe_id}/data-stores/{data_store_id}/entries/{data_store_entry_id}
universes/{universe_id}/data-stores/{data_store_id}/scopes/{data_store_scope_id}/entries/{data_store_entry_id}.

createTimestring

Yalnızca Çıkış

Veri depolama girişi oluşturulduğunda tarih ve saat. Bu dizi Timestamp olarak biçimlendirilmiş.

revisionIdstring

Sabit

Yalnızca Çıkış

Veri depolama girişinin revizyon kimliği.

Veri depolama girişi herhangi bir şekilde değiştirildiğinde yeni bir revizyon işlenir.

Biçim rastgele bir dize. Örnek: "foo".

revisionCreateTimestring

Yalnızca Çıkış

Revizyon oluşturulduğunda tarih ve saat. Bu dizi Timestamp olarak biçimlendirilmiş.

stateEnum<string>

Yalnızca Çıkış

Veri depolama girişinin durumu.

Olası değerler:

| Değer | Açıklama | | --- | --- | | STATE_UNSPECIFIED | Varsayılan değer.Bu değer, durum atlanırsa kullanılır.| | AKTİF | Yeni oluşturulan bir veri depolama girişinin varsayılan durumu.| | SİLİNDİ | Veri depolama girişi silinmiş olarak işaretlenir.Gelecekte bir noktada kalıcı olarak silinecek. |. Olası değerler:

etagstring

Bu denetim, diğer alanların değerine dayanarak sunucu tarafından hesaplanır ve müşterinin ilerlemeden önce güncel bir değere sahip olduğundan emin olmak için güncelleme ve silme isteklerine (ve potansiyel olarak belirli özel yöntemlere) gönderilebilir.

valueJSON value

Girişin değeri.

JSON değeri null, boolean, string, number, array ya da object olabilir.

idstring

Yalnızca Çıkış

Girişin kaynak kimliği.

Bu, kaynak yolunun son bölümüyle eşleşir ve sadece uygunluk için sağlanır.

usersarray<string>

Giriş ile ilişkili kullanıcılar.

attributesobject

Giriş ile ilişkili rastgele bir dizi özellik.

Taban URL

https://apis.roblox.com

DataStoreEntry Kaynağı

{
  "path": "universes/123/data-stores/some-data-store/entries/some-data-store-entry",
  "createTime": "2023-07-05T12:34:56Z",
  "revisionId": "string",
  "revisionCreateTime": "2023-07-05T12:34:56Z",
  "state": "STATE_UNSPECIFIED",
  "etag": "string",
  "value": "JSON value",
  "id": "string",
  "users": [
    "string"
  ],
  "attributes": "object"
}

DataStoreEntry

Veri Deposu Girişlerini Listele
Beta

GET /cloud/v2/universes/{universe_id}/data-stores/{data_store_id}/entries

Bir veri depolamasından bir dizi giriş döndürür.

Sadece path ve id alanları doldurulur; diğer alanları almak için GetDataStoreEntry kullanın.

Tüm alanlardan girişleri listelemek için yıldızlı alanı belirtin ( - ) .

Kapsamlar

universe-datastores.objects:list

TalepYol Parametreleri

universe_idstring

Gerekli

Evren kimliği.

data_store_idstring

Gerekli

Veri depolama kimliği.

Sorgu Parametreleri

maxPageSizenumber

Geri verilecek veri depolama girişlerinin maksimum sayısı.Hizmet bu değerden daha azını iade edebilir.Belirtilmediğinde, en fazla 10 veri depolama girişi döndürülür.Maksimum değer 256'dır ve daha yüksek değerler 256 olarak ayarlanır.

pageTokenstring

Bir önceki çağrıdan alınan bir sayfa jetonu, sonraki bir sayfa almak için.

Sayfa numaralandırırken, sonraki çağrıya verilen tüm diğer parametler, sayfa jetonu sağlayan çağrıya eşleşmelidir.

filterstring

Bu alan, döndürülen kaynakları filtrelemek için ayarlanabilir.

The filter alanı, çok küçük bir CEL altkümesini destekler:

Sadece id alanı desteklenir.
Sadece startsWith fonksiyonu mevcuttur; başka operatörler veya yerleşikler desteklenmez.

Örnek filtre: id.startsWith("foo").

showDeletedboolean

Eğer doğruysa, bekleyen silme için işaretlenen kaynaklar sonuçlara dahil edilir.

Yanıt

Ebeveyn koleksiyonundaki DataStoreEntries listesi.

dataStoreEntriesarray<DataStoreEntry>

Belirtilen DataStore veya DataStoreScope'tan gelen VeriDepolamaGirişleri.

nextPageTokenstring

Bir sonraki sayfayı almak için bir pageToken çözümleyici olarak gönderebileceğiniz bir jeton. Bu alan atlanırsa, sonraki sayfalar yoktur.

GET /cloud/v2/universes/{universe_id}/data-stores/{data_store_id}/entries

curl -L -X GET 'https://apis.roblox.com/cloud/v2/universes/{universe_id}/data-stores/{data_store_id}/entries?maxPageSize=10&pageToken={string}&filter={string}&showDeleted={boolean}' \
  -H 'x-api-key: {your-api-key}'

Yanıt

{
  "dataStoreEntries": [
    {
      "path": "universes/123/data-stores/some-data-store/entries/some-data-store-entry",
      "createTime": "2023-07-05T12:34:56Z",
      "revisionId": "string",
      "revisionCreateTime": "2023-07-05T12:34:56Z",
      "state": "STATE_UNSPECIFIED",
      "etag": "string",
      "value": "JSON value",
      "id": "string",
      "users": [
        "string"
      ],
      "attributes": "object"
    }
  ],
  "nextPageToken": "string"
}

DataStoreEntry

Veri Deposu Girişi Oluştur
Beta

POST /cloud/v2/universes/{universe_id}/data-stores/{data_store_id}/entries

Verilen ID ve değerle bir giriş oluşturur.

Giriş varsa 400 Kötü İstek döndürür.

Kapsamlar

universe-datastores.objects:create

TalepYol Parametreleri

universe_idstring

Gerekli

Evren kimliği.

data_store_idstring

Gerekli

Veri depolama kimliği.

Sorgu Parametreleri

idstring

Veri depolama girişi için kullanılacak ID, ki bu veri depolama girişinin kaynak yolunun son bileşeni olacak.

Bu değer 1-50 karakterlik bir dize olmalıdır. Sadece küçük harfler, sayısal sayılar ve tireler kullanmanızı şiddetle tavsiye ediyoruz.

Talep GövdesiDataStoreEntry

YanıtDataStoreEntry

POST /cloud/v2/universes/{universe_id}/data-stores/{data_store_id}/entries

curl -L -X POST 'https://apis.roblox.com/cloud/v2/universes/{universe_id}/data-stores/{data_store_id}/entries?id=my-entry' \
  -H 'x-api-key: {your-api-key}' \
  -H 'Content-Type: application/json' \
  --data '{
  "etag": "string",
  "value": "JSON value",
  "users": [
    "string"
  ],
  "attributes": "object"
}'

Yanıt

{
  "path": "universes/123/data-stores/some-data-store/entries/some-data-store-entry",
  "createTime": "2023-07-05T12:34:56Z",
  "revisionId": "string",
  "revisionCreateTime": "2023-07-05T12:34:56Z",
  "state": "STATE_UNSPECIFIED",
  "etag": "string",
  "value": "JSON value",
  "id": "string",
  "users": [
    "string"
  ],
  "attributes": "object"
}

DataStoreEntry

Veri Deposu Girişi Alın
Beta

GET /cloud/v2/universes/{universe_id}/data-stores/{data_store_id}/entries/{entry_id}

Belirtilen girişi alır.

Belirli bir sürümde giriş almak için, yolu sonuna @<revisionId> ekleyin.

Örneğin, revizyon kimliği my-entry 'de 08DC3D3F43F9FCC1.0000000001.08DC3D3F43F9FCC1.01 almak için, yol kullanın /v2/universes/1234/data-stores/5678/entries/my-entry@08DC3D3F43F9FCC1.0000000001.08DC3D3F43F9FCC1.01 .

Giriş kimliğiniz bir veya daha fazla @ karakter içeriyorsa ve en son sürümü herhangi bir belirli sürümden almak istemiyorsanız, özel revizyon kimliğini @latest yolu sonuna ekleyin.Aksi takdirde, son @ ID'den sonraki giriş segmenti bir revizyon kimliği olarak yorumlanacaktır.

Örneğin, en son sürümü almak için my-entry , yol /v2/universes/1234/data-stores/5678/entries/my@entry@latest kullanın.

Belirli bir zamanda mevcut olan girişi almak için, @latest:<timestamp> yolu sonuna ekleyin, <timestamp> RFC-3339 biçimlendirilmiştir.Verilen tarih işareti Unix döneminden (1/1/1970) sonra olmalı ve gelecekte on dakikadan fazla olmamalıdır.

Örneğin, 12/2/2024 saat 06:00 UTC'de mevcut olan my-entry revizyonunu almak için, yol /v2/universes/1234/data-stores/5678/entries/my-entry@latest:2024-12-02T06:00:00Z kullanın.

Kapsamlar

universe-datastores.objects:read

TalepYol Parametreleri

universe_idstring

Gerekli

Evren kimliği.

data_store_idstring

Gerekli

Veri depolama kimliği.

entry_idstring

Gerekli

Giriş ID'si.

YanıtDataStoreEntry

GET /cloud/v2/universes/{universe_id}/data-stores/{data_store_id}/entries/{entry_id}

curl -L -X GET 'https://apis.roblox.com/cloud/v2/universes/{universe_id}/data-stores/{data_store_id}/entries/{entry_id}' \
  -H 'x-api-key: {your-api-key}'

Yanıt

{
  "path": "universes/123/data-stores/some-data-store/entries/some-data-store-entry",
  "createTime": "2023-07-05T12:34:56Z",
  "revisionId": "string",
  "revisionCreateTime": "2023-07-05T12:34:56Z",
  "state": "STATE_UNSPECIFIED",
  "etag": "string",
  "value": "JSON value",
  "id": "string",
  "users": [
    "string"
  ],
  "attributes": "object"
}

DataStoreEntry

Veri Deposu Girişini Sil
Beta

DELETE /cloud/v2/universes/{universe_id}/data-stores/{data_store_id}/entries/{entry_id}

Belirtilen girişi silmek için işaretler.

Girişler hemen silinmez; bunun yerine, state alanı DELETED olarak ayarlanacaktır. Kalıcı silme 30 gün sonra gerçekleşir.

Başarılı olduğunda, 200 OK döndürür. Giriş mevcut değilse, 404 Not Found döndürür.

Kapsamlar

universe-datastores.objects:delete

TalepYol Parametreleri

universe_idstring

Gerekli

Evren kimliği.

data_store_idstring

Gerekli

Veri depolama kimliği.

entry_idstring

Gerekli

Giriş ID'si.

DELETE /cloud/v2/universes/{universe_id}/data-stores/{data_store_id}/entries/{entry_id}

curl -L -X DELETE 'https://apis.roblox.com/cloud/v2/universes/{universe_id}/data-stores/{data_store_id}/entries/{entry_id}' \
  -H 'x-api-key: {your-api-key}'

DataStoreEntry

Veri Deposu Girişini Güncelle
Beta

PATCH /cloud/v2/universes/{universe_id}/data-stores/{data_store_id}/entries/{entry_id}

Bir girişin değerini, özniteliklerini ve kullanıcılarını günceller.

Girişin belirli revizyonlarını güncelleştirmek desteklenmiyor .Yol üzerinde bir revizyon kimliği belirtirseniz ve , güncelleme isteği yerine anahtarın bir parçası olarak 缀i ile yeni bir giriş oluşturur.

Kısmi güncelleme desteklenmiyor .Değer güncellenirken öznitelikler veya kullanıcılar sağlanmazsa temizlenecektir.Bir giriş güncellenirken değer daima sağlanmalıdır.

Kapsamlar

universe-datastores.objects:update

TalepYol Parametreleri

universe_idstring

Gerekli

Evren kimliği.

data_store_idstring

Gerekli

Veri depolama kimliği.

entry_idstring

Gerekli

Giriş ID'si.

Sorgu Parametreleri

allowMissingboolean

Doğru ayarlanırsa ve veri depolama girişi bulunmazsa, bir veri depolama girişi oluşturulur.

Talep GövdesiDataStoreEntry

YanıtDataStoreEntry

PATCH /cloud/v2/universes/{universe_id}/data-stores/{data_store_id}/entries/{entry_id}

curl -L -X PATCH 'https://apis.roblox.com/cloud/v2/universes/{universe_id}/data-stores/{data_store_id}/entries/{entry_id}?allowMissing={boolean}' \
  -H 'x-api-key: {your-api-key}' \
  -H 'Content-Type: application/json' \
  --data '{
  "etag": "string",
  "value": "JSON value",
  "users": [
    "string"
  ],
  "attributes": "object"
}'

Yanıt

{
  "path": "universes/123/data-stores/some-data-store/entries/some-data-store-entry",
  "createTime": "2023-07-05T12:34:56Z",
  "revisionId": "string",
  "revisionCreateTime": "2023-07-05T12:34:56Z",
  "state": "STATE_UNSPECIFIED",
  "etag": "string",
  "value": "JSON value",
  "id": "string",
  "users": [
    "string"
  ],
  "attributes": "object"
}

DataStoreEntry

Artırma Veri Deposu Girişi
Beta

POST /cloud/v2/universes/{universe_id}/data-stores/{data_store_id}/entries/{entry_id}:increment

Belirtilen girişin değerini artırır. Mevcut değer ve artırma miktarının her ikisi de sayısal olmalıdır.

Giriş mevcut değilse, belirtilen değerle bir giriş oluşturur.

Girişin belirli revizyonlarını artırmak desteklenmiyor .Yol üzerinde bir revizyon kimliği belirtirseniz, artırma isteği anahtarın bir parçası olarak @<revisionId> 缀i ile yeni bir giriş oluşturur.

Bilinen sorun: değer, geçerli değer aralığının ötesine artırılabilir.Bu gerçekleştiğinde, döndürülen değer geçerli aralığa sabitlenecek, ancak arka plandaki orijinal değer devam edebilir.Bu davranış, geriye dönük uyumluluk nedenleriyle korunur, ancak bu API'nin gelecekteki bir sürümünde değişebilir.

Kapsamlar

universe-datastores.objects:createuniverse-datastores.objects:update

TalepYol Parametreleri

universe_idstring

Gerekli

Evren kimliği.

data_store_idstring

Gerekli

Veri depolama kimliği.

entry_idstring

Gerekli

Giriş ID'si.

Talep Gövdesi

amountnumber

Giriş değerini artırmak için kullanılacak miktar. Mevcut değer ve artırma miktarı sayısal olmalıdır.

usersarray<string>

Giriş ile ilişkili kullanıcılar.

Bunlar sağlanmazsa, mevcut kullanıcı kimlikleri temizlenir.

attributesobject

Giriş ile ilişkili rastgele bir dizi özellik.

Bunlar sağlanmazsa, mevcut öznitelikler temizlenir.

YanıtDataStoreEntry

POST /cloud/v2/universes/{universe_id}/data-stores/{data_store_id}/entries/{entry_id}:increment

curl -L -X POST 'https://apis.roblox.com/cloud/v2/universes/{universe_id}/data-stores/{data_store_id}/entries/{entry_id}:increment' \
  -H 'x-api-key: {your-api-key}' \
  -H 'Content-Type: application/json' \
  --data '{
  "amount": "number",
  "users": [
    "string"
  ],
  "attributes": "object"
}'

Yanıt

{
  "path": "universes/123/data-stores/some-data-store/entries/some-data-store-entry",
  "createTime": "2023-07-05T12:34:56Z",
  "revisionId": "string",
  "revisionCreateTime": "2023-07-05T12:34:56Z",
  "state": "STATE_UNSPECIFIED",
  "etag": "string",
  "value": "JSON value",
  "id": "string",
  "users": [
    "string"
  ],
  "attributes": "object"
}

DataStoreEntry

Veri Deposu Giriş Revizyonlarını Listele
Beta

GET /cloud/v2/universes/{universe_id}/data-stores/{data_store_id}/entries/{entry_id}:listRevisions

Veri depolama girişinin revizyonlarını listeleyin.

Bu yöntem kısmi veri depolama girişleri döndürür.

Özellikle, sadece path , id , createTime , revisionCreateTime , revisionId , etag ve state alanları doldurulur.Hem path hem de id alanlarının bir @<version> ekine sahip olması gerekir.

Bir revizyonda tüm girişi almak için, verilen path alanı ile GetDataStoreEntry yöntemi kullanabilirsiniz, yani GET /v1/universes/1234/data-stores/5678/entries/my-entry@<version>.

Kapsamlar

universe-datastores.versions:list

TalepYol Parametreleri

universe_idstring

Gerekli

Evren kimliği.

data_store_idstring

Gerekli

Veri depolama kimliği.

entry_idstring

Gerekli

Giriş ID'si.

Sorgu Parametreleri

maxPageSizenumber

Sayfa başına geri göndermek için maksimum sayıda değişiklik.

Hizmet maksimum sayıdan daha az geri dönüş yapabilir.Belirtilmediğinde, en fazla 10 değişiklik geri döndürülür.Maksimum değer 100 değer ve daha yüksek değerler 100 olarak ayarlanır.

pageTokenstring

Bir önceki çağrıdan alınan bir sayfa jetonu, sonraki bir sayfa almak için.

Sayfa numaralandırırken, sonraki çağrıya verilen tüm diğer parametler, sayfa jetonu sağlayan çağrıya eşleşmelidir.

filterstring

CEL'in aşağıdaki alt kümesini destekler:

Sadece && , <= ve >= operatörleri desteklenir.
Sadece revision_create_time alanı desteklenir.

Örneğin:

"revision_create_time >= 2000-01-01T00:00:00Z && revision_create_time <= 2001-01-01T00:00:00Z".

Yanıt

Bir veri depolama girişinin değişiklikleri listesi.

dataStoreEntriesarray<DataStoreEntry>

data_store_entry'nin değişiklikleri.

nextPageTokenstring

Bir sonraki sayfayı almak için bir pageToken çözümleyici olarak gönderdiğiniz bir jeton. Bu alan atlanırsa, sonraki sayfalar yoktur.

GET /cloud/v2/universes/{universe_id}/data-stores/{data_store_id}/entries/{entry_id}:listRevisions

curl -L -X GET 'https://apis.roblox.com/cloud/v2/universes/{universe_id}/data-stores/{data_store_id}/entries/{entry_id}:listRevisions?maxPageSize=10&pageToken={string}&filter={string}' \
  -H 'x-api-key: {your-api-key}'

Yanıt

{
  "dataStoreEntries": [
    {
      "path": "universes/123/data-stores/some-data-store/entries/some-data-store-entry",
      "createTime": "2023-07-05T12:34:56Z",
      "revisionId": "string",
      "revisionCreateTime": "2023-07-05T12:34:56Z",
      "state": "STATE_UNSPECIFIED",
      "etag": "string",
      "value": "JSON value",
      "id": "string",
      "users": [
        "string"
      ],
      "attributes": "object"
    }
  ],
  "nextPageToken": "string"
}

DataStoreEntry

Nitelikler

DataStoreEntry

Veri Deposu Girişlerini ListeleBeta

DataStoreEntry

Veri Deposu Girişi OluşturBeta

DataStoreEntry

Veri Deposu Girişi AlınBeta

DataStoreEntry

Veri Deposu Girişini SilBeta

DataStoreEntry

Veri Deposu Girişini GüncelleBeta

DataStoreEntry

Artırma Veri Deposu GirişiBeta

DataStoreEntry

Veri Deposu Giriş Revizyonlarını ListeleBeta

Veri Deposu Girişlerini Listele
Beta

Veri Deposu Girişi Oluştur
Beta

Veri Deposu Girişi Alın
Beta

Veri Deposu Girişini Sil
Beta

Veri Deposu Girişini Güncelle
Beta

Artırma Veri Deposu Girişi
Beta

Veri Deposu Giriş Revizyonlarını Listele
Beta