Chạy các kịch bản Luau không có giao diện người dùng trong một địa điểm Roblox thông qua Open Cloud cho các bài kiểm tra tự động, cấu hình trò chơi và tạo thủ tục, với quyền truy cập đầy đủ vào DataModel và API Luau của động cơ. Các nhiệm vụ có thể chạy tối đa 5 phút, với giới hạn 10 nhiệm vụ đồng thời trên mỗi địa điểm. Bạn có thể lưu các thay đổi bằng cách sử dụng [`SavePlaceAsync`](/reference/engine/classes/AssetService#SavePlaceAsync), chuyển các tải trọng nhị phân lớn, và sử dụng [`SerializationService`](/reference/engine/classes/SerializationService) để giải mã nội dung RBXM. Để biết triển khai tham chiếu, xem [Roblox/place-ci-cd-demo](https://github.com/Roblox/place-ci-cd-demo) trên GitHub.

Quy trình làm việc:

1. [Tạo một nhiệm vụ](#Cloud_CreateLuauExecutionSessionTask__Using_Universes) với universeId, placeId và kịch bản Luau để chạy
2. Một máy chủ sẽ khởi chạy, tải địa điểm, và thực hiện mã của bạn
3. [Kiểm tra để hoàn tất](#Cloud_GetLuauExecutionSessionTask) và nhận các giá trị trả về của kịch bản và [nhật ký](#Cloud_ListLuauExecutionSessionTaskLogs)

Các trường hợp sử dụng phổ biến bao gồm:

- Kiểm tra tự động: Chạy các kịch bản kiểm tra trên các phiên bản địa điểm cụ thể như một phần của quy trình CI/CD
- Cấu hình trò chơi: Cập nhật giá cả, thống kê và biến cân bằng ngoài Studio


Đại diện cho một giá trị kiểu động có thể là null, một số, một chuỗi, một boolean, một giá trị cấu trúc đệ quy, hoặc một danh sách các giá trị.

Danh sách các LuauExecutionSessionTaskLogs trong bộ sưu tập cha.

Các LuauExecutionSessionTaskLogs từ
LuauExecutionSessionTask đã chỉ định.

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

Một `LuauExecutionSessionTask` (viết tắt là "tác vụ") thực thi một kịch bản Luau nhất định
trong bối cảnh của một phiên bản cụ thể của một địa điểm.

Trong một tác vụ, việc mô phỏng vật lý không được chạy. Các kịch bản trên máy chủ và cục bộ trong
tiến trình cũng không tự động chạy.

Kịch bản có thể truy cập và cập nhật mô hình dữ liệu của địa điểm, bao gồm
gọi bất kỳ kịch bản mô-đun nào. Tuy nhiên, các thay đổi mô hình dữ liệu chỉ có thể chữa khỏi cho
tác vụ và không thể được bảo tồn.

Kịch bản cũng có thể gọi các API của engine được sử dụng để đọc và/hoặc sửa đổi dữ liệu được lưu trữ trong
the cloud, như là những cái cho DataStores. Hãy cẩn thận khi sử dụng những
API này.

Kịch bản có thể có kích thước lên đến 4 MB và chạy tối đa 5 phút. Những kịch bản
chạy qua giáp tỷ lệ thời gian tối đa sẽ kết thúc với một lỗi.

Kịch bản được thực hiện chính xác và không cần phải được bọc trong một hàm.

Kịch bản có thể trả lại giá trị (sử dụng từ khóa Luau `return`). Các giá trị trả về
được tuần tự hóa thành JSON và có thể được truy xuất bằng API `Get
LuauExecutionSessionTask` sau khi tác vụ hoàn tất. Tổng kích thước của
các giá trị trả về sau khi tuần tự hóa JSON không được vượt quá 4 MB. Nếu quá giới hạn,
tác vụ sẽ kết thúc với một lỗi.

Nếu kịch bản gây ra một lỗi không xử lý, tác vụ sẽ kết thúc. Thông tin về lỗi
có thể được truy xuất bằng API `GetLuauExecutionSessionTask`.

Đầu ra tiêu chuẩn (được tạo ra bởi hàm Luau `print`) có thể được truy xuất
bằng phương pháp `ListLuauExecutionSessionTaskLogs` sau khi tác vụ hoàn tất.
Một tối đa 450 KB nhật ký được giữ lại. Nếu số lượng nhật ký vượt quá
giới hạn, các nhật ký cũ hơn sẽ bị loại bỏ.

Thông tin về một tác vụ được giữ trong 24 giờ sau khi tác vụ hoàn tất.

Tối đa mười tác vụ chưa hoàn tất được cho phép mỗi địa điểm. Cố gắng tạo ra nhiều tác vụ hơn
khi mười tác vụ đầu tiên chưa hoàn tất sẽ dẫn đến phản hồi HTTP 429.

Đường dẫn tài nguyên của đầu vào nhị phân cho tác vụ này. Xem tài liệu cho
tài nguyên `LuauExecutionSessionTaskBinaryInput` để biết chi tiết sử dụng.

URI cho đầu ra nhị phân của tác vụ này. Xem trường `enableBinaryOutput`
để biết chi tiết sử dụng.

Thời gian mà tác vụ này được tạo.

Nếu được đặt thành true, cho phép tác vụ xuất một đối tượng nhị phân lớn bên cạnh
các giá trị trả về tiêu chuẩn.

Nếu `enable_binary_output` được đặt là true, kịch bản tác vụ phải trả về
một `LuauExecutionTaskOutput` (hoặc bảng tương đương) và không cần giá trị trả về nào khác.

Dưới đây là mã ví dụ để thực hiện điều đó:

```luau
local buf: buffer = buffer.create(10)
local result: LuauExecutionTaskOutput = {
  BinaryOutput = buf,
  ReturnValues = { "hello world", 123 }
}
return result
```

Bộ đệm `BinaryOutput` không được lớn hơn 256 MiB.

Mảng `ReturnValues`, nếu được cung cấp, sẽ được tuần tự hóa thành JSON và được
cung cấp trong trường `output` của tài nguyên `LuauExecutionSessionTask`,
nó tương tự như các giá trị trả về thông thường khi không sử dụng `enable_binary_output`.

Đầu ra nhị phân có thể được truy xuất từ URI trong trường `binaryOutputUri`
sau khi tác vụ hoàn tất. `binaryOutputUri` sẽ hợp lệ trong vòng 15
phút sau khi hoàn thành tác vụ.

Đường dẫn tài nguyên của tác vụ phiên thực thi luau.

Các định dạng:
* `universes/{universe_id}/places/{place_id}/luau-execution-session-tasks/{luau_execution_session_task_id}`
* `universes/{universe_id}/places/{place_id}/versions/{place_version_id}/luau-execution-session-tasks/{luau_execution_session_task_id}`
* `universes/{universe_id}/places/{place_id}/luau-execution-sessions/{luau_execution_session_id}/tasks/{luau_execution_session_task_id}`
* `universes/{universe_id}/places/{place_id}/versions/{place_version_id}/luau-execution-sessions/{luau_execution_session_id}/tasks/{luau_execution_session_task_id}`

Kịch bản sẽ được thực thi như một phần của tác vụ này.

Ví dụ:

```luau
local x = 3
local y = 4
return x + y
```

Trạng thái của tác vụ. Xem enum State để biết thông tin về từng giá trị có thể.

Các giá trị có thể:

  | Giá trị | Mô tả |
  | --- | --- |
  | STATE_UNSPECIFIED | KHÔNG XÁC ĐỊNH |
  | QUEUED | Tác vụ đang chờ được xử lý. |
  | PROCESSING | Tác vụ đã được chọn để xử lý. |
  | CANCELLED | Tác vụ đã bị dừng bởi người dùng. |
  | COMPLETE | Tác vụ đã hoàn tất xử lý. Trường đầu ra chứa đầu ra. |
  | FAILED | Tác vụ thất bại. Trường lỗi chứa chi tiết về lỗi.

Giới hạn thời gian mà kịch bản có thể chạy.

Tác vụ sẽ thất bại nếu kịch bản không hoàn thành trong khoảng thời gian
dã chỉ định.

Mặc định là 5 phút.

Thời gian mà trạng thái của tác vụ này thay đổi lần cuối.

Người dùng đã tạo khóa API được sử dụng để tạo tác vụ này.

Biểu thị một đầu vào nhị phân lớn có thể được cung cấp cho
tác vụ `LuauExecutionSessionTask`.

Mỗi `LuauExecutionSessionTaskBinaryInput` được liên kết với một URL ký trước
có thể được sử dụng để tải lên một đối tượng tùy ý. Sau khi tải đối tượng, đường dẫn của
`LuauExecutionSessionTaskBinaryInput` có thể được truyền khi
tạo `LuauExecutionSessionTask` để làm cho đối tượng khả dụng cho tác vụ.

Trong tác vụ, nội dung của đối tượng sẽ được sử dụng trong một bảng
được truyền dưới dạng đối số đầu tiên cho kịch bản, với khóa `BinaryInput`. Ví dụ sau đây cho thấy cách để lấy dữ liệu:

```
local taskInput: LuauExecutionTaskInput = ({...})[1]
local buf: buffer = taskInput.BinaryInput
```

Mỗi `LuauExecutionSessionTaskBinaryInput` có hiệu lực trong 15 phút kể từ
thời gian tạo. Trong khoảng thời gian đó, nếu cần, bạn có thể sử dụng nó để tạo
nhiều tác vụ cho cùng một vũ trụ.

Đối tượng nhị phân đã tải lên không được lớn hơn 100 MiB.

Đường dẫn tài nguyên của đầu vào nhị phân của tác vụ thực thi luau.

Định dạng:
`universes/{universe_id}/luau-execution-session-task-binary-inputs/{luau_execution_session_task_binary_input_id}`

Kích thước của đối tượng đầu vào nhị phân sẽ được tải lên.

Kích thước tối đa được phép là 100 MiB.

Tải lên đối tượng đầu vào nhị phân bằng cách sử dụng URI này.

Biểu thị một phân đoạn của các thông điệp nhật ký được tạo ra bởi một
`LuauExecutionSessionTask`.

Số lượng nhật ký được giữ lại là có giới hạn. Xem tài liệu của
tài nguyên `LuauExecutionSessionTask` để biết thêm chi tiết.

Các nhật ký có thời gian giữ giống như tác vụ cha.

Danh sách các thông điệp nhật ký được tạo ra bởi việc thực thi tác vụ.
Mỗi lần gọi hàm Luau `print()` từ mã kịch bản của tác vụ
kết quả trong một mục danh sách duy nhất ở đây, ngay cả khi thông điệp đó chứa
các dòng mới. Trường này được điền khi View là FLAT (đây là giá trị
mặc định).

Đường dẫn tài nguyên của nhật ký tác vụ thực thi luau.

Các định dạng:
* `universes/{universe_id}/places/{place_id}/luau-execution-session-tasks/{luau_execution_session_task_id}/logs/{luau_execution_session_task_log_id}`
* `universes/{universe_id}/places/{place_id}/versions/{place_version_id}/luau-execution-session-tasks/{luau_execution_session_task_id}/logs/{luau_execution_session_task_log_id}`
* `universes/{universe_id}/places/{place_id}/luau-execution-sessions/{luau_execution_session_id}/tasks/{luau_execution_session_task_id}/logs/{luau_execution_session_task_log_id}`
* `universes/{universe_id}/places/{place_id}/versions/{place_version_id}/luau-execution-sessions/{luau_execution_session_id}/tasks/{luau_execution_session_task_id}/logs/{luau_execution_session_task_log_id}`

Danh sách các thông điệp nhật ký được tạo ra bởi việc thực thi tác vụ và các
siêu dữ liệu liên quan.
Mỗi lần gọi hàm Luau `print()` từ mã kịch bản của tác vụ
kết quả trong một mục danh sách duy nhất ở đây, ngay cả khi thông điệp đó chứa
các dòng mới. Trường này được điền khi View là STRUCTURED.

Một thông điệp nhật ký đơn lẻ cùng với siêu dữ liệu liên quan của nó.

Thời gian mà thông điệp nhật ký được tạo ra.

Loại `MessageType` của thông điệp nhật ký.

Các giá trị có thể:

  | Giá trị | Mô tả |
  | --- | --- |
  | MESSAGE_TYPE_UNSPECIFIED | KHÔNG XÁC ĐỊNH |
  | OUTPUT | Tương ứng với giá trị enum `MessageOutput` của API engine. |
  | INFO | Tương ứng với giá trị enum `MessageInfo` của API engine. |
  | WARNING | Tương ứng với giá trị enum `MessageWarning` của API engine. |
  | ERROR | Tương ứng với giá trị enum `MessageError` của API engine. |

Chứa thông tin lỗi trong trường hợp thực thi thất bại.

Mã lỗi cho biết loại lỗi.

Các giá trị có thể:

  | Giá trị | Mô tả |
  | --- | --- |
  | ERROR_CODE_UNSPECIFIED | KHÔNG XÁC ĐỊNH |
  | SCRIPT_ERROR | Kịch bản của tác vụ đã gây ra một lỗi không được xử lý. |
  | DEADLINE_EXCEEDED | Tác vụ đã vượt quá thời gian thực thi tối đa cho phép. |
  | OUTPUT_SIZE_LIMIT_EXCEEDED | Đầu ra của tác vụ quá lớn. |
  | INTERNAL_ERROR | Tác vụ thất bại do một lỗi hệ thống nội bộ. |

Một thông điệp lỗi chứa thêm thông tin về lỗi.

Chứa đầu ra của việc thực thi tác vụ.

Các giá trị trả về từ kịch bản đã chạy. Các giá trị trả về mà không thể
được tuần tự hóa thành JSON (chẳng hạn như các thể loại mô hình dữ liệu) sẽ được trả về dưới dạng
null.

Một khóa có thể cấu hình cho phép truy cập chi tiết đến các tài nguyên của Roblox. Xem https://create.roblox.com/docs/cloud/auth/api-keys để biết thêm thông tin.

x-api-key

Một cookie trình duyệt đại diện cho danh tính của người dùng Roblox. KHÔNG CHIA SẺ ĐIỀU NÀY. Việc chia sẻ này sẽ cho phép ai đó đăng nhập như bạn và đánh cắp Robux và vật phẩm của bạn. Chúng tôi không khuyên bạn nên sử dụng cookie để gọi các điểm cuối. Khi có thể, hãy sử dụng khóa API với tiêu đề x-api-key hoặc OAuth 2.0 thay vào đó để xác thực.

.ROBLOSECURITY

Xây dựng hoặc ủy quyền ứng dụng để truy cập tài nguyên Roblox. Xem https://create.roblox.com/docs/cloud/auth/oauth2-overview để biết thêm thông tin.

API Roblox. Xem https://create.roblox.com/docs/cloud/open-cloud để biết thêm chi tiết.

API Roblox

Tạo một `LuauExecutionSessionTaskBinaryInput` mới.

universe_id

Tạo Nhập Binary Công Việc Phiên Thực Thi Luau

LuauExecutionSessionTaskBinaryInput

universe.place.luau-execution-session:write

Tạo một tác vụ nhưng không đợi tác vụ hoàn thành.

Để kiểm tra liệu một tác vụ đã
hoàn thành hay chưa, hãy gọi phương thức `GetLuauExecutionSessionTask` và kiểm tra
trường `state` của tài nguyên được trả về.

Giới hạn:
* 5 cuộc gọi mỗi phút mỗi chủ sở hữu khóa API
* 45 cuộc gọi mỗi phút trên mỗi địa chỉ IP

place_id

LuauExecutionSessionTask

Tạo một nhiệm vụ nhưng không chờ nhiệm vụ hoàn thành.

Để kiểm tra xem một nhiệm vụ đã hoàn thành hay chưa,
hãy gọi phương thức `GetLuauExecutionSessionTask` và kiểm tra trường
`state` của tài nguyên trả về.

Giới hạn:
* 5 cuộc gọi mỗi phút cho mỗi chủ sở hữu khóa API
* 45 cuộc gọi mỗi phút cho mỗi địa chỉ IP

version_id

Tạo Nhiệm vụ Phiên Thực Thi Luau

Lấy thông tin về một nhiệm vụ.

Giới hạn:
* 45 cuộc gọi mỗi phút cho mỗi chủ sở hữu khóa API hoặc địa chỉ IP

luau_execution_session_id

task_id

Cái nhìn trong đó để lấy nhiệm vụ phiên thực thi luau.

Hỗ trợ BÁSIC và FULL.

Mặc định là BÁSIC.

Giá trị có thể:

  | Giá trị | Mô tả |
  | --- | --- |
  | VIEW_UNSPECIFIED | Chế độ xem nhiệm vụ phiên thực thi luau không được chỉ định; mặc định sẽ được sử dụng. |
  | BASIC | Không bao gồm trường `script`. |
  | FULL | Bao gồm tất cả các trường. |

view

Lấy Nhiệm vụ Phiên Thực Thi Luau

universe.place.luau-execution-session:read

Liệt kê các khối nhật ký do một `LuauExecutionSessionTask` tạo ra.

Giới hạn:
* 45 cuộc gọi mỗi phút cho mỗi chủ sở hữu khóa API hoặc địa chỉ IP

Số lượng tối đa nhật ký nhiệm vụ phiên thực thi luau để trả về. 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 10000
nhật ký nhiệm vụ phiên thực thi luau sẽ được trả về. Giá trị tối đa là 10000
và các giá trị lớn hơn được đặt thành 10000.

maxPageSize

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

Khi phân trang, tất cả các tham số khác được cung cấp cho cuộc gọi tiếp theo phải
trùng khớp với cuộc gọi đã cung cấp mã trang.

pageToken

Chế độ xem trong đó để lấy nhật ký nhiệm vụ phiên thực thi luau.

Hỗ trợ FLAT và STRUCTURED.

Mặc định là FLAT.

Giá trị có thể:

  | Giá trị | Mô tả |
  | --- | --- |
  | VIEW_UNSPECIFIED | Chế độ xem nhật ký nhiệm vụ phiên thực thi luau không được chỉ định; mặc định sẽ được sử dụng. |
  | FLAT | Nếu chế độ xem này được chọn, trường `messages` sẽ được phân bổ (và trường `structuredMessages` sẽ không). Mỗi mục trong mảng `messages` chỉ chứa thông điệp nhật ký, mà không có metadata bổ sung. Đây là mặc định. |
  | STRUCTURED | Nếu chế độ xem này được chọn, trường `structuredMessages` sẽ được phân bổ (và trường `messages` sẽ không). Mỗi mục trong mảng `structuredMessages` chứa thông điệp nhật ký cộng với metadata bổ sung (xem `LogMessage` để biết chi tiết). |

Danh sách Nhật ký Nhiệm vụ Phiên Thực Thi Luau

LuauExecutionSessionTaskLog

Luau Execution

Trải Nghiệm

Avatar

Tài Sản

Mẫu và dự án

API của công cụ

API đám mây nguồn mở

Studio

Phân Tích

Nền tảng

Hướng Dẫn

Chương trình của nhà sáng tạo

Giáo dục

Các khóa học

Học tập

Phương pháp này không đồng bộ và trả về một "Hoạt Động" cho biết trạng thái hiện tại của hoạt động. Phương pháp chứa một đường dẫn điểm cuối mà bạn có thể thăm dò để nhận về phản hồi thực tế và siêu dữ liệu hiện hành. Xem [tài liệu] ({longRunningOperationsLink}) về các hoạt động kéo dài để biết thêm thông tin.
            
Các phần dưới đây mô tả những phản hồi và siêu dữ liệu có được khi một hoạt động hoàn thành.

Các đầu cuối beta đã sẵn sàng cho việc sử dụng công khai. Có thể xuất hiện những thay đổi bất ngờ, nhưng trường hợp này rất hiếm.

Các trang tài liệu Open Cloud này sẽ bị gỡ bỏ vào ngày 31 tháng 3 năm 2026. Tại thời điểm đó, hệ thống sẽ tự động chuyển hướng bạn đến trang tài liệu Open Cloud mới. {linkStart}Tìm hiểu thêm{linkEnd}

Các trang Open Cloud cũ này sẽ bị gỡ bỏ và tự động chuyển hướng vào ngày 31 tháng 3 năm 2026. {linkStart}Tìm hiểu thêm{linkEnd}

Các điểm cuối thử nghiệm đã sẵn sàng để sử dụng công khai, nhưng đôi khi có thể gặp thay đổi gây mất tương thích khi hợp đồng API được hoàn thiện.

Có thể dùng khóa API để chạy lệnh gọi điểm cuối này thông qua {httpServiceLinkStart}HttpService{httpServiceLinkEnd}.

Trường này có thể được đặt khi tạo tài nguyên, nhưng không thể được sửa đổi bởi các yêu cầu tiếp theo.

Các trường này có thể được đặt khi tạo tài nguyên, nhưng không thể được sửa đổi bởi các yêu cầu tiếp theo.

Trường này có thể được cung cấp trong các yêu cầu, nhưng sẽ không bao giờ được đưa vào các phản hồi.

Phương thức xác thực cũ. Luôn ưu tiên sử dụng API Key hoặc OAuth 2.0 khi có thể.

Mỗi Khóa API: {maxInPeriod} yêu cầu mỗi {periodInSeconds} giây cho mỗi Địa Chỉ IP

Không yêu cầu xác thực khi gọi. Thông thường có giới hạn tần suất thấp hơn đáng kể. Luôn ưu tiên sử dụng API Key hoặc OAuth 2.0 khi có thể.

Với mỗi nhóm, chỉ cần cung cấp một trong các trường sau trong lược đồ, các trường còn lại có thể bỏ qua.

Bạn có thể chọn sử dụng lại bất cứ lúc nào. {linkStart}Gửi ý kiến phản hồi.{linkEnd}

Bạn đang xem tài liệu cũ. {linkStart}Gửi ý kiến phản hồi.{linkEnd}

Bạn có thể ngừng sử dụng bất cứ lúc nào và sẽ được chuyển hướng về các trang tham chiếu cũ. {linkStart}Gửi phản hồi.{linkEnd}

Bạn đang xem tài liệu đã được cải tiến. {linkStart}Gửi ý kiến phản hồi.{linkEnd}

Trường này có thể được đặt thành các phản hồi, nhưng sẽ bị bỏ qua trong các yêu cầu.

Lưu ý: Trong các giai đoạn cao điểm, giới hạn về tần suất có thể thấp hơn. Một số điểm cuối có giới hạn tần suất bổ sung. [Tìm hiểu thêm về giới hạn tần suất]({link}).

{limit} yêu cầu mỗi ngày cho tất cả khóa API của một người dùng hoặc nhóm

{limit} yêu cầu mỗi giờ cho tất cả khóa API của một người dùng hoặc nhóm

{limit} yêu cầu mỗi phút cho tất cả khóa API của một người dùng hoặc nhóm

{limit} yêu cầu mỗi giây cho tất cả khóa API của một người dùng hoặc nhóm

{limit} yêu cầu mỗi phút đối với mỗi người sở hữu khóa API

{limit} yêu cầu mỗi ngày cho mỗi người dùng ứng dụng

{limit} yêu cầu mỗi giờ cho mỗi người dùng ứng dụng

{limit} yêu cầu mỗi phút cho mỗi người dùng ứng dụng

{limit} yêu cầu mỗi giây cho mỗi người dùng ứng dụng

{limit} yêu cầu mỗi giây đối với mỗi người sở hữu khóa API

Các phạm vi sẽ kiểm soát những quyền được cấp cho thông tin đăng nhập của bạn. Bạn chỉ có thể sử dụng thông tin đăng nhập để truy cập các điểm cuối mà phạm vi bạn chọn có hỗ trợ.

Các điểm cuối ổn định đã sẵn sàng cho môi trường sản xuất và hầu như sẽ không gặp thay đổi gây mất tương thích trong suốt vòng đời của chúng.

Mục tiêu này cho phép bạn giới hạn quyền truy cập của khóa mã trong phạm vi {requiredParts} được chọn

Mục tiêu này cho phép bạn giới hạn quyền truy cập của khóa mã trong phạm vi {requiredParts} và {optionalParts} được chọn

Loại mục tiêu được dùng để giới hạn những tài nguyên mà bạn có quyền sử dụng theo thông tin đăng nhập của mình. Chỉ có thể thao tác với những tài nguyên được chọn, ngay cả khi tài khoản của bạn được phép sử dụng những tài nguyên khác. Một số phạm vi không áp dụng theo bộ phận mục tiêu. Trong trường hợp này, bạn có thể thao tác với mọi tài nguyên liên quan.

Không cần chọn Phần cấp cao nhất của vũ trụ cho các Khóa API do người dùng sở hữu. Trong trường hợp này, Khóa API của bạn sẽ có quyền truy cập vào tất cả các trải nghiệm do bạn sở hữu với tư cách người dùng và các trải nghiệm thuộc nhóm mà bạn có quyền nhóm tương ứng.

Tính năng Dùng thử chưa hỗ trợ các điểm cuối yêu cầu khóa API hoặc xác thực OAuth 2.0

Để đảm bảo an toàn, tính năng xác thực bằng cookie đã bị vô hiệu hóa cho các hoạt động có rủi ro cao.

Các điểm cuối có rủi ro nghiêm trọng là cực kỳ nhạy cảm và tính năng Dùng thử đã bị vô hiệu hóa để đảm bảo an toàn

Lưu ý: Các tiêu đề xác thực không có trong mẫu mã này. Bạn có thể cần thêm tiêu đề xác thực để lệnh này có hiệu lực.

Đây là một điểm cuối có rủi ro cao, có thể sửa đổi hoặc xóa dữ liệu quan trọng. Hãy hết sức thận trọng khi kiểm thử.

Điểm cuối API này được phân loại là RỦI RO CAO và có thể ảnh hưởng đến dữ liệu trực tiếp hoặc tài khoản người dùng.

Các yêu cầu đã xác thực đến API rủi ro cao có thể tạo ra những thay đổi không thể hoàn tác. Vui lòng xem xét kỹ các tham số yêu cầu của bạn trước khi tiếp tục.

Vui lòng đăng nhập để sử dụng xác thực cookie

Đây là một điểm cuối có rủi ro thấp dùng để truy xuất dữ liệu, nhìn chung là an toàn để kiểm thử.

Đây là điểm cuối có rủi ro trung bình dùng để sửa đổi dữ liệu. Hãy kiểm thử cẩn thận bằng các tài khoản không quan trọng, vì các thay đổi có thể được áp dụng vĩnh viễn.

Để đảm bảo an toàn cho tài khoản của bạn, tuyệt đối không dán văn bản từ các nguồn khác vào đây hoặc gửi thông tin từ trang này cho người khác.

Bạn sắp kiểm thử các điểm cuối API trực tiếp bằng thông tin xác thực tài khoản thực của mình.

Hãy chỉ tiếp tục nếu bạn hiểu rõ hệ quả của những lệnh gọi API mà bạn sắp thực hiện. Đừng quên xem kỹ tài liệu API trước khi kiểm thử.

Các lệnh gọi API sẽ được thực hiện bằng phiên đã xác thực của bạn

Đây là các lệnh gọi API thực có thể ảnh hưởng đến tài khoản hoặc dữ liệu của bạn

Giới hạn tốc độ và các hạn chế khác về API sẽ được áp dụng

Một số thao tác có thể khiến dữ liệu bị sửa đổi hoặc xóa

Điểm cuối này đã được thay thế bằng các đề xuất sau:

Cần có các phạm vi sau để gọi điểm cuối này. Để biết thêm
thông tin về cách tạo khóa thích hợp, hãy xem [Quản lý khóa API]({apiKeyReferenceDocLink}).

Để biết thêm thông tin về cách tạo khóa, hãy xem [Quản lý khóa API]({apiKeyReferenceDocLink}).

Các điểm cuối sau đây có trong đường dẫn liên quan đến URL cơ sở.

Chuỗi này được định dạng là [Mặt nạ trường](/cloud/reference/types#timestamp).

Giá trị JSON có thể là `null`, `boolean`, `string`, `number`, `array` hoặc `object`.

Cần có các phạm vi sau đây để ứng dụng OAuth 2.0 của bạn sử dụng điểm cuối này. Để biết thêm thông tin về cách đăng ký ứng dụng OAuth 2.0, hãy xem [Đăng ký và đánh giá ứng dụng]({oauth2ReferenceDocLink}).

Để biết thêm thông tin về cách đăng ký ứng dụng OAuth 2.0, hãy xem [Đăng ký và xem xét ứng dụng]({oauth2ReferenceDocLink}).

Các đối tượng sau đây mô tả payload được chấp nhận hoặc bị trả về. Xem từng điểm cuối để biết thêm thông tin về thời điểm sử dụng các đối tượng này.

Cần có các phạm vi sau để gọi điểm cuối này.

Đường dẫn của tài nguyên

Chuỗi này được định dạng là [Dấu thời gian](/cloud/reference/types#timestamp).

Cần có các phạm vi sau đây để ứng dụng OAuth 2.0 của bạn sử dụng điểm cuối này. Để biết thêm thông tin về cách đăng ký ứng dụng OAuth 2.0, hãy xem [Đăng Ký và Đánh Giá Ứng Dụng]({oauth2ReferenceDocLink}).

Không khuyến khích

Bạn đang xem tài liệu tham khảo Open Cloud phiên bản mới.

Bạn đã chọn không sử dụng tài liệu tham khảo Open Cloud mới.

Không có mô tả nào được cung cấp.

Xem tài khoản chi trả quảng cáo của bạn.

Xem chiến dịch quảng cáo của bạn và hiệu suất của các chiến dịch đó.

Tạo, cập nhật và quản lý chiến dịch quảng cáo của bạn.

Điều này cho phép bạn xem thông tin về tài sản của mình.

Điều này cho phép bạn tải lên và cập nhật tài sản vào Roblox.

Quyền này cho phép xem quyền đối với tài sản cho các chủ thể (bao gồm nhóm và trải nghiệm) cũng như các tài sản mà tài khoản của bạn có quyền truy cập.

Điều này giúp bạn có thể cấp quyền đối với tài sản cho bất kỳ chủ thể nào (bao gồm nhóm và trải nghiệm) để sử dụng những tài sản mà tài khoản của bạn đang quản lý.

Quyền này cho phép bạn xem trạng thái và kết quả của các tác vụ tự động thiết lập avatar thay mặt cho bạn.

Quyền này cho phép bạn tạo và quản lý các tác vụ tự động thiết lập avatar thay mặt cho bạn.

Cấp khả năng cập nhật huy hiệu mà người dùng sở hữu.

Điều này cho phép bạn xem thông tin về vật phẩm thương mại của mình.

Thao tác này cho phép thay đổi các vật phẩm thương mại đã đồng bộ của bạn.

Việc này cho phép xem thông tin về người quen là người bán thương mại của bạn.

Điều này cho phép bạn chỉnh sửa các kết nối người bán thương mại.

Điều này cho phép bạn xem thông tin về các sản phẩm trong Cửa Hàng Nhà Sáng Tạo của bạn.

Điều này cho phép bạn sửa đổi thông tin về các sản phẩm trong Cửa Hàng Nhà Sáng Tạo của bạn.

Điều này cho phép bạn xem thông tin về các mục đã lưu trong Cửa hàng nhà sáng tạo của mình.

Điều này cho phép bạn sửa đổi thông tin về các mục đã lưu trong Cửa hàng nhà sáng tạo của mình.

Cấp quyền tạo kho dữ liệu thay mặt cho bạn.

Hãy cấp quyền xóa các kho dữ liệu thay mặt cho bạn.

Cấp quyền đọc danh sách kho dữ liệu.

Cấp quyền tạo ảnh chụp nhanh cho các kho dữ liệu của bạn.

Cấp quyền tạo mục trong kho dữ liệu của bạn.

Cấp quyền đánh dấu mục được chỉ định để xóa.

Cấp quyền liệt kê các bản sửa đổi bản ghi trong kho dữ liệu của bạn.

Cấp quyền đọc mục được chỉ định trong kho dữ liệu của bạn.

Cấp quyền cập nhật giá trị, thuộc tính và người dùng của một mục nhập.

Cấp quyền xóa các bản sửa đổi bản ghi trong kho dữ liệu của bạn.

Cấp quyền đọc các bản sửa đổi bản ghi trong kho dữ liệu của bạn.

Cấp quyền truy cập để xem chi tiết cấu hình cho các sản phẩm nhà phát triển của người dùng được ủy quyền.

Cấp quyền chỉnh sửa các sản phẩm nhà phát triển của người dùng được ủy quyền.

Tính năng này cho phép xem thông tin về môi trường trong vũ trụ của bạn.

Tính năng này cho phép chỉnh sửa môi trường trong vũ trụ của bạn.

Cấp quyền xem chi tiết cấu hình cho các vé trò chơi của người dùng được ủy quyền.

Cấp quyền chỉnh sửa vé trò chơi của người dùng được ủy quyền.

Hãy cấp quyền truy cập để xem thông tin trên diễn đàn cộng đồng của tài khoản bạn.

Cấp quyền truy cập để quản lý thông tin trên diễn đàn cộng đồng cho tài khoản của bạn.

Điều này cho phép bạn xem thông tin về cộng đồng của mình.

Điều này cho phép bạn quản lý các yêu cầu tham gia cộng đồng và cập nhật vai trò của thành viên cộng đồng bậc thấp cho tài khoản của bạn.

Cho phép bạn xem dữ liệu thuộc tính của một trường hợp.

Cho phép bạn sửa đổi dữ liệu thuộc tính của các đối tượng (hiện chỉ hỗ trợ Tập lệnh).

Điều này cho phép bạn xem thông tin về kho của mình.

Cấp quyền quản lý tài sản của người dùng.

Cấp quyền truy cập để quản lý huy hiệu của bạn.

Cấp quyền để quản lý huy hiệu của bạn và chi tiêu robux.

Cấp quyền cập nhật huy hiệu của người dùng được ủy quyền.

Cấp quyền quản lý các sản phẩm phát triển của bạn.

Cho phép truy cập để đọc thông tin về các trải nghiệm mà bạn đã bật thông báo.

Cho phép thay mặt bạn bật hoặc tắt thông báo cho trải nghiệm.

Cấp quyền truy cập để quản lý vé của bạn.

Cấp quyền truy cập để quản lý các cộng đồng của bạn.

Cấp quyền để đọc thông tin cộng đồng.

Cấp quyền để đọc và ghi các bảng bản địa hóa của bạn

Cấp quyền truy cập để quản lý hoạt động cộng tác đội cho tất cả các trải nghiệm của bạn.

Cấp quyền truy cập để quản lý các trải nghiệm của bạn và một số thông tin cụ thể gắn liền với các trải nghiệm đó (ví dụ: thông tin bản địa hóa).

Cấp quyền để đọc thông tin bản địa hóa của các trải nghiệm của bạn.

Cấp quyền để sửa đổi các tùy chọn bản địa hóa trải nghiệm của bạn.

Cấp quyền truy cập để quản lý tài khoản người dùng của bạn.

Cấp quyền để sửa đổi các tùy chọn bản địa hóa của người dùng.

Cho phép bạn xem trạng thái, nhật ký và kết quả của các tác vụ thực thi Luau cho địa điểm được liên kết.

Cho phép bạn tạo các tác vụ thực thi Luau mới cho địa điểm được liên kết.

Cấp quyền xóa không đồng bộ tất cả các cấu trúc dữ liệu trong vũ trụ.

Cấp quyền tạo mục mới trong hàng chờ.

Cấp quyền loại bỏ các mục đã đọc khỏi đầu hàng chờ.

Cấp quyền đọc các mục ở đầu hàng chờ.

Cấp quyền đọc các mục trong kho lưu trữ bộ nhớ của bạn.

Cấp quyền đọc các mục trên bản đồ.

Cấp quyền tạo, cập nhật và xóa các mục trên bản đồ.

Điều này cho phép bạn đăng tải tin nhắn thay mặt cho người dùng.

Điều này cho phép gửi các thông báo từ trải nghiệm của bạn đến người dùng.

(Lỗi thời) Cấp quyền đọc danh sách các mục trong một kho dữ liệu đã sắp xếp.

(Lỗi thời) Cấp quyền tạo một mục mới trong kho dữ liệu đã sắp xếp.

Cấp quyền liệt kê các mục từ một kho dữ liệu đã sắp xếp.

Cấp quyền tạo các mục trong một kho dữ liệu đã sắp xếp.

Điều này cho phép bạn liệt kê mã liên quan đến trải nghiệm của bạn.

Điều này cho phép bạn tạo và cập nhật mã liên quan đến trải nghiệm của bạn.

Quyền này cho phép bạn gửi một tác vụ đánh giá và xem kết quả của tác vụ.

Cấp quyền để đọc về các trang bị đặc quyền của bạn.

Quyền này cho phép bạn đọc thông tin hình nhỏ thay mặt cho bạn.

Cấp quyền đọc dữ liệu phân tích trò chơi.

Cấp khả năng đọc thông tin địa điểm.

Cấp khả năng chỉnh sửa thông tin địa điểm.

Cấp quyền đăng phiên bản mới của trải nghiệm lên Roblox.

Cấp khả năng đọc thông tin trải nghiệm.

Cấp quyền chỉnh sửa trải nghiệm của người dùng được ủy quyền.

Cho phép bạn xem các hạn chế của người dùng trong trải nghiệm.

Cho phép bạn chỉnh sửa các hạn chế người dùng trong trải nghiệm.

Quyền này cho phép xem các thông báo được gửi đến tài khoản của bạn.

Cho phép đọc trạng thái premium và trạng thái đã xác thực của người dùng được ủy quyền.

Quyền này cho phép bạn xem các tài khoản xã hội của người dùng được ủy quyền.

Điều này cho phép kích hoạt chức năng Đăng Nhập Một Lần.

Điều này cho phép người dùng đọc thông tin hồ sơ của bạn.

Luau Execution

Places