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

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

object (ParagraphMarker)

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

startIndex และ วันที่ endIndex ขององค์ประกอบข้อความนี้จะแสดงช่วงของย่อหน้า องค์ประกอบข้อความอื่นๆ ที่มีช่วงดัชนีที่อยู่ในช่วงของย่อหน้านี้จะถือว่าเป็นส่วนหนึ่งของย่อหน้านี้ ช่วงของดัชนี 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

แบบอักษรบางแบบอาจส่งผลต่อน้ำหนักของข้อความได้ หากคำขออัปเดตระบุค่าสำหรับทั้ง 2 แบบ 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 คำขอที่ไม่ถูกต้อง

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 ("ปกติ")

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)

รูปแบบของสัญลักษณ์หัวข้อย่อยสำหรับการซ้อนระดับนี้