รันสคริปต์ Luau แบบไม่มีหัวในสถานที่ Roblox ผ่าน Open Cloud สำหรับการทดสอบอัตโนมัติ, การกำหนดค่าเกม, และการสร้างเชิงพาณิชย์, พร้อมการเข้าถึง API ของ DataModel และเครื่องยนต์ Luau อย่างเต็มที่. งานสามารถรันได้สูงสุด 5 นาที, โดยมีข้อจำกัด 10 งานพร้อมกันต่อสถานที่. คุณสามารถบันทึกการเปลี่ยนแปลงโดยใช้ [`SavePlaceAsync`](/reference/engine/classes/AssetService#SavePlaceAsync), ส่งข้อมูลไบนารีขนาดใหญ่, และใช้ [`SerializationService`](/reference/engine/classes/SerializationService) เพื่อถอดรหัสเนื้อหา RBXM. สำหรับการใช้งานอ้างอิง, ดู [Roblox/place-ci-cd-demo](https://github.com/Roblox/place-ci-cd-demo) บน GitHub.

การทำงาน:

1. [สร้างงาน](#Cloud_CreateLuauExecutionSessionTask__Using_Universes) โดยใช้ universeId, placeId, และสคริปต์ Luau ที่จะรัน
2. เซิร์ฟเวอร์จะเริ่มต้น, โหลดสถานที่, และรันโค้ดของคุณ
3. [ตรวจสอบความสำเร็จ](#Cloud_GetLuauExecutionSessionTask) และรับค่าที่ส่งกลับของสคริปต์และ [บันทึก](#Cloud_ListLuauExecutionSessionTaskLogs)

กรณีการใช้งานทั่วไป ได้แก่:

- การทดสอบอัตโนมัติ: รันสคริปต์ทดสอบกับเวอร์ชันสถานที่เฉพาะในกระบวนการ CI/CD
- การกำหนดค่าเกม: อัปเดตราคาสถิติและตัวแปรการปรับสมดุลนอกสตูดิโอ


แสดงค่าที่มีประเภทไดนามิกซึ่งสามารถเป็นได้ทั้ง null, ตัวเลข, สตริง, บูลีน, ค่าที่ซ้ำซ้อน หรือรายการของค่า.

รายการของ LuauExecutionSessionTaskLogs ในคอลเลกชันหลัก.

บันทึกของ LuauExecutionSessionTaskLogs จาก LuauExecutionSessionTask ที่ระบุ.

โทเค็นที่คุณสามารถส่งเป็นพารามิเตอร์ `pageToken` เพื่อดึงข้อมูลหน้าถัดไป.
หากไม่ได้ฟิลด์นี้ จะไม่มีหน้าถัดไป.

งาน `LuauExecutionSessionTask` ("task" สำหรับสั้น) ดำเนินการสคริปต์ Luau ที่กำหนด
ในบริบทของเวอร์ชันเฉพาะของสถานที่.

ในงาน การจำลองฟิสิกส์จะไม่ทำงาน. สคริปต์เซิร์ฟเวอร์และท้องถิ่นภายใน
สถานที่ก็จะไม่ทำงานโดยอัตโนมัติ.

สคริปต์อาจเข้าถึงและอัปเดตแบบจำลองข้อมูลของสถานที่รวมถึง
การเรียกใช้สคริปต์โมดูลใดๆ อย่างไรก็ตาม การเปลี่ยนแปลงในแบบจำลองข้อมูลจะอยู่ในระดับท้องถิ่น
ของงานและไม่สามารถเก็บถาวรได้.

สคริปต์สามารถเรียกใช้ API ของเครื่องยนต์ที่อ่านและ/หรือแก้ไขข้อมูลที่จัดเก็บใน
คลาวด์ เช่น API สำหรับ DataStores ต้องระมัดระวังเมื่อใช้
API เหล่านี้.

สคริปต์สามารถมีขนาดสูงสุด 4 MB และใช้เวลาทำงานสูงสุด 5 นาที. หากสคริปต์ทำงานนานกว่าขีดจำกัดเวลาจะสิ้นสุดลงด้วยข้อผิดพลาด.

สคริปต์จะถูกรันดังที่เป็นและไม่จำเป็นต้องห่อหุ้มในฟังก์ชัน.

สคริปต์สามารถส่งค่ากลับ (ใช้คีย์เวิร์ด Luau `return`). ค่าที่ส่งกลับ
จะถูกจัดรูปแบบเป็น JSON และสามารถเข้าถึงได้ด้วย API `Get
LuauExecutionSessionTask` หลังจากเสร็จสิ้นการทำงาน. ขนาดรวมของค่าที่ส่งกลับหลังจากการจัดรูปแบบเป็น JSON ไม่ควรเกิน 4 MB. หากเกินขีดจำกัด งานจะสิ้นสุดด้วยข้อผิดพลาด.

หากสคริปต์เกิดข้อผิดพลาดที่ไม่ได้จัดการ งานจะสิ้นสุด. ข้อมูลข้อผิดพลาดสามารถดึงข้อมูลได้ด้วย API `GetLuauExecutionSessionTask`.

ผลผลิตมาตรฐาน (ที่สร้างโดยฟังก์ชัน Luau `print`) สามารถดึงข้อมูลได้
ด้วยวิธีการ `ListLuauExecutionSessionTaskLogs` หลังจากการทำงานเสร็จสิ้น.
บันทึกสูงสุด 450 KB จะถูกเก็บรักษาไว้. หากปริมาณบันทึกเกินขีดจำกัด บันทึกเก่าๆ จะถูกทิ้ง.

ข้อมูลเกี่ยวกับงานจะถูกเก็บรักษาเป็นเวลา 24 ชั่วโมงหลังจากการทำงานเสร็จสิ้น.

สูงสุดสิบงานที่ไม่สมบูรณ์จะได้รับอนุญาตต่อสถานที่. การพยายามสร้างงานมากกว่าสิบงานในขณะที่งานแรกสิบงานยังไม่เสร็จสิ้นจะส่งผลให้มีการตอบสนอง HTTP 429.

เส้นทางทรัพยากรของข้อมูลไบนารีที่ส่งเข้ามาในงานนี้. ดูเอกสารสำหรับ
`LuauExecutionSessionTaskBinaryInput` สำหรับรายละเอียดการใช้งาน.

URI สำหรับการส่งออกไบนารีของงานนี้. ดูฟิลด์ `enableBinaryOutput`
สำหรับรายละเอียดการใช้งาน.

เวลาที่งานนี้ถูกสร้างขึ้น.

หากถูกตั้งค่าเป็นจริง จะอนุญาตให้งานสร้างผลลัพธ์ไบนารีขนาดใหญ่
นอกเหนือจากค่าผลลัพธ์แบบมาตรฐาน.

หาก `enable_binary_output` ถูกตั้งค่าเป็นจริง สคริปต์งานจะต้องส่งคืนชิ้นส่วน
`LuauExecutionTaskOutput` (หรือเทียบเท่า) และไม่มีค่าผลลัพธ์อื่นๆ.

ด้านล่างนี้คือโค้ดตัวอย่างสำหรับการทำเช่นนั้น:

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

บัฟเฟอร์ `BinaryOutput` จะต้องมีขนาดไม่เกิน 256 MiB.

อาร์เรย์ `ReturnValues` หากให้จะถูกจัดรูปแบบเป็น JSON และทำให้สามารถเข้าถึงได้ใน
ฟิลด์ `output` ของทรัพยากร `LuauExecutionSessionTask` ซึ่งคล้ายกับค่าผลลัพธ์ทั่วไปเมื่อไม่ใช้
`enable_binary_output`.

การส่งออกไบนารีสามารถดึงข้อมูลจาก URI ในฟิลด์ `binaryOutputUri`
หลังจากเสร็จสิ้นการทำงาน งานเมื่อเสร็จสิ้นแล้ว `binaryOutputUri` จะมีอายุ 15
นาที.

เส้นทางของทรัพยากรของงานเซสชันการดำเนินการ luau.

รูปแบบ:
* `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}`

สคริปต์ที่จะทำในส่วนของงานนี้.

ตัวอย่าง:

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

สถานะของงาน. ดู enum State เพื่อดูข้อมูลเกี่ยวกับแต่ละค่าสำหรับสถานะ.

ค่าสามารถเป็นได้:

  | ค่า | คำอธิบาย |
  | --- | --- |
  | STATE_UNSPECIFIED | ไม่ระบุ |
  | QUEUED | งานกำลังรอการประมวลผล. |
  | PROCESSING | งานถูกหยิบขึ้นมาเพื่อการประมวลผล. |
  | CANCELLED | งานถูกหยุดโดยผู้ใช้. |
  | COMPLETE | งานเสร็จสิ้นการประมวลผล. ฟิลด์ผลลัพธ์จะประกอบด้วยผลลัพธ์. |
  | FAILED | งานล้มเหลว. ฟิลด์ข้อผิดพลาดประกอบด้วยรายละเอียดเกี่ยวกับข้อผิดพลาด.

ขีดจำกัดสำหรับระยะเวลาที่สคริปต์ทำงาน.

งานจะล้มเหลวหากสคริปต์ไม่เสร็จสมบูรณ์ภายในระยะเวลาที่กำหนด.

ค่าปริยายคือ 5 นาที.

เวลาที่สถานะของงานนี้มีการเปลี่ยนแปลงเป็นครั้งแรก.

ผู้ใช้ซึ่งสร้างคีย์ API ที่ใช้ในการสร้างงานนี้.

แสดงถึงข้อมูลไบนารีขนาดใหญ่ที่สามารถมอบให้กับ
`LuauExecutionSessionTask`.

แต่ละ `LuauExecutionSessionTaskBinaryInput` จะถูกเชื่อมโยงกับ URL ที่ได้รับการลงนามล่วงหน้า
ซึ่งสามารถใช้ในการอัปโหลดออบเจ็กต์ใดๆ หลังจากอัปโหลดออบเจ็กต์แล้ว,
เส้นทางของ `LuauExecutionSessionTaskBinaryInput` สามารถผ่านไปได้เมื่อสร้าง
`LuauExecutionSessionTask` เพื่อให้วัตถุสามารถเข้าถึงได้ในงาน.

ภายในงาน เนื้อหาของวัตถุจะมีให้ในตารางที่ส่งผ่านเป็นอาร์กิวเมนต์แรกให้กับสคริปต์,
โดยใช้คีย์ `BinaryInput`. ตัวอย่างต่อไปนี้จะแสดงถึงวิธีการดึงข้อมูล:

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

แต่ละ `LuauExecutionSessionTaskBinaryInput` มีอายุ 15 นาทีจากเวลาที่สร้าง.
ภายในเวลานั้น หากต้องการคุณสามารถใช้มันเพื่อสร้าง
งานหลายงานสำหรับจักรวาลเดียวกัน.

ออบเจ็กต์ข้อมูลไบนารีที่อัปโหลดจะต้องมีขนาดไม่เกิน 100 MiB.

เส้นทางทรัพยากรของข้อมูลไบนารีที่ส่งเข้ามาในงานเซสชันการดำเนินการ luau.

รูปแบบ:
`universes/{universe_id}/luau-execution-session-task-binary-inputs/{luau_execution_session_task_binary_input_id}`

ขนาดของออบเจ็กต์ข้อมูลไบนารีที่จะอัปโหลด.

ขนาดสูงสุดที่อนุญาตคือ 100 MiB.

อัปโหลดออบเจ็กต์ข้อมูลไบนารีนี้โดยใช้ URI นี้.

แสดงถึงชุดข้อความบันทึกที่สร้างขึ้นโดย
`LuauExecutionSessionTask`.

จำนวนบันทึกที่เก็บรักษาไว้ถูกจำกัด. ดูเอกสารของทรัพยากร
`LuauExecutionSessionTask` สำหรับรายละเอียดเพิ่มเติม.

บันทึกมีเวลาการเก็บรักษาเดียวกับงานหลัก.

รายการของข้อความบันทึกที่สร้างขึ้นโดยการดำเนินการของงาน.
แต่ละการเรียกใช้ฟังก์ชัน Luau `print()` จากรหัสของสคริปต์งานจะ
สร้างไอเท็มรายการเดียวที่นี่แม้ว่าข้อความจะมีขึ้นบรรทัดใหม่. ฟิลด์นี้จะถูกเติมเมื่อมุมมองเป็น FLAT (ซึ่งเป็นค่าเริ่มต้น).

เส้นทางทรัพยากรของบันทึกงานเซสชันการดำเนินการ luau.

รูปแบบ:
* `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}`

รายการของข้อความบันทึกที่สร้างขึ้นโดยการดำเนินการของงานและ
เมตาดาต้าเก่า.
แต่ละการเรียกใช้ฟังก์ชัน Luau `print()` จากรหัสของสคริปต์งานจะ
สร้างไอเท็มรายการเดียวที่นี่แม้ว่าข้อความจะมีขึ้นบรรทัดใหม่. ฟิลด์นี้จะถูกเติมเมื่อมุมมองเป็น STRUCTURED.

ข้อความบันทึกหนึ่งข้อความพร้อมกับเมตาดาต้าเกี่ยวข้องของมัน

เวลาที่ข้อความบันทึกถูกสร้างขึ้น

ประเภท `MessageType` ของข้อความบันทึก.

ค่าสามารถเป็นได้:

  | ค่า | คำอธิบาย |
  | --- | --- |
  | MESSAGE_TYPE_UNSPECIFIED | ไม่ระบุ |
  | OUTPUT | ตรงกับค่า `MessageOutput` enum ของ API เครื่องยนต์. |
  | INFO | ตรงกับค่า `MessageInfo` enum ของ API เครื่องยนต์. |
  | WARNING | ตรงกับค่า `MessageWarning` enum ของ API เครื่องยนต์. |
  | ERROR | ตรงกับค่า `MessageError` enum ของ API เครื่องยนต์.

มีรายละเอียดของข้อผิดพลาดในกรณีที่การดำเนินการล้มเหลว.

รหัสข้อผิดพลาดที่บ่งบอกประเภทของข้อผิดพลาด.

ค่าสามารถเป็นได้:

  | ค่า | คำอธิบาย |
  | --- | --- |
  | ERROR_CODE_UNSPECIFIED | ไม่ระบุ |
  | SCRIPT_ERROR | สคริปต์ของงานเกิดขึ้นความผิดพลาดที่ไม่จัดการ. |
  | DEADLINE_EXCEEDED | งานเกินระยะเวลาการดำเนินงานสูงสุดที่อนุญาต. |
  | OUTPUT_SIZE_LIMIT_EXCEEDED | ผลลัพธ์ของงานมีขนาดใหญ่เกินไป. |
  | INTERNAL_ERROR | งานล้มเหลวเนื่องจากข้อผิดพลาดภายในระบบ.

ข้อความข้อผิดพลาดที่มีรายละเอียดเพิ่มเติมเกี่ยวกับข้อผิดพลาด.

มีผลลัพธ์ของการดำเนินการของงาน.

ค่าที่ส่งกลับจากสคริปต์ที่ถูกเรียกใช้งาน. ค่าที่ส่งกลับที่ไม่สามารถแปลงเป็น
JSON (เช่น อ็อบเจ็กต์โมเดลข้อมูล) จะถูกส่งกลับเป็น null.

คีย์ที่ตั้งค่าได้ที่อนุญาตให้เข้าถึงทรัพยากร Roblox ได้อย่างละเอียด ดู https://create.roblox.com/docs/cloud/auth/api-keys สำหรับข้อมูลเพิ่มเติม

x-api-key

คุกกี้ของเบราว์เซอร์ที่แสดงถึงตัวตนของผู้ใช้ Roblox ห้ามแชร์สิ่งนี้ การแชร์จะให้คนอื่นล็อกอินเป็นผู้ใช้และขโมย Robux และไอเท็มของคุณ เราไม่แนะนำให้ใช้คุกกี้ในการเรียกใช้ Endpoint เมื่อใดก็ตามที่เป็นไปได้ ให้ใช้คีย์ API ที่มีหัวข้อ x-api-key หรือ OAuth 2.0 แทนสำหรับการตรวจสอบตัวตน

.ROBLOSECURITY

สร้างหรืออนุญาตแอปเพื่อเข้าถึงทรัพยากร Roblox ดู https://create.roblox.com/docs/cloud/auth/oauth2-overview สำหรับข้อมูลเพิ่มเติม

API ของ Roblox ดูรายละเอียดเพิ่มเติมได้ที่ https://create.roblox.com/docs/cloud/open-cloud

Roblox API

สร้าง `LuauExecutionSessionTaskBinaryInput` ใหม่.

universe_id

สร้างอาร์กิวเมนต์ชุดการดำเนินการของ Luau

LuauExecutionSessionTaskBinaryInput

universe.place.luau-execution-session:write

สร้างงานแต่ไม่รอให้งานเสร็จสิ้น

เพื่อตรวจสอบว่างานเสร็จสิ้นหรือไม่
ให้เรียกใช้วิธี `GetLuauExecutionSessionTask` และตรวจสอบ
ฟิลด์ `state` ของทรัพยากรที่ส่งคืน

ขีดจำกัด:
* 5 การโทรต่อนาทีต่อเจ้าของกุญแจ API
* 45 การโทรต่อนาทีต่อที่อยู่ IP

place_id

สร้างงานการดำเนินการ Luau

LuauExecutionSessionTask

Creates a task but does not wait for the task to complete.

To check whether a task has
completed, call the `GetLuauExecutionSessionTask` method and inspect the
`state` field of the returned resource.

Quotas:
* 5 calls per minute per API key owner
* 45 calls per minute per IP address

version_id

Gets information about a task.

Quotas:
* 45 calls per minute per API key owner or IP address

luau_execution_session_id

task_id

The view in which to retrieve the luau execution session task.

Supports BASIC and FULL.

Defaults to BASIC.

Possible values:

  | Value | Description |
  | --- | --- |
  | VIEW_UNSPECIFIED | The luau execution session task view is not specified; the default will be used. |
  | BASIC | Excludes the `script` field. |
  | FULL | Includes all fields. |

view

universe.place.luau-execution-session:read

Lists log chunks generated by a `LuauExecutionSessionTask`.

Quotas:
* 45 calls per minute per API key owner or IP address

The maximum number of luau execution session task logs to return. The
service might return fewer than this value. If unspecified, at most 10000
luau execution session task logs are returned. The maximum value is 10000
and higher values are set to 10000.

maxPageSize

A page token, received from a previous call, to retrieve a subsequent page.

When paginating, all other parameters provided to the subsequent call must
match the call that provided the page token.

pageToken

The view in which to retrieve the luau execution session task log.

Supports FLAT and STRUCTURED.

Defaults to FLAT.

Possible values:

  | Value | Description |
  | --- | --- |
  | VIEW_UNSPECIFIED | The luau execution session task log view is not specified; the default will be used. |
  | FLAT | If this view is selected, the `messages` field will be populated (and the `structuredMessages` field will not). Each entry of the `messages` array contains only the log message, without additional medata. This is the default. |
  | STRUCTURED | If this view is selected, the `structuredMessages` field will be populated (and the `messages` field will not). Each entry of the `structuredMessages` array contains the log message plus additional metadata (see `LogMessage` for details). |

LuauExecutionSessionTaskLog

Luau Execution

ประสบการณ์

อวาตาร์

ทรัพยากร

ตัวอย่างและโปรเจ็กต์

Engine API

Open Cloud API

Studio

การวิเคราะห์

แพลตฟอร์ม

คู่มือการใช้งาน

โปรแกรมสำหรับครีเอเตอร์

การศึกษา

หลักสูตร

เรียนรู้

การยืนยันตัวตนด้วยคีย์ API

วิธีนี้ไม่ได้ทำพร้อมกันและส่งคืน `Operation` ซึ่งแสดงสถานะปัจจุบันของการดำเนินการและมีเส้นทาง Endpoint ที่คุณใช้สำรวจความคิดเห็นได้ เพื่อเช็คการตอบสนองจริงและข้อมูลเมตาที่เกี่ยวข้อง หากต้องการข้อมูลเพิ่มเติม โปรดดู[เอกสาร]({longRunningOperationsLink})เกี่ยวกับการดำเนินการที่ใช้เวลานาน
            
ส่วนต่อไปนี้จะอธิบายการตอบสนองและวัตถุข้อมูลเมตาที่จะได้รับเมื่อดำเนินการเสร็จสิ้น

Endpoint เวอร์ชัน Beta พร้อมสำหรับการใช้งานทั่วไปแล้ว อาจมีการเปลี่ยนแปลงที่ทำให้ใช้งานไม่ได้ แต่ก็เป็นไปได้ยาก

หน้าเอกสาร Open Cloud เหล่านี้จะถูกลบออกในวันที่ 31 มีนาคม 2026 คุณจะถูกเปลี่ยนเส้นทางไปยังเอกสาร Open Cloud ใหม่โดยอัตโนมัติตั้งแต่วันดังกล่าว {linkStart}เรียนรู้เพิ่มเติม{linkEnd}

หน้า Open Cloud เก่าเหล่านี้จะถูกลบออกและเปลี่ยนเส้นทางในวันที่ 31 มีนาคม 2026 {linkStart}เรียนรู้เพิ่มเติม{linkEnd}

Endpoints รุ่นทดลองพร้อมให้ใช้งานสาธารณะแล้ว แต่บางครั้งอาจมีการเปลี่ยนแปลงที่ทำให้ใช้งานไม่ได้ เนื่องจากมีการกำหนดสัญญา API ไว้เสร็จแล้ว ปรับเปลี่ยนไม่ได้

สามารถเรียกใช้ Endpoint นี้ได้ในประสบการณ์ผ่าน {httpServiceLinkStart}HttpService{httpServiceLinkEnd} ด้วยคีย์ API

สามารถตั้งค่าฟิลด์นี้ได้เมื่อสร้างทรัพยากร แต่ไม่สามารถแก้ไขได้ด้วยคำขอภายหลัง

ตั้งค่าช่องข้อมูลเหล่านี้ตอนสร้างแหล่งข้อมูลได้ แต่จะส่งคำขอแก้ไขหลังจากนั้นไม่ได้

อาจมีช่องข้อมูลนี้ในคำขอ แต่จะไม่รวมอยู่ในการตอบกลับโดยเด็ดขาด

วิธีการยืนยันตัวตนแบบเก่า ควรใช้คีย์ API หรือ OAuth 2.0 เสมอ หากมี

ต่อคีย์ API: {maxInPeriod} คำขอทุกๆ {periodInSeconds} วินาทีต่อที่อยู่ IP

ไม่จำเป็นต้องมีการยืนยันตัวตนในการเรียกใช้ โดยปกติจะมีการจำกัดอัตราการเรียกใช้ที่ลดลงอย่างมาก ควรใช้คีย์ API หรือ OAuth 2.0 เสมอ หากมีให้ใช้งาน

การยืนยันตัวตนด้วย OAuth 2.0

สำหรับแต่ละกลุ่ม จะต้องระบุฟิลด์เพียง 1 รายการ จากรายการต่อไปนี้ในแบบแผน (schema) เท่านั้น และเว้นฟิลด์อื่นๆ ไว้ได้

คุณเลือกกลับมาได้ตลอดเวลา {linkStart}ให้ข้อเสนอแนะ{linkEnd}

คุณกำลังดูเอกสารแบบเก่า {linkStart}ให้ข้อเสนอแนะ{linkEnd}

คุณเลือกไม่เข้าร่วมได้ตลอดเวลาและจะถูกนำกลับไปยังหน้าอ้างอิงเก่า {linkStart}ให้ข้อเสนอแนะ{linkEnd}

คุณกำลังดูเอกสารโฉมใหม่ {linkStart}ให้ข้อเสนอแนะ{linkEnd}

อาจใช้ช่องข้อมูลนี้การตอบกลับ แต่จะเว้นไว้ในคำขอ

หมายเหตุ: อัตราสูงสุดอาจต่ำกว่านี้ในช่วงที่มีการใช้งานสูง บาง Endpoints มีอัตราสูงสุดเพิ่มเติม [เรียนรู้เพิ่มเติมเกี่ยวกับอัตราสูงสุด]({link})

{limit} คำขอต่อวันสำหรับคีย์ API ทั้งหมดสำหรับผู้ใช้หรือกลุ่ม

{limit} คำขอต่อชั่วโมงสำหรับคีย์ API ทั้งหมดสำหรับผู้ใช้หรือกลุ่ม

{limit} คำขอต่อนาทีสำหรับคีย์ API ทั้งหมดสำหรับผู้ใช้หรือกลุ่ม

{limit} คำขอต่อวินาทีสำหรับคีย์ API ทั้งหมดสำหรับผู้ใช้หรือกลุ่ม

{limit} คำขอต่อนาทีต่อเจ้าของคีย์ API

{limit} คำขอต่อวันต่อผู้ใช้แอป

{limit} คำขอต่อชั่วโมงต่อผู้ใช้แอป

{limit} คำขอต่อนาทีต่อผู้ใช้แอป

{limit} คำขอต่อวินาทีต่อผู้ใช้แอป

{limit} คำขอต่อวินาทีต่อเจ้าของคีย์ API

ขอบเขตจะควบคุมสิทธิ์ที่ข้อมูลประจำตัวของคุณมี ข้อมูลประจำตัวของคุณจะเข้าถึงได้เฉพาะ Endpoints ที่ขอบเขตที่คุณเลือกไว้รองรับเท่านั้น

Endpoints รุ่นเสถียรพร้อมใช้งานในสภาพแวดล้อมจริงแล้ว และแทบจะไม่เกิดการเปลี่ยนแปลงที่ทำให้ใช้งานไม่ได้ตลอดอายุการใช้งาน

เป้าหมายนี้ช่วยให้คุณสามารถจำกัดการใช้คีย์ของคุณเข้าถึง{requiredParts}ที่เลือกไว้

เป้าหมายนี้ช่วยให้คุณสามารถจำกัดการใช้คีย์ของคุณเข้าถึง{requiredParts}และ{optionalParts}ที่เลือกไว้

ประเภทเป้าหมายนั้นใช้เพื่อจำกัดทรัพยากรที่ข้อมูลประจำตัวของคุณมีสิทธิ์ใช้งานได้ แม้ว่าบัญชีของคุณจะมีสิทธิ์ใช้งานทรัพยากรเพิ่มเติม แต่จะดำเนินการได้เฉพาะทรัพยากรที่เลือกไว้เท่านั้น ทั้งนี้ ในกรณีที่ขอบเขตไม่มีส่วนเป้าหมาย คุณจะดำเนินการกับทรัพยากรที่เกี่ยวข้องทั้งหมดได้

ไม่จำเป็นต้องเลือกส่วนระดับบนสุดของยูนิเวอร์สสำหรับคีย์ API ที่ผู้ใช้เป็นเจ้าของ ในกรณีนี้ คีย์ API ของคุณจะมีสิทธิ์เข้าถึงประสบการณ์ทั้งหมดที่ผู้ใช้เป็นเจ้าของ รวมถึงประสบการณ์ที่กลุ่มเป็นเจ้าของซึ่งคุณมีสิทธิ์กลุ่มที่ถูกต้อง

ยังไม่รองรับการลองใช้สำหรับ Endpoints ที่ต้องใช้คีย์ API หรือการยืนยันตัวตนด้วย OAuth 2.0

การยืนยันตัวตนด้วยคุกกี้ถูกปิดใช้งานสำหรับการดำเนินการที่มีความเสี่ยงสูงเพื่อความปลอดภัย

Endpoints ที่มีความเสี่ยงสูงนั้นละเอียดอ่อนมาก การลองใช้จึงถูกปิดใช้งานเพื่อความปลอดภัย

หมายเหตุ: ตัวอย่างโค้ดนี้ไม่มีส่วนหัวสำหรับการยืนยันตัวตน คุณอาจต้องเพิ่มส่วนหัวเพื่อใช้คำสั่งนี้

Endpoints ที่สามารถแก้ไขหรือลบข้อมูลสำคัญได้นี้มีความเสี่ยงสูง โปรดทดสอบด้วยความระมัดระวังอย่างยิ่ง

Endpoint ของ API นี้จัดอยู่ในประเภทความเสี่ยงสูง และอาจส่งผลกระทบต่อข้อมูลจริงหรือบัญชีผู้ใช้

คำขอที่ผ่านการยืนยันตัวตนไปยัง API ที่มีความเสี่ยงสูงอาจทำให้เกิดการเปลี่ยนแปลงที่ไม่สามารถยกเลิกได้ โปรดตรวจสอบพารามิเตอร์คำขอของคุณอย่างรอบคอบก่อนดำเนินการต่อ

โปรดลงชื่อเข้าใช้เพื่อใช้การยืนยันตัวตนด้วยคุกกี้

Endpoints ที่สามารถดึงข้อมูลได้นี้มีความเสี่ยงต่ำ โดยทั่วไปจะปลอดภัยสำหรับการทดสอบ

Endpoints ที่สามารถแก้ไขข้อมูลได้นี้มีความเสี่ยงปานกลาง ทดสอบด้วยความระมัดระวังโดยใช้บัญชีที่ไม่สำคัญ เนื่องจากอาจเป็นการเปลี่ยนแปลงถาวร

อย่าวางข้อความจากแหล่งอื่นที่นี่หรือส่งข้อมูลจากหน้านี้ให้ผู้อื่น เพื่อรักษาบัญชีของคุณให้ปลอดภัย

คุณกำลังจะทดสอบ Endpoints ของ API แบบเรียลไทม์โดยใช้ข้อมูลประจำตัวของบัญชีจริง

โปรดดำเนินการต่อเฉพาะในกรณีที่คุณเข้าใจผลกระทบในการเรียกใช้ API นี้ และตรวจสอบเอกสารประกอบ API อย่างรอบคอบก่อนทดสอบ

การเรียกใช้ API จะดำเนินการโดยใช้เซสชันที่ผ่านการตรวจสอบสิทธิ์แล้ว

ซึ่งเป็นการเรียกใช้ API จริง และอาจส่งผลกระทบต่อบัญชีหรือข้อมูลของคุณ

มีการจำกัดอัตราและมีข้อจำกัดอื่นๆ สำหรับ API

การดำเนินการบางส่วนอาจเป็นการแก้ไขหรือลบข้อมูล

Endpoint นี้มีการแทนที่ด้วย Endpoint ทางเลือกแนะนำเหล่านี้:

ต้องมีขอบเขตต่อไปนี้เพื่อเรียกใช้ Endpoint นี้ ดูข้อมูลเพิ่มเติม
เกี่ยวกับการสร้างคีย์ที่เหมาะสมได้ที่[จัดการคีย์ API]({apiKeyReferenceDocLink})

ดูข้อมูลเพิ่มเติมเกี่ยวกับการสร้างคีย์ได้ที่[จัดการคีย์ API]({apiKeyReferenceDocLink})

Endpoints ต่อไปนี้พร้อมใช้งานที่เส้นทางที่สัมพันธ์กับ URL หลัก

สตริงนี้มีรูปแบบ [FieldMask](/cloud/reference/types#fieldmask)

ค่า JSON จะเป็น `null`, `boolean`, `string`, `number`, `array` หรือ `object` ก็ได้

แอปพลิเคชัน OAuth 2.0 ของคุณต้องมีขอบเขตต่อไปนี้เพื่อใช้ Endpoint นี้ ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีลงทะเบียนแอปพลิเคชัน OAuth 2.0 ได้ที่[การลงทะเบียนและการตรวจสอบแอป]({oauth2ReferenceDocLink})

ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีลงทะเบียนแอปพลิเคชัน OAuth 2.0 ได้ที่[การลงทะเบียนและการตรวจสอบแอป]({oauth2ReferenceDocLink})

วัตถุต่อไปนี้ใช้บรรยายเพย์โหลดที่ยอมรับหรือส่งคืน ดูข้อมูลเพิ่มเติมว่าจะใช้วัตถุเหล่านี้ตอนไหนที่ Endpoint แต่ละจุด

เนื้อหาคำขอเป็น

ต้องมีขอบเขตต่อไปนี้เพื่อเรียกใช้ Endpoint นี้

เส้นทางแหล่งข้อมูล

สตริงนี้มีรูปแบบ[ประทับเวลา](/cloud/reference/types#timestamp)

ต้องมีขอบเขตต่อไปนี้สำหรับแอปพลิเคชัน OAuth 2.0 ของคุณเพื่อใช้ Endpoint นี้ ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีลงทะเบียนแอปพลิเคชัน OAuth 2.0 ได้ที่[การลงทะเบียนและการตรวจสอบแอป]({oauth2ReferenceDocLink})

ไม่แนะนำ

คุณกำลังดูข้อมูลอ้างอิง Open Cloud โฉมใหม่

คุณเลือกไม่ใช้ข้อมูลอ้างอิง Open Cloud ใหม่

ดูบัญชีเรียกเก็บเงินค่าโฆษณาของคุณ

ดูแคมเปญโฆษณาของคุณและประสิทธิภาพของแคมเปญ

สร้าง อัปเดต และจัดการแคมเปญโฆษณาของคุณ

สิทธิ์นี้อนุญาตให้ดูข้อมูลเกี่ยวกับทรัพยากรของคุณ

สิทธิ์นี้อนุญาตให้อัปโหลดและอัปเดตทรัพยากรไปยัง Roblox

การตั้งค่านี้จะให้สิทธิ์ดูแอสเซทแก่ผู้ใช้ทุกประเภท (รวมถึงกลุ่มและประสบการณ์) และแอสเซทที่บัญชีของคุณสามารถเข้าถึง

สิทธิ์นี้ให้สิทธิ์การเข้าถึงทรัพยากรแก่ผู้ใช้ทุกประเภท (รวมถึงกลุ่มและประสบการณ์) และทรัพยากรที่บัญชีของคุณสามารถเข้าถึง

การตั้งค่านี้จะอนุญาตให้คุณดูสถานะและผลลัพธ์ของงานตั้งค่าอวาตาร์ในนามของคุณได้โดยอัตโนมัติ

การตั้งค่านี้จะอนุญาตให้คุณสร้างและจัดการงานตั้งค่าอวาตาร์ในนามของคุณได้โดยอัตโนมัติ

อนุญาตให้ใช้ความสามารถในการอัปเดตเหรียญตราที่ผู้ใช้เป็นเจ้าของ

สิทธิ์นี้อนุญาตให้ดูข้อมูลเกี่ยวกับไอเท็มการค้าของคุณ

สิทธิ์นี้อนุญาตให้เปลี่ยนแปลงไอเท็มการค้าที่ซิงค์แล้วของคุณ

ซึ่งจะช่วยให้คุณสามารถดูข้อมูลเกี่ยวกับการเชื่อมต่อผู้ขายสินค้าของคุณได้

สิทธิ์นี้อนุญาตให้แก้ไขการเชื่อมต่อผู้ขายสินค้าของคุณได้

สิทธิ์นี้อนุญาตให้คุณดูข้อมูลเกี่ยวกับผลิตภัณฑ์บนร้านค้าครีเอเตอร์ของคุณได้

สิทธิ์นี้อนุญาตให้คุณแก้ไขข้อมูลเกี่ยวกับผลิตภัณฑ์บนร้านค้าครีเอเตอร์ของคุณได้

ซึ่งจะช่วยให้คุณดูข้อมูลเกี่ยวกับผลิตภัณฑ์บนร้านค้าครีเอเตอร์ของคุณได้

ซึ่งจะช่วยให้คุณแก้ไขข้อมูลเกี่ยวกับผลิตภัณฑ์บนร้านค้าครีเอเตอร์ของคุณได้

อนุญาตให้เข้าถึงเพื่อสร้างที่เก็บข้อมูลในนามของคุณ

อนุญาตให้เข้าถึงเพื่อลบที่จัดเก็บข้อมูลในนามของคุณ

อนุญาตให้เข้าถึงเพื่ออ่านรายการที่จัดเก็บข้อมูล

อนุญาตให้เข้าถึงเพื่อถ่ายสแน็ปช็อตที่จัดเก็บข้อมูลของคุณ

อนุญาตให้เข้าถึงเพื่อสร้างรายการในที่จัดเก็บข้อมูลของคุณ

อนุญาตให้เข้าถึงเพื่อทำเครื่องหมายรายการที่ระบุเพื่อลบ

อนุญาตให้เข้าถึงเพื่อแสดงรายการในที่จัดเก็บข้อมูลของคุณ

อนุญาตให้เข้าถึงเพื่ออ่านรายการที่ระบุในที่เก็บข้อมูลของคุณ

อนุญาตให้เข้าถึงเพื่ออัปเดตค่า แอตทริบิวต์ และผู้ใช้ของรายการ

อนุญาตให้เข้าถึงเพื่อลบเวอร์ชันที่แก้ไขของรายการในที่จัดเก็บข้อมูลของคุณ

อนุญาตให้เข้าถึงเพื่อแสดงรายการเวอร์ชันที่แก้ไขของรายการในที่จัดเก็บข้อมูลของคุณ

อนุญาตให้เข้าถึงเพื่อดูรายละเอียดการกำหนดค่าสำหรับผลิตภัณฑ์นักพัฒนาของผู้ใช้ที่ได้รับอนุญาต

อนุญาตให้เข้าถึงเพื่อแก้ไขผลิตภัณฑ์นักพัฒนาของผู้ใช้ที่ได้รับอนุญาต

สิทธิ์นี้อนุญาตให้ดูข้อมูลเกี่ยวกับสภาพแวดล้อมในยูนิเวิร์สของคุณ

สิทธิ์นี้อนุญาตให้แก้ไขสภาพแวดล้อมในยูนิเวิร์สของคุณ

อนุญาตให้เข้าถึงเพื่อดูรายละเอียดการกำหนดค่าสำหรับบัตรผ่านเกมของผู้ใช้ที่ได้รับอนุญาต

อนุญาตให้เข้าถึงเพื่อแก้ไขบัตรผ่านเกมของผู้ใช้ที่ได้รับอนุญาต

อนุญาตให้เข้าถึงเพื่อดูข้อมูลฟอรัมชุมชนสำหรับบัญชีของคุณ

อนุญาตให้เข้าถึงเพื่อจัดการข้อมูลฟอรัมชุมชนสำหรับบัญชีของคุณ

สิทธิ์นี้อนุญาตให้ดูข้อมูลเกี่ยวกับชุมชนของคุณ

สิทธิ์นี้อนุญาตให้คุณจัดการคำขอเข้าร่วมชุมชนและอัปเดตบทบาทของสมาชิกชุมชนที่มีสถานะต่ำกว่าสำหรับบัญชีของคุณได้

อนุญาตให้คุณดูข้อมูลคุณสมบัติของอินสแตนซ์

อนุญาตให้คุณแก้ไขข้อมูลคุณสมบัติของอินสแตนซ์ (ปัจจุบันรองรับเฉพาะสคริปต์เท่านั้น)

สิทธิ์นี้อนุญาตให้ดูข้อมูลเกี่ยวกับคลังไอเท็มของคุณ

อนุญาตให้เข้าถึงเพื่อจัดการทรัพยากรของผู้ใช้

อนุญาตให้เข้าถึงเพื่อจัดการเหรียญตราของคุณ

อนุญาตให้เข้าถึงเพื่อจัดการเหรียญตราของคุณและใช้จ่าย Robux

อนุญาตให้เข้าถึงเพื่ออัปเดตเหรียญตราของผู้ใช้ที่ได้รับอนุญาต

อนุญาตให้เข้าถึงเพื่อจัดการผลิตภัณฑ์นักพัฒนาระบบของคุณ

อนุญาตให้เข้าถึงเพื่ออ่านข้อมูลเกี่ยวกับประสบการณ์ที่คุณเปิดการแจ้งเตือน

อนุญาตให้เข้าถึงเพื่อเปิดหรือปิดการแจ้งเตือนสำหรับประสบการณ์ในนามของคุณ

อนุญาตให้เข้าถึงเพื่อจัดการบัตรผ่านของคุณ

อนุญาตให้เข้าถึงเพื่อจัดการชุมชนของคุณ

อนุญาตให้มีสิทธิ์ในการอ่านข้อมูลชุมชน

อนุญาตให้มีสิทธิ์ในการจัดการชุมชน

อนุญาตให้เข้าถึงเพื่ออ่านและเขียนตารางการแปลของคุณ

อนุญาตให้เข้าถึงเพื่อจัดการการทำงานร่วมกันเป็นทีมสำหรับประสบการณ์ทั้งหมดที่คุณเป็นเจ้าของ

อนุญาตให้เข้าถึงเพื่อจัดการประสบการณ์ของคุณและข้อมูลบางอย่างที่เกี่ยวข้องกับประสบการณ์ของคุณ (เช่น ข้อมูลการแปลภาษา)

อนุญาตให้เข้าถึงเพื่ออ่านข้อมูลการแปลประสบการณ์ของคุณ

อนุญาตให้เข้าถึงเพื่อแก้ไขการตั้งค่าการแปลประสบการณ์ของคุณ

อนุญาตให้เข้าถึงเพื่อจัดการบัญชีผู้ใช้ของคุณ

อนุญาตให้เข้าถึงเพื่อแก้ไขการตั้งค่าการแปลภาษาของผู้ใช้

อนุญาตให้คุณดูสถานะ บันทึก และแสดงผลลัพธ์ของงานดำเนินการในภาษา Luau สำหรับสถานที่ที่เชื่อมโยงได้

อนุญาตให้คุณสร้างงานดำเนินการใหม่ในภาษา Luau สำหรับสถานที่ที่เชื่อมโยงได้

อนุญาตให้เข้าถึงเพื่อล้างโครงสร้างข้อมูลทั้งหมดในยูนิเวิร์สแบบไม่ต้องรอให้ซิงค์ข้อมูล

อนุญาตให้เข้าถึงเพื่อสร้างไอเท็มใหม่ในคิว

อนุญาตให้เข้าถึงเพื่อลบไอเท็มที่อ่านแล้วออกจากด้านหน้าของคิว

อนุญาตให้เข้าถึงเพื่ออ่านไอเท็มที่ด้านหน้าของคิว

อนุญาตให้เข้าถึงเพื่ออ่านไอเท็มบนที่เก็บข้อมูลในหน่วยความจำของคุณ

อนุญาตให้เข้าถึงเพื่ออ่านไอเท็มบนแผนที่

อนุญาตให้เข้าถึงเพื่อสร้าง อัปเดต และลบไอเท็มบนแผนที่

การดำเนินการนี้จะอนุญาตให้ใช้ความสามารถในการเผยแพร่ข้อความในนามของผู้ใช้

สิทธิ์นี้อนุญาตให้ส่งการแจ้งเตือนจากประสบการณ์ของคุณไปยังผู้ใช้ได้

(เลิกใช้แล้ว) อนุญาตให้เข้าถึงเพื่ออ่านรายการในที่จัดเก็บข้อมูลที่เรียงตามลำดับ

(เลิกใช้แล้ว) อนุญาตให้เข้าถึงเพื่อสร้างรายการใหม่ในที่จัดเก็บข้อมูลที่เรียงตามลำดับ

อนุญาตให้เข้าถึงเพื่อแสดงรายการจากที่จัดเก็บข้อมูลที่เรียงตามลำดับ

อนุญาตให้เข้าถึงเพื่อสร้างรายการในที่จัดเก็บข้อมูลที่เรียงตามลำดับ

สิทธิ์นี้อนุญาตให้ลงข้อมูลลับที่เชื่อมโยงกับประสบการณ์ของคุณ

สิทธิ์นี้อนุญาตให้สร้างและอัปเดตข้อมูลลับที่เชื่อมโยงกับประสบการณ์ของคุณ

สิทธิ์นี้อนุญาตให้คุณส่งงานประเมินผลและดูผลลัพธ์เกี่ยวกับงาน

อนุญาตให้เข้าถึงเพื่ออ่านข้อมูลเกี่ยวกับผลิตภัณฑ์ที่คุณสมัครสมาชิก

การตั้งค่านี้จะอนุญาตให้คุณอ่านข้อมูลภาพขนาดย่อในนามของคุณได้

อนุญาตให้อ่านการวิเคราะห์เกมได้

อนุญาตให้ใช้ความสามารถในการอ่านข้อมูลเกี่ยวกับสถานที่

อนุญาตให้ใช้ความสามารถในการแก้ไขข้อมูลเกี่ยวกับสถานที่

อนุญาตให้เข้าถึงเพื่อเผยแพร่ประสบการณ์เวอร์ชันใหม่ไปยัง Roblox

อนุญาตให้ใช้ความสามารถในการอ่านข้อมูลประสบการณ์

อนุญาตให้เข้าถึงเพื่อแก้ไขประสบการณ์ของผู้ใช้ที่ได้รับอนุญาต

อนุญาตให้คุณดูข้อจำกัดของผู้ใช้ในประสบการณ์ได้

อนุญาตให้คุณแก้ไขข้อจำกัดของผู้ใช้ในประสบการณ์ได้

การตั้งค่านี้จะอนุญาตให้ดูการแจ้งเตือนที่ส่งไปยังบัญชีของคุณได้

อนุญาตให้ใช้ความสามารถในการอ่านสถานะ Premium และสถานะที่ยืนยันแล้วของผู้ใช้

สิทธิ์นี้อนุญาตให้คุณดูบัญชีโซเชียลของผู้ใช้ที่ได้รับอนุญาตได้

การดำเนินการนี้จะเปิดใช้งานฟังก์ชันการลงชื่อเข้าใช้แบบครั้งเดียว

การดำเนินการนี้จะอนุญาตให้เข้าถึงเพื่ออ่านข้อมูลโปรไฟล์ของคุณ

Luau Execution

Places