Text

TextContent

Nội dung văn bản chung. Văn bản phải nằm ở 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 một 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 từ 0 của phần tử văn bản này, theo đơ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 kết hợp 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)

Điểm đánh dấu đại diện cho phần đầu của một đoạn mới.

Chiến lược phát hành đĩa đơn startIndex và endIndex của TextElement này đại diện cho phạm vi của đoạ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)

Một TextElement đại diện cho một loạt văn bản trong đó tất cả các ký tự trong lần chạy có cùng giá trị TextStyle.

Chiến lược phát hành đĩa đơn 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 paragraphMarker TextElement. Nói cách khác, TextRun sẽ không bao giờ kéo dài nhiều đoạn.

autoText

object (AutoText)

TextElement hiện là một vị trí trong văn bản và đượ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 này. Nếu không có thì đoạn không thuộc danh sách nào.

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ó cha/mẹ placeholder, thì các kiểu đoạn văn này có thể được kế thừa từ cấp độ gốc. Kiểu đoạn được kế thừa phụ thuộc vào mức độ lồng 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 kế thừa được biểu thị dưới dạng các trường chưa được đặ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, dưới dạng tỷ lệ phần trăm bình thường, trong khi bình thường được biểu thị là 100,0. Nếu bạn không đặt chính sách này, thì giá trị sẽ được kế thừa từ đơn vị tổ chức mẹ.

alignment

enum (Alignment)

Căn chỉnh văn bản cho đoạ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 bạn không đặt chính sách này, thì giá trị sẽ được kế thừa từ đơn vị tổ chức mẹ.

indentEnd

object (Dimension)

Mức thụt lề cho đoạn ở bên tương ứng với phần 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 chính sách này, thì giá trị sẽ được kế thừa từ đơn vị tổ chức mẹ.

spaceAbove

object (Dimension)

Lượng không gian thừa phía trên đoạn. Nếu bạn không đặt chính sách này, thì giá trị sẽ được kế thừa từ đơn vị tổ chức mẹ.

spaceBelow

object (Dimension)

Lượng không gian thừa bên dưới đoạn. Nếu bạn không đặt chính sách này, thì giá trị sẽ được kế thừa từ đơn vị tổ chức mẹ.

indentFirstLine

object (Dimension)

Lượng thụt lề ở đầu dòng đầu tiên của đoạn. Nếu bạn không đặt chính sách này, thì giá trị sẽ được kế thừa từ đơn vị tổ chức 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ách căn chỉnh đoạn được kế thừa từ cấp độ gốc.
START Đoạn được căn chỉnh với đầu dòng. Căn trái đối với văn bản LTR, nếu không thì căn phải.
CENTER Đoạn được căn giữa.
END Đoạn được căn chỉnh với cuối dòng. Căn phải đối với văn bản LTR, nếu không thì căn trái.
JUSTIFIED Đoạ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 dịch chuyển từ phải sang trái.

SpacingMode

Các chế độ giãn cách đoạn.

Enum
SPACING_MODE_UNSPECIFIED Chế độ giãn cách được kế thừa từ chế độ mẹ.
NEVER_COLLAPSE Độ giãn cách đoạn luôn được hiển thị.
COLLAPSE_LISTS Bỏ qua khoảng cách đoạn 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 này.

nestingLevel

integer

Mức độ lồng ghép của đoạ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 đượ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 được đặ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ì việc huỷ thiết lập các trường này sẽ chuyển kiểu 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 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 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 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 đọc, fontSize sẽ được chỉ định bằng điểm.

baselineOffset

enum (BaselineOffset)

Độ lệch 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 cỡ nhỏ hay không.

strikethrough

boolean

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

underline

boolean

Liệu văn bản có được gạch chân hay không.

weightedFontFamily

object (WeightedFontFamily)

Bộ phông chữ và độ đậm hiển thị 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 fontFamily được đặt và weightedFontFamily không, giá trị của fontFamily được áp dụng có độ đậm 400 ("bình thường").
  • Nếu cả hai trường đều được đặt, giá trị của fontFamily phải khớp với URL 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ừ thành phần mẹ. Xin lưu ý rằng các tài sản này không thể kế thừa độc lập 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 400 với yêu cầu không hợp lệ.

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, màu này sẽ được sử 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ác 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 của nó.

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 theo chiều dọc lên trên (chỉ số trên).
SUBSCRIPT Văn bản được dịch chuyển theo chiều dọc xuống dưới (chỉ số dưới).

WeightedFontFamily

Đại diện cho 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 từ trình đơn Phông chữ trong Trang trình bày hoặc từ Google Fonts (Phông chữ Google). 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 kết xuất của văn bản. Trường này có thể chứa bất kỳ giá trị nào là bội số của 100 trong khoảng 100 và 900. Phạm vi này tương ứng với các giá trị số được mô tả trong Thông số kỹ thuật CSS 2.1, mục 15.6, không cho phép các giá trị không phải số. 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 loạt 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 lần chạy 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 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 dấu đầu dòng thuộc các đoạn được liên kết với danh sách. Một đoạn thuộc danh sách có tham chiếu ngầm đến mã 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 mức độ lồng nhau theo thuộc tính của dấu đầu dòng ở cấp liên quan. 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 nhau nhất định.

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

object (TextStyle)

Kiểu dấu đầu dòng ở cấp độ lồng nhau này.