Một `Logger` phát ra các mục log có cấu trúc được gán nhãn với một tên phân cấp,
cho phép bạn nhóm các thông điệp liên quan theo hệ thống con hoặc tính năng. Lấy một
logger cấp cao từ `Class.LogService:GetLogger()`, sau đó tạo các logger con lồng
nhau với `Class.Logger:GetLogger()`. Mỗi logger có một `Class.Logger.Name` ngắn
và một `Class.Logger.FullPath` nối với dấu chấm được xây dựng từ tổ tiên của nó
(ví dụ, một logger có tên `Damage` được tạo từ một logger có tên `Combat` có
đường dẫn đầy đủ là `Combat.Damage`).

```lua
local LogService = game:GetService("LogService")

local combat = LogService:GetLogger("Combat")
local damage = combat:GetLogger("Damage")

print(damage.Name)      --> Damage
print(damage.FullPath)  --> Combat.Damage

damage:Info("Đã gây {amount} sát thương cho {target}", {amount = 25, target = "Goblin"})
```
Các logger hoạt động giống như các phương thức ghi log có cấu trúc trên
`Class.LogService`: các thông điệp chảy vào cửa sổ **Output**, Bảng điều khiển
Nhà phát triển, và `Class.LogService.MessageOut`, và được bao gồm trong
`Class.LogService:GetLogHistory()` được gán nhãn với đường dẫn đầy đủ của logger.

#### Phân cấp và Phát tán

Khi một thông điệp được ghi trên một logger, sự kiện `Class.Logger.MessageOut`
được kích hoạt trên logger đó **và** trên mọi tổ tiên lên đến gốc. Điều này cho phép bạn
gắn một listener trên một logger cha để quan sát tất cả các thông điệp được phát ra
bởi các hậu duệ của nó. Thông điệp được phát ra đến hệ thống đầu ra của engine chỉ
một lần, được gán nhãn với đường dẫn đầy đủ của logger gốc.

#### Cú pháp Mẫu và Ngữ cảnh

Các phương thức ghi log chấp nhận cùng các chỗ giữ chỗ mẫu `{key}` và
các bảng `context` như các phương thức ghi log có cấu trúc trên `Class.LogService`. Xem
`Class.LogService` để biết chi tiết về cú pháp mẫu và cách các giá trị ngữ cảnh được
lưu trữ.

#### Thời gian sống

Một logger vẫn hợp lệ miễn là bạn giữ một tham chiếu đến nó. Khi tất cả
các tham chiếu đến một logger (và các hậu duệ của nó) được giải phóng, nó sẽ được thu hồi,
và việc gọi bất kỳ phương thức nào trên một logger cũ sẽ gây ra lỗi. Số lượng logger
sống và độ dài của đường dẫn đầy đủ của một logger đều có giới hạn; vượt quá
một trong hai giới hạn sẽ gây ra lỗi từ `Class.Logger:GetLogger()`.

#### Cảnh báo

Lớp này có thể có hành vi không mong đợi hoặc không đáng tin cậy và nội dung có thể bị
cắt ngắn. Đừng dựa vào nội dung của các sự kiện và thông điệp được phát ra bởi các logger
cho bất kỳ logic trò chơi quan trọng nào.


Kích hoạt bất cứ khi nào một thông điệp được ghi qua logger này hoặc bất kỳ logger
nào bên dưới nó trong phân cấp. Bởi vì một thông điệp được ghi kích hoạt `MessageOut`
trên logger gốc và mỗi tổ tiên của nó, một listener gắn vào một logger cha sẽ quan sát
mỗi thông điệp được phát ra bởi các hậu duệ của nó. Tham số `message` chứa văn bản đã được
render hoàn toàn (các chỗ giữ chỗ mẫu đã được thay thế), và tham số `context` mang các
cặp khóa-giá trị có cấu trúc khi thông điệp được ghi với một bảng ngữ cảnh; nếu không thì là nil.

```lua
local LogService = game:GetService("LogService")
local combat = LogService:GetLogger("Combat")

combat.MessageOut:Connect(function(message, messageType, context)
	print("[Combat]", message)
end)

-- Một thông điệp được ghi trên một hậu duệ cũng kích hoạt MessageOut của cha.
combat:GetLogger("Damage"):Info("Đánh cho {amount}", {amount = 10})
-- In ra: [Combat] Đánh cho 10
```


Logger.MessageOut

message

Chuỗi thông điệp đã được render hoàn toàn sau bất kỳ sự thay thế chỗ giữ chỗ mẫu nào.


messageType

Một giá trị `Enum.MessageType` chỉ ra mức độ nghiêm trọng của
thông điệp.


context

Một từ điển các cặp khóa-giá trị được cung cấp khi thông điệp được ghi,
hoặc nil nếu không có ngữ cảnh nào được cung cấp.


Kích hoạt khi một thông điệp được ghi qua logger này hoặc bất kỳ hậu duệ nào của nó.


Trả về logger con với `name` đã cho, tạo nó nếu nó chưa tồn tại. Gọi phương thức này
với cùng một tên nhiều lần sẽ trả về cùng một thể hiện logger miễn là có một tham chiếu
đến nó. `Class.Logger.FullPath` của logger được trả về là đường dẫn đầy đủ của logger này
được theo sau bởi `.` và `name`.

Phương thức này sẽ gây ra lỗi nếu tên rỗng, chứa ký tự `.`, hoặc
chứa các ký tự điều khiển, nếu đường dẫn đầy đủ kết quả quá dài, hoặc nếu
số lượng logger sống tối đa đã bị vượt quá.

```lua
local LogService = game:GetService("LogService")

local network = LogService:GetLogger("Network")
local http = network:GetLogger("Http")

print(http.FullPath)  --> Network.Http
```


Logger:GetLogger

name

Tên của logger con. Phải không rỗng, không chứa ký tự `.` và không chứa các ký tự điều khiển.


Logger con `Class.Logger` có đường dẫn đầy đủ là đường dẫn đầy đủ của logger này
được theo sau bởi `.name`.


Trả về một logger con với tên đã cho, tạo nó nếu nó chưa tồn tại.


Ghi một thông điệp ở cấp độ `Enum.MessageType.MessageOutput`, được gán nhãn với
`Class.Logger.FullPath` của logger này. Khi một bảng `context` được cung cấp,
các chỗ giữ chỗ mẫu như `{key}` trong thông điệp sẽ được thay thế bằng các
giá trị ngữ cảnh tương ứng, và ngữ cảnh được bảo tồn dưới dạng dữ liệu có cấu trúc để hiển thị
trong Bảng điều khiển Nhà phát triển và cửa sổ **Output** của Studio.

```lua
local LogService = game:GetService("LogService")
local logger = LogService:GetLogger("Shop")

logger:Output("Người chơi {name} đã mở cửa hàng", {name = "Alice"})
-- Đầu ra: "Người chơi Alice đã mở cửa hàng"
```


Logger:Output

Chuỗi thông điệp. Hỗ trợ các chỗ giữ chỗ mẫu `{key}` khi một
bảng ngữ cảnh được cung cấp.


Một từ điển tùy chọn của các cặp khóa-giá trị. Khi được cung cấp, các chỗ giữ chỗ `{key}`
trong thông điệp sẽ được thay thế bằng các giá trị tương ứng.


Ghi một thông điệp ở cấp độ `Enum.MessageType.MessageOutput` với ngữ cảnh có cấu trúc tùy chọn.


Ghi một thông điệp ở cấp độ `Enum.MessageType.MessageInfo`, được gán nhãn với
`Class.Logger.FullPath` của logger này. Khi một bảng `context` được cung cấp,
các chỗ giữ chỗ mẫu như `{key}` trong thông điệp sẽ được thay thế bằng các
giá trị ngữ cảnh tương ứng.

```lua
local LogService = game:GetService("LogService")
local logger = LogService:GetLogger("Combat")

logger:Info("Đã gây {amount} sát thương", {amount = 42})
-- Đầu ra: "Đã gây 42 sát thương"
```


Logger:Info

Ghi một thông điệp ở cấp độ `Enum.MessageType.MessageInfo` với ngữ cảnh có cấu trúc tùy chọn.


Ghi một thông điệp ở cấp độ `Enum.MessageType.MessageWarning`, được gán nhãn với
`Class.Logger.FullPath` của logger này. Khi một bảng `context` được cung cấp,
các chỗ giữ chỗ mẫu như `{key}` trong thông điệp sẽ được thay thế bằng các
giá trị ngữ cảnh tương ứng.

```lua
local LogService = game:GetService("LogService")
local logger = LogService:GetLogger("Combat")

logger:Warn("Sức khỏe thấp: {hp}", {hp = 5})
-- Đầu ra: "Sức khỏe thấp: 5"
```


Logger:Warn

Ghi một thông điệp ở cấp độ `Enum.MessageType.MessageWarning` với ngữ cảnh có cấu trúc tùy chọn.


Ghi một thông điệp ở cấp độ `Enum.MessageType.MessageError`, được gán nhãn với
`Class.Logger.FullPath` của logger này. Khác với `Class.LogService:Error()`,
phương thức này phát ra một mục log cấp độ lỗi và trả về bình thường; nó không
**không** ném ra lỗi. Khi một bảng `context` được cung cấp, các chỗ giữ chỗ
như `{key}` trong thông điệp sẽ được thay thế bằng các giá trị ngữ cảnh tương ứng.

```lua
local LogService = game:GetService("LogService")
local logger = LogService:GetLogger("Network")

logger:Error("Yêu cầu thất bại: {reason}", {reason = "timeout"})
-- Phát ra một log cấp độ lỗi; thực thi tiếp tục.
```


Logger:Error

Ghi một thông điệp ở cấp độ `Enum.MessageType.MessageError` với ngữ cảnh có cấu trúc tùy chọn.


Ghi một thông điệp ở cấp độ `Enum.MessageType` chỉ định, được gán nhãn với
`Class.Logger.FullPath` của logger này. Đây là một phương thức đa mục đích kết hợp
`Class.Logger:Output()|Output()`, `Class.Logger:Info()|Info()`,
`Class.Logger:Warn()|Warn()`, và `Class.Logger:Error()|Error()` thành một
cuộc gọi duy nhất với tham số loại thông điệp rõ ràng. Khác với
`Class.LogService:Log()`, việc truyền `Enum.MessageType.MessageError` phát ra một
log cấp độ lỗi và trả về bình thường thay vì ném ra lỗi.

```lua
local LogService = game:GetService("LogService")
local logger = LogService:GetLogger("Combat")

logger:Log(Enum.MessageType.MessageInfo, "Sự kiện {action}", {action = "spawn"})
```


Logger:Log

`Enum.MessageType` chỉ định cấp độ log.


Ghi một thông điệp ở cấp độ chỉ định với ngữ cảnh có cấu trúc tùy chọn.


Logger

Tên của logger này như được cung cấp cho `Class.LogService:GetLogger()` hoặc
`Class.Logger:GetLogger()`. Đây là một phân đoạn đường dẫn đơn và không bao giờ
chứa ký tự `.`. Sử dụng `Class.Logger.FullPath` cho đường dẫn đầy đủ.


Logger.Name

Phân đoạn tên của logger này trong cha của nó.


Đường dẫn đầy đủ của logger này, được hình thành bằng cách nối `Class.Logger.Name`
của mỗi logger từ gốc xuống logger này với các dấu phân cách `.`. Đối với một logger
cấp cao, đường dẫn đầy đủ bằng với tên của nó. Các thông điệp được ghi qua
logger này được gán nhãn với đường dẫn đầy đủ này trong
`Class.LogService:GetLogHistory()`.


Logger.FullPath

Đường dẫn nối dấu chấm của logger này từ logger gốc.


Một logger có tên phát ra các mục log có cấu trúc được giới hạn trong một
đường dẫn phân cấp.


`Object` là lớp cơ sở cho tất cả các lớp trong hệ thống lớp của Roblox.
Mọi lớp khác mà Roblox Engine định nghĩa đều kế thừa tất cả các thành viên
của `Object`. Không thể tạo trực tiếp một `Object`.


Mẫu này minh họa những điều tinh tế của sự kiện `Changed` trên các đối tượng bình thường
và các đối tượng `Value`.


Mẫu mã này minh họa sự kiện Changed được kích hoạt trong một đối tượng cha.


Sự kiện này được kích hoạt ngay sau khi một thuộc tính của đối tượng được thay đổi, với
một số ngoại lệ (xem bên dưới). Giá trị mới của một thuộc tính đã thay đổi là
**không** được truyền dưới dạng tham số. Thay vào đó, bạn có thể truy cập nó bằng cách sử dụng
`object[property]`:

```
object.Changed:Connect(function(property)
	print("Giá trị mới của thuộc tính là", object[property])
end)
```

- Nếu bạn chỉ quan tâm đến việc lắng nghe các thay đổi của một thuộc tính cụ thể,
hãy xem xét sử dụng phương thức
  `Class.Object:GetPropertyChangedSignal()|GetPropertyChangedSignal()`
  thay thế.
- Để lắng nghe các thay đổi trong thuộc tính, xem
  `Class.Instance:GetAttributeChangedSignal()` và
  `Class.Instance.AttributeChanged`.
- Để phát hiện khi các đối tượng con được thêm hoặc xóa, xem
  `Class.Instance.ChildAdded` và `Class.Instance.ChildRemoved`.

Đối với các đối tượng `Class.ValueBase` như `Class.IntValue` và
`Class.StringValue`, sự kiện này chỉ được kích hoạt khi thuộc tính `Value`
của đối tượng thay đổi. Để phát hiện các thay đổi khác trong các đối tượng `Class.ValueBase`,
hãy sử dụng `Class.Object:GetPropertyChangedSignal()|GetPropertyChangedSignal()`.

#### Giới hạn

Sự kiện này **không** được kích hoạt cho các thay đổi liên quan đến vật lý, chẳng hạn như khi
các thuộc tính `Class.BasePart.CFrame|CFrame`,
`Class.BasePart.AssemblyLinearVelocity|AssemblyLinearVelocity`,
`Class.BasePart.AssemblyAngularVelocity|AssemblyAngularVelocity`,
`Class.BasePart.Position|Position`, hoặc
`Class.BasePart.Orientation|Orientation` của một `Class.BasePart`
thay đổi do trọng lực. Để phát hiện các thay đổi trong những thuộc tính này, hãy xem xét
sử dụng một sự kiện dựa trên vật lý như `Class.RunService.PreSimulation`.
Tương tự, sự kiện `Changed` không được kích hoạt khi
`Class.BasePart.AssemblyMass|AssemblyMass` cập nhật do thay đổi trong
vật liệu, kích thước hoặc mật độ cho một phần đã hàn (nhưng sự kiện này được kích hoạt cho
`Class.BasePart.Mass|Mass` nếu bạn thay đổi kích thước của một phần).

Đối với các thuộc tính thay đổi thường xuyên, sự kiện `Changed` có thể không được kích hoạt
cho mọi sửa đổi, hoặc nó có thể không được kích hoạt chút nào. **Nếu một thay đổi thuộc tính
ảnh hưởng đến logic trò chơi của bạn, hãy kiểm tra cẩn thận** để đảm bảo sự kiện đang
kích hoạt như bạn mong đợi.


Object.Changed

property

Tên của thuộc tính đã thay đổi.


Kích hoạt ngay sau khi một thuộc tính của đối tượng thay đổi, với một số
giới hạn.


Mẫu mã này minh họa cách lưu một giá trị trước khi sự kiện thay đổi xảy ra
trên nó để có thêm thông tin về một sự thay đổi.


Mẫu mã này minh họa sự tương đương của sự kiện `Changed` và sự kiện
được trả về bởi `GetPropertyChangedSignal`.


Phương thức này trả về một sự kiện hoạt động chính xác như sự kiện
`Class.Object.Changed|Changed`, ngoại trừ việc nó chỉ được kích hoạt khi thuộc tính
được chỉ định thay đổi. Thông thường, đây là một ý tưởng tốt để sử dụng phương thức này
thay vì kết nối với `Class.Object.Changed|Changed` với một hàm
kiểm tra tên thuộc tính. Các cuộc gọi tiếp theo đến phương thức này trên cùng một
đối tượng với cùng một tên thuộc tính sẽ trả về cùng một sự kiện.

Các đối tượng `Class.ValueBase`, chẳng hạn như `Class.IntValue` và
`Class.StringValue`, sử dụng một sự kiện `Class.Object.Changed|Changed` đã được sửa đổi
kích hoạt với nội dung của thuộc tính `Value` của chúng. Do đó, phương thức này cung cấp
một cách để phát hiện các thay đổi trong các thuộc tính khác của những
đối tượng đó.

Lưu ý rằng sự kiện này sẽ không truyền bất kỳ tham số nào đến một hàm đã kết nối,
vì vậy giá trị của thuộc tính đã thay đổi phải được đọc trực tiếp trong một
script.

#### Giới hạn

Sự kiện được trả về bởi phương thức này **không** được kích hoạt cho các thay đổi liên quan đến vật lý,
hay khi các thuộc tính `Class.BasePart.CFrame|CFrame`,
`Class.BasePart.AssemblyLinearVelocity|AssemblyLinearVelocity`,
`Class.BasePart.AssemblyAngularVelocity|AssemblyAngularVelocity`,
`Class.BasePart.Position|Position`, hoặc
`Class.BasePart.Orientation|Orientation` của một `Class.BasePart`
thay đổi do trọng lực. Để phát hiện các thay đổi trong những thuộc tính này, hãy xem xét
sử dụng một sự kiện dựa trên vật lý như `Class.RunService.PreSimulation`.

Ngoài ra, sự kiện được trả về có thể không được kích hoạt cho mọi sửa đổi của
các thuộc tính thay đổi rất thường xuyên, và/hoặc nó có thể không được kích hoạt cho những
thuộc tính như vậy. Nên kiểm tra cẩn thận cho các thay đổi thuộc tính
ảnh hưởng đến logic trò chơi.


Object:GetPropertyChangedSignal

Một tín hiệu được kích hoạt bất cứ khi nào thuộc tính thay đổi.


Lấy một sự kiện được kích hoạt khi một thuộc tính nhất định của đối tượng thay đổi.


Chứng minh việc xác định lớp của Workspace bằng cách sử dụng `Class.Instance:IsA()`

Workspace thuộc lớp 'Workspace', vì vậy câu đầu tiên là đúng. Workspace
không thuộc lớp 'BasePart', vì vậy câu thứ hai là sai. Workspace
kế thừa từ Instance và do đó thuộc lớp 'Instance', vì vậy câu thứ ba
là đúng.


IsA trả về true nếu lớp của đối tượng là **tương đương với** hoặc là một
**lớp con** của một lớp nhất định. Hàm này tương tự như các toán tử
**instanceof** trong các ngôn ngữ khác, và là một hình thức của
[type introspection](https://en.wikipedia.org/wiki/Type_introspection). Để
bỏ qua kế thừa lớp, hãy kiểm tra thuộc tính `Class.Object.ClassName|ClassName`
trực tiếp thay thế. Để kiểm tra các kiểu dữ liệu Luau gốc (số,
chuỗi, v.v.) hãy sử dụng các hàm `type` và `typeof`.

Thường thì, hàm này được sử dụng để kiểm tra xem một đối tượng có phải là một loại
phần nào đó, chẳng hạn như `Class.Part` hoặc `Class.WedgePart`, mà kế thừa từ
`Class.BasePart` (một lớp trừu tượng). Ví dụ, nếu mục tiêu của bạn là
thay đổi tất cả các chi của một nhân vật thành cùng một màu, bạn có thể sử dụng
`Class.Instance:GetChildren()|GetChildren` để lặp qua các đối tượng con,
rồi sử dụng IsA để lọc các đối tượng không phải `Class.BasePart` mà thiếu thuộc tính
`Datatype.BrickColor`:

```lua
local Players = game:GetService("Players")

local function paintFigure(character, color)
	-- Lặp qua các đối tượng con của nhân vật
	for _, child in character:GetChildren() do
		-- Lọc ra các đối tượng không phải phần, chẳng hạn như Áo, Quần và Nhân vật
		-- R15 sử dụng MeshPart và R6 sử dụng Part, vì vậy chúng ta sử dụng BasePart ở đây để phát hiện cả hai:
		if child:IsA("BasePart") then
			child.BrickColor = color
		end
	end
end
paintFigure(Players.Player.Character, BrickColor.new("Bright blue"))
```
Vì tất cả các lớp đều kế thừa từ `Class.Object`, việc gọi
`object:IsA("Object")` sẽ luôn trả về true.


Object:IsA

className

Lớp mà lớp của Object sẽ được kiểm tra.
Phân biệt chữ hoa chữ thường.


Mô tả xem lớp của Object có khớp hoặc là một lớp con của lớp
được chỉ định hay không.


Trả về true nếu lớp của một đối tượng khớp hoặc kế thừa từ một lớp nhất định.


Object:isA

Object

Một chuỗi chỉ đọc đại diện cho lớp mà `Class.Object` này thuộc về.

Thuộc tính này có thể được sử dụng với nhiều hàm khác nhau được sử dụng để
xác định các đối tượng theo loại, chẳng hạn như `Class.Object:IsA()` hoặc
`Class.Instance:FindFirstChildOfClass()`.

Lưu ý rằng thuộc tính này chỉ đọc và không thể bị thay đổi bởi các script.
Các nhà phát triển muốn thay đổi lớp của một đối tượng sẽ phải tạo
một `Class.Object` mới.

Khác với `Class.Object:IsA()`, ClassName có thể được sử dụng để kiểm tra xem một đối tượng
thuộc về một lớp cụ thể mà không quan tâm đến kế thừa lớp. Ví dụ:


Object.ClassName

Một chuỗi chỉ đọc đại diện cho lớp mà `Class.Object` này thuộc về.


Object.className

`Object` là lớp cơ sở cho tất cả các lớp trong hệ thống lớp của Roblox.


Luau

Dictionary

Một logger có tên phát ra các mục log có cấu trúc được giới hạn trong một đường dẫn phân cấp.

Class

Loại tin nhắn và mức độ nghiêm trọng.

Enum

Enum.MessageType

Một đối tượng chạy các hàm kết nối khi xảy ra một sự kiện cụ thể.

Data Type

RBXScriptSignal

Kiểu dữ liệu có giá trị là đúng hoặc sai.

boolean

Một chuỗi các ký tự, chẳng hạn như chữ cái, số và ký hiệu.

string

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

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.

Cấp quyền truy cập để điều chỉnh tài khoản thanh toán và mua tín dụng quảng cáo.

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 cảnh báo về dữ liệu phân tích.

Cấp quyền tạo hoặc sửa đổi cảnh báo về dữ liệu phân tích.

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

Cấp quyền ghi dữ liệu cho những tài nguyên liên quan đến 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.

Quyền này cho phép bạn xem hình nhỏ và cài đặt cá nhân hóa hình nhỏ cho trải nghiệm của mình.

Quyền này cho phép bạn tải lên và xóa hình nhỏ cũng như quản lý cài đặt cá nhân hóa hình nhỏ cho trải nghiệm của mình.

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.

Cấp quyền đọc sự kiện của trò chơi.

Cấp quyền chỉnh sửa sự kiện của trò chơi

Đ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.

Tóm tắt