HTTP APIs for working with places on Roblox Cloud.

Open Cloud v2

Open Cloud v1

Legacy APIs with API key

Develop v2 with API key

Develop v1 with API key

Legacy APIs

Places

Tổng Quan

Hướng Dẫn

Tham Khảo

Tài Nguyên

Nghệ Thuật

Thiết Kế

Động Cơ

Avatar

Đám Mây

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.

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.

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

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.

Cần có các quyền khóa API sau đây để gọi ra điểm cuối này. Để biết thêm
thông tin về cách tạo các khóa thích hợp, 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}).

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.

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 có mô tả nào được cung cấp.

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

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.

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

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

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 quản lý các sản phẩm phát triển của bạn.

Cấp quyền đọc thông tin về các trải nghiệm mà bạn đang theo dõi.

Cấp quyền thay mặt bạn theo dõi và bỏ theo dõi các 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.

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

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

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

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.

Thao tác này cấp quyền đăng tải các phiên bản mới của trải nghiệm cho Roblox.

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

Cấp khả năng chỉnh sửa thông tin trải nghiệm.

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.

Cấp khả năng đọc trạng thái premium và trạng thái đã xác thực của người dùng.

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

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

Giá Trị Mặc Định: {defaultValueStart}{defaultValueEnd}

Mảng là danh sách các giá trị được sắp xếp theo thứ tự. Mảng rất hữu ích để lưu trữ các bộ dữ liệu.

Một tập hợp các cặp giá trị khóa, trong đó khóa có thể là bất kỳ số, chuỗi hoặc đối tượng nào.

Chẳng hạn {tuples}, một danh sách các giá trị.

Hàm này sẽ trả về kết quả ngay lập tức nếu có thể, nhưng cũng có khả năng tạm dừng luồng đã gọi hàm cho đến khi hàm có giá trị để trả về.

{nameStart}tên{nameEnd} không còn được hỗ trợ hoặc duy trì bởi Roblox.

Phép toán này không còn được hỗ trợ hoặc duy trì bởi Roblox.

Thành phần này không xuất hiện trong trình duyệt đối tượng và không dành cho mục đích sử dụng rộng rãi.

Chỉ có thể truy cập thành phần thông qua thanh lệnh. Việc sử dụng thành phần này trong kịch bản sẽ gây ra lỗi.

Hàm này không thể tạm dừng luồng Lua đã gọi hàm.

Việc cố gắng truy cập thành phần này trong kịch bản sẽ gây ra lỗi. Tuy nhiên, bạn có thể truy cập thành phần này từ cửa sổ thuộc tính của Roblox Studio.

Thành phần này không xuất hiện trong Trình duyệt Đối tượng của Roblox Studio.

Bạn không thể tạo một phiên bản của lớp này với hàm khởi tạo Instance.new.

Roblox không sao chép thành phần này qua ranh giới máy chủ - máy khách.

Mã Lua không thể truy cập thành phần này. Bạn có thể thay đổi giá trị của nó từ cửa sổ thuộc tính trong Roblox Studio.

Thành viên này có thể truy cập từ các nhiệm vụ thực thi OpenCloud Luau.

Hành vi sao chép của đối tượng này phụ thuộc vào người chơi sở hữu nó.

Có thể truy cập thành phần thông qua thanh lệnh và plugin. Việc sử dụng thành phần này trong tập lệnh sẽ gây ra lỗi.

Thành phần này ở dạng chỉ đọc. Việc cố ghi vào thành phần này sẽ gây ra lỗi.

Thuộc tính này ở dạng chỉ đọc và có thể đọc an toàn trên các luồng không đồng bộ. Việc cố gắng ghi vào thuộc tính này sẽ gây ra lỗi.

Chỉ có thể truy cập thành phần này trong CoreScripts.

Chỉ Roblox CoreScripts mới có thể truy cập thành phần này, và Người Chơi không thể truy cập được.

Bạn có thể đọc và ghi vào thuộc tính này một cách an toàn từ nhiều luồng.

Lớp này là một singleton hàng đầu. Hãy lấy một phiên bản của lớp này bằng hàm GetService.

Nhiều luồng có thể ghi thuộc tính này, vì vậy việc đọc từ các luồng không đồng bộ sẽ là một việc không an toàn.

Hàm này sẽ tạm dừng luồng Lua đã gọi hàm cho đến khi hàm này trả về một kết quả. Tuy nhiên, việc tạm dừng này không ảnh hưởng đến các kịch bản khác đang chạy.

Xây dựng trải nghiệm đầu tiên của bạn

Quản lý và phân tích tất cả trải nghiệm tiện lợi chỉ trong một nơi.

Học qua tài liệu và tài nguyên cho tất cả các nhà sáng tạo.

Học cách sáng tạo trải nghiệm Roblox với chỉ dẫn, hướng dẫn và mã mẫu.

Xây dựng trải nghiệm của bạn trong Studio, IDE toàn diện của chúng tôi và triển khai trên nhiều thiết bị khác nhau.

Cách đáng tin cậy để mang đến giá trị cho đối tượng khách hàng theo thời gian

Tìm hiểu cách tạo quảng cáo thành công thúc đẩy lưu lượng truy cập đến các nội dung sáng tạo của bạn

Lập biểu đồ cho thấy sự phát triển của trải nghiệm và khám phá các cơ hội để cải thiện

Tìm hiểu cách áp dụng chuyển động cho nhân vật và môi trường

Tìm hiểu cách tải lên hoặc sử dụng tài sản từ Cửa Hàng trong các nội dung sáng tạo của bạn

Tạo các vật phẩm Avatar và đăng tải lên Chợ

Sắp xếp theo doanh thu cao nhất trong 7 ngày qua

Tìm hiểu xem bạn có thể tạo và bán những gì trên chợ

Avatar là một nhân vật có thể tùy chỉnh để đại diện cho mọi người dùng Roblox

Xem chủ đề này về các nội dung sáng tạo tuyệt vời đang được cộng đồng xây dựng

Tìm hiểu các kỹ thuật tạo mô hình cơ bản trong blender

Tìm các mô hình, kịch bản và plugin được tạo bởi những nhà sáng tạo khác

Tìm hiểu cách tạo khung các vật phẩm avatar từ nghệ sĩ 3D của riêng bạn trên Roblox

Tìm hiểu cách điều chỉnh nhân vật để đảm bảo tất cả các tính năng avatar hoạt động bình thường

Tìm hiểu cách tạo các vật thể tương tác với thế giới hoặc người dùng khác

Tạo và bán vật phẩm trang phục cơ bản đầu tiên của bạn trên Roblox

Sử dụng các công cụ cộng tác của Studio để làm việc với nhóm của bạn cùng một lúc

Xem những gì đang thịnh hành trên Chợ Nhà Sáng Tạo

Xem những gì đang thịnh hành trên Cửa Hàng Nhà Sáng Tạo

Tham gia vào các sự kiện cộng đồng do những Nhà Sáng Tạo khác tổ chức

Tìm hướng dẫn được viết bởi cộng đồng Nhà Sáng Tạo

Giúp người chơi duy trì tương tác và kiếm tiền với các bản cập nhật nội dung

Thu hút đối tượng bằng một chu kỳ chơi thú vị

Thúc đẩy mức độ tương tác và tiến độ với trò chơi lặp thú vị

Tìm hiểu cách tạo một cánh cửa trượt mà không cần viết bất kỳ mã nào

Alex chia sẻ những trải nghiệm thực tế về quá trình tạo ra một trải nghiệm trò chơi thịnh hành, Vượt Ngục

Blake đã tìm thấy niềm đam mê trong việc tạo ra các trò chơi lễ hội kỳ quặc, thực tế

The Clemens là một studio gia đình đã tạo ra các trò chơi thịnh hành như Trò Chơi Sinh Tồn

Jasmine là nghệ sĩ đã tạo ra một số mặt hàng avatar phổ biến nhất trên Chợ

Jessica là nhà thiết kế đằng sau các môi trường giàu trí tưởng tượng như trong Alo Yoga

Jenni là người tạo ra UGC và là tác giả của nhiều sản phẩm hợp tác nổi tiếng

Phong cách độc đáo của Morphist kết hợp giữa thiết kế dễ thương và emo

Các nhà sáng tạo Riotfall đi du lịch để tìm cảm hứng cho môi trường nhập vai của họ

Stephen chia sẻ đam mê về các công cụ lập trình

Sam chia sẻ cách mình bắt đầu thiết kế các vật phẩm thời trang mà mình muốn có

Tất cả các đối tượng tạo nên một thế giới 3D, chẳng hạn như các bộ phận và ánh sáng

Tìm hiểu về các công cụ gỡ lỗi có sẵn trong Studio

Xem tiến độ của bạn với lần rút tiền tiếp theo!

Sử dụng bảng điều khiển dành cho nhà phát triển để gỡ lỗi trải nghiệm của bạn khi thử nghiệm

Thêm gói đăng ký vào trải nghiệm để giúp xây dựng mối quan hệ lâu dài với cơ sở người dùng. Cho phép đăng ký trước ngày 15 tháng 12 năm 2023 và tận hưởng 3 tháng với giá thấp hơn.

Xem những Trải Nghiệm hàng đầu để lấy cảm hứng

Bắt đầu với Studio, công cụ sáng tạo của Roblox

Thêm một vài dòng mã để mở khóa bảng điều khiển mới nhằm hiểu rõ hơn phễu làm quen của bạn và các phễu khác, đồng thời theo dõi kinh tế trong trò chơi của bạn.

Minty dạy Enyu về hình học không gian kết cấu.

Xây dựng các sự kiện và cảnh cắt ngắn trực tiếp giữa các máy chủ trên một chuỗi có cấu trúc

Tìm hiểu cách tạo sự kiện theo thời gian cho trải nghiệm của bạn

Tạo sự kiện trên cơ sở thời gian để tăng khả năng tìm kiếm trên Roblox. Thông báo bản cập nhật mới nhất của bạn, nêu bật một hoạt động hoặc kỷ niệm một cột mốc với người chơi của bạn!

Tìm hiểu cách nhắm mục tiêu đúng nhóm tuổi cho Nội Dung Sáng Tạo của bạn thông qua Hướng Dẫn Dành Cho Người Có Kinh Nghiệm

Nhận kiến thức và chuyên môn trực tiếp từ Roblox

Tìm hiểu cách triển khai hệ thống tiền thưởng khi mời bạn bè

Nắm được những điều cơ bản về cách tạo một trò chơi

Tìm hiểu xem bạn có thể kiểm soát cách dữ liệu của mình được sử dụng để huấn luyện AI như thế nào. {linkStart}Đọc Thêm{linkEnd}

Dễ dàng tạo kết cấu tùy chỉnh bằng các công cụ AI của chúng tôi

Sử dụng công cụ sáng tạo toàn diện của chúng tôi để xây dựng bất cứ thứ gì bạn có thể tưởng tượng

PolarCub chia sẻ tất cả các mẹo thủ thuật để tạo ra các mục UGC

Tận dụng Guilded để xây dựng cộng đồng dành cho Nội Dung Sáng Tạo của bạn

Tham gia cùng đội ngũ các nhà sáng tạo tuyệt vời của chúng tôi trong một cuộc thi sáng tạo game chủ đề Halloween

Sử dụng phần đầu để tạo hiệu ứng động cho khuôn mặt hoặc kích hoạt biểu cảm

Sử dụng số liệu để biết bạn có thể cải thiện lối chơi của mình như thế nào

Tìm hiểu làm thế nào để khiến người dùng quay trở lại trò chơi của bạn

Đầu vào cho người dùng sẽ giúp người dùng tương tác với môi trường trải nghiệm của bạn

Hướng dẫn người chơi trong lần đầu họ đến với trải nghiệm của bạn

Tạo quần áo vừa với cơ thể của bất kỳ avatar nào

Roblox tin rằng cách tốt nhất để học hỏi là qua thực hành. Hãy chọn một trong những hướng dẫn của chúng tôi để khám phá thêm những gì nền tảng này cung cấp.

Nhận hỗ trợ lập trình và được giải đáp cho các câu hỏi về sáng tạo của bạn

Dịch vụ Ánh Sáng và Âm Thanh cho phép bạn kiểm soát các hiệu ứng môi trường

Tìm hiểu cách điều chỉnh nội dung của bạn cho các ngôn ngữ và chuẩn mực văn hóa khác nhau

Hướng dẫn này sẽ đề cập đến các điểm gắn, chùm tia và một số khái niệm cơ bản về kịch bản để hướng dẫn cách đặt thanh máu của người chơi về 0 nếu họ chạm vào thứ gì đó

Làm thế nào để thử nghiệm nhanh những ý tưởng mới

Xây dựng cơ sở người chơi tích cực là một phần quan trọng trong việc phát triển một trò chơi thành công và lâu dài.

Bắt đầu với công cụ tối ưu hóa hiệu suất và xử lý sự cố

Microprofiler cung cấp thông tin thời gian cho trình lên lịch nhiệm vụ

Nghiên cứu tỉ mỉ màu sắc khung hình, đồ thị ngọn lửa, và nhiều hơn nữa

Nắm được cách sử dụng số liệu để thành công hơn

Cải thiện hiệu suất của tập lệnh Luau đòi hỏi tính toán lớn

Xem các điểm chuẩn, thông tin chuyên sâu và số liệu theo thời gian thực hàng ngày của bạn để đưa {boldStart}{experienceName}{boldEnd} lên một tầm cao mới.

Tìm hiểu cách sử dụng NPC (nhân vật không phải người chơi) trong trải nghiệm của bạn

@minty tạo ra obby trực tiếp từ đầu dựa trên những gợi ý từ cuộc trò chuyện

Nền tảng của chúng tôi cung cấp cho bạn những cơ hội sáng tạo vô song. Hãy bắt đầu bằng cách khám phá Trung Tâm Nhà Sáng Tạo, Roblox Studio và cộng đồng Nhà Sáng Tạo sôi động của chúng tôi.

Nền tảng của chúng tôi mang đến cho bạn những cơ hội đặc biệt để sáng tạo.

Cộng đồng các studio từng đoạt giải thưởng và các nhà sáng tạo tự học của chúng tôi giống như bạn đều bắt đầu từ đây. 

Một nghệ sĩ thiết kế môi trường chính tại Roblox thảo luận về cách sử dụng gói và lý do

Luồng nhân viên về trọng lực, tính chất vật liệu và các ràng buộc

Tìm hiểu về những gì xảy ra khi người dùng tham gia trải nghiệm

Plugin thêm các tính năng hoặc chức năng bổ sung cho các nội dung sáng tạo của bạn

Cùng tham quan Cửa Hàng Tại Nhà UGC của PolarCub và gặp gỡ Temprist!

Tìm hiểu cách thúc đẩy lưu lượng truy cập và nhận thức cho các nội dung sáng tạo của bạn

Xem lại toàn bộ điểm nổi bật của RDC năm nay

Tìm hiểu công cụ sáng tạo của chúng tôi có thể giúp bạn làm những gì

Học cách gắn khung xương cho mô hình nhân vật hình nhân R15

Tạo và bán phụ kiện cứng cơ bản đầu tiên của bạn trên Roblox

Xem trước một số tính năng và khả năng mới sắp có trên Roblox

Studio là công cụ cho phép bạn tạo trải nghiệm trên Roblox

Tìm hiểu cách sử dụng trình chỉnh sửa kịch bản trong Studio để tạo kịch bản tùy chỉnh

Viết kịch bản cho phép bạn thêm các tương tác nhập vai cho người dùng

Tìm hiểu các phím tắt Studio và các lệnh phím giúp xây dựng nhanh hơn

Tìm hiểu cách tích hợp các tính năng cho phép người chơi chơi với bạn bè

Tạo một Quảng Cáo Được Tài Trợ để Nội Dung Sáng Tạo của bạn xuất hiện trước nhiều Nhà Sáng Tạo hơn

Studio là một công cụ toàn diện để xây dựng trên Roblox. Hãy thử tạo một nội dung ngay hôm nay!

Tìm hiểu cách mang đến cho người chơi các lợi ích định kỳ với phí hàng tháng

Phát triển trải nghiệm của bạn với sự hỗ trợ của những Nhà Sáng Tạo khác

Sử dụng trình chỉnh sửa địa hình để tạo và thay đổi địa hình trong Studio

Những trải nghiệm như {boldStart}{experienceName}{boldEnd} chứng kiến tỷ lệ phiên chơi đủ điều kiện có tính năng cá nhân hóa tăng trung bình hơn 8,5%.

Bản dịch có thể giúp nội dung sáng tạo của bạn tiếp cận hàng ngàn đối tượng khác nhau

Khám phá mẫu Cửa Hàng Tại Nhà UGC mới cùng Minty và SCHLEEMPH

Tìm hiểu cách xây dựng cho đối tượng độc đáo của Roblox

Chúng là gì và làm thế nào để sử dụng chúng trong xây dựng

Xem một bài giới thiệu nhanh về cách tạo trên Roblox, sau đó truy cập Studio

Đọc các thông báo mới nhất từ Nhân Viên Roblox

Quản lý các nội dung sáng tạo của bạn trên Bảng Điều Khiển

Quản lý và phát triển các nội dung sáng tạo của bạn tất cả ở một nơi thuận tiện

Workspace chứa các đối tượng bạn muốn công cụ hiển thị trong dự án của mình

Luồng nhân viên bao gồm các bộ phận, lưới, địa hình và ánh sáng

Thêm nội dung cộng đồng vào Trải Nghiệm của bạn

Places

Open Cloud v2

Open Cloud v1

Legacy APIs with API key

Develop v2 with API key

Develop v1 with API key

Legacy APIs

Chat v2

Develop v2

Develop v1

Game join v1

Games v1

Inventory v1

Trên trang này