Text

เนื้อหาข้อความ

เนื้อหาข้อความทั่วไป ข้อความต้องอยู่ในรูปร่างที่ใช้งานร่วมกันได้ (เช่น ช่องข้อความหรือสี่เหลี่ยมผืนผ้า) หรือเซลล์ในตารางในหน้าเว็บ

การแสดง JSON 
{
  "textElements": [
    {
      object (TextElement)
    }
  ],
  "lists": {
    string: {
      object (List)
    },
    ...
  }
}
ช่อง
textElements[]

object (TextElement)

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

lists

map (key: string, value: object ( List))

รายการสัญลักษณ์หัวข้อย่อยที่อยู่ในข้อความนี้ แยกตามรหัสรายการ

องค์ประกอบข้อความ

TextElement อธิบายเนื้อหาของช่วงดัชนีในเนื้อหาของข้อความของรูปร่างหรือ TableCell

การแสดง JSON 
{
  "startIndex": integer,
  "endIndex": integer,

  // Union field kind can be only one of the following:
  "paragraphMarker": {
    object (ParagraphMarker)
  },
  "textRun": {
    object (TextRun)
  },
  "autoText": {
    object (AutoText)
  }
  // End of list of possible types for union field kind.
}
ช่อง
startIndex

integer

ดัชนีเริ่มต้นที่เป็นศูนย์ขององค์ประกอบข้อความนี้ในหน่วยโค้ด Unicode

endIndex

integer

ดัชนีสิ้นสุดแบบ 0 ขององค์ประกอบข้อความนี้ โดยเฉพาะในหน่วยโค้ด Unicode

ช่อง Union kind ประเภทของข้อความที่องค์ประกอบนี้แทน kind ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
paragraphMarker

object (ParagraphMarker)

เครื่องหมายที่แสดงจุดเริ่มต้นของย่อหน้าใหม่

startIndex และ endIndex ของ TextElement นี้แสดงถึงช่วงของย่อหน้า องค์ประกอบข้อความอื่นๆ ที่มีช่วงดัชนีที่อยู่ในช่วงของย่อหน้านี้ถือว่าเป็นส่วนหนึ่งของย่อหน้านี้ ช่วงของดัชนีใน 2 ย่อหน้าแยกกันจะไม่ทับซ้อนกัน

textRun

object (TextRun)

TextElement แสดงถึงการเรียกใช้ข้อความ โดยอักขระทั้งหมดในการเรียกใช้มี TextStyle เหมือนกัน

startIndex และ endIndex ของ TextRuns จะอยู่ในช่วงดัชนีของ paragraphMarkerElement Text เพียงครั้งเดียวเสมอ กล่าวคือ TextRun จะไม่ครอบคลุมหลายย่อหน้า

autoText

object (AutoText)

TextElement แสดงถึงจุดในข้อความที่จะถูกแทนที่ด้วยเนื้อหาที่เปลี่ยนแปลงได้ตลอดเวลา

ตัวทําเครื่องหมายย่อหน้า

ชนิด TextElement ที่แทนจุดเริ่มต้นของย่อหน้าใหม่

การแสดง JSON 
{
  "style": {
    object (ParagraphStyle)
  },
  "bullet": {
    object (Bullet)
  }
}
ช่อง
style

object (ParagraphStyle)

รูปแบบของย่อหน้า

bullet

object (Bullet)

หัวข้อย่อยของย่อหน้านี้ หากไม่มีย่อหน้า ย่อหน้าไม่ได้อยู่ในรายการ

ลักษณะของย่อหน้า

รูปแบบที่ใช้กับทั้งย่อหน้า

หากข้อความนี้อยู่ในรูปร่างที่มี placeholder ระดับบนสุด แสดงว่ารูปแบบย่อหน้าเหล่านี้จะรับค่ามาจากระดับบนสุด รูปแบบของย่อหน้าที่สืบทอดจะขึ้นอยู่กับระดับที่ซ้อนกันของรายการ

  • ย่อหน้าที่ไม่อยู่ในรายการจะรับค่าสไตล์ย่อหน้าจากย่อหน้าที่ระดับการซ้อน 0 ของรายการภายในตัวยึดตําแหน่งระดับบนสุด
  • ย่อหน้าในรายการจะรับค่าสไตล์ย่อหน้าจากย่อหน้าที่ระดับการซ้อนกันของรายการภายในตัวยึดตําแหน่งหลัก

รูปแบบย่อหน้าที่รับมาจะแสดงเป็นช่องที่ไม่ได้กําหนดค่าในข้อความนี้

การแสดง JSON 
{
  "lineSpacing": number,
  "alignment": enum (Alignment),
  "indentStart": {
    object (Dimension)
  },
  "indentEnd": {
    object (Dimension)
  },
  "spaceAbove": {
    object (Dimension)
  },
  "spaceBelow": {
    object (Dimension)
  },
  "indentFirstLine": {
    object (Dimension)
  },
  "direction": enum (TextDirection),
  "spacingMode": enum (SpacingMode)
}
ช่อง
lineSpacing

number

จํานวนวรรคระหว่างบรรทัด เป็นหน่วยปกติที่ปกติจะแสดงเป็น 100.0 หากไม่ได้ตั้งค่า ค่าดังกล่าวจะรับช่วงมาจากระดับบนสุด

alignment

enum (Alignment)

การจัดข้อความสําหรับย่อหน้านี้

indentStart

object (Dimension)

จํานวนการเยื้องของย่อหน้าทางด้านข้างของจุดเริ่มต้นข้อความ โดยจะขึ้นอยู่กับทิศทางของข้อความปัจจุบัน หากไม่ได้ตั้งค่า ค่าดังกล่าวจะรับช่วงมาจากระดับบนสุด

indentEnd

object (Dimension)

จํานวนการเยื้องของย่อหน้าที่ด้านท้ายของข้อความ โดยพิจารณาจากทิศทางของข้อความปัจจุบัน หากไม่ได้ตั้งค่า ค่าดังกล่าวจะรับช่วงมาจากระดับบนสุด

spaceAbove

object (Dimension)

ปริมาณพื้นที่เกินเหนือย่อหน้า หากไม่ได้ตั้งค่า ค่าดังกล่าวจะรับช่วงมาจากระดับบนสุด

spaceBelow

object (Dimension)

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

indentFirstLine

object (Dimension)

จํานวนการเยื้องที่ขึ้นต้นบรรทัดแรกของย่อหน้า หากไม่ได้ตั้งค่า ค่าดังกล่าวจะรับช่วงมาจากระดับบนสุด

direction

enum (TextDirection)

ทิศทางข้อความของย่อหน้านี้ หากไม่ได้ตั้งค่า ค่าเริ่มต้นจะเป็น LEFT_TO_RIGHT เนื่องจากไม่มีการรับทิศทางข้อความ

spacingMode

enum (SpacingMode)

โหมดระยะห่างสําหรับย่อหน้า

การจัดข้อความ

ประเภทของการจัดข้อความสําหรับย่อหน้า

Enum
ALIGNMENT_UNSPECIFIED การปรับแนวย่อหน้าจะสืบทอดมาจากระดับบนสุด
START ย่อหน้าจะอยู่ในแนวต้นบรรทัด จัดชิดซ้ายสําหรับข้อความ LTR โดยให้จัดชิดขวา มิเช่นนั้น
CENTER ย่อหน้าอยู่ตรงกลาง
END ย่อหน้าจะอยู่ในแนวที่ท้ายบรรทัด จัดชิดขวาสําหรับข้อความ LTR โดยให้จัดชิดซ้าย มิเช่นนั้น
JUSTIFIED ย่อหน้าเหมาะสมเสมอ

ทิศทางข้อความ

ข้อความเส้นทางจะเคลื่อนเข้ามาได้

Enum
TEXT_DIRECTION_UNSPECIFIED รับค่าทิศทางข้อความมาจากระดับบนสุด
LEFT_TO_RIGHT ข้อความจะอ่านจากซ้ายไปขวา
RIGHT_TO_LEFT ข้อความจากขวาไปซ้าย

โหมดระยะห่าง

โหมดต่างๆ สําหรับระยะห่างระหว่างย่อหน้า

Enum
SPACING_MODE_UNSPECIFIED โหมดระยะห่างมาจากโหมดระดับบน
NEVER_COLLAPSE ระยะห่างระหว่างย่อหน้าจะแสดงผลเสมอ
COLLAPSE_LISTS ระบบจะข้ามระยะห่างระหว่างย่อหน้าระหว่างองค์ประกอบของรายการ

สัญลักษณ์หัวข้อย่อย

อธิบายหัวข้อย่อยของย่อหน้า

การแสดง JSON 
{
  "listId": string,
  "nestingLevel": integer,
  "glyph": string,
  "bulletStyle": {
    object (TextStyle)
  }
}
ช่อง
listId

string

รหัสของรายการย่อหน้านี้

nestingLevel

integer

ระดับการซ้อนของย่อหน้านี้ในรายการ

glyph

string

สัญลักษณ์แสดงหัวข้อย่อยที่แสดงผลสําหรับย่อหน้านี้

bulletStyle

object (TextStyle)

ใช้รูปแบบข้อความที่เจาะจงของย่อหน้ากับหัวข้อย่อยนี้

รูปแบบข้อความ

แสดงการจัดรูปแบบที่สามารถนําไปใช้กับ TextRun

หากข้อความนี้อยู่ในรูปร่างที่มี placeholder ระดับบน อาจมีการรับค่าสไตล์ข้อความเหล่านี้มาจากองค์กรระดับบนสุด รูปแบบของข้อความที่รับช่วงต่อจะขึ้นอยู่กับระดับการซ้อนของรายการ ดังนี้

  • ข้อความที่เรียกใช้ในย่อหน้าที่ไม่อยู่ในรายการจะรับค่าสไตล์ข้อความจากอักขระบรรทัดใหม่ในย่อหน้าที่ระดับการซ้อน 0 ของรายการภายในตัวยึดตําแหน่งระดับบนสุด
  • ข้อความที่เรียกใช้ในย่อหน้าที่อยู่ในรายการจะสืบทอดลักษณะข้อความจากอักขระบรรทัดใหม่ในย่อหน้าในระดับที่ซ้อนอยู่ของรายการภายในตัวยึดตําแหน่งระดับบนสุด

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

การแสดง JSON 
{
  "backgroundColor": {
    object (OptionalColor)
  },
  "foregroundColor": {
    object (OptionalColor)
  },
  "bold": boolean,
  "italic": boolean,
  "fontFamily": string,
  "fontSize": {
    object (Dimension)
  },
  "link": {
    object (Link)
  },
  "baselineOffset": enum (BaselineOffset),
  "smallCaps": boolean,
  "strikethrough": boolean,
  "underline": boolean,
  "weightedFontFamily": {
    object (WeightedFontFamily)
  }
}
ช่อง
backgroundColor

object (OptionalColor)

สีพื้นหลังของข้อความ หากตั้งค่า สีจะเป็นสีทึบหรือโปร่งแสง โดยขึ้นอยู่กับว่าตั้งค่าช่อง opaqueColor ไว้หรือไม่

foregroundColor

object (OptionalColor)

สีของตัวข้อความเอง หากตั้งค่า สีจะเป็นสีทึบหรือโปร่งแสง โดยขึ้นอยู่กับว่าตั้งค่าช่อง opaqueColor ไว้หรือไม่

bold

boolean

ระบุว่าข้อความเป็นตัวหนาหรือไม่

italic

boolean

ข้อความเป็นตัวเอียงหรือไม่

fontFamily

string

ชุดแบบอักษรของข้อความ

ชุดแบบอักษรอาจเป็นแบบอักษรใดก็ได้จากเมนูแบบอักษรในสไลด์หรือจาก Google Fonts หากไม่รู้จักชื่อแบบอักษร ข้อความจะแสดงผลใน Arial

แบบอักษรบางตัวอาจส่งผลต่อน้ําหนักของข้อความ หากคําขออัปเดตระบุค่าของทั้ง fontFamily และ bold ระบบจะใช้ค่า bold ที่ระบุไว้อย่างชัดเจน

fontSize

object (Dimension)

ขนาดตัวอักษรของข้อความ เมื่ออ่าน fontSize จะระบุเป็นคะแนน

baselineOffset

enum (BaselineOffset)

ออฟเซ็ตแนวตั้งของข้อความจากตําแหน่งปกติ

ข้อความที่มีออฟเซ็ต SUPERSCRIPT หรือ SUBSCRIPT จะแสดงผลเป็นขนาดตัวอักษรที่เล็กลงโดยอัตโนมัติ โดยคํานวณตามช่อง fontSize fontSize เองจะไม่ได้รับผลกระทบจากการเปลี่ยนแปลงในช่องนี้

smallCaps

boolean

ข้อความเป็นตัวพิมพ์ใหญ่ขนาดเล็กหรือไม่

strikethrough

boolean

มีการขีดทับข้อความหรือไม่

underline

boolean

มีการขีดเส้นใต้ข้อความหรือไม่

weightedFontFamily

object (WeightedFontFamily)

ชุดแบบอักษรและน้ําหนักข้อความ

ช่องนี้เป็นส่วนขยายของ fontFamily เพื่อรองรับน้ําหนักแบบอักษรที่ชัดเจนโดยไม่ทําให้ความเข้ากันได้ก่อนหน้านี้ไม่ทํางาน ดังนั้น เมื่ออ่านรูปแบบของข้อความช่วง ค่าของ weightedFontFamily#fontFamily จะเท่ากับค่า fontFamily เสมอ อย่างไรก็ตาม เมื่อเขียน หากทั้ง 2 ช่องรวมอยู่ในมาสก์ของช่อง (ไม่ว่าจะโดยตรงหรือผ่านไวลด์การ์ด "*") ค่าต่างๆ จะได้รับการปรับยอดดังนี้

  • หากตั้งค่า fontFamily ไว้และไม่ได้ตั้งค่า weightedFontFamily ระบบจะใช้ค่าของ fontFamily กับน้ําหนัก 400 ("ปกติ")
  • หากมีการตั้งค่าทั้ง 2 ช่อง ค่าของ fontFamily ต้องตรงกับค่าของ weightedFontFamily#fontFamily ในกรณีนี้ ระบบจะใช้ชุดแบบอักษรและน้ําหนักของ weightedFontFamily มิเช่นนั้น ระบบจะแสดงข้อผิดพลาดเกี่ยวกับคําขอผิดพลาด 400
  • หากตั้งค่า weightedFontFamily ไว้และไม่ได้ตั้งค่า fontFamily ระบบจะใช้ชุดแบบอักษรและน้ําหนักของ weightedFontFamily
  • หากไม่ได้ตั้งค่าทั้ง 2 ช่องไว้ ชุดแบบอักษรและน้ําหนักของข้อความจะรับช่วงมาจากระดับบนสุด โปรดทราบว่าพร็อพเพอร์ตี้เหล่านี้ไม่สามารถสืบทอดต่อกันได้

หากคําขออัปเดตระบุค่าของทั้ง weightedFontFamily และ bold ระบบจะใช้ weightedFontFamily ก่อนแล้วจึงตามด้วย bold

หากไม่ได้ตั้งค่า weightedFontFamily#weight ค่าเริ่มต้นจะเป็น 400

หากมีการตั้งค่า weightedFontFamily แล้ว ก็จะต้องตั้งค่า weightedFontFamily#fontFamily เป็นค่าที่ไม่ว่างเปล่าด้วย มิเช่นนั้น ระบบจะแสดงข้อผิดพลาดเกี่ยวกับคําขอผิดพลาด 400

สีแบบไม่บังคับ

สีที่อาจจะทึบแสงหรือโปร่งใสเต็มที่ก็ได้

การแสดง JSON 
{
  "opaqueColor": {
    object (OpaqueColor)
  }
}
ช่อง
opaqueColor

object (OpaqueColor)

หากตั้งค่าเป็น ระบบจะใช้สีนี้เป็นสีทึบ หากไม่ได้ตั้งค่า ค่านี้จะเป็นสีโปร่งใส

ออฟเซ็ตฐาน

ข้อความที่สามารถออฟเซ็ตในแนวตั้งจากตําแหน่งปกติได้

Enum
BASELINE_OFFSET_UNSPECIFIED ออฟเซ็ตพื้นฐานของข้อความจะรับช่วงมาจากระดับบนสุด
NONE ข้อความไม่ได้ชดเชยในแนวตั้ง
SUPERSCRIPT ข้อความถูกออฟเซ็ตในแนวตั้งขึ้น (ด้านบน)
SUBSCRIPT ข้อความมีออฟเซ็ตแนวตั้งลง (ตัวห้อย)

แบบอักษรที่ระบุน้ําหนัก

แสดงชุดแบบอักษรและน้ําหนักที่ใช้จัดรูปแบบ TextRun

การแสดง JSON 
{
  "fontFamily": string,
  "weight": integer
}
ช่อง
fontFamily

string

ชุดแบบอักษรของข้อความ

ชุดแบบอักษรอาจเป็นแบบอักษรใดก็ได้จากเมนูแบบอักษรในสไลด์หรือจาก Google Fonts หากไม่รู้จักชื่อแบบอักษร ข้อความจะแสดงผลใน Arial

weight

integer

น้ําหนักที่แสดงผลของข้อความ ช่องนี้จะมีค่าพหุคูณของ 100 ระหว่าง 100 และ 900 ได้ ช่วงนี้จะตรงกับค่าตัวเลขที่อธิบายไว้ในข้อกําหนดเฉพาะของ CSS 2.1, ส่วนที่ 15.6 โดยไม่อนุญาตให้ใช้ค่าที่ไม่ใช่ตัวเลข น้ําหนักที่มากกว่าหรือเท่ากับ 700 จะถือว่าเป็นตัวหนา และน้ําหนักที่น้อยกว่า 700 จะไม่เป็นตัวหนา ค่าเริ่มต้นคือ 400 ("ปกติ")

การเรียกใช้ข้อความ

ประเภท TextElement ที่แสดงการเรียกใช้ข้อความโดยมีการจัดรูปแบบเหมือนกัน

การแสดง JSON 
{
  "content": string,
  "style": {
    object (TextStyle)
  }
}
ช่อง
content

string

ข้อความของการเรียกใช้นี้

style

object (TextStyle)

การจัดรูปแบบที่ใช้กับการเรียกใช้นี้

ข้อความอัตโนมัติ

ชนิดของ TextElement ที่แทนข้อความอัตโนมัติ

การแสดง JSON 
{
  "type": enum (Type),
  "content": string,
  "style": {
    object (TextStyle)
  }
}
ช่อง
type

enum (Type)

ประเภทของข้อความอัตโนมัตินี้

content

string

เนื้อหาที่แสดงผลของข้อความอัตโนมัตินี้ (หากมี)

style

object (TextStyle)

การจัดรูปแบบที่ใช้กับข้อความอัตโนมัตินี้

Type

ประเภทของข้อความอัตโนมัติ

Enum
TYPE_UNSPECIFIED ประเภทข้อความอัตโนมัติที่ไม่ระบุ
SLIDE_NUMBER พิมพ์สําหรับข้อความอัตโนมัติที่แสดงหมายเลขสไลด์ปัจจุบัน

รายการ

รายการอธิบายรูปลักษณ์ของหัวข้อย่อยในย่อหน้าที่เกี่ยวข้องกับรายการ ย่อหน้าที่เป็นส่วนหนึ่งของรายการมีการอ้างอิงโดยนัยกับรหัสของรายการนั้น

การแสดง JSON 
{
  "listId": string,
  "nestingLevel": {
    integer: {
      object (NestingLevel)
    },
    ...
  }
}
ช่อง
listId

string

รหัสของรายการ

nestingLevel

map (key: integer, value: object ( NestingLevel))

แผนที่ระดับการซ้อนกับคุณสมบัติของหัวข้อย่อยที่ระดับที่เกี่ยวข้อง รายการมีระดับการซ้อนไม่เกิน 9 ระดับ ดังนั้น ค่าที่เป็นไปได้สําหรับคีย์ของแผนที่นี้คือ 0 ถึง 8 โดยรวม

ระดับการซ้อน

มีพร็อพเพอร์ตี้ที่อธิบายรูปลักษณ์ของหัวข้อย่อยของรายการที่ระดับการซ้อน

การแสดง JSON 
{
  "bulletStyle": {
    object (TextStyle)
  }
}
ช่อง
bulletStyle

object (TextStyle)

รูปแบบของหัวข้อย่อยที่ระดับการซ้อนนี้