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 thành phần, bao gồm cả thông tin định kiểu. Tài sản này đang ở chế độ chỉ có thể đọc.

lists

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

Các danh sách có dấu đầu dòng có trong văn bản này, được khoá theo mã 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 một Hình dạng hoặc ô Table.

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

integer

Chỉ mục bắt đầu dựa trên 0 của phần tử văn bản này, tính theo đơn vị mã Unicode.

endIndex

integer

Chỉ mục kết thúc bằng 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 hợp hợp nhất kind. Loại văn bản mà phần tử này đại diện. kind chỉ có thể là một trong các trạng thái sau:
paragraphMarker

object (ParagraphMarker)

Một điểm đánh dấu thể hiện đầu đoạn mới.

startIndex và endIndex của TextElement này đại diện cho 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 này được coi là một phần của đoạn này. Phạm vi chỉ mục của hai đoạn riêng biệt sẽ không bao giờ chồng chéo nhau.

textRun

object (TextRun)

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

startIndex và endIndex của TextRuns sẽ luôn được chứa đầy đủ trong phạm vi chỉ mục của một TextElement paragraphMarker duy nhất. Nói cách khác, TextRun sẽ không bao giờ kéo dài nhiều đoạn.

autoText

object (AutoText)

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

ParagraphMarker

Một loại TextElement đại diện cho phần đầu của một đoạ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

bullet

object (Bullet)

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

ParagraphStyle

Kiểu áp dụng cho toàn bộ đoạ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ừ phần tử mẹ. Kiểu đoạn được kế thừa phụ thuộc vào mức lồng ghép của danh sách:

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

Kiểu đoạn văn được kế thừa đượ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 của giá trị thông thường, trong đó giá trị thông thường được biểu thị là 100.0. Nếu không được đặ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 văn này.

indentStart

object (Dimension)

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

indentEnd

object (Dimension)

Khoảng thụt lề cho đoạn văn bả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 không được đặt, giá trị sẽ được kế thừa từ phần tử mẹ.

spaceAbove

object (Dimension)

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

spaceBelow

object (Dimension)

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

indentFirstLine

object (Dimension)

Lượng thụt lề ở đầu dòng đầu tiên của đoạn. Nếu không được đặ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 chính sách này, giá trị mặc định 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.

Căn chỉnh

Các kiểu căn chỉnh văn bản cho một đoạn.

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

TextDirection

Văn bản chỉ đường có thể xuất hiện.

Enum
TEXT_DIRECTION_UNSPECIFIED Hướng văn bản được kế thừa từ cấp độ gốc.
LEFT_TO_RIGHT Văn bản dịch chuyển từ trái sang phải.
RIGHT_TO_LEFT Văn bản đ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 văn bản.

Enum
SPACING_MODE_UNSPECIFIED Chế độ khoảng cách được kế thừa từ thành phần mẹ.
NEVER_COLLAPSE Giãn cách đoạ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.

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 chứa đoạn văn này.

nestingLevel

integer

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

glyph

string

Ký tự gạch đầu dòng được kết xuất cho đoạ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ó cha/mẹ placeholder, thì những kiểu văn bản này có thể được kế thừa từ cấp độ gốc. Kiểu văn bản nào được kế thừa phụ thuộc vào mức độ lồng của danh sách:

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

Kiểu văn bản kế thừa đượ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 mà không có phần giữ chỗ mẹ, thì khi bạn huỷ thiết lập các trường này, kiểu sẽ được chuyển về một giá trị phù hợ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ờ hoặc trong suốt, tuỳ thuộc vào việc opaqueColor trong trường đó đã được đặt.

foregroundColor

object (OptionalColor)

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

bold

boolean

Văn bản có hiển thị ở dạng 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 từ trình đơn Phông chữ trong Trang trình bày hoặc từ Google Fonts (Phông chữ Google). Nếu không nhận dạng được tên phông chữ, văn bản sẽ được hiển thị trong Arial.

Một số phông chữ có thể ảnh hưởng đến độ đậm của văn bản. Nếu yêu cầu cập nhật chỉ định các giá trị cho cả fontFamily và bold, giá trị được đặt rõ ràng bold giá trị đượ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 bằng điểm.

baselineOffset

enum (BaselineOffset)

Độ dời theo chiều dọc của văn bản so với vị trí thông thường.

Nhắn tin với SUPERSCRIPT hoặc SUBSCRIPT độ lệch đường cơ sở được tự động hiển thị ở cỡ chữ nhỏ hơn, được tính toán dựa trên fontSize . Chiến lược phát hành đĩa đơn fontSize không chịu ảnh hưởng của những thay đổi trong trường này.

smallCaps

boolean

Liệu văn bản có được viết hoa chữ thường hay không.

strikethrough

boolean

Liệu văn bản có bị gạch ngang hay không.

underline

boolean

Liệu văn bản có được gạch dưới 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à phần mở rộng của fontFamily nhằm hỗ trợ độ đậm phông chữ rõ ràng mà không phá vỡ 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 giá trị của fontFamily. Tuy nhiên, khi viết, 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ì giá trị của chúng đượ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 ("bình thường").
  • 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ó, bộ phông chữ và độ đậm của weightedFontFamily sẽ được áp dụng. Nếu không, hệ thống sẽ trả về lỗi 400 với yêu cầu không hợp lệ.
  • Nếu weightedFontFamily được đặt và fontFamily không, bộ phông chữ và độ đậm của weightedFontFamily sẽ được áp dụng.
  • Nếu bạn không đặt trường nào, 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 yêu cầu cập nhật chỉ định các giá trị cho cả weightedFontFamily và bold, weightedFontFamily được áp dụng trước tiên, sau đó bold.

Nếu weightedFontFamily#weight không được thiết lập, giá trị mặc định là 400.

Nếu weightedFontFamily được đặt, sau đó weightedFontFamily#fontFamily cũng phải được đặt với giá trị không trống. Nếu không, hệ thống sẽ trả về lỗi yêu cầu không hợp lệ 400.

OptionalColor

Màu có thể mờ hoàn toàn hoặc trong suốt hoàn toàn.

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 mờ. Nếu bạn không đặt chính sách này thì màu này sẽ là màu trong suốt.

BaselineOffset

Cách mà văn bản có thể được bù trừ 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ừ thành phần mẹ.
NONE Văn bản không được bù trừ theo chiều dọc.
SUPERSCRIPT Văn bản được dịch chuyển lên trên theo chiều dọc (chỉ số trên).
SUBSCRIPT Văn bản được dịch chuyển xuống dưới theo chiều dọc (dấu dưới).

WeightedFontFamily

Biểu thị một bộ phông chữ và độ đậm được 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ữ trong Trang trình bày hoặc trong Google Fonts. Nếu không nhận dạng được tên phông chữ, văn bản sẽ được hiển thị trong Arial.

weight

integer

Độ đậm kết xuất 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ị số được mô tả trong Bản đặc tả CSS 2.1, phần 15.6, với các giá trị không phải số không được phép. Trọng số lớn hơn hoặc bằng 700 được coi là in đậm và trọng số nhỏ hơn 700 không được in đậm. Giá trị mặc định là 400 ("bình thường").

TextRun

Một loại TextElement đại diện cho một dòng văn bản đều có cùng một 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 lần chạy này.

AutoText

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 kết xuất 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 không xác định.
SLIDE_NUMBER Nhập văn bản tự động thể hiện 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 các đoạn được liên kết với một danh sách. Một đoạn văn bản thuộc danh sách có 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ã của danh sách.

nestingLevel

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

Bản đồ các cấp lồng ghép với các thuộc tính của dấu đầu dòng ở cấp liên kết. Danh sách có tối đa chín cấp độ lồng nhau, do đó giá trị có thể có cho các khoá của bản đồ này là từ 0 đến 8, tính toàn bộ.

NestingLevel

Chứa các thuộc tính mô tả giao diện của một dấu đầu dòng danh sách ở 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 này.