*Nội dung này được dịch bằng AI (Beta) và có thể có lỗi. Để xem trang này bằng tiếng Anh, hãy nhấp vào đây.

OrderedDataStoreEntry

Một cái nhập key-value trong một cửa hàng dữ liệu được sắp xếp.

Thuộc Tính

pathstring

Con đường tài nguyên của các thành phần dữ liệu được đặt hàng.

Định dạng: universes/{universe_id}/ordered-data-stores/{ordered_data_store_id}/scopes/{ordered_data_store_scope_id}/entries/{ordered_data_store_entry_id}.

valuenumber

Giá trị của mục nhập.

Luôn làm tròn lên số nguyên gần nhất.

idstring
Chỉ Xuất

Tên của mục nhập.

URL Cơ Sở
https://apis.roblox.com
Tài nguyên OrderedDataStoreEntry
{

  "path": "universes/123/ordered-data-stores/some-ordered-data-store-id/scopes/some-ordered-data-store-scope-id/entries/some-ordered-data-store-entry-id",

  "value": "number",

  "id": "string"

}

OrderedDataStoreEntry

Danh sách các điểm dữ liệu được sắp xếp theo thứ tự
Bản Beta

GET /cloud/v2/universes/{universe_id}/ordered-data-stores/{ordered_data_store_id}/scopes/{scope_id}/entries

Trả về một danh sách các bản ghi từ một cửa hàng dữ liệu được xếp hạng.

Phạm Vi
universe.ordered-data-store.scope.entry:read
Yêu CầuTham Số Đường Dẫn
universe_idstring
Bắt Buộc

ID của vũ trụ.

ordered_data_store_idstring
Bắt Buộc

ID của cửa hàng dữ liệu được đặt hàng.

scope_idstring
Bắt Buộc

ID của phạm vi.

Tham Số Truy Vấn
maxPageSizenumber

Số lượng tối đa các điểm dữ liệu được đặt hàng để trả lại.Dịch vụ có thể trả về ít hơn giá trị này.Nếu không được xác định, tối đa 10 lượt truy cập cửa hàng dữ liệu được trả về.Giá trị tối đa là 100 và giá trị cao hơn được đặt thành 100.

pageTokenstring

Một token trang, nhận từ cuộc gọi trước, để lấy lại trang tiếp theo.

Khi paginate, tất cả các tham số khác được cung cấp cho cuộc gọi tiếp theo phải phù hợp với cuộc gọi cung cấp token trang.

orderBystring

Nếu được xác định, kết quả được sắp xếp theo các trường được xác định.

Giá trị phải là một danh sách phân cách bằng dấu phẩy của các trường, với một chữ "desc" tùy chọn cho mỗi trường để sắp xếp theo thứ tự giảm dần chứ không phải tăng dần giá trị.Bạn có thể truy cập các trường con với một . operator.

Kết quả có thể được sắp xếp theo các trường sau: value.

Ví dụ: "value desc".

filterstring

Trường này có thể được đặt để lọc các tài nguyên được trả về.

Chúng tôi hỗ trợ hai operator so sánh cho hoạt động này: <= và >=.Các operator so sánh này hoạt động như một minValue và maxValue cho các giá trị được trả về.Nếu lọc là cần thiết cho một giá trị giữa một minValue và maxValue, người dùng có thể sử dụng logic operator &&.Tất cả các token trong bài toán lọc phải được tách bởi một khoảng trống duy nhất.

Ví dụ bộ lọc: entry <= 10 ; entry >= 10 && entry <= 30.

Phản Hồi

Một danh sách các OrderedDataStoreEntries trong bộ sưu tập cha.

orderedDataStoreEntriesarray<OrderedDataStoreEntry>

Các thành phần OrderedDataStoreEntries từ phạm vi OrderedDataStoreScope được chỉ định.

nextPageTokenstring

Một token mà bạn có thể gửi như một tham số pageToken để lấy trang tiếp theo. Nếu trường này bị bỏ qua, không có trang tiếp theo.

GET /cloud/v2/universes/{universe_id}/ordered-data-stores/{ordered_data_store_id}/scopes/{scope_id}/entries
curl -L -X GET 'https://apis.roblox.com/cloud/v2/universes/{universe_id}/ordered-data-stores/{ordered_data_store_id}/scopes/{scope_id}/entries?maxPageSize=10&pageToken={string}&orderBy={string}&filter={string}' \

  -H 'x-api-key: {your-api-key}'
Phản Hồi
{

  "orderedDataStoreEntries": [

    {

      "path": "universes/123/ordered-data-stores/some-ordered-data-store-id/scopes/some-ordered-data-store-scope-id/entries/some-ordered-data-store-entry-id",

      "value": "number",

      "id": "string"

    }

  ],

  "nextPageToken": "string"

}

OrderedDataStoreEntry

Tạo lượt truy cập Cửa hàng dữ liệu được sắp xếp
Bản Beta

POST /cloud/v2/universes/{universe_id}/ordered-data-stores/{ordered_data_store_id}/scopes/{scope_id}/entries

Tạo một cái nhập với ID và giá trị được cung cấp.

Trả về một yêu cầu tồi 400 nếu mục tồn tại.

Phạm Vi
universe.ordered-data-store.scope.entry:write
Yêu CầuTham Số Đường Dẫn
universe_idstring
Bắt Buộc

ID của vũ trụ.

ordered_data_store_idstring
Bắt Buộc

ID của cửa hàng dữ liệu được đặt hàng.

scope_idstring
Bắt Buộc

ID của phạm vi.

Tham Số Truy Vấn
idstring

ID để sử dụng cho lưu trữ dữ liệu được đặt hàng, sẽ trở thành thành phần cuối cùng của con đường tài nguyên của lưu trữ dữ liệu được đặt hàng.

Giá trị này nên là một chuỗi ký tự 1-63. Chúng tôi khuyên bạn nên sử dụng chỉ các chữ cái thấp hơn, các chữ số và dấu gạch ngang.

Yêu Cầu Cơ ThểOrderedDataStoreEntry
Phản HồiOrderedDataStoreEntry
POST /cloud/v2/universes/{universe_id}/ordered-data-stores/{ordered_data_store_id}/scopes/{scope_id}/entries
curl -L -X POST 'https://apis.roblox.com/cloud/v2/universes/{universe_id}/ordered-data-stores/{ordered_data_store_id}/scopes/{scope_id}/entries?id=my-entry' \

  -H 'x-api-key: {your-api-key}' \

  -H 'Content-Type: application/json' \

  --data '{

  "value": "number"

}'
Phản Hồi
{

  "path": "universes/123/ordered-data-stores/some-ordered-data-store-id/scopes/some-ordered-data-store-scope-id/entries/some-ordered-data-store-entry-id",

  "value": "number",

  "id": "string"

}

OrderedDataStoreEntry

Nhận được lưu trữ dữ liệu được xếp hạng Entry
Bản Beta

GET /cloud/v2/universes/{universe_id}/ordered-data-stores/{ordered_data_store_id}/scopes/{scope_id}/entries/{entry_id}

Nhận được các thành phần được định.

Phạm Vi
universe.ordered-data-store.scope.entry:read
Yêu CầuTham Số Đường Dẫn
universe_idstring
Bắt Buộc

ID của vũ trụ.

ordered_data_store_idstring
Bắt Buộc

ID của cửa hàng dữ liệu được đặt hàng.

scope_idstring
Bắt Buộc

ID của phạm vi.

entry_idstring
Bắt Buộc

ID nhập.

Phản HồiOrderedDataStoreEntry
GET /cloud/v2/universes/{universe_id}/ordered-data-stores/{ordered_data_store_id}/scopes/{scope_id}/entries/{entry_id}
curl -L -X GET 'https://apis.roblox.com/cloud/v2/universes/{universe_id}/ordered-data-stores/{ordered_data_store_id}/scopes/{scope_id}/entries/{entry_id}' \

  -H 'x-api-key: {your-api-key}'
Phản Hồi
{

  "path": "universes/123/ordered-data-stores/some-ordered-data-store-id/scopes/some-ordered-data-store-scope-id/entries/some-ordered-data-store-entry-id",

  "value": "number",

  "id": "string"

}

OrderedDataStoreEntry

Xóa lượt truy cập Cửa hàng dữ liệu được sắp xếp
Bản Beta

DELETE /cloud/v2/universes/{universe_id}/ordered-data-stores/{ordered_data_store_id}/scopes/{scope_id}/entries/{entry_id}

Xóa mục đã được chỉ định.

Khi thành công, trả về 200 OK. Nếu mục không tồn tại, trả về 404 Not Found.

Phạm Vi
universe.ordered-data-store.scope.entry:write
Yêu CầuTham Số Đường Dẫn
universe_idstring
Bắt Buộc

ID của vũ trụ.

ordered_data_store_idstring
Bắt Buộc

ID của cửa hàng dữ liệu được đặt hàng.

scope_idstring
Bắt Buộc

ID của phạm vi.

entry_idstring
Bắt Buộc

ID nhập.

DELETE /cloud/v2/universes/{universe_id}/ordered-data-stores/{ordered_data_store_id}/scopes/{scope_id}/entries/{entry_id}
curl -L -X DELETE 'https://apis.roblox.com/cloud/v2/universes/{universe_id}/ordered-data-stores/{ordered_data_store_id}/scopes/{scope_id}/entries/{entry_id}' \

  -H 'x-api-key: {your-api-key}'

OrderedDataStoreEntry

Cập nhật lưu trữ thông tin được xếp hạng
Bản Beta

PATCH /cloud/v2/universes/{universe_id}/ordered-data-stores/{ordered_data_store_id}/scopes/{scope_id}/entries/{entry_id}

Cập nhật giá trị của một cái nhập.

Phạm Vi
universe.ordered-data-store.scope.entry:write
Yêu CầuTham Số Đường Dẫn
universe_idstring
Bắt Buộc

ID của vũ trụ.

ordered_data_store_idstring
Bắt Buộc

ID của cửa hàng dữ liệu được đặt hàng.

scope_idstring
Bắt Buộc

ID của phạm vi.

entry_idstring
Bắt Buộc

ID nhập.

Tham Số Truy Vấn
allowMissingboolean

Nếu được đặt thành true, và không tìm thấy lưu trữ dữ liệu được xếp hạng, một lưu trữ dữ liệu được xếp hạng được tạo ra.

Yêu Cầu Cơ ThểOrderedDataStoreEntry
Phản HồiOrderedDataStoreEntry
PATCH /cloud/v2/universes/{universe_id}/ordered-data-stores/{ordered_data_store_id}/scopes/{scope_id}/entries/{entry_id}
curl -L -X PATCH 'https://apis.roblox.com/cloud/v2/universes/{universe_id}/ordered-data-stores/{ordered_data_store_id}/scopes/{scope_id}/entries/{entry_id}?allowMissing={boolean}' \

  -H 'x-api-key: {your-api-key}' \

  -H 'Content-Type: application/json' \

  --data '{

  "value": "number"

}'
Phản Hồi
{

  "path": "universes/123/ordered-data-stores/some-ordered-data-store-id/scopes/some-ordered-data-store-scope-id/entries/some-ordered-data-store-entry-id",

  "value": "number",

  "id": "string"

}

OrderedDataStoreEntry

Thêm vào Cửa hàng dữ liệu được xếp hạng Increment
Bản Beta

POST /cloud/v2/universes/{universe_id}/ordered-data-stores/{ordered_data_store_id}/scopes/{scope_id}/entries/{entry_id}:increment

Tăng giá trị của mục được chỉ định. Cả giá trị hiện tại và số tăng phải là số lẻ.

Nếu mục không tồn tại, tạo một mục với giá trị được định.

Vấn đề đã biết: giá trị có thể được tăng quá phạm vi giá trị hợp lệ.Khi điều này xảy ra, giá trị trả về sẽ bị giữ lại trong phạm vi hợp lệ, nhưng backend có thể giữ nguyên giá trị ban đầu.Hành vi này được duy trì vì lý do tương thích ngược, nhưng có thể thay đổi trong phiên bản API trong tương lai.

Phạm Vi
universe.ordered-data-store.scope.entry:write
Yêu CầuTham Số Đường Dẫn
universe_idstring
Bắt Buộc

ID của vũ trụ.

ordered_data_store_idstring
Bắt Buộc

ID của cửa hàng dữ liệu được đặt hàng.

scope_idstring
Bắt Buộc

ID của phạm vi.

entry_idstring
Bắt Buộc

ID nhập.

Yêu Cầu Cơ Thể
amountnumber

Số tiền để tăng giá trị nhập. Cả giá trị hiện tại và số tăng phải là số lẻ.

Phản HồiOrderedDataStoreEntry
POST /cloud/v2/universes/{universe_id}/ordered-data-stores/{ordered_data_store_id}/scopes/{scope_id}/entries/{entry_id}:increment
curl -L -X POST 'https://apis.roblox.com/cloud/v2/universes/{universe_id}/ordered-data-stores/{ordered_data_store_id}/scopes/{scope_id}/entries/{entry_id}:increment' \

  -H 'x-api-key: {your-api-key}' \

  -H 'Content-Type: application/json' \

  --data '{

  "amount": "number"

}'
Phản Hồi
{

  "path": "universes/123/ordered-data-stores/some-ordered-data-store-id/scopes/some-ordered-data-store-scope-id/entries/some-ordered-data-store-entry-id",

  "value": "number",

  "id": "string"

}