Text

TextContent

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

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

object (TextElement)

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

lists

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

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

TextElement

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

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

endIndex

integer

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

ฟิลด์สหภาพ kind ประเภทของข้อความที่องค์ประกอบนี้แสดง kind ต้องเป็นอย่างใดอย่างหนึ่งต่อไปนี้
paragraphMarker

object (ParagraphMarker)

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

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

textRun

object (TextRun)

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

startIndex และ endIndex ของ TextRuns จะอยู่ภายใต้ช่วงดัชนีของ paragraphMarker TextElement กล่าวคือ TextRun จะไม่ครอบคลุมหลายย่อหน้า

autoText

object (AutoText)

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

ParagraphMarker

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

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

object (ParagraphStyle)

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

bullet

object (Bullet)

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

ParagraphStyle

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

หากข้อความนี้อยู่ในรูปร่างที่มีระดับบนสุด 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 ย่อหน้านั้นมีการอธิบายอย่างเหมาะสม

TextDirection

ข้อความเส้นทางไหลเข้ามาได้

Enum
TEXT_DIRECTION_UNSPECIFIED การวางแนวข้อความจะรับค่ามาจากเทมเพลตหลัก
LEFT_TO_RIGHT ข้อความจะแสดงจากซ้ายไปขวา
RIGHT_TO_LEFT ข้อความจะแสดงจากขวาไปซ้าย

SpacingMode

โหมดต่างๆ ของการเว้นวรรคระหว่างย่อหน้า

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)

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

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 โดยตัว 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 Bad Request
  • หากตั้งค่า weightedFontFamily แล้ว แต่ไม่ได้ตั้งค่า fontFamily ระบบจะใช้ชุดแบบอักษรและน้ำหนักของ weightedFontFamily
  • หากไม่ได้ตั้งค่าช่องไว้ ชุดแบบอักษรและน้ำหนักของข้อความจะรับค่ามาจากระดับบน โปรดทราบว่าพร็อพเพอร์ตี้เหล่านี้จะรับค่าจากกันไม่ได้

หากคำขออัปเดตระบุค่าสำหรับทั้ง 2 แบบ weightedFontFamily และ bold weightedFontFamily ก่อน จากนั้นจะ bold

ถ้า weightedFontFamily#weight ไม่ได้ตั้งค่าไว้ ระบบจะใช้ค่าเริ่มต้นเป็น 400

ถ้า weightedFontFamily ตั้งค่าแล้ว weightedFontFamily#fontFamily ต้องตั้งค่าด้วยค่าที่ไม่ว่างเปล่า มิฉะนั้น ระบบจะแสดงข้อผิดพลาด 400 Bad Request

OptionalColor

สีที่ทึบแสงหรือโปร่งแสงได้ทั้งหมด

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

object (OpaqueColor)

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

BaselineOffset

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

Enum
BASELINE_OFFSET_UNSPECIFIED ส่วนการเลื่อนเส้นฐานของข้อความจะรับค่ามาจากองค์ประกอบหลัก
NONE ข้อความไม่เลื่อนในแนวตั้ง
SUPERSCRIPT ข้อความจะเลื่อนขึ้นด้านบนในแนวตั้ง (ตัวยก)
SUBSCRIPT ข้อความมีการเลื่อนในแนวตั้งลง (ตัวห้อย)

WeightedFontFamily

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

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

string

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

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

weight

integer

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

TextRun

ชนิด TextElement ที่แสดงการเรียกใช้ข้อความที่มีรูปแบบเดียวกัน

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

string

ข้อความของการวิ่งครั้งนี้

style

object (TextStyle)

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

AutoText

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

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

enum (Type)

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

content

string

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

style

object (TextStyle)

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

ประเภท

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

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

รายการ

รายการจะอธิบายลักษณะของสัญลักษณ์หัวข้อของย่อหน้าซึ่งเชื่อมโยงกับรายการ ย่อหน้าที่อยู่ในรายการมีการอ้างอิงโดยนัยถึงรหัสของรายการนั้น

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

string

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

nestingLevel

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

แผนที่ของระดับการฝังกับพร็อพเพอร์ตี้ของหัวข้อในระดับที่เกี่ยวข้อง รายการมีการซ้อนกันไม่เกิน 9 ระดับ ดังนั้นค่าที่เป็นไปได้สำหรับคีย์ของแผนที่นี้คือ 0 ถึง 8 (รวมค่าแรกและค่าสุดท้าย)

NestingLevel

มีพร็อพเพอร์ตี้ที่อธิบายลักษณะที่ปรากฏของสัญลักษณ์หัวข้อรายการในระดับการฝังหนึ่งๆ

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

object (TextStyle)

สไตล์ของหัวข้อย่อยในระดับการฝังนี้