แสดงวิธีการใช้ `Datatype.Font.new()`。

สร้าง `Datatype.Font` ใหม่。

Font.new

family

ID แอสเซ็ทสำหรับฟอนต์แฟมิลี่เริ่มต้นด้วย `rbxasset://` หรือ `rbxassetid://`。

weight

ความหนาของข้อความ。

style

ข้อความปกติหรือเอียง。

โค้ดตัวอย่างด้านล่างแสดงวิธีการใช้ `Datatype.Font.fromEnum()` ในตัวอย่างนี้ `Enum.Font.SciFi` จะแมพไปยัง `rbxasset://fonts/families/Zekton.json` ด้วยน้ำหนักปกติ `Datatype.Font.Weight|Weight` และสไตล์ปกติ `Datatype.Font.Style|Style`。


สร้าง `Datatype.Font` จากค่าของ `Enum.Font` จะโยนข้อผิดพลาดเมื่อเรียกใช้ด้วย `Enum.Font.Unknown`。

ตารางด้านล่างแสดงถึงค่าของ `Enum.Font` ที่เชื่อมโยงกับฟอนต์ `Datatype.Font.Family|Family`。

<table size="small">
<thead>
<tr>
 <th>ฟอนต์ Enum</th>
 <th>ฟามิลีที่เทียบเท่า</th>
</tr>
</thead>
<tbody>
<tr>
 <td><code>Enum.Font.AmaticSC|AmaticSC</code></td>
 <td><code>rbxasset://fonts/families/AmaticSC.json</code></td>
</tr>
<tr>
 <td><code>Enum.Font.Antique|Antique</code></td>
 <td><code>rbxasset://fonts/families/RomanAntique.json</code></td>
</tr>
<tr>
 <td><code>Enum.Font.Arcade|Arcade</code></td>
 <td><code>rbxasset://fonts/families/PressStart2P.json</code></td>
</tr>
<tr>
 <td><code>Enum.Font.Arimo|Arimo</code>, <code>Enum.Font.ArimoBold|ArimoBold</code></td>
 <td><code>rbxasset://fonts/families/Arimo.json</code></td>
</tr>
<tr>
 <td><code>Enum.Font.Bangers|Bangers</code></td>
 <td><code>rbxasset://fonts/families/Bangers.json</code></td>
</tr>
<tr>
 <td><code>Enum.Font.Bodoni|Bodoni</code></td>
 <td><code>rbxasset://fonts/families/AccanthisADFStd.json</code></td>
</tr>
<tr>
 <td><code>Enum.Font.BuilderSans|BuilderSans</code>, <code>Enum.Font.BuilderSansMedium|BuilderSansMedium</code>, <code>Enum.Font.BuilderSansBold|BuilderSansBold</code>, <code>Enum.Font.BuilderSansExtraBold|BuilderSansExtraBold</code></td>
 <td><code>rbxasset://fonts/families/BuilderSans.json</code></td>
</tr>
<tr>
 <td><code>Enum.Font.Cartoon|Cartoon</code></td>
 <td><code>rbxasset://fonts/families/ComicNeueAngular.json</code></td>
</tr>
<tr>
 <td><code>Enum.Font.Code|Code</code></td>
 <td><code>rbxasset://fonts/families/Inconsolata.json</code></td>
</tr>
<tr>
 <td><code>Enum.Font.Creepster|Creepster</code></td>
 <td><code>rbxasset://fonts/families/Creepster.json</code></td>
</tr>
<tr>
 <td><code>Enum.Font.DenkOne|DenkOne</code></td>
 <td><code>rbxasset://fonts/families/DenkOne.json</code></td>
</tr>
<tr>
 <td><code>Enum.Font.Fantasy|Fantasy</code></td>
 <td><code>rbxasset://fonts/families/Balthazar.json</code></td>
</tr>
<tr>
 <td><code>Enum.Font.Fondamento|Fondamento</code></td>
 <td><code>rbxasset://fonts/families/Fondamento.json</code></td>
</tr>
<tr>
 <td><code>Enum.Font.FredokaOne|FredokaOne</code></td>
 <td><code>rbxasset://fonts/families/FredokaOne.json</code></td>
</tr>
<tr>
 <td><code>Enum.Font.Garamond|Garamond</code></td>
 <td><code>rbxasset://fonts/families/Guru.json</code></td>
</tr>
<tr>
 <td><code>Enum.Font.GrenzeGotisch|GrenzeGotisch</code></td>
 <td><code>rbxasset://fonts/families/GrenzeGotisch.json</code></td>
</tr>
<tr>
 <td><code>Enum.Font.Highway|Highway</code></td>
 <td><code>rbxasset://fonts/families/HighwayGothic.json</code></td>
</tr>
<tr>
 <td><code>Enum.Font.IndieFlower|IndieFlower</code></td>
 <td><code>rbxasset://fonts/families/IndieFlower.json</code></td>
</tr>
<tr>
 <td><code>Enum.Font.JosefinSans|JosefinSans</code></td>
 <td><code>rbxasset://fonts/families/JosefinSans.json</code></td>
</tr>
<tr>
 <td><code>Enum.Font.Jura|Jura</code></td>
 <td><code>rbxasset://fonts/families/Jura.json</code></td>
</tr>
<tr>
 <td><code>Enum.Font.Kalam|Kalam</code></td>
 <td><code>rbxasset://fonts/families/Kalam.json</code></td>
</tr>
<tr>
 <td><code>Enum.Font.Legacy|Legacy</code></td>
 <td><code>rbxasset://fonts/families/LegacyArial.json</code></td>
</tr>
<tr>
 <td><code>Enum.Font.LuckiestGuy|LuckiestGuy</code></td>
 <td><code>rbxasset://fonts/families/LuckiestGuy.json</code></td>
</tr>
<tr>
 <td><code>Enum.Font.Merriweather|Merriweather</code></td>
 <td><code>rbxasset://fonts/families/Merriweather.json</code></td>
</tr>
<tr>
 <td><code>Enum.Font.Michroma|Michroma</code></td>
 <td><code>rbxasset://fonts/families/Michroma.json</code></td>
</tr>
<tr>
 <td><code>Enum.Font.Nunito|Nunito</code></td>
 <td><code>rbxasset://fonts/families/Nunito.json</code></td>
</tr>
<tr>
 <td><code>Enum.Font.Oswald|Oswald</code></td>
 <td><code>rbxasset://fonts/families/Oswald.json</code></td>
</tr>
<tr>
 <td><code>Enum.Font.PatrickHand|PatrickHand</code></td>
 <td><code>rbxasset://fonts/families/PatrickHand.json</code></td>
</tr>
<tr>
 <td><code>Enum.Font.PermanentMarker|PermanentMarker</code></td>
 <td><code>rbxasset://fonts/families/PermanentMarker.json</code></td>
</tr>
<tr>
 <td><code>Enum.Font.Roboto|Roboto</code></td>
 <td><code>rbxasset://fonts/families/Roboto.json</code></td>
</tr>
<tr>
 <td><code>Enum.Font.RobotoCondensed|RobotoCondensed</code></td>
 <td><code>rbxasset://fonts/families/RobotoCondensed.json</code></td>
</tr>
<tr>
 <td><code>Enum.Font.RobotoMono|RobotoMono</code></td>
 <td><code>rbxasset://fonts/families/RobotoMono.json</code></td>
</tr>
<tr>
 <td><code>Enum.Font.Sarpanch|Sarpanch</code></td>
 <td><code>rbxasset://fonts/families/Sarpanch.json</code></td>
</tr>
<tr>
 <td><code>Enum.Font.SciFi|SciFi</code></td>
 <td><code>rbxasset://fonts/families/Zekton.json</code></td>
</tr>
<tr>
 <td><code>Enum.Font.SourceSans|SourceSans</code>, <code>Enum.Font.SourceSansBold|SourceSansBold</code>, <code>Enum.Font.SourceSansItalic|SourceSansItalic</code>, <code>Enum.Font.SourceSansLight|SourceSansLight</code>, <code>Enum.Font.SourceSansSemibold|SourceSansSemibold</code></td>
 <td><code>rbxasset://fonts/families/SourceSansPro.json</code></td>
</tr>
<tr>
 <td><code>Enum.Font.SpecialElite|SpecialElite</code></td>
 <td><code>rbxasset://fonts/families/SpecialElite.json</code></td>
</tr>
<tr>
 <td><code>Enum.Font.TitilliumWeb|TitilliumWeb</code></td>
 <td><code>rbxasset://fonts/families/TitilliumWeb.json</code></td>
</tr>
<tr>
 <td><code>Enum.Font.Ubuntu|Ubuntu</code></td>
 <td><code>rbxasset://fonts/families/Ubuntu.json</code></td>
</tr>
</tbody>
</table>

Font.fromEnum

font

ค่า enum ของฟอนต์ที่จะใช้。

สร้าง `Datatype.Font` จากค่า `Enum.Font`。

แสดงวิธีการใช้ `Datatype.Font.fromName()`.

นี่คือวิธีที่สะดวกในการสร้างฟอนต์จากโฟลเดอร์เนื้อหา ชื่อที่คุณใส่เข้าไปจะถูกแปลงเป็น ID แอสเซ็ตเช่น `rbxasset://fonts/families/BuilderSans.json`。

ชื่อสามารถประกอบด้วยตัวอักษรภาษาอังกฤษ หมายเลข `_` (ขีดล่าง) และ `-` (ขีดกลาง) เท่านั้น ไม่สามารถมีช่องว่างได้.

Font.fromName

name

สร้าง `Datatype.Font` จากชื่อเช่น `FredokaOne`.

แสดงวิธีการใช้ `Datatype.Font.fromId()`.

นี่คือวิธีการสะดวกในการสร้างฟอนต์จากหมายเลข ID แอสเซ็ท。

Font.fromId

ID แอสเซ็ทของฟอนต์ในรูปแบบหมายเลข。

สร้าง `Datatype.Font` จาก ID แอสเซ็ตประเภทตัวเลข.

อธิบายเกี่ยวกับฟอนต์ที่ใช้ในการเรนเดอร์ข้อความ ฟอนต์แต่ละตัวประกอบไปด้วย **ฟอนต์
แบบครอบครัว**, **น้ำหนัก** เช่น `Enum.FontWeight.Bold`, และ **สไตล์** เช่น
`Enum.FontStyle.Italic`.

ฟอนต์แบบครอบครัวเป็นประเภทของทรัพย์สิน เช่น รูปภาพหรือเมช ฟอนต์แต่ละแบบครอบครัว
มีจำนวนฟอนต์หน้าที่แตกต่างกัน และแต่ละหน้ามีน้ำหนักและสไตล์ที่แตกต่างกัน.

`Datatype.Font` ถูกใช้โดย `Class.TextLabel.FontFace`,
`Class.TextButton.FontFace`, `Class.TextBox.FontFace`, และคุณสมบัติที่คล้ายกัน.
ดู `Enum.Font` เป็นตัวเลือกที่เก่ากว่าสำหรับประเภทข้อมูลนี้ที่จำเป็นต้องใช้
โดยบางวิธีและคุณสมบัติ.

<table size="small">
<thead>
<tr>
 <th width="25%">ชื่อ</th>
 <th width="75%">รหัสทรัพย์สิน / น้ำหนัก / รายละเอียด</th>
</tr>
</thead>
<tbody>
<tr>
 <td>Accanthis ADF Std</td>
 <td><code>rbxasset://fonts/families/AccanthisADFStd.json</code> <img src="../../../assets/engine-api/datatypes/Font/Accanthis-ADF-Std.png" /></td>
</tr>
<tr>
 <td>Amatic SC</td>
 <td><code>rbxasset://fonts/families/AmaticSC.json</code> <img src="../../../assets/engine-api/datatypes/Font/Amatic-SC.png" /></td>
</tr>
<tr>
 <td>Arimo</td>
 <td><code>rbxasset://fonts/families/Arimo.json</code> <img src="../../../assets/engine-api/datatypes/Font/Arimo.png" /></td>
</tr>
<tr>
 <td>Balthazar</td>
 <td><code>rbxasset://fonts/families/Balthazar.json</code> <img src="../../../assets/engine-api/datatypes/Font/Balthazar.png" /></td>
</tr>
<tr>
 <td>Bangers</td>
 <td><code>rbxasset://fonts/families/Bangers.json</code> <img src="../../../assets/engine-api/datatypes/Font/Bangers.png" /></td>
</tr>
<tr>
 <td>Builder Extended</td>
 <td><code>rbxasset://fonts/families/BuilderExtended.json</code> <img src="../../../assets/engine-api/datatypes/Font/Builder-Extended.png" /></td>
</tr>
<tr>
 <td>Builder Mono</td>
 <td><code>rbxasset://fonts/families/BuilderMono.json</code> <img src="../../../assets/engine-api/datatypes/Font/Builder-Mono.png" /></td>
</tr>
<tr>
 <td>Builder Sans</td>
 <td><code>rbxasset://fonts/families/BuilderSans.json</code> <img src="../../../assets/engine-api/datatypes/Font/Builder-Sans.png" /></td>
</tr>
<tr>
 <td>Comic Neue Angular</td>
 <td><code>rbxasset://fonts/families/ComicNeueAngular.json</code> <img src="../../../assets/engine-api/datatypes/Font/Comic-Neue-Angular.png" /></td>
</tr>
<tr>
 <td>Creepster</td>
 <td><code>rbxasset://fonts/families/Creepster.json</code> <img src="../../../assets/engine-api/datatypes/Font/Creepster.png" /></td>
</tr>
<tr>
 <td>Denk One</td>
 <td><code>rbxasset://fonts/families/DenkOne.json</code> <img src="../../../assets/engine-api/datatypes/Font/Denk-One.png" /></td>
</tr>
<tr>
 <td>Fondamento</td>
 <td><code>rbxasset://fonts/families/Fondamento.json</code> <img src="../../../assets/engine-api/datatypes/Font/Fondamento.png" /></td>
</tr>
<tr>
 <td>Fredoka One</td>
 <td><code>rbxasset://fonts/families/FredokaOne.json</code> <img src="../../../assets/engine-api/datatypes/Font/Fredoka-One.png" /></td>
</tr>
<tr>
 <td>Grenze Gotisch</td>
 <td><code>rbxasset://fonts/families/GrenzeGotisch.json</code> <img src="../../../assets/engine-api/datatypes/Font/Grenze-Gotisch.png" /></td>
</tr>
<tr>
 <td>Guru</td>
 <td><code>rbxasset://fonts/families/Guru.json</code> <img src="../../../assets/engine-api/datatypes/Font/Guru.png" /></td>
</tr>
<tr>
 <td>Highway Gothic</td>
 <td><code>rbxasset://fonts/families/HighwayGothic.json</code> <img src="../../../assets/engine-api/datatypes/Font/Highway-Gothic.png" /></td>
</tr>
<tr>
 <td>Inconsolata</td>
 <td><code>rbxasset://fonts/families/Inconsolata.json</code> <img src="../../../assets/engine-api/datatypes/Font/Inconsolata.png" /></td>
</tr>
<tr>
 <td>Indie Flower</td>
 <td><code>rbxasset://fonts/families/IndieFlower.json</code> <img src="../../../assets/engine-api/datatypes/Font/Indie-Flower.png" /></td>
</tr>
<tr>
 <td>Josefin Sans</td>
 <td><code>rbxasset://fonts/families/JosefinSans.json</code> <img src="../../../assets/engine-api/datatypes/Font/Josefin-Sans.png" /></td>
</tr>
<tr>
 <td>Jura</td>
 <td><code>rbxasset://fonts/families/Jura.json</code> <img src="../../../assets/engine-api/datatypes/Font/Jura.png" /></td>
</tr>
<tr>
 <td>Kalam</td>
 <td><code>rbxasset://fonts/families/Kalam.json</code> <img src="../../../assets/engine-api/datatypes/Font/Kalam.png" /></td>
</tr>
<tr>
 <td>Luckiest Guy</td>
 <td><code>rbxasset://fonts/families/LuckiestGuy.json</code> <img src="../../../assets/engine-api/datatypes/Font/Luckiest-Guy.png" /></td>
</tr>
<tr>
 <td>Merriweather</td>
 <td><code>rbxasset://fonts/families/Merriweather.json</code> <img src="../../../assets/engine-api/datatypes/Font/Merriweather.png" /></td>
</tr>
<tr>
 <td>Michroma</td>
 <td><code>rbxasset://fonts/families/Michroma.json</code> <img src="../../../assets/engine-api/datatypes/Font/Michroma.png" /></td>
</tr>
<tr>
 <td>Montserrat</td>
 <td><code>rbxasset://fonts/families/Montserrat.json</code> <img src="../../../assets/engine-api/datatypes/Font/Montserrat.png" /></td>
</tr>
<tr>
 <td>Nunito</td>
 <td><code>rbxasset://fonts/families/Nunito.json</code> <img src="../../../assets/engine-api/datatypes/Font/Nunito.png" /></td>
</tr>
<tr>
 <td>Oswald</td>
 <td><code>rbxasset://fonts/families/Oswald.json</code> <img src="../../../assets/engine-api/datatypes/Font/Oswald.png" /></td>
</tr>
<tr>
 <td>Patrick Hand</td>
 <td><code>rbxasset://fonts/families/PatrickHand.json</code> <img src="../../../assets/engine-api/datatypes/Font/Patrick-Hand.png" /></td>
</tr>
<tr>
 <td>Permanent Marker</td>
 <td><code>rbxasset://fonts/families/PermanentMarker.json</code> <img src="../../../assets/engine-api/datatypes/Font/Permanent-Marker.png" /></td>
</tr>
<tr>
 <td>Press Start 2P</td>
 <td><code>rbxasset://fonts/families/PressStart2P.json</code> <img src="../../../assets/engine-api/datatypes/Font/Press-Start-2P.png" /></td>
</tr>
<tr>
 <td>Roboto</td>
 <td><code>rbxasset://fonts/families/Roboto.json</code> <img src="../../../assets/engine-api/datatypes/Font/Roboto.png" /></td>
</tr>
<tr>
 <td>Roboto Condensed</td>
 <td><code>rbxasset://fonts/families/RobotoCondensed.json</code> <img src="../../../assets/engine-api/datatypes/Font/Roboto-Condensed.png" /></td>
</tr>
<tr>
 <td>Roboto Mono</td>
 <td><code>rbxasset://fonts/families/RobotoMono.json</code> <img src="../../../assets/engine-api/datatypes/Font/Roboto-Mono.png" /></td>
</tr>
<tr>
 <td>Roman Antique</td>
 <td><code>rbxasset://fonts/families/RomanAntique.json</code> <img src="../../../assets/engine-api/datatypes/Font/Roman-Antique.png" /></td>
</tr>
<tr>
 <td>Sarpanch</td>
 <td><code>rbxasset://fonts/families/Sarpanch.json</code> <img src="../../../assets/engine-api/datatypes/Font/Sarpanch.png" /></td>
</tr>
<tr>
 <td>Source Sans Pro</td>
 <td><code>rbxasset://fonts/families/SourceSansPro.json</code> <img src="../../../assets/engine-api/datatypes/Font/Source-Sans-Pro.png" /></td>
</tr>
<tr>
 <td>Special Elite</td>
 <td><code>rbxasset://fonts/families/SpecialElite.json</code> <img src="../../../assets/engine-api/datatypes/Font/Special-Elite.png" /></td>
</tr>
<tr>
 <td>Titillium Web</td>
 <td><code>rbxasset://fonts/families/TitilliumWeb.json</code> <img src="../../../assets/engine-api/datatypes/Font/Titillium-Web.png" /></td>
</tr>
<tr>
 <td>Ubuntu</td>
 <td><code>rbxasset://fonts/families/Ubuntu.json</code> <img src="../../../assets/engine-api/datatypes/Font/Ubuntu.png" /></td>
</tr>
<tr>
 <td>Zekton</td>
 <td><code>rbxasset://fonts/families/Zekton.json</code> <img src="../../../assets/engine-api/datatypes/Font/Zekton.png" /></td>
</tr>
</tbody>
</table>

Font

ID แอสเซ็ทสำหรับฟอนต์แฟมิลี่ ซึ่งเริ่มต้นด้วย `rbxasset://` หรือ `rbxassetid://`。

Font.Family

ID แอสเซ็ทสำหรับฟอนต์แฟมิลี่。

ความหนาของข้อความ ค่าดีฟอลต์คือ `Enum.FontWeight.Regular`。

เมื่อถูกตั้งค่า `Datatype.Font.Bold` จะถูกอัปเดตและกลายเป็น `true` หากน้ำหนัก
คือ `Enum.FontWeight.SemiBold` หรือหนากว่า。

Font.Weight

ฟอนต์เป็นอิตาลิกหรือไม่ ค่าดีฟอลต์คือ `Enum.FontStyle.Normal`。

Font.Style

ฟอนต์เป็นเอียงหรือไม่。

ฟอนต์เป็นตัวหนาหรือไม่ ตั้งค่า `Datatype.Font.Weight` เป็น
`Enum.FontWeight.Bold` เมื่อ `true` หรือเป็น `Enum.FontWeight.Regular`
ในกรณีอื่น。

Font.Bold

ฟอนต์หนาหรือไม่。

อธิบายฟอนต์ที่ใช้ในการเรนเดอร์ข้อความ。

แสดงถึงการอ้างอิงไปยังเนื้อหาทรัพย์สินที่จัดเก็บภายนอกหรือเป็นวัตถุ ภายในสถานที่。

Data Type

Content

อีหน่วย `Font` ใช้ใน `Class.TextBox`, `Class.TextLabel`, `Class.TextButton`, และวัตถุ GUI ที่คล้ายกันเพื่อกำหนดว่าจะให้แสดงข้อความอย่างไร  ดูยัง `Datatype.Font` ซึ่งเป็นทางเลือกที่ใหม่กว่าในอีหน่วยนี้ที่ แนบฟอนต์เป็นประเภทข้อมูลและให้การเข้าถึงฟอนต์มากกว่าที่อีหน่วยนี้ อนุญาต

Enum

Enum.Font

อธิบายว่าสไตล์ `Datatype.Font` เป็นปกติหรือเอียง

Enum.FontStyle

อธิบายว่าความหนาของ `Datatype.Font` เป็นอย่างไร

Enum.FontWeight

วัตถุที่เรียกใช้งานฟังก์ชันที่เชื่อมต่อเมื่อมีเหตุการณ์เฉพาะเกิดขึ้น。

RBXScriptSignal

ประเภทข้อมูลที่มีค่าเป็นจริงหรือเท็จ

Luau

boolean

หมายเลขแบบทศนิยมความแม่นยำคู่

number

ชุดของตัวอักษร เช่น ตัวอักษร ตัวเลข และสัญลักษณ์

string

ประสบการณ์

อวาตาร์

ทรัพยากร

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

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 และสถานะที่ยืนยันแล้วของผู้ใช้

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

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

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