文字內容
一般文字內容。文字必須位於相容的形狀 (例如文字方塊或矩形) 或頁面中的表格儲存格。
JSON 表示法 |
---|
{ "textElements": [ { object ( |
欄位 | |
---|---|
textElements[]
|
文字內容會細分為元件部分,包括樣式資訊。此屬性處於唯讀狀態。 |
lists
|
這段文字中的項目符號清單 (依清單 ID 排序)。 |
文字元素
TextElement 描述 Shape 或 TableCell 文字內容中的一系列索引內容。
JSON 表示法 |
---|
{ "startIndex": integer, "endIndex": integer, // Union field |
欄位 | |
---|---|
startIndex
|
這個文字元素的從 0 開始的索引,以萬國碼 (Unicode) 代碼單位表示。 |
endIndex
|
這個文字元素從 0 開始的索引 (不含萬國碼 (Unicode) 程式碼單元)。 |
聯集欄位 kind 。這個元素代表的文字類型。
kind 只能是下列其中一個值: |
|
paragraphMarker
|
代表新段落開頭的標記。
這個 TextElement 的 |
textRun
|
一個文字元素,代表執行中的所有字元都具有相同的
TextRun 的 |
autoText
|
TextText 代表文字中的一個位置,該位置以動態方式動態變更。 |
ParagraphMarker
代表新段落開頭的 TextElement 種類。
JSON 表示法 |
---|
{ "style": { object ( |
欄位 | |
---|---|
style
|
段落的樣式 |
bullet
|
本段落的條目。如果沒有,該段落不屬於清單。 |
ParagraphStyle
套用至整個段落的樣式。
如果文字包含父項 placeholder
的形狀,則這些段落樣式可能會沿用父項。要沿用哪些段落樣式取決於清單的巢狀層級:
- 不在清單的段落將沿用父項預留位置中清單 0 的段落樣式。
- 清單的段落會沿用該段落預留位置中父項巢狀結構的段落樣式。
這則訊息中會沿用的段落樣式是以未設定的欄位表示。
JSON 表示法 |
---|
{ "lineSpacing": number, "alignment": enum ( |
欄位 | |
---|---|
lineSpacing
|
行距的空間,以一般百分比表示,其中正常表示 100.0。如未設定,則會沿用父項的值。 |
alignment
|
這個段落的文字對齊方式。 |
indentStart
|
與側邊文字方向相對應的段落縮排 (以目前的文字方向為準)。如未設定,則會沿用父項的值。 |
indentEnd
|
段落中與段落結尾的文字量 (視目前的文字方向而定)。如未設定,則會沿用父項的值。 |
spaceAbove
|
段落上方多餘的空間。如未設定,則會沿用父項的值。 |
spaceBelow
|
段落下方有多餘的空間。如未設定,則會沿用父項的值。 |
indentFirstLine
|
段落第一行開頭的縮排數量。如未設定,則會沿用父項的值。 |
direction
|
這個段落的文字方向。如未設定,文字會沿用為預設值,因此這個值會預設為 |
spacingMode
|
段落的間距模式。 |
對齊
段落的文字對齊類型。
列舉 | |
---|---|
ALIGNMENT_UNSPECIFIED
|
段落對齊沿用自父項。 |
START
|
段落已對齊線條。針對由左至右的文字,靠左對齊,否則靠左對齊。 |
CENTER
|
段落置中。 |
END
|
段落已對齊線條。針對 LTR 文字,靠右對齊,否則靠左對齊。 |
JUSTIFIED
|
段落合理解釋。 |
文字方向
路線文字可以流入。
列舉 | |
---|---|
TEXT_DIRECTION_UNSPECIFIED
|
文字方向繼承自父項。 |
LEFT_TO_RIGHT
|
文字從左到右。 |
RIGHT_TO_LEFT
|
文字從右到左。 |
SpacingMode
段落間距的不同模式。
列舉 | |
---|---|
SPACING_MODE_UNSPECIFIED
|
繼承父項。 |
NEVER_COLLAPSE
|
系統一律會轉譯段落間距。 |
COLLAPSE_LISTS
|
系統會在清單元素之間略過段落間距。 |
項目符號
說明段落的條目。
JSON 表示法 |
---|
{
"listId": string,
"nestingLevel": integer,
"glyph": string,
"bulletStyle": {
object (
|
欄位 | |
---|---|
listId
|
這個段落所屬的清單 ID。 |
nestingLevel
|
此段落的巢狀層級。 |
glyph
|
這個段落的轉譯項目符號字符。 |
bulletStyle
|
此項目套用的段落專屬文字樣式。 |
文字樣式
代表可套用至 TextRun 的樣式。
如果文字包含父項 placeholder
的形狀,這些文字樣式可能會沿用父項。沿用的文字樣式取決於清單的巢狀層級:
- 如果文字不是位於清單中的段落,則文字會沿用該段落中第一行文字,且其文字位於父項預留位置中清單 0 的巢狀層級。
- 顯示於清單中的段落文字,將會沿用段落中新行字元的文字樣式。
在這則訊息中,沿用的文字樣式會顯示為未設定的欄位。如果文字包含沒有父項預留位置的形狀,取消設定這些欄位後,樣式會還原為簡報編輯器中預設值。
JSON 表示法 |
---|
{ "backgroundColor": { object ( |
欄位 | |
---|---|
backgroundColor
|
文字的背景顏色。如果設定這個顏色,顏色會設為不透明或透明,視已設定的 |
foregroundColor
|
文字本身的顏色。如果設定這個顏色,顏色會設為不透明或透明,視已設定的 |
bold
|
文字是否以粗體顯示。 |
italic
|
文字是否加上斜體。 |
fontFamily
|
文字的字型系列。
從 Google 簡報的「字型」選單和 Google Fonts 都可以使用字型系列。如果無法辨識字型名稱,文字會以
部分字型可能會影響文字粗細。如果更新要求指定 |
fontSize
|
文字的字型大小。讀取時, |
link
|
文字的超連結目的地。如果未設定,則表示沒有連結。不會沿用父項文字的連結。 如在更新要求中變更連結,也會變更範圍的文字樣式:
|
baselineOffset
|
文字的垂直偏移值與一般位置的差距。
文字為 |
smallCaps
|
文字是否使用小型大寫字母。 |
strikethrough
|
表示文字是否卡在過關。 |
underline
|
文字是否加上底線。 |
weightedFontFamily
|
字型系列和文字的粗細。
這個欄位是
如果更新要求指定
如未設定
如果設定了 |
選填色彩
完全不透明或完全透明的顏色。
JSON 表示法 |
---|
{
"opaqueColor": {
object (
|
欄位 | |
---|---|
opaqueColor
|
設定後,系統會使用不透明的顏色。如未設定,則為透明顏色。 |
BaselineOffset
文字與一般位置垂直偏移的方式。
列舉 | |
---|---|
BASELINE_OFFSET_UNSPECIFIED
|
文字的基準偏移會沿用自父項。 |
NONE
|
文字未垂直偏移。 |
SUPERSCRIPT
|
文字垂直垂直對齊 (上標) |
SUBSCRIPT
|
文字垂直垂直偏移 (下標) |
WeightedFontFamily
代表用於設定 TextRun 樣式的字型系列和粗細。
JSON 表示法 |
---|
{ "fontFamily": string, "weight": integer } |
欄位 | |
---|---|
fontFamily
|
文字的字型系列。
從 Google 簡報的「字型」選單和 Google Fonts 都可以使用字型系列。如果無法辨識字型名稱,文字會以 |
weight
|
文字的算繪權重。這個欄位可以介於 |
執行文字
代表一段文字的 TextElement 種類,且全都具有相同的樣式。
JSON 表示法 |
---|
{
"content": string,
"style": {
object (
|
欄位 | |
---|---|
content
|
這項執行作業的文字。 |
style
|
套用至這項執行作業的樣式。 |
自動文字
代表自動文字的 TextElement 種類。
JSON 表示法 |
---|
{ "type": enum ( |
欄位 | |
---|---|
type
|
此自動文字的類型。 |
content
|
此自動文字的轉譯內容 (如有)。 |
style
|
套用至這個自動文字的樣式。 |
類型
自動文字的類型
列舉 | |
---|---|
TYPE_UNSPECIFIED
|
未指定的自動文字類型。 |
SLIDE_NUMBER
|
代表目前投影片編號的自動文字類型。 |
清單
清單會針對與清單相關的段落,顯示項目符號的外觀和風格。清單的段落有隱式參照該清單 ID。
JSON 表示法 |
---|
{
"listId": string,
"nestingLevel": {
integer: {
object (
|
欄位 | |
---|---|
listId
|
清單的 ID。 |
nestingLevel
|
以不同層級查看項目符號的巢狀結構對應圖。清單最多包含 9 個巢狀結構層級,因此此地圖鍵的值可能為 0 到 8 (含)。 |
巢狀層級
包含的屬性會以巢狀結構來表示清單項目巢狀結構的外觀與風格。
JSON 表示法 |
---|
{
"bulletStyle": {
object (
|
欄位 | |
---|---|
bulletStyle
|
此巢狀結構中的項目符號樣式。 |