Text

TextContent

Nội dung văn bản chung. Văn bản phải nằm trong một hình dạng tương thích (ví dụ: hộp văn bản hoặc hình chữ nhật) hoặc một ô trong bảng trên trang.

Biểu diễn dưới dạng JSON 
{
  "textElements": [
    {
      object (TextElement)
    }
  ],
  "lists": {
    string: {
      object (List)
    },
    ...
  }
}
Trường
textElements[]

object (TextElement)

Nội dung văn bản được chia thành các phần cấu thành, bao gồm cả thông tin định kiểu. Thuộc tính này chỉ có thể đọc.

lists

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

Danh sách có dấu đầu dòng có trong văn bản này, được khoá bằng mã nhận dạng danh sách.

TextElement

TextElement mô tả nội dung của một dải chỉ mục trong nội dung văn bản của Shape hoặc TableCell.

Biểu diễn dưới dạng JSON 
{
  "startIndex": integer,
  "endIndex": integer,

  "paragraphMarker": {
    object (ParagraphMarker)
  },
  "textRun": {
    object (TextRun)
  },
  "autoText": {
    object (AutoText)
  }
}
Trường
startIndex

integer

Chỉ mục bắt đầu từ 0 của phần tử văn bản này, tính bằng đơn vị mã Unicode.

endIndex

integer

Chỉ mục kết thúc (dựa trên 0) của phần tử văn bản này, không bao gồm, trong các đơn vị mã Unicode.

Trường nhóm kind. Loại văn bản mà phần tử này biểu thị. kind chỉ có thể là một trong những trạng thái sau:
paragraphMarker

object (ParagraphMarker)

Một điểm đánh dấu biểu thị điểm bắt đầu của một đoạn văn mới.

startIndex và endIndex của TextElement này biểu thị phạm vi của đoạn văn. Các TextElement khác có phạm vi chỉ mục nằm trong phạm vi của đoạn văn này được coi là một phần của đoạn văn này. Phạm vi chỉ mục của hai đoạn văn riêng biệt sẽ không bao giờ trùng lặp.

textRun

object (TextRun)

Một TextElement đại diện cho một chuỗi văn bản, trong đó tất cả các ký tự trong chuỗi đều có cùng TextStyle.

startIndex và endIndex của TextRuns sẽ luôn nằm hoàn toàn trong dải chỉ mục của một TextElement paragraphMarker duy nhất. Nói cách khác, TextRun sẽ không bao giờ trải dài trên nhiều đoạn văn.

autoText

object (AutoText)

Một TextElement đại diện cho một vị trí trong văn bản được thay thế linh hoạt bằng nội dung có thể thay đổi theo thời gian.

ParagraphMarker

Một loại TextElement biểu thị phần đầu của một đoạn văn mới.

Biểu diễn dưới dạng JSON 
{
  "style": {
    object (ParagraphStyle)
  },
  "bullet": {
    object (Bullet)
  }
}
Trường
style

object (ParagraphStyle)

Kiểu của đoạn văn

bullet

object (Bullet)

Dấu đầu dòng cho đoạn văn này. Nếu không có, đoạn văn sẽ không thuộc danh sách.

ParagraphStyle

Kiểu áp dụng cho toàn bộ đoạn văn.

Nếu văn bản này nằm trong một hình dạng có placeholder mẹ, thì các kiểu đoạn văn này có thể được kế thừa từ placeholder mẹ. Những kiểu đoạn văn nào được kế thừa phụ thuộc vào cấp độ lồng của danh sách:

  • Đoạn văn không nằm trong danh sách sẽ kế thừa kiểu đoạn văn từ đoạn văn ở cấp độ lồng 0 của danh sách bên trong phần giữ chỗ mẹ.
  • Một đoạn văn trong danh sách sẽ kế thừa kiểu đoạn văn của đoạn văn ở cấp lồng ghép tương ứng của danh sách bên trong phần giữ chỗ mẹ.

Các kiểu đoạn văn được kế thừa sẽ được biểu thị dưới dạng các trường chưa đặt trong thông báo này.

Biểu diễn dưới dạng 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)
}
Trường
lineSpacing

number

Khoảng cách giữa các dòng, tính theo tỷ lệ phần trăm so với khoảng cách bình thường, trong đó khoảng cách bình thường được biểu thị là 100.0. Nếu bạn không đặt, giá trị sẽ được kế thừa từ phần tử mẹ.

alignment

enum (Alignment)

Cách căn chỉnh văn bản cho đoạn này.

indentStart

object (Dimension)

Khoảng thụt lề cho đoạn văn ở phía tương ứng với phần đầu của văn bản, dựa trên hướng văn bản hiện tại. Nếu bạn không đặt, giá trị sẽ được kế thừa từ phần tử mẹ.

indentEnd

object (Dimension)

Số lượng thụt lề cho đoạn văn ở phía tương ứng với cuối văn bản, dựa trên hướng văn bản hiện tại. Nếu bạn không đặt, giá trị sẽ được kế thừa từ phần tử mẹ.

spaceAbove

object (Dimension)

Lượng khoảng trống bổ sung phía trên đoạn. Nếu bạn không đặt, giá trị sẽ được kế thừa từ phần tử mẹ.

spaceBelow

object (Dimension)

Lượng khoảng trống bổ sung bên dưới đoạn văn. Nếu bạn không đặt, giá trị sẽ được kế thừa từ phần tử mẹ.

indentFirstLine

object (Dimension)

Mức thụt lề cho phần đầu của dòng đầu tiên trong đoạn văn. Nếu bạn không đặt, giá trị sẽ được kế thừa từ phần tử mẹ.

direction

enum (TextDirection)

Hướng văn bản của đoạn này. Nếu bạn không đặt, giá trị mặc định sẽ là LEFT_TO_RIGHT vì hướng văn bản không được kế thừa.

spacingMode

enum (SpacingMode)

Chế độ giãn cách cho đoạn văn.

Căn chỉnh

Các loại căn chỉnh văn bản cho một đoạn văn.

Enum
ALIGNMENT_UNSPECIFIED Căn chỉnh đoạn văn được kế thừa từ thành phần mẹ.
START Đoạn văn được căn chỉnh theo đầu dòng. Căn trái cho văn bản LTR, căn phải cho văn bản khác.
CENTER Đoạn văn được căn giữa.
END Đoạn văn được căn chỉnh ở cuối dòng. Căn phải đối với văn bản từ trái sang phải, căn trái trong trường hợp khác.
JUSTIFIED Đoạn văn được căn đều.

TextDirection

Văn bản chỉ dẫn có thể xuất hiện.

Enum
TEXT_DIRECTION_UNSPECIFIED Hướng văn bản được kế thừa từ thành phần mẹ.
LEFT_TO_RIGHT Văn bản sẽ đi từ trái sang phải.
RIGHT_TO_LEFT Văn bản sẽ đi từ phải sang trái.

SpacingMode

Các chế độ khác nhau cho khoảng cách giữa các đoạn.

Enum
SPACING_MODE_UNSPECIFIED Chế độ khoảng cách được kế thừa từ thành phần mẹ.
NEVER_COLLAPSE Khoảng cách giữa các đoạn văn bản luôn được hiển thị.
COLLAPSE_LISTS Khoảng cách đoạn văn bị bỏ qua giữa các phần tử danh sách.

Dấu đầu dòng

Mô tả dấu đầu dòng của một đoạn văn.

Biểu diễn dưới dạng JSON 
{
  "listId": string,
  "nestingLevel": integer,
  "glyph": string,
  "bulletStyle": {
    object (TextStyle)
  }
}
Trường
listId

string

Mã của danh sách mà đoạn văn này thuộc về.

nestingLevel

integer

Cấp độ lồng ghép của đoạn văn này trong danh sách.

glyph

string

Glyph dấu đầu dòng được kết xuất cho đoạn văn này.

bulletStyle

object (TextStyle)

Kiểu văn bản cụ thể của đoạn văn được áp dụng cho dấu đầu dòng này.

TextStyle

Biểu thị kiểu có thể áp dụng cho TextRun.

Nếu văn bản này nằm trong một hình dạng có placeholder gốc, thì các kiểu văn bản này có thể được kế thừa từ gốc. Những kiểu văn bản được kế thừa phụ thuộc vào cấp độ lồng của danh sách:

  • Một đoạn văn bản trong một đoạn văn bản không nằm trong danh sách sẽ kế thừa kiểu văn bản từ ký tự dòng mới trong đoạn văn bản ở cấp độ lồng 0 của danh sách bên trong phần giữ chỗ mẹ.
  • Một đoạn văn bản trong một đoạn văn nằm trong danh sách sẽ kế thừa kiểu văn bản của đoạn văn đó từ ký tự dòng mới trong đoạn văn ở cấp độ lồng ghép tương ứng của danh sách bên trong phần giữ chỗ gốc.

Các kiểu văn bản được kế thừa sẽ được biểu thị dưới dạng các trường chưa đặt trong thông báo này. Nếu văn bản nằm trong một hình dạng không có phần giữ chỗ mẹ, thì việc huỷ đặt các trường này sẽ chuyển kiểu về giá trị khớp với giá trị mặc định trong trình chỉnh sửa Trang trình bày.

Biểu diễn dưới dạng 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)
  }
}
Trường
backgroundColor

object (OptionalColor)

Màu nền của văn bản. Nếu được đặt, màu sẽ mờ đục hoặc trong suốt, tuỳ thuộc vào việc trường opaqueColor trong đó có được đặt hay không.

foregroundColor

object (OptionalColor)

Màu của chính văn bản. Nếu được đặt, màu sẽ mờ đục hoặc trong suốt, tuỳ thuộc vào việc trường opaqueColor trong đó có được đặt hay không.

bold

boolean

Văn bản có được hiển thị dưới dạng chữ in đậm hay không.

italic

boolean

Văn bản có được in nghiêng hay không.

fontFamily

string

Bộ phông chữ của văn bản.

Bộ phông chữ có thể là bất kỳ phông chữ nào trong trình đơn Phông chữ của Trang trình bày hoặc trong Google Fonts. Nếu tên phông chữ không được nhận dạng, văn bản sẽ được hiển thị bằng Arial.

Một số phông chữ có thể ảnh hưởng đến độ đậm của văn bản. Nếu một yêu cầu cập nhật chỉ định giá trị cho cả fontFamily và bold, thì giá trị bold được đặt rõ ràng sẽ được sử dụng.

fontSize

object (Dimension)

Kích thước phông chữ của văn bản. Khi đọc, fontSize sẽ được chỉ định theo điểm.

baselineOffset

enum (BaselineOffset)

Độ lệch dọc của văn bản so với vị trí thông thường.

Văn bản có độ lệch đường cơ sở SUPERSCRIPT hoặc SUBSCRIPT sẽ tự động được kết xuất ở cỡ chữ nhỏ hơn, được tính dựa trên trường fontSize. Bản thân fontSize không bị ảnh hưởng bởi các thay đổi trong trường này.

smallCaps

boolean

Văn bản có được viết bằng chữ hoa nhỏ hay không.

strikethrough

boolean

Văn bản có bị gạch ngang hay không.

underline

boolean

Văn bản có được gạch chân hay không.

weightedFontFamily

object (WeightedFontFamily)

Bộ phông chữ và độ đậm được kết xuất của văn bản.

Trường này là một phần mở rộng của fontFamily nhằm hỗ trợ các độ đậm phông chữ rõ ràng mà không làm ảnh hưởng đến khả năng tương thích ngược. Do đó, khi đọc kiểu của một dải văn bản, giá trị của weightedFontFamily#fontFamily sẽ luôn bằng với giá trị của fontFamily. Tuy nhiên, khi ghi, nếu cả hai trường đều có trong mặt nạ trường (một cách rõ ràng hoặc thông qua ký tự đại diện "*"), thì các giá trị của chúng sẽ được điều chỉnh như sau:

  • Nếu bạn đặt fontFamily và không đặt weightedFontFamily, thì giá trị của fontFamily sẽ được áp dụng với trọng số 400 ("normal").
  • Nếu bạn đặt cả hai trường, thì giá trị của fontFamily phải khớp với giá trị của weightedFontFamily#fontFamily. Nếu có, họ phông chữ và độ đậm của weightedFontFamily sẽ được áp dụng. Nếu không, lỗi 400 yêu cầu không hợp lệ sẽ được trả về.
  • Nếu bạn đặt weightedFontFamily nhưng không đặt fontFamily, thì họ phông chữ và độ đậm của weightedFontFamily sẽ được áp dụng.
  • Nếu bạn không đặt giá trị cho cả hai trường, thì bộ phông chữ và độ đậm của văn bản sẽ kế thừa từ phần tử mẹ. Xin lưu ý rằng các thuộc tính này không thể kế thừa riêng biệt với nhau.

Nếu một yêu cầu cập nhật chỉ định giá trị cho cả weightedFontFamily và bold, thì weightedFontFamily sẽ được áp dụng trước, sau đó là bold.

Nếu bạn không đặt weightedFontFamily#weight, thì giá trị mặc định sẽ là 400.

Nếu bạn đặt weightedFontFamily, thì bạn cũng phải đặt weightedFontFamily#fontFamily thành một giá trị không trống. Nếu không, lỗi 400 yêu cầu không hợp lệ sẽ được trả về.

OptionalColor

Một màu có thể hoàn toàn không trong suốt hoặc hoàn toàn trong suốt.

Biểu diễn dưới dạng JSON 
{
  "opaqueColor": {
    object (OpaqueColor)
  }
}
Trường
opaqueColor

object (OpaqueColor)

Nếu được đặt, giá trị này sẽ được dùng làm màu sắc không trong suốt. Nếu bạn không đặt, thì giá trị này sẽ biểu thị một màu trong suốt.

BaselineOffset

Các cách mà văn bản có thể được bù theo chiều dọc so với vị trí thông thường.

Enum
BASELINE_OFFSET_UNSPECIFIED Độ lệch đường cơ sở của văn bản được kế thừa từ phần tử mẹ.
NONE Văn bản không bị lệch theo chiều dọc.
SUPERSCRIPT Văn bản được bù theo chiều dọc lên trên (chỉ số trên).
SUBSCRIPT Văn bản được bù theo chiều dọc xuống dưới (chỉ số dưới).

WeightedFontFamily

Biểu thị bộ phông chữ và độ đậm dùng để tạo kiểu cho TextRun.

Biểu diễn dưới dạng JSON 
{
  "fontFamily": string,
  "weight": integer
}
Trường
fontFamily

string

Bộ phông chữ của văn bản.

Bộ phông chữ có thể là bất kỳ phông chữ nào trong trình đơn Phông chữ của Trang trình bày hoặc trong Google Fonts. Nếu tên phông chữ không được nhận dạng, văn bản sẽ được hiển thị bằng Arial.

weight

integer

Độ đậm được hiển thị của văn bản. Trường này có thể có bất kỳ giá trị nào là bội số của 100 trong khoảng từ 100 đến 900. Phạm vi này tương ứng với các giá trị bằng số được mô tả trong Quy cách CSS 2.1, mục 15.6, trong đó các giá trị không phải bằng số không được phép. Trọng số lớn hơn hoặc bằng 700 được coi là đậm và trọng số nhỏ hơn 700 không được coi là đậm. Giá trị mặc định là 400 ("normal").

TextRun

Một loại TextElement đại diện cho một đoạn văn bản có cùng kiểu.

Biểu diễn dưới dạng JSON 
{
  "content": string,
  "style": {
    object (TextStyle)
  }
}
Trường
content

string

Văn bản của lần chạy này.

style

object (TextStyle)

Kiểu được áp dụng cho đoạn văn bản này.

AutoText

Một loại TextElement đại diện cho văn bản tự động.

Biểu diễn dưới dạng JSON 
{
  "type": enum (Type),
  "content": string,
  "style": {
    object (TextStyle)
  }
}
Trường
type

enum (Type)

Loại văn bản tự động này.

content

string

Nội dung được hiển thị của văn bản tự động này (nếu có).

style

object (TextStyle)

Kiểu được áp dụng cho văn bản tự động này.

Loại

Các loại văn bản tự động

Enum
TYPE_UNSPECIFIED Loại văn bản tự động chưa được chỉ định.
SLIDE_NUMBER Nhập để tạo văn bản tự động biểu thị số trang trình bày hiện tại.

Danh sách

Danh sách mô tả giao diện của các dấu đầu dòng thuộc về các đoạn văn được liên kết với một danh sách. Một đoạn văn nằm trong danh sách có một tham chiếu ngầm đến mã nhận dạng của danh sách đó.

Biểu diễn dưới dạng JSON 
{
  "listId": string,
  "nestingLevel": {
    integer: {
      object (NestingLevel)
    },
    ...
  }
}
Trường
listId

string

Mã nhận dạng của danh sách.

nestingLevel

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

Bản đồ các cấp lồng nhau cho các thuộc tính của dấu đầu dòng ở cấp được liên kết. Một danh sách có tối đa 9 cấp độ lồng nhau, vì vậy các giá trị có thể có cho khoá của bản đồ này là từ 0 đến 8 (bao gồm cả 0 và 8).

NestingLevel

Chứa các thuộc tính mô tả giao diện của dấu đầu dòng ở một cấp độ lồng ghép nhất định.

Biểu diễn dưới dạng JSON 
{
  "bulletStyle": {
    object (TextStyle)
  }
}
Trường
bulletStyle

object (TextStyle)

Kiểu của dấu đầu dòng ở cấp lồng ghép này.