Text

TextContent

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

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

object (TextElement)

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

lists

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

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

TextElement

TextElement อธิบายเนื้อหาของช่วงดัชนีในเนื้อหาข้อความของ Shape หรือ 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 ของ TextElement นี้แสดงถึงช่วงของย่อหน้า ระบบจะถือว่า 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 จะไม่ได้รับผลกระทบจากการเปลี่ยนแปลงในช่องนี้

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)

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