REST Resource: documents

Tài nguyên: Tài liệu

Tài liệu trên Google Tài liệu.

Biểu diễn dưới dạng JSON 
{
  "documentId": string,
  "title": string,
  "tabs": [
    {
      object (Tab)
    }
  ],
  "revisionId": string,
  "suggestionsViewMode": enum (SuggestionsViewMode),
  "body": {
    object (Body)
  },
  "headers": {
    string: {
      object (Header)
    },
    ...
  },
  "footers": {
    string: {
      object (Footer)
    },
    ...
  },
  "footnotes": {
    string: {
      object (Footnote)
    },
    ...
  },
  "documentStyle": {
    object (DocumentStyle)
  },
  "suggestedDocumentStyleChanges": {
    string: {
      object (SuggestedDocumentStyle)
    },
    ...
  },
  "namedStyles": {
    object (NamedStyles)
  },
  "suggestedNamedStylesChanges": {
    string: {
      object (SuggestedNamedStyles)
    },
    ...
  },
  "lists": {
    string: {
      object (List)
    },
    ...
  },
  "namedRanges": {
    string: {
      object (NamedRanges)
    },
    ...
  },
  "inlineObjects": {
    string: {
      object (InlineObject)
    },
    ...
  },
  "positionedObjects": {
    string: {
      object (PositionedObject)
    },
    ...
  }
}
Trường
documentId

string

Chỉ có đầu ra. Mã của tài liệu.
title

string

Tiêu đề của tài liệu.
tabs[]

object (Tab)

Các thẻ là một phần của một tài liệu.

Thẻ có thể chứa các thẻ con, một thẻ được lồng trong một thẻ khác. Thẻ con được biểu thị bằng trường Tab.childTabs.
revisionId

string

Chỉ có đầu ra. Mã sửa đổi của tài liệu. Có thể dùng trong các yêu cầu cập nhật để chỉ định bản sửa đổi của tài liệu cần áp dụng nội dung cập nhật và cách yêu cầu hoạt động nếu tài liệu đã được chỉnh sửa kể từ bản sửa đổi đó. Chỉ được điền nếu người dùng có quyền chỉnh sửa tài liệu.

Mã bản sửa đổi không phải là một số thứ tự mà là một chuỗi mờ. Định dạng của mã sửa đổi có thể thay đổi theo thời gian. Mã sửa đổi được trả về chỉ được đảm bảo hợp lệ trong 24 giờ sau khi được trả về và không thể chia sẻ giữa các người dùng. Nếu mã sửa đổi không thay đổi giữa các lệnh gọi, thì tài liệu đó chưa thay đổi. Ngược lại, giấy tờ tuỳ thân đã thay đổi (cho cùng một tài liệu và người dùng) thường có nghĩa là giấy tờ đó đã được cập nhật. Tuy nhiên, mã nhận dạng cũng có thể thay đổi do các yếu tố nội bộ, chẳng hạn như thay đổi định dạng mã nhận dạng.
suggestionsViewMode

enum (SuggestionsViewMode)

Chỉ có đầu ra. Chế độ xem đề xuất được áp dụng cho tài liệu.

Lưu ý: Khi chỉnh sửa tài liệu, các thay đổi phải dựa trên tài liệu có SUGGESTIONS_INLINE.
body

object (Body)

Chỉ có đầu ra. Phần nội dung chính của tài liệu.

Trường cũ: Thay vào đó, hãy sử dụng Document.tabs.documentTab.body để hiển thị nội dung tài liệu thực tế từ tất cả các thẻ khi thông số includeTabsContent được đặt thành true. Nếu là false hoặc chưa đặt, trường này sẽ chứa thông tin về thẻ đầu tiên trong tài liệu.
headers

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

Chỉ có đầu ra. Các tiêu đề trong tài liệu, được khoá theo mã nhận dạng tiêu đề.

Trường cũ: Thay vào đó, hãy sử dụng Document.tabs.documentTab.headers để hiển thị nội dung tài liệu thực tế trên tất cả các thẻ khi tham số includeTabsContent được đặt thành true. Nếu là false hoặc chưa đặt, trường này sẽ chứa thông tin về thẻ đầu tiên trong tài liệu.
footers

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

Chỉ có đầu ra. Chân trang trong tài liệu, có mã nhận dạng chân trang.

Trường cũ: Thay vào đó, hãy sử dụng Document.tabs.documentTab.footers để hiển thị nội dung tài liệu thực tế từ tất cả các thẻ khi thông số includeTabsContent được đặt thành true. Nếu là false hoặc chưa đặt, trường này chứa thông tin về thẻ đầu tiên trong tài liệu.
footnotes

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

Chỉ có đầu ra. Các chú thích cuối trang trong tài liệu, được khoá bằng mã nhận dạng chú thích cuối trang.

Trường cũ: Thay vào đó, hãy sử dụng Document.tabs.documentTab.footnotes để hiển thị nội dung tài liệu thực tế từ tất cả các thẻ khi thông số includeTabsContent được đặt thành true. Nếu là false hoặc chưa đặt, trường này sẽ chứa thông tin về thẻ đầu tiên trong tài liệu.
documentStyle

object (DocumentStyle)

Chỉ có đầu ra. Kiểu của tài liệu.

Trường cũ: Thay vào đó, hãy sử dụng Document.tabs.documentTab.documentStyle để hiển thị nội dung tài liệu thực tế từ tất cả các thẻ khi thông số includeTabsContent được đặt thành true. Nếu là false hoặc chưa đặt, trường này chứa thông tin về thẻ đầu tiên trong tài liệu.
suggestedDocumentStyleChanges

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

Chỉ có đầu ra. Các thay đổi đề xuất cho kiểu của tài liệu, được khóa theo mã đề xuất.

Trường cũ: Thay vào đó, hãy sử dụng Document.tabs.documentTab.suggestedDocumentStyleChanges để hiển thị nội dung tài liệu thực tế từ tất cả các thẻ khi thông số includeTabsContent được đặt thành true. Nếu bạn đặt chính sách false hoặc không đặt, trường này sẽ chứa thông tin về thẻ đầu tiên trong tài liệu.
namedStyles

object (NamedStyles)

Chỉ có đầu ra. Các kiểu có tên của tài liệu.

Trường cũ: Thay vào đó, hãy sử dụng Document.tabs.documentTab.namedStyles để hiển thị nội dung tài liệu thực tế từ tất cả các thẻ khi thông số includeTabsContent được đặt thành true. Nếu là false hoặc chưa đặt, trường này sẽ chứa thông tin về thẻ đầu tiên trong tài liệu.
suggestedNamedStylesChanges

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

Chỉ có đầu ra. Các thay đổi được đề xuất đối với các kiểu được đặt tên của tài liệu, được khoá theo mã đề xuất.

Trường cũ: Thay vào đó, hãy sử dụng Document.tabs.documentTab.suggestedNamedStylesChanges để hiển thị nội dung tài liệu thực tế từ tất cả các thẻ khi thông số includeTabsContent được đặt thành true. Nếu là false hoặc chưa đặt, trường này sẽ chứa thông tin về thẻ đầu tiên trong tài liệu.
lists

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

Chỉ có đầu ra. Các danh sách trong tài liệu, được khoá theo mã danh sách.

Trường cũ: Thay vào đó, hãy sử dụng Document.tabs.documentTab.lists để hiển thị nội dung tài liệu thực tế từ tất cả các thẻ khi thông số includeTabsContent được đặt thành true. Nếu là false hoặc chưa đặt, trường này chứa thông tin về thẻ đầu tiên trong tài liệu.
namedRanges

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

Chỉ có đầu ra. Các dải ô được đặt tên trong tài liệu, được khoá theo tên.

Trường cũ: Thay vào đó, hãy sử dụng Document.tabs.documentTab.namedRanges để hiển thị nội dung tài liệu thực tế từ tất cả các thẻ khi thông số includeTabsContent được đặt thành true. Nếu là false hoặc chưa đặt, trường này chứa thông tin về thẻ đầu tiên trong tài liệu.
inlineObjects

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

Chỉ có đầu ra. Các đối tượng cùng dòng trong tài liệu, được khoá theo mã nhận dạng đối tượng.

Trường cũ: Thay vào đó, hãy sử dụng Document.tabs.documentTab.inlineObjects để hiển thị nội dung tài liệu thực tế từ tất cả các thẻ khi thông số includeTabsContent được đặt thành true. Nếu là false hoặc chưa đặt, trường này sẽ chứa thông tin về thẻ đầu tiên trong tài liệu.
positionedObjects

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

Chỉ có đầu ra. Các đối tượng được định vị trong tài liệu, được khoá theo mã đối tượng.

Trường cũ: Thay vào đó, hãy sử dụng Document.tabs.documentTab.positionedObjects để hiển thị nội dung tài liệu thực tế trên tất cả các thẻ khi tham số includeTabsContent được đặt thành true. Nếu là false hoặc chưa đặt, trường này chứa thông tin về thẻ đầu tiên trong tài liệu.

Tab

Thẻ trong tài liệu.

Biểu diễn dưới dạng JSON 
{
  "tabProperties": {
    object (TabProperties)
  },
  "childTabs": [
    {
      object (Tab)
    }
  ],

  // Union field content can be only one of the following:
  "documentTab": {
    object (DocumentTab)
  }
  // End of list of possible types for union field content.
}
Trường
tabProperties

object (TabProperties)

Các thuộc tính của thẻ, chẳng hạn như mã nhận dạng và tiêu đề.
childTabs[]

object (Tab)

Các thẻ con lồng trong thẻ này.
Trường kết hợp content. Nội dung của thẻ. content chỉ có thể là một trong những trạng thái sau đây:
documentTab

object (DocumentTab)

Thẻ chứa nội dung tài liệu, chẳng hạn như văn bản và hình ảnh.

TabProperties

Thuộc tính của thẻ.

Biểu diễn dưới dạng JSON 
{
  "tabId": string,
  "title": string,
  "parentTabId": string,
  "index": integer,
  "nestingLevel": integer
}
Trường
tabId

string

Chỉ có đầu ra. Mã của thẻ. Bạn không thể thay đổi trường này.
title

string

Tên thẻ hiển thị cho người dùng.
parentTabId

string

Không bắt buộc. Mã của thẻ mẹ. Để trống khi thẻ hiện tại là thẻ cấp cơ sở, tức là thẻ này không có thẻ mẹ nào.
index

integer

Chỉ mục từ 0 của thẻ trong thành phần mẹ.
nestingLevel

integer

Chỉ có đầu ra. Độ sâu của thẻ trong tài liệu. Các thẻ cấp gốc bắt đầu từ 0.

DocumentTab

Một thẻ có nội dung tài liệu.

Biểu diễn dưới dạng JSON 
{
  "body": {
    object (Body)
  },
  "headers": {
    string: {
      object (Header)
    },
    ...
  },
  "footers": {
    string: {
      object (Footer)
    },
    ...
  },
  "footnotes": {
    string: {
      object (Footnote)
    },
    ...
  },
  "documentStyle": {
    object (DocumentStyle)
  },
  "suggestedDocumentStyleChanges": {
    string: {
      object (SuggestedDocumentStyle)
    },
    ...
  },
  "namedStyles": {
    object (NamedStyles)
  },
  "suggestedNamedStylesChanges": {
    string: {
      object (SuggestedNamedStyles)
    },
    ...
  },
  "lists": {
    string: {
      object (List)
    },
    ...
  },
  "namedRanges": {
    string: {
      object (NamedRanges)
    },
    ...
  },
  "inlineObjects": {
    string: {
      object (InlineObject)
    },
    ...
  },
  "positionedObjects": {
    string: {
      object (PositionedObject)
    },
    ...
  }
}
Trường
body

object (Body)

Phần nội dung chính của thẻ tài liệu.
headers

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

Các tiêu đề trong thẻ tài liệu, được nhập bởi mã tiêu đề.
footers

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

Chân trang trong thẻ tài liệu, được khoá theo mã nhận dạng chân trang.
footnotes

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

Chú thích cuối trang trong thẻ tài liệu, được khoá bằng mã nhận dạng chú thích cuối trang.
documentStyle

object (DocumentStyle)

Kiểu của thẻ tài liệu.
suggestedDocumentStyleChanges

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

Các thay đổi đề xuất đối với kiểu của thẻ tài liệu, được khoá bằng mã đề xuất.
namedStyles

object (NamedStyles)

Kiểu được đặt tên của thẻ tài liệu.
suggestedNamedStylesChanges

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

Các thay đổi được đề xuất đối với các kiểu được đặt tên của thẻ tài liệu, được khoá theo mã đề xuất.
lists

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

Các danh sách trong thẻ tài liệu, được khoá bằng mã danh sách.
namedRanges

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

Các dải ô được đặt tên trong thẻ tài liệu, được sắp xếp theo tên.
inlineObjects

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

Các đối tượng cùng dòng trong thẻ tài liệu, được khoá theo mã nhận dạng đối tượng.
positionedObjects

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

Các đối tượng được định vị trong thẻ tài liệu, được khoá theo mã đối tượng.

Nội dung

Nội dung tài liệu.

Phần nội dung thường chứa toàn bộ nội dung tài liệu, ngoại trừ headers, footers và footnotes.

Biểu diễn dưới dạng JSON 
{
  "content": [
    {
      object (StructuralElement)
    }
  ]
}
Trường
content[]

object (StructuralElement)

Nội dung của phần thân.

Các chỉ mục cho nội dung của phần nội dung bắt đầu từ 0.

StructuralElement

StructuralElement mô tả nội dung cung cấp cấu trúc cho tài liệu.

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

  // Union field content can be only one of the following:
  "paragraph": {
    object (Paragraph)
  },
  "sectionBreak": {
    object (SectionBreak)
  },
  "table": {
    object (Table)
  },
  "tableOfContents": {
    object (TableOfContents)
  }
  // End of list of possible types for union field content.
}
Trường
startIndex

integer

Chỉ mục bắt đầu dựa trên số 0 của phần tử cấu trúc này, tính theo đơn vị mã UTF-16.
endIndex

integer

Chỉ mục kết thúc dựa trên số 0 của phần tử cấu trúc này, riêng biệt, trong các đơn vị mã UTF-16.
Trường hợp hợp nhất content. Nội dung của phần tử cấu trúc. content chỉ có thể là một trong những giá trị sau:
paragraph

object (Paragraph)

Loại đoạn của phần tử cấu trúc.
sectionBreak

object (SectionBreak)

Loại ngắt phần của phần tử cấu trúc.
table

object (Table)

Một loại bảng của phần tử cấu trúc.
tableOfContents

object (TableOfContents)

Loại mục lục của phần tử cấu trúc.

Đoạn

StructuralElement đại diện cho một đoạn văn bản. Đoạn là một dải nội dung được kết thúc bằng một ký tự dòng mới.

Biểu diễn dưới dạng JSON 
{
  "elements": [
    {
      object (ParagraphElement)
    }
  ],
  "paragraphStyle": {
    object (ParagraphStyle)
  },
  "suggestedParagraphStyleChanges": {
    string: {
      object (SuggestedParagraphStyle)
    },
    ...
  },
  "bullet": {
    object (Bullet)
  },
  "suggestedBulletChanges": {
    string: {
      object (SuggestedBullet)
    },
    ...
  },
  "positionedObjectIds": [
    string
  ],
  "suggestedPositionedObjectIds": {
    string: {
      object (ObjectReferences)
    },
    ...
  }
}
Trường
elements[]

object (ParagraphElement)

Nội dung của đoạn văn, được chia nhỏ thành các phần thành phần.
paragraphStyle

object (ParagraphStyle)

Kiểu của đoạn văn này.
suggestedParagraphStyleChanges

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

Kiểu đoạn văn bản đề xuất thay đổi cho đoạn này, được khoá bởi mã đề xuất.
bullet

object (Bullet)

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

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

Các thay đổi đề xuất cho dấu đầu dòng của đoạn này.
positionedObjectIds[]

string

Mã nhận dạng của các đối tượng được định vị liên kết với đoạn văn này.
suggestedPositionedObjectIds

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

Mã nhận dạng của các đối tượng được định vị được đề xuất đính kèm vào đoạn văn này, được khoá theo mã đề xuất.

ParagraphElement

ParagraphElement mô tả nội dung trong Paragraph.

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

  // Union field content can be only one of the following:
  "textRun": {
    object (TextRun)
  },
  "autoText": {
    object (AutoText)
  },
  "pageBreak": {
    object (PageBreak)
  },
  "columnBreak": {
    object (ColumnBreak)
  },
  "footnoteReference": {
    object (FootnoteReference)
  },
  "horizontalRule": {
    object (HorizontalRule)
  },
  "equation": {
    object (Equation)
  },
  "inlineObjectElement": {
    object (InlineObjectElement)
  },
  "person": {
    object (Person)
  },
  "richLink": {
    object (RichLink)
  }
  // End of list of possible types for union field content.
}
Trường
startIndex

integer

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

integer

Chỉ số kết thúc có cơ số 0 của phần tử đoạn này, không bao gồm, theo đơn vị mã UTF-16.
Trường kết hợp content. Nội dung của phần tử đoạn văn. content chỉ có thể là một trong những giá trị sau:
textRun

object (TextRun)

Phần tử đoạn văn bản chạy.
autoText

object (AutoText)

Một phần tử đoạn văn bản tự động.
pageBreak

object (PageBreak)

Phần tử đoạn văn bản ngắt trang.
columnBreak

object (ColumnBreak)

Phần tử đoạn văn ngắt cột.
footnoteReference

object (FootnoteReference)

Phần tử đoạn văn tham chiếu đến chú thích cuối trang.
horizontalRule

object (HorizontalRule)

Phần tử đoạn văn bản có đường kẻ ngang.
equation

object (Equation)

Phần tử đoạn văn phương trình.
inlineObjectElement

object (InlineObjectElement)

Phần tử đoạn văn đối tượng cùng dòng.
person

object (Person)

Phần tử đoạn văn bản liên kết đến một người hoặc địa chỉ email.

TextRun

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

Biểu diễn dưới dạng JSON 
{
  "content": string,
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}
Trường
content

string

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

Mọi phần tử không phải văn bản trong lần chạy đều được thay thế bằng ký tự Unicode U+E907.
suggestedInsertionIds[]

string

Mã chèn được đề xuất. TextRun có thể có nhiều mã chèn nếu đó là thay đổi được đề xuất lồng nhau. Nếu trống, thì đây không phải là nội dung chèn được đề xuất.
suggestedDeletionIds[]

string

Mã nhận dạng được đề xuất xoá. Nếu trống, thì không có nội dung nào được đề xuất xoá.
textStyle

object (TextStyle)

Kiểu văn bản của lần chạy này.
suggestedTextStyleChanges

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

Kiểu văn bản được đề xuất sẽ thay đổi thành lần chạy này, được khoá bằng mã đề xuất.

TextStyle

Biểu thị kiểu có thể áp dụng cho văn bản.

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. Phần tử mẹ của kiểu văn bản phụ thuộc vào vị trí xác định kiểu văn bản:

  • TextStyle của văn bản trong Paragraph kế thừa từ named style type tương ứng của đoạn văn bản.
  • TextStyle trên named style kế thừa từ kiểu có tên normal text.
  • TextStyle của kiểu có tên normal text kế thừa từ kiểu văn bản mặc định trong trình chỉnh sửa Tài liệu.
  • TextStyle trên phần tử Paragraph nằm trong bảng có thể kế thừa kiểu văn bản từ kiểu bảng.

Nếu kiểu văn bản không kế thừa từ phần tử mẹ, thì khi bạn huỷ thiết lập các trường, kiểu văn bản đó sẽ trở về một giá trị phù hợp với giá trị mặc định trong Trình chỉnh sửa Tài liệu.

Biểu diễn dưới dạng JSON 
{
  "bold": boolean,
  "italic": boolean,
  "underline": boolean,
  "strikethrough": boolean,
  "smallCaps": boolean,
  "backgroundColor": {
    object (OptionalColor)
  },
  "foregroundColor": {
    object (OptionalColor)
  },
  "fontSize": {
    object (Dimension)
  },
  "weightedFontFamily": {
    object (WeightedFontFamily)
  },
  "baselineOffset": enum (BaselineOffset),
  "link": {
    object (Link)
  }
}
Trường
bold

boolean

Liệu văn bản có được hiển thị dưới dạng in đậm hay không.
italic

boolean

Liệu văn bản có được in nghiêng hay không.
underline

boolean

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

boolean

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

boolean

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

object (OptionalColor)

Màu nền của văn bản. Nếu được đặt, màu sẽ là màu RGB hoặc màu trong suốt, tuỳ thuộc vào trường color.
foregroundColor

object (OptionalColor)

Màu nền trước của văn bản. Nếu được đặt, màu sẽ là màu RGB hoặc màu trong suốt, tuỳ thuộc vào trường color.
fontSize

object (Dimension)

Kích thước phông chữ của văn bản.
weightedFontFamily

object (WeightedFontFamily)

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

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, giá trị mặc định sẽ là 400.

Nếu bạn đặt weightedFontFamily, thì bạn cũng phải đặt weightedFontFamily#fontFamily bằng một 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.
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.

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

OptionalColor

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

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

object (Color)

Nếu được đặt, màu này sẽ được sử dụng làm màu mờ. Nếu không được đặt, thuộc tính này sẽ biểu thị màu trong suốt.

Màu

Một màu đồng nhất.

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

object (RgbColor)

Giá trị màu RGB.

RgbColor

Màu RGB.

Biểu diễn dưới dạng JSON 
{
  "red": number,
  "green": number,
  "blue": number
}
Trường
red

number

Thành phần màu đỏ của màu, từ 0.0 đến 1.0.
green

number

Thành phần màu xanh lục của màu, từ 0 đến 1.
blue

number

Thành phần màu xanh dương của màu, từ 0 đến 1.

Phương diện

Độ lớn theo một hướng trong các đơn vị đã chỉ định.

Biểu diễn dưới dạng JSON 
{
  "magnitude": number,
  "unit": enum (Unit)
}
Trường
magnitude

number

Magnitude.
unit

enum (Unit)

Đơn vị cho độ lớn.

Đơn vị

Đơn vị đo lường.

Enum
UNIT_UNSPECIFIED Đơn vị không xác định.
PT Một điểm, 1/72 inch.

WeightedFontFamily

Đại diện cho bộ phông chữ và độ đậm của văn bản.

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

integer

Độ đậm của phông chữ. 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.

Giá trị mặc định là 400 ("bình thường").

Độ đậm phông chữ chỉ chiếm một thành phần của độ đậm phông chữ được kết xuất. Sự kết hợp giữa weight và giá trị bold đã phân giải của kiểu văn bản xác định độ đậm được hiển thị, sau khi tính đến tính kế thừa:

  • Nếu văn bản in đậm và độ đậm nhỏ hơn 400, thì độ đậm hiển thị sẽ là 400.
  • Nếu văn bản được in đậm và độ đậm lớn hơn hoặc bằng 400 nhưng nhỏ hơn 700, thì độ đậm hiển thị là 700.
  • Nếu trọng số lớn hơn hoặc bằng 700 thì trọng số được kết xuất sẽ bằng trọng số.
  • Nếu văn bản không được in đậm, thì độ đậm hiển thị sẽ bằng độ đậm.

BaselineOffset

Các cách văn bản có thể được dịch chuyển 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 bị lệch 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).

SuggestedTextStyle

Đã đề xuất thay đổi đối với TextStyle.

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

object (TextStyle)

TextStyle chỉ bao gồm các thay đổi được thực hiện trong đề xuất này. Bạn có thể sử dụng thuộc tính này cùng với textStyleSuggestionState để xem trường nào đã thay đổi và giá trị mới của các trường đó.
textStyleSuggestionState

object (TextStyleSuggestionState)

Một mặt nạ cho biết trường nào trên TextStyle cơ sở đã được thay đổi trong đề xuất này.

TextStyleSuggestionState

Một mặt nạ cho biết trường nào trên TextStyle cơ sở đã được thay đổi trong đề xuất này. Đối với mọi trường được đặt thành đúng, sẽ có một giá trị đề xuất mới.

Biểu diễn dưới dạng JSON 
{
  "boldSuggested": boolean,
  "italicSuggested": boolean,
  "underlineSuggested": boolean,
  "strikethroughSuggested": boolean,
  "smallCapsSuggested": boolean,
  "backgroundColorSuggested": boolean,
  "foregroundColorSuggested": boolean,
  "fontSizeSuggested": boolean,
  "weightedFontFamilySuggested": boolean,
  "baselineOffsetSuggested": boolean,
  "linkSuggested": boolean
}
Trường
boldSuggested

boolean

Cho biết liệu có thay đổi được đề xuất đối với bold hay không.
italicSuggested

boolean

Cho biết liệu có thay đổi nào được đề xuất đối với italic hay không.
underlineSuggested

boolean

Cho biết liệu có thay đổi được đề xuất đối với underline hay không.
strikethroughSuggested

boolean

Cho biết liệu có thay đổi được đề xuất đối với strikethrough hay không.
smallCapsSuggested

boolean

Cho biết liệu có thay đổi nào được đề xuất đối với smallCaps hay không.
backgroundColorSuggested

boolean

Cho biết liệu có thay đổi nào được đề xuất đối với backgroundColor hay không.
foregroundColorSuggested

boolean

Cho biết liệu có thay đổi được đề xuất đối với foregroundColor hay không.
fontSizeSuggested

boolean

Cho biết liệu có thay đổi nào được đề xuất đối với fontSize hay không.
weightedFontFamilySuggested

boolean

Cho biết liệu có thay đổi nào được đề xuất đối với weightedFontFamily hay không.
baselineOffsetSuggested

boolean

Cho biết liệu có thay đổi được đề xuất đối với baselineOffset hay không.

AutoText

ParagraphElement đại diện cho một vị trí trong văn bản được thay thế động bằng nội dung có thể thay đổi theo thời gian, chẳng hạn như số trang.

Biểu diễn dưới dạng JSON 
{
  "type": enum (Type),
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}
Trường
type

enum (Type)

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

string

Mã chèn được đề xuất. AutoText có thể có nhiều mã chèn nếu đó là một thay đổi được đề xuất lồng nhau. Nếu trống, thì đây không phải là nội dung chèn được đề xuất.
suggestedDeletionIds[]

string

Mã nhận dạng được đề xuất xoá. Nếu trống, thì không có nội dung nào được đề xuất xoá.
textStyle

object (TextStyle)

Kiểu văn bản của Văn bản tự động này.
suggestedTextStyleChanges

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

Kiểu văn bản đề xuất thay đổi thành Văn bản tự động này, được khoá theo mã đề xuất.

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.
PAGE_NUMBER Nhập văn bản tự động thể hiện số trang hiện tại.
PAGE_COUNT Nhập văn bản tự động thể hiện tổng số trang trong tài liệu.

PageBreak

ParagraphElement đại diện cho một dấu ngắt trang. Ngắt trang làm cho văn bản tiếp theo bắt đầu ở đầu trang tiếp theo.

Biểu diễn dưới dạng JSON 
{
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}
Trường
suggestedInsertionIds[]

string

Mã chèn được đề xuất. Một PageBreak có thể có nhiều mã chèn nếu đó là một thay đổi đề xuất lồng nhau. Nếu trống, thì đây không phải là nội dung chèn được đề xuất.
suggestedDeletionIds[]

string

Mã xoá được đề xuất. Nếu trống, thì không có nội dung nào được đề xuất xoá.
textStyle

object (TextStyle)

Kiểu văn bản của PageBreak này.

Tương tự như nội dung văn bản, chẳng hạn như dòng văn bản và tệp tham chiếu chú thích cuối trang, kiểu văn bản của dấu ngắt trang có thể ảnh hưởng đến bố cục nội dung cũng như kiểu văn bản được chèn bên cạnh.
suggestedTextStyleChanges

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

Kiểu văn bản được đề xuất sẽ thay đổi thành PageBreak này, được khoá bằng mã đề xuất.

ColumnBreak

ParagraphElement đại diện cho một dòng ngắt cột. Phần ngắt cột làm cho văn bản tiếp theo bắt đầu ở đầu cột tiếp theo.

Biểu diễn dưới dạng JSON 
{
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}
Trường
suggestedInsertionIds[]

string

Mã chèn được đề xuất. ColumnBreak có thể có nhiều mã chèn nếu đó là một thay đổi được đề xuất lồng nhau. Nếu trống, thì đây không phải là nội dung chèn được đề xuất.
suggestedDeletionIds[]

string

Mã xoá được đề xuất. Nếu trống, thì không có nội dung nào được đề xuất xoá.
textStyle

object (TextStyle)

Kiểu văn bản của ColumnBreak này.

Tương tự như nội dung văn bản, chẳng hạn như dòng văn bản và chú thích cuối trang, kiểu văn bản của dòng phân cách cột có thể ảnh hưởng đến bố cục nội dung cũng như kiểu văn bản được chèn bên cạnh dòng phân cách cột đó.
suggestedTextStyleChanges

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

Kiểu văn bản được đề xuất sẽ thay đổi thành ColumnBreak này, được khoá bằng mã đề xuất.

FootnoteReference

ParagraphElement đại diện cho tham chiếu đến chú thích cuối trang. Phần tham chiếu đến chú thích cuối trang là nội dung cùng dòng được hiển thị cùng với một số và được dùng để xác định chú thích cuối trang.

Biểu diễn dưới dạng JSON 
{
  "footnoteId": string,
  "footnoteNumber": string,
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}
Trường
footnoteId

string

Mã của footnote chứa nội dung của tham chiếu chú thích cuối trang này.
footnoteNumber

string

Số lượt hiển thị của chú thích cuối trang này.
suggestedInsertionIds[]

string

Mã chèn được đề xuất. FootnoteReference có thể có nhiều mã chèn nếu đó là một thay đổi được đề xuất lồng nhau. Nếu trống, thì đây không phải là nội dung chèn được đề xuất.
suggestedDeletionIds[]

string

Mã xoá được đề xuất. Nếu trống, thì không có đề xuất xoá nội dung này.
textStyle

object (TextStyle)

Kiểu văn bản của FootnoteReference này.
suggestedTextStyleChanges

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

Kiểu văn bản đề xuất thay đổi cho FootnoteReference này, được tạo khoá theo mã đề xuất.

HorizontalRule

ParagraphElement đại diện cho một đường ngang.

Biểu diễn dưới dạng JSON 
{
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}
Trường
suggestedInsertionIds[]

string

Mã chèn được đề xuất. HorizontalRule có thể có nhiều mã chèn nếu đó là một thay đổi đề xuất được lồng. Nếu trống thì đây không phải là phần chèn được đề xuất.
suggestedDeletionIds[]

string

Mã nhận dạng được đề xuất xoá. Nếu trống, thì không có nội dung nào được đề xuất xoá.
textStyle

object (TextStyle)

Kiểu văn bản của HorizontalRule này.

Tương tự như nội dung văn bản, chẳng hạn như dòng văn bản và tệp tham chiếu chú thích cuối trang, kiểu văn bản của đường kẻ ngang có thể ảnh hưởng đến bố cục nội dung cũng như kiểu văn bản được chèn bên cạnh đường kẻ đó.
suggestedTextStyleChanges

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

Kiểu văn bản được đề xuất sẽ thay đổi thành HorizontalRule này, được khoá bằng mã đề xuất.

Phương trình

ParagraphElement đại diện cho một phương trình.

Biểu diễn dưới dạng JSON 
{
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ]
}
Trường
suggestedInsertionIds[]

string

Mã chèn được đề xuất. Equation có thể có nhiều mã chèn nếu đó là một thay đổi được đề xuất lồng nhau. Nếu trống, thì đây không phải là nội dung chèn được đề xuất.
suggestedDeletionIds[]

string

Mã nhận dạng được đề xuất xoá. Nếu trống, thì không có nội dung nào được đề xuất xoá.

InlineObjectElement

ParagraphElement chứa InlineObject.

Biểu diễn dưới dạng JSON 
{
  "inlineObjectId": string,
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}
Trường
inlineObjectId

string

Mã nhận dạng của InlineObject mà phần tử này chứa.
suggestedInsertionIds[]

string

Mã chèn được đề xuất. Một InlineObjectElement có thể có nhiều mã chèn nếu đó là một thay đổi đề xuất lồng nhau. Nếu trống thì đây không phải là phần chèn được đề xuất.
suggestedDeletionIds[]

string

Mã xoá được đề xuất. Nếu trống, thì không có nội dung nào được đề xuất xoá.
textStyle

object (TextStyle)

Kiểu văn bản của InlineObjectElement này.

Tương tự như nội dung văn bản, chẳng hạn như các lần chạy văn bản và phần tham chiếu đến chú thích cuối trang, kiểu văn bản của một phần tử đối tượng cùng dòng có thể ảnh hưởng đến bố cục nội dung cũng như kiểu văn bản được chèn bên cạnh phần tử đó.
suggestedTextStyleChanges

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

Kiểu văn bản được đề xuất sẽ thay đổi thành InlineObject này, được khoá bằng mã đề xuất.

Người

Một người hoặc địa chỉ email được đề cập trong tài liệu. Những lượt đề cập này hoạt động như một phần tử không thể thay đổi, chứa tên hoặc địa chỉ email của người đó.

Biểu diễn dưới dạng JSON 
{
  "personId": string,
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  },
  "personProperties": {
    object (PersonProperties)
  }
}
Trường
personId

string

Chỉ có đầu ra. Mã nhận dạng duy nhất của đường liên kết này.
suggestedInsertionIds[]

string

Mã nhận dạng cho các đề xuất chèn đường liên kết đến người này vào tài liệu. Person có thể có nhiều mã chèn nếu đó là thay đổi được đề xuất lồng nhau (ví dụ: một đề xuất trong một đề xuất do người dùng khác đưa ra). Nếu trống, thì đường liên kết đến người này sẽ không phải là nội dung chèn được đề xuất.
suggestedDeletionIds[]

string

Mã nhận dạng cho các đề xuất xoá đường liên kết đến người này khỏi tài liệu. Một Person có thể có nhiều mã xoá nếu có nhiều người dùng đề xuất xoá. Nếu trống, bạn không nên xoá đường liên kết đến người này.
textStyle

object (TextStyle)

Kiểu văn bản của Person này.
suggestedTextStyleChanges

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

Kiểu văn bản được đề xuất sẽ thay đổi thành Person này, được khoá bằng mã đề xuất.
personProperties

object (PersonProperties)

Chỉ có đầu ra. Các thuộc tính của Person này. Trường này luôn hiển thị.

PersonProperties

Các thuộc tính dành riêng cho Person được liên kết.

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

string

Chỉ có đầu ra. Tên của người đó nếu tên đó xuất hiện trong văn bản đường liên kết thay vì địa chỉ email của người đó.
email

string

Chỉ có đầu ra. Địa chỉ email được liên kết với Person này. Trường này luôn xuất hiện.

RichLinkProperties

Các thuộc tính dành riêng cho RichLink.

Biểu diễn dưới dạng JSON 
{
  "title": string,
  "uri": string,
  "mimeType": string
}
Trường
title

string

Chỉ có đầu ra. Tiêu đề của RichLink như hiển thị trong đường liên kết. Tiêu đề này khớp với tiêu đề của tài nguyên được liên kết tại thời điểm chèn hoặc cập nhật gần đây nhất của đường liên kết. Trường này luôn hiển thị.
uri

string

Chỉ có đầu ra. URI đến RichLink. Mục này luôn xuất hiện.
mimeType

string

Chỉ có đầu ra. Loại MIME của RichLink, nếu có (ví dụ: khi đó là tệp trong Drive).

ParagraphStyle

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

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. Cấp độ gốc của kiểu đoạn phụ thuộc vào nơi kiểu đoạn được xác định:

  • ParagraphStyle trên Paragraph kế thừa từ named style type tương ứng của đoạn văn.
  • ParagraphStyle trên named style kế thừa từ kiểu có tên normal text.
  • ĐoạnStyle của kiểu có tên normal text kế thừa từ kiểu đoạn văn mặc định trong Trình chỉnh sửa Tài liệu.
  • ĐoạnStyle trên phần tử Paragraph nằm trong bảng có thể kế thừa kiểu đoạn văn bản từ kiểu bảng.

Nếu kiểu đoạn văn không kế thừa từ một kiểu mẹ, thì việc huỷ thiết lập các trường sẽ chuyển kiểu về một giá trị khớp với giá trị mặc định trong trình chỉnh sửa Tài liệu.

Biểu diễn dưới dạng JSON 
{
  "headingId": string,
  "namedStyleType": enum (NamedStyleType),
  "alignment": enum (Alignment),
  "lineSpacing": number,
  "direction": enum (ContentDirection),
  "spacingMode": enum (SpacingMode),
  "spaceAbove": {
    object (Dimension)
  },
  "spaceBelow": {
    object (Dimension)
  },
  "borderBetween": {
    object (ParagraphBorder)
  },
  "borderTop": {
    object (ParagraphBorder)
  },
  "borderBottom": {
    object (ParagraphBorder)
  },
  "borderLeft": {
    object (ParagraphBorder)
  },
  "borderRight": {
    object (ParagraphBorder)
  },
  "indentFirstLine": {
    object (Dimension)
  },
  "indentStart": {
    object (Dimension)
  },
  "indentEnd": {
    object (Dimension)
  },
  "tabStops": [
    {
      object (TabStop)
    }
  ],
  "keepLinesTogether": boolean,
  "keepWithNext": boolean,
  "avoidWidowAndOrphan": boolean,
  "shading": {
    object (Shading)
  },
  "pageBreakBefore": boolean
}
Trường
headingId

string

Mã tiêu đề của đoạn. Nếu trống, thì đoạn này không phải là tiêu đề.

Thuộc tính này chỉ có thể đọc.
namedStyleType

enum (NamedStyleType)

Loại kiểu được đặt tên của đoạn văn bản.

Vì việc cập nhật kiểu kiểu đã đặt tên ảnh hưởng đến các thuộc tính khác trong BreadcrumbStyle, nên loại kiểu đã đặt tên sẽ được áp dụng trước khi cập nhật các thuộc tính khác.
alignment

enum (Alignment)

Cách căn chỉnh văn bản cho đoạn văn này.
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ẹ.
direction

enum (ContentDirection)

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

enum (SpacingMode)

Chế độ giãn cách cho đoạn văn bản.
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)

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

object (ParagraphBorder)

Đường viền giữa đoạn này với các đoạn tiếp theo và trước đó. 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ẹ.

Đường viền giữa được hiển thị khi đoạn văn bản liền kề có cùng thuộc tính đường viền và thụt lề.

Không thể cập nhật một phần đường viền đoạn. Khi thay đổi đường viền đoạn, đường viền mới phải được chỉ định toàn bộ.
borderTop

object (ParagraphBorder)

Đường viền ở đầu đoạn này. Nếu không được đặt, giá trị sẽ được kế thừa từ phần tử mẹ.

Đường viền trên được hiển thị khi đoạn ở trên có các thuộc tính khác nhau về đường viền và thụt lề.

Không thể cập nhật một phần đường viền đoạn. Khi thay đổi đường viền đoạn, đường viền mới phải được chỉ định toàn bộ.
borderBottom

object (ParagraphBorder)

Đường viền ở cuối đoạn này. Nếu không được đặt, giá trị sẽ được kế thừa từ phần tử mẹ.

Đường viền dưới cùng được hiển thị khi đoạn văn bản bên dưới có các thuộc tính đường viền và thụt lề khác nhau.

Không thể cập nhật một phần đường viền đoạn văn. Khi thay đổi đường viền đoạn, đường viền mới phải được chỉ định toàn bộ.
borderLeft

object (ParagraphBorder)

Đường viền ở bên trái của đoạn văn này. Nếu không được đặt, giá trị sẽ được kế thừa từ phần tử mẹ.

Không thể cập nhật một phần đường viền đoạn. Khi thay đổi đường viền của một đoạn văn bản, bạn phải chỉ định toàn bộ đường viền mới.
borderRight

object (ParagraphBorder)

Đường viền ở bên phải đoạn văn này. Nếu không được đặt, giá trị sẽ được kế thừa từ phần tử mẹ.

Không thể cập nhật một phần đường viền đoạn. Khi thay đổi đường viền của một đoạn văn bản, bạn phải chỉ định toàn bộ đường viền mới.
indentFirstLine

object (Dimension)

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

object (TabStop)

Danh sách các dấu tab cho đoạn văn này. Danh sách điểm dừng thẻ không được kế thừa.

Thuộc tính này chỉ có thể đọc.
keepLinesTogether

boolean

Liệu tất cả các dòng của đoạn văn có nên được bố trí trên cùng một trang hoặc cột hay không nếu có thể. Nếu không được đặt, giá trị sẽ được kế thừa từ phần tử mẹ.
keepWithNext

boolean

Nếu có thể, ít nhất một phần của đoạn văn này phải được bố trí trên cùng một trang hoặc cột với đoạn văn tiếp theo. Nếu không được đặt, giá trị sẽ được kế thừa từ phần tử mẹ.
avoidWidowAndOrphan

boolean

Liệu có nên tránh các dòng thừa và dòng lẻ cho đoạn văn bản hay không. Nếu không được đặt, giá trị sẽ được kế thừa từ phần tử mẹ.
shading

object (Shading)

Độ đậm nhạt của đoạn văn bản. Nếu không được đặt, giá trị sẽ được kế thừa từ phần tử mẹ.
pageBreakBefore

boolean

Liệu đoạn văn bản hiện tại có phải luôn bắt đầu ở đầu trang hay không. Nếu không được đặt, giá trị sẽ được kế thừa từ phần tử mẹ.

Việc cố gắng cập nhật pageBreakBefore cho các đoạn văn bản ở các khu vực không được hỗ trợ, bao gồm cả Table, Header, Footer và Footnote, có thể dẫn đến trạng thái tài liệu không hợp lệ và trả về lỗi yêu cầu không hợp lệ 400.

NamedStyleType

Các loại kiểu được đặt tên.

Enum
NAMED_STYLE_TYPE_UNSPECIFIED Loại kiểu được đặt tên chưa được xác định.
NORMAL_TEXT Văn bản thông thường.
TITLE Tiêu đề.
SUBTITLE Phụ đề.
HEADING_1 Tiêu đề 1.
HEADING_2 Tiêu đề 2.
HEADING_3 Tiêu đề 3.
HEADING_4 Tiêu đề 4.
HEADING_5 Tiêu đề 5.
HEADING_6 Tiêu đề 6.

Căn chỉnh

Các kiểu 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ừ phần tử mẹ.
START Đoạn vă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, nếu không thì căn trái.
JUSTIFIED Đoạn văn được căn chỉnh.

ContentDirection

Nội dung chỉ dẫn có thể chảy vào.

Enum
CONTENT_DIRECTION_UNSPECIFIED Chưa xác định hướng nội dung.
LEFT_TO_RIGHT Nội dung đi từ trái sang phải.
RIGHT_TO_LEFT Nội dung đ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 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.

ParagraphBorder

Đường viền xung quanh một đoạn văn bản.

Biểu diễn dưới dạng JSON 
{
  "color": {
    object (OptionalColor)
  },
  "width": {
    object (Dimension)
  },
  "padding": {
    object (Dimension)
  },
  "dashStyle": enum (DashStyle)
}
Trường
color

object (OptionalColor)

Màu của đường viền.
width

object (Dimension)

Chiều rộng của đường viền.
padding

object (Dimension)

Khoảng đệm của đường viền.
dashStyle

enum (DashStyle)

Kiểu gạch ngang của đường viền.

DashStyle

Các loại dấu gạch ngang có thể kết xuất hình học tuyến tính. Các giá trị này dựa trên loại đơn giản "ST_PresetLineDashVal" được mô tả trong phần 20.1.10.48 của "Định dạng tệp XML mở rộng – Tài liệu cơ bản và tài liệu tham khảo về ngôn ngữ đánh dấu", phần 1 của phiên bản thứ 4 của ECMA-376.

Enum
DASH_STYLE_UNSPECIFIED Kiểu dấu gạch ngang không xác định.
SOLID Đường liền nét. Tương ứng với giá trị ECMA-376 ST_PresetLineDashVal "solid". Đây là kiểu dấu gạch ngang mặc định.
DOT Đường nét đứt. Tương ứng với giá trị ECMA-376 ST_PresetLineDashVal "dot".
DASH Đường gạch ngang. Tương ứng với giá trị "dấu gạch ngang" của ECMA-376 ST_PresetLineDashVal.

TabStop

Dấu tab trong một đoạn văn.

Biểu diễn dưới dạng JSON 
{
  "offset": {
    object (Dimension)
  },
  "alignment": enum (TabStopAlignment)
}
Trường
offset

object (Dimension)

Khoảng cách giữa thẻ này dừng và lề bắt đầu.
alignment

enum (TabStopAlignment)

Căn chỉnh điểm dừng thẻ này. Nếu bạn không đặt giá trị này, giá trị mặc định sẽ là START.

TabStopAlignment

Cách căn chỉnh dấu ngắt thẻ.

Enum
TAB_STOP_ALIGNMENT_UNSPECIFIED Chưa chỉ định căn chỉnh điểm dừng thẻ.
START Dấu ngắt thẻ được căn chỉnh với đầu dòng. Đây là tuỳ chọn mặc định.
CENTER Dấu ngắt thẻ được căn chỉnh vào chính giữa dòng.
END Dấu ngắt thẻ được căn chỉnh với cuối dòng.

Tô bóng

Tô bóng đoạn văn bản.

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

object (OptionalColor)

Màu nền của phần tô bóng trong đoạn văn này.

SuggestedParagraphStyle

Nội dung thay đổi đề xuất đối với ParagraphStyle.

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

object (ParagraphStyle)

ParagraphStyle chỉ bao gồm các thay đổi được thực hiện trong đề xuất này. Bạn có thể sử dụng hàm này cùng với paragraphStyleSuggestionState để xem những trường nào đã thay đổi và giá trị mới của các trường đó.
paragraphStyleSuggestionState

object (ParagraphStyleSuggestionState)

Một mặt nạ cho biết trường nào trên ParagraphStyle cơ sở đã được thay đổi trong đề xuất này.

ParagraphStyleSuggestionState

Một mặt nạ cho biết trường nào trên ParagraphStyle cơ sở đã được thay đổi trong đề xuất này. Đối với bất kỳ trường nào được đặt thành đúng, sẽ có một giá trị đề xuất mới.

Biểu diễn dưới dạng JSON 
{
  "headingIdSuggested": boolean,
  "namedStyleTypeSuggested": boolean,
  "alignmentSuggested": boolean,
  "lineSpacingSuggested": boolean,
  "directionSuggested": boolean,
  "spacingModeSuggested": boolean,
  "spaceAboveSuggested": boolean,
  "spaceBelowSuggested": boolean,
  "borderBetweenSuggested": boolean,
  "borderTopSuggested": boolean,
  "borderBottomSuggested": boolean,
  "borderLeftSuggested": boolean,
  "borderRightSuggested": boolean,
  "indentFirstLineSuggested": boolean,
  "indentStartSuggested": boolean,
  "indentEndSuggested": boolean,
  "keepLinesTogetherSuggested": boolean,
  "keepWithNextSuggested": boolean,
  "avoidWidowAndOrphanSuggested": boolean,
  "shadingSuggestionState": {
    object (ShadingSuggestionState)
  },
  "pageBreakBeforeSuggested": boolean
}
Trường
headingIdSuggested

boolean

Cho biết liệu có thay đổi nào được đề xuất đối với headingId hay không.
namedStyleTypeSuggested

boolean

Cho biết liệu có thay đổi nào được đề xuất đối với namedStyleType hay không.
alignmentSuggested

boolean

Cho biết liệu có thay đổi nào được đề xuất đối với alignment hay không.
lineSpacingSuggested

boolean

Cho biết liệu có thay đổi nào được đề xuất đối với lineSpacing hay không.
directionSuggested

boolean

Cho biết liệu có thay đổi nào được đề xuất đối với direction hay không.
spacingModeSuggested

boolean

Cho biết liệu có thay đổi nào được đề xuất đối với spacingMode hay không.
spaceAboveSuggested

boolean

Cho biết liệu có thay đổi được đề xuất đối với spaceAbove hay không.
spaceBelowSuggested

boolean

Cho biết liệu có thay đổi nào được đề xuất đối với spaceBelow hay không.
borderBetweenSuggested

boolean

Cho biết liệu có thay đổi nào được đề xuất đối với borderBetween hay không.
borderTopSuggested

boolean

Cho biết liệu có thay đổi nào được đề xuất đối với borderTop hay không.
borderBottomSuggested

boolean

Cho biết liệu có thay đổi được đề xuất đối với borderBottom hay không.
borderLeftSuggested

boolean

Cho biết liệu có thay đổi nào được đề xuất đối với borderLeft hay không.
borderRightSuggested

boolean

Cho biết liệu có thay đổi nào được đề xuất đối với borderRight hay không.
indentFirstLineSuggested

boolean

Cho biết liệu có thay đổi nào được đề xuất đối với indentFirstLine hay không.
indentStartSuggested

boolean

Cho biết liệu có thay đổi nào được đề xuất đối với indentStart hay không.
indentEndSuggested

boolean

Cho biết liệu có thay đổi được đề xuất đối với indentEnd hay không.
keepLinesTogetherSuggested

boolean

Cho biết liệu có thay đổi được đề xuất đối với keepLinesTogether hay không.
keepWithNextSuggested

boolean

Cho biết liệu có thay đổi nào được đề xuất đối với keepWithNext hay không.
avoidWidowAndOrphanSuggested

boolean

Cho biết liệu có thay đổi nào được đề xuất đối với avoidWidowAndOrphan hay không.
shadingSuggestionState

object (ShadingSuggestionState)

Một mặt nạ cho biết trường nào trong shading đã được thay đổi theo đề xuất này.
pageBreakBeforeSuggested

boolean

Cho biết liệu có thay đổi nào được đề xuất đối với pageBreakBefore hay không.

ShadingSuggestionState

Một mặt nạ cho biết trường nào trên Shading cơ sở đã được thay đổi trong thay đổi đề xuất này. Đối với mọi trường được đặt thành đúng, sẽ có một giá trị mới được đề xuất.

Biểu diễn dưới dạng JSON 
{
  "backgroundColorSuggested": boolean
}
Trường
backgroundColorSuggested

boolean

Cho biết liệu có thay đổi nào được đề xuất đối với Shading hay không.

Dấu đầu dòng

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

Biểu diễn dưới dạng JSON 
{
  "listId": string,
  "nestingLevel": integer,
  "textStyle": {
    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.
textStyle

object (TextStyle)

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

SuggestedBullet

Nội dung thay đổi đề xuất đối với Bullet.

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

object (Bullet)

Bullet chỉ bao gồm các thay đổi được thực hiện trong đề xuất này. Bạn có thể sử dụng hàm này cùng với bulletSuggestionState để xem những trường nào đã thay đổi và giá trị mới của các trường đó.
bulletSuggestionState

object (BulletSuggestionState)

Một mặt nạ cho biết trường nào trên Bullet cơ sở đã được thay đổi trong đề xuất này.

BulletSuggestionState

Một mặt nạ cho biết trường nào trên Bullet cơ sở đã được thay đổi trong đề xuất này. Bất kỳ trường nào được đặt thành true sẽ có một giá trị được đề xuất mới.

Biểu diễn dưới dạng JSON 
{
  "listIdSuggested": boolean,
  "nestingLevelSuggested": boolean,
  "textStyleSuggestionState": {
    object (TextStyleSuggestionState)
  }
}
Trường
listIdSuggested

boolean

Cho biết liệu có thay đổi nào được đề xuất đối với listId hay không.
nestingLevelSuggested

boolean

Cho biết liệu có thay đổi nào được đề xuất đối với nestingLevel hay không.
textStyleSuggestionState

object (TextStyleSuggestionState)

Một mặt nạ cho biết trường nào trong text style đã được thay đổi trong đề xuất này.

ObjectReferences

Tập hợp các mã nhận dạng đối tượng.

Biểu diễn dưới dạng JSON 
{
  "objectIds": [
    string
  ]
}
Trường
objectIds[]

string

Mã đối tượng.

SectionBreak

StructuralElement đại diện cho một điểm ngắt mục. Phần là một dải nội dung có cùng SectionStyle. Dấu ngắt mục thể hiện điểm bắt đầu của một mục mới và kiểu mục sẽ áp dụng cho mục sau dấu ngắt mục.

Phần nội dung của tài liệu luôn bắt đầu bằng một dấu ngắt phần.

Biểu diễn dưới dạng JSON 
{
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "sectionStyle": {
    object (SectionStyle)
  }
}
Trường
suggestedInsertionIds[]

string

Mã chèn được đề xuất. Một SectionBreak có thể có nhiều mã chèn nếu đó là một thay đổi đề xuất lồng nhau. Nếu trống thì đây không phải là phần chèn được đề xuất.
suggestedDeletionIds[]

string

Mã nhận dạng được đề xuất xoá. Nếu trống, thì không có nội dung nào được đề xuất xoá.
sectionStyle

object (SectionStyle)

Kiểu của phần sau dấu ngắt phần này.

SectionStyle

Kiểu áp dụng cho một phần.

Biểu diễn dưới dạng JSON 
{
  "columnProperties": [
    {
      object (SectionColumnProperties)
    }
  ],
  "columnSeparatorStyle": enum (ColumnSeparatorStyle),
  "contentDirection": enum (ContentDirection),
  "marginTop": {
    object (Dimension)
  },
  "marginBottom": {
    object (Dimension)
  },
  "marginRight": {
    object (Dimension)
  },
  "marginLeft": {
    object (Dimension)
  },
  "marginHeader": {
    object (Dimension)
  },
  "marginFooter": {
    object (Dimension)
  },
  "sectionType": enum (SectionType),
  "defaultHeaderId": string,
  "defaultFooterId": string,
  "firstPageHeaderId": string,
  "firstPageFooterId": string,
  "evenPageHeaderId": string,
  "evenPageFooterId": string,
  "useFirstPageHeaderFooter": boolean,
  "pageNumberStart": integer,
  "flipPageOrientation": boolean
}
Trường
columnProperties[]

object (SectionColumnProperties)

Thuộc tính cột của mục này.

Nếu trống, phần này sẽ chứa một cột có các thuộc tính mặc định trong Trình chỉnh sửa Tài liệu. Bạn có thể cập nhật một mục để có tối đa 3 cột.

Khi cập nhật thuộc tính này, bạn phải đặt một giá trị cụ thể. Việc huỷ thiết lập thuộc tính này sẽ dẫn đến lỗi yêu cầu không hợp lệ 400.
columnSeparatorStyle

enum (ColumnSeparatorStyle)

Kiểu của dòng phân cách cột.

Bạn có thể đặt kiểu này ngay cả khi có một cột trong phần.

Khi cập nhật thuộc tính này, bạn phải đặt một giá trị cụ thể. Việc huỷ đặt thuộc tính này sẽ dẫn đến lỗi yêu cầu không hợp lệ 400.
contentDirection

enum (ContentDirection)

Hướng nội dung của phần này. Nếu bạn không đặt giá trị này, giá trị mặc định sẽ là LEFT_TO_RIGHT.

Khi cập nhật thuộc tính này, bạn phải đặt một giá trị cụ thể. Việc huỷ đặt thuộc tính này sẽ dẫn đến lỗi yêu cầu không hợp lệ 400.
marginTop

object (Dimension)

Lề trang trên cùng của mục. Nếu bạn không đặt giá trị, giá trị mặc định sẽ là marginTop từ DocumentStyle.

Khi cập nhật thuộc tính này, bạn phải đặt một giá trị cụ thể. Việc huỷ đặt thuộc tính này sẽ dẫn đến lỗi yêu cầu không hợp lệ 400.
marginBottom

object (Dimension)

Lề trang dưới cùng của mục. Nếu bạn không đặt chính sách này, thì giá trị mặc định từ DocumentStyle sẽ là marginBottom.

Khi cập nhật thuộc tính này, bạn phải đặt một giá trị cụ thể. Việc huỷ đặt thuộc tính này sẽ dẫn đến lỗi yêu cầu không hợp lệ 400.
marginRight

object (Dimension)

Lề phải của trang trong mục. Nếu bạn không đặt giá trị, giá trị mặc định sẽ là marginRight từ DocumentStyle. Việc cập nhật lề phải sẽ khiến các cột trong mục này đổi kích thước. Vì lề ảnh hưởng đến chiều rộng cột, nên lề được áp dụng trước các thuộc tính cột.

Khi cập nhật thuộc tính này, bạn phải đặt một giá trị cụ thể. Việc huỷ đặt thuộc tính này sẽ dẫn đến lỗi yêu cầu không hợp lệ 400.
marginLeft

object (Dimension)

Lề trái của trang trong phần. Nếu bạn không đặt giá trị này, giá trị mặc định sẽ là marginLeft từ DocumentStyle. Việc cập nhật lề bên trái sẽ làm thay đổi kích thước của các cột trong phần này. Vì lề ảnh hưởng đến chiều rộng cột, nên lề được áp dụng trước các thuộc tính cột.

Khi cập nhật thuộc tính này, bạn phải đặt một giá trị cụ thể. Việc huỷ đặt thuộc tính này sẽ dẫn đến lỗi yêu cầu không hợp lệ 400.
marginHeader

object (Dimension)

Lề tiêu đề của phần. Nếu bạn không đặt chính sách này, thì giá trị mặc định từ DocumentStyle sẽ là marginHeader. Nếu được cập nhật, useCustomHeaderFooterMargins sẽ được đặt thành true trên DocumentStyle. Giá trị của useCustomHeaderFooterMargins trên DocumentStyle cho biết liệu lề tiêu đề có được tuân thủ cho phần này hay không.

Khi cập nhật thuộc tính này, bạn phải đặt một giá trị cụ thể. Việc huỷ đặt thuộc tính này sẽ dẫn đến lỗi yêu cầu không hợp lệ 400.
sectionType

enum (SectionType)

Chỉ có đầu ra. Loại mục.
defaultHeaderId

string

Mã của tiêu đề mặc định. Nếu bạn không đặt chính sách này, thì giá trị sẽ kế thừa từ SectionStyle SectionBreak's trước đó. Nếu bạn không đặt giá trị trong SectionBreak đầu tiên, thì giá trị đó sẽ kế thừa từ defaultHeaderId của DocumentStyle.

Thuộc tính này chỉ có thể đọc.
firstPageHeaderId

string

Mã nhận dạng của tiêu đề chỉ được dùng cho trang đầu tiên của mục. Nếu useFirstPageHeaderFooter là đúng, giá trị này sẽ được dùng cho tiêu đề trên trang đầu tiên của phần. Nếu giá trị này là false, thì tiêu đề trên trang đầu tiên của phần sẽ sử dụng defaultHeaderId. Nếu bạn không đặt chính sách này, thì giá trị sẽ kế thừa từ SectionStyle SectionBreak's trước đó. Nếu giá trị không được đặt trong SectionBreak đầu tiên, thì giá trị đó sẽ kế thừa từ firstPageHeaderId của DocumentStyle.

Tài sản này đang ở chế độ chỉ có thể đọc.
firstPageFooterId

string

Mã của chân trang chỉ dùng cho trang đầu tiên của phần. Nếu useFirstPageHeaderFooter là true, thì giá trị này sẽ được dùng cho chân trang ở trang đầu tiên của mục này. Nếu giá trị này là false, thì chân trang ở trang đầu tiên của mục này sẽ sử dụng defaultFooterId. Nếu không được đặt, giá trị này sẽ kế thừa từ SectionStyle SectionBreak's trước đó. Nếu bạn không đặt giá trị trong SectionBreak đầu tiên, thì giá trị đó sẽ kế thừa từ firstPageFooterId của DocumentStyle.

Tài sản này đang ở chế độ chỉ có thể đọc.
evenPageHeaderId

string

Mã của tiêu đề chỉ dùng cho các trang chẵn. Nếu giá trị của useEvenPageHeaderFooter của DocumentStyle là true, thì giá trị này sẽ được dùng cho tiêu đề trên các trang chẵn trong mục. Nếu giá trị này là sai, thì tiêu đề trên các trang chẵn sẽ sử dụng defaultHeaderId. Nếu bạn không đặt chính sách này, thì giá trị sẽ kế thừa từ SectionStyle SectionBreak's trước đó. Nếu bạn không đặt giá trị trong SectionBreak đầu tiên, thì giá trị đó sẽ kế thừa từ evenPageHeaderId của DocumentStyle.

Thuộc tính này chỉ có thể đọc.
evenPageFooterId

string

Mã của chân trang chỉ dùng cho các trang chẵn. Nếu giá trị useEvenPageHeaderFooter của DocumentStyle là true, thì giá trị này sẽ được dùng cho chân trang trên các trang chẵn trong phần này. Nếu giá trị này là sai, chân trang trên các trang chẵn sẽ sử dụng defaultFooterId. Nếu không được đặt, giá trị này sẽ kế thừa từ SectionStyle SectionBreak's trước đó. Nếu bạn không đặt giá trị trong SectionBreak đầu tiên, thì giá trị đó sẽ kế thừa từ evenPageFooterId của DocumentStyle.

Thuộc tính này chỉ có thể đọc.
useFirstPageHeaderFooter

boolean

Cho biết liệu có sử dụng mã nhận dạng đầu trang / chân trang cho trang đầu tiên của phần hay không. Nếu không được đặt, thuộc tính này sẽ kế thừa từ useFirstPageHeaderFooter của DocumentStyle cho mục đầu tiên. Nếu bạn không đặt giá trị cho các phân đoạn tiếp theo, thì giá trị này sẽ được diễn giải là sai.

Khi cập nhật thuộc tính này, bạn phải đặt một giá trị cụ thể. Việc huỷ đặt thuộc tính này sẽ dẫn đến lỗi yêu cầu không hợp lệ 400.
pageNumberStart

integer

Số trang bắt đầu đếm số trang cho phần này. Nếu bạn không đặt giá trị, thì việc đánh số trang sẽ tiếp tục từ phần trước. Nếu giá trị không được đặt trong SectionBreak đầu tiên, hãy tham khảo pageNumberStart của DocumentStyle.

Khi cập nhật thuộc tính này, bạn phải đặt một giá trị cụ thể. Việc huỷ đặt thuộc tính này sẽ dẫn đến lỗi yêu cầu không hợp lệ 400.
flipPageOrientation

boolean

Không bắt buộc. Cho biết liệu có lật các kích thước của pageSize của DocumentStyle cho phần này hay không, cho phép thay đổi hướng trang giữa dọc và ngang. Nếu không được đặt, giá trị này sẽ kế thừa từ flipPageOrientation của DocumentStyle.

Khi cập nhật thuộc tính này, bạn phải đặt một giá trị cụ thể. Việc huỷ đặt thuộc tính này sẽ dẫn đến lỗi yêu cầu không hợp lệ 400.

SectionColumnProperties

Các thuộc tính áp dụng cho cột của một mục.

Biểu diễn dưới dạng JSON 
{
  "width": {
    object (Dimension)
  },
  "paddingEnd": {
    object (Dimension)
  }
}
Trường
width

object (Dimension)

Chỉ có đầu ra. Chiều rộng của cột.
paddingEnd

object (Dimension)

Khoảng đệm ở cuối cột.

ColumnSeparatorStyle

Kiểu của dòng phân cách cột giữa các cột.

Enum
COLUMN_SEPARATOR_STYLE_UNSPECIFIED Kiểu dòng phân cách cột không xác định.
NONE Không có dòng phân cách cột giữa các cột.
BETWEEN_EACH_COLUMN Hiển thị dòng phân cách cột giữa mỗi cột.

SectionType

Biểu thị cách vị trí bắt đầu của phần hiện tại so với phần trước.

Enum
SECTION_TYPE_UNSPECIFIED Loại mục chưa được chỉ định.
CONTINUOUS Phần này bắt đầu ngay sau đoạn cuối của phần trước.
NEXT_PAGE Mục này bắt đầu trên trang tiếp theo.

Bảng

StructuralElement đại diện cho một bảng.

Biểu diễn dưới dạng JSON 
{
  "rows": integer,
  "columns": integer,
  "tableRows": [
    {
      object (TableRow)
    }
  ],
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "tableStyle": {
    object (TableStyle)
  }
}
Trường
rows

integer

Số hàng trong bảng.
columns

integer

Số cột trong bảng.

Một bảng có thể không phải là hình chữ nhật, nên một số hàng có thể có số lượng ô khác.
tableRows[]

object (TableRow)

Nội dung và kiểu của mỗi hàng.
suggestedInsertionIds[]

string

Các mã chèn đề xuất. Một Table có thể có nhiều mã chèn nếu đó là một thay đổi đề xuất lồng nhau. Nếu trống, thì đây không phải là nội dung chèn được đề xuất.
suggestedDeletionIds[]

string

Mã nhận dạng được đề xuất xoá. Nếu trống, thì không có đề xuất xoá nội dung này.
tableStyle

object (TableStyle)

Kiểu của bảng.

TableRow

Nội dung và kiểu của một hàng trong Table.

Biểu diễn dưới dạng JSON 
{
  "startIndex": integer,
  "endIndex": integer,
  "tableCells": [
    {
      object (TableCell)
    }
  ],
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "tableRowStyle": {
    object (TableRowStyle)
  },
  "suggestedTableRowStyleChanges": {
    string: {
      object (SuggestedTableRowStyle)
    },
    ...
  }
}
Trường
startIndex

integer

Chỉ mục bắt đầu dựa trên 0 của hàng này, tính theo đơn vị mã UTF-16.
endIndex

integer

Chỉ mục kết thúc dựa trên số 0 của hàng này, không bao gồm, trong các đơn vị mã UTF-16.
tableCells[]

object (TableCell)

Nội dung và kiểu của từng ô trong hàng này.

Bảng có thể không phải hình chữ nhật, vì vậy, một số hàng có thể có số ô khác với các hàng khác trong cùng một bảng.
suggestedInsertionIds[]

string

Mã chèn được đề xuất. TableRow có thể có nhiều mã chèn nếu đó là một thay đổi được đề xuất lồng nhau. Nếu trống, thì đây không phải là nội dung chèn được đề xuất.
suggestedDeletionIds[]

string

Mã xoá được đề xuất. Nếu trống, thì không có nội dung nào được đề xuất xoá.
tableRowStyle

object (TableRowStyle)

Kiểu của hàng trong bảng.
suggestedTableRowStyleChanges

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

Kiểu được đề xuất cho hàng này, được khoá bởi mã đề xuất.

TableCell

Nội dung và kiểu của một ô trong Table.

Biểu diễn dưới dạng JSON 
{
  "startIndex": integer,
  "endIndex": integer,
  "content": [
    {
      object (StructuralElement)
    }
  ],
  "tableCellStyle": {
    object (TableCellStyle)
  },
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "suggestedTableCellStyleChanges": {
    string: {
      object (SuggestedTableCellStyle)
    },
    ...
  }
}
Trường
startIndex

integer

Chỉ mục bắt đầu dựa trên 0 của ô này, tính theo đơn vị mã UTF-16.
endIndex

integer

Chỉ mục kết thúc dựa trên số 0 của ô này, không bao gồm, trong các đơn vị mã UTF-16.
content[]

object (StructuralElement)

Nội dung của ô.
tableCellStyle

object (TableCellStyle)

Kiểu của ô.
suggestedInsertionIds[]

string

Mã chèn được đề xuất. TableCell có thể có nhiều mã chèn nếu đó là một thay đổi được đề xuất lồng nhau. Nếu trống, thì đây không phải là nội dung chèn được đề xuất.
suggestedDeletionIds[]

string

Mã xoá được đề xuất. Nếu trống, thì không có nội dung nào được đề xuất xoá.
suggestedTableCellStyleChanges

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

Các thay đổi được đề xuất đối với kiểu ô trong bảng, được khoá bằng mã đề xuất.

TableCellStyle

Kiểu của TableCell.

Kiểu ô bảng 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. Kiểu ô trong bảng có thể kế thừa từ kiểu của bảng.

Biểu diễn dưới dạng JSON 
{
  "rowSpan": integer,
  "columnSpan": integer,
  "backgroundColor": {
    object (OptionalColor)
  },
  "borderLeft": {
    object (TableCellBorder)
  },
  "borderRight": {
    object (TableCellBorder)
  },
  "borderTop": {
    object (TableCellBorder)
  },
  "borderBottom": {
    object (TableCellBorder)
  },
  "paddingLeft": {
    object (Dimension)
  },
  "paddingRight": {
    object (Dimension)
  },
  "paddingTop": {
    object (Dimension)
  },
  "paddingBottom": {
    object (Dimension)
  },
  "contentAlignment": enum (ContentAlignment)
}
Trường
rowSpan

integer

Phạm vi hàng của ô.

Tài sản này đang ở chế độ chỉ có thể đọc.
columnSpan

integer

Chiều rộng cột của ô.

Thuộc tính này chỉ có thể đọc.
backgroundColor

object (OptionalColor)

Màu nền của ô.
borderLeft

object (TableCellBorder)

Đường viền trái của ô.
borderRight

object (TableCellBorder)

Đường viền phải của ô.
borderTop

object (TableCellBorder)

Đường viền trên của ô.
borderBottom

object (TableCellBorder)

Đường viền dưới của ô.
paddingLeft

object (Dimension)

Khoảng đệm bên trái của ô.
paddingRight

object (Dimension)

Khoảng đệm bên phải của ô.
paddingTop

object (Dimension)

Khoảng đệm trên cùng của ô.
paddingBottom

object (Dimension)

Khoảng đệm dưới cùng của ô.
contentAlignment

enum (ContentAlignment)

Cách căn chỉnh nội dung trong ô bảng. Căn chỉnh mặc định khớp với căn chỉnh cho các ô bảng mới tạo trong trình chỉnh sửa Tài liệu.

TableCellBorder

Đường viền xung quanh một ô trong bảng.

Đường viền ô trong bảng không được trong suốt. Để ẩn đường viền ô trong bảng, hãy đặt chiều rộng của ô đó thành 0.

Biểu diễn dưới dạng JSON 
{
  "color": {
    object (OptionalColor)
  },
  "width": {
    object (Dimension)
  },
  "dashStyle": enum (DashStyle)
}
Trường
color

object (OptionalColor)

Màu của đường viền.

Màu này không được trong suốt.
width

object (Dimension)

Chiều rộng của đường viền.
dashStyle

enum (DashStyle)

Kiểu nét đứt của đường viền.

ContentAlignment

Các kiểu căn chỉnh nội dung.

Phát sinh từ một tập hợp con các giá trị của loại đơn giản "ST_TextAnchoringType" trong phần 20.1.10.59 của "Office Open XML File Formats – Fundamentals and Markup Language Reference" (Định dạng tệp Office Open XML – Kiến thức cơ bản và tài liệu tham khảo về ngôn ngữ đánh dấu), phần 1 của ECMA-376 phiên bản 4.

Enum
CONTENT_ALIGNMENT_UNSPECIFIED Cách căn chỉnh nội dung không xác định. Cách căn chỉnh nội dung được kế thừa từ thành phần mẹ nếu có.
CONTENT_ALIGNMENT_UNSUPPORTED Cách căn chỉnh nội dung không được hỗ trợ.
TOP Cách căn chỉnh nội dung với phần đầu của phần giữ nội dung. Tương ứng với ECMA-376 ST_TextAnchoringType 't'.
MIDDLE Cách căn chỉnh nội dung vào giữa phần giữ nội dung. Tương ứng với ECMA-376 ST_TextAnchoringType "ctr".
BOTTOM Cách căn chỉnh nội dung với phần dưới cùng của phần giữ nội dung. Tương ứng với ECMA-376 ST_TextAnchoringType "b".

SuggestedTableCellStyle

Đã đề xuất thay đổi đối với TableCellStyle.

Biểu diễn dưới dạng JSON 
{
  "tableCellStyle": {
    object (TableCellStyle)
  },
  "tableCellStyleSuggestionState": {
    object (TableCellStyleSuggestionState)
  }
}
Trường
tableCellStyle

object (TableCellStyle)

TableCellStyle chỉ bao gồm các thay đổi được thực hiện trong đề xuất này. Bạn có thể sử dụng hàm này cùng với tableCellStyleSuggestionState để xem những trường nào đã thay đổi và giá trị mới của các trường đó.
tableCellStyleSuggestionState

object (TableCellStyleSuggestionState)

Một mặt nạ cho biết trường nào trên TableCellStyle cơ sở đã được thay đổi trong đề xuất này.

TableCellStyleSuggestionState

Một mặt nạ cho biết trường nào trên TableCellStyle cơ sở đã được thay đổi trong đề xuất này. Đối với mọi trường được đặt thành đúng, sẽ có một giá trị đề xuất mới.

Biểu diễn dưới dạng JSON 
{
  "rowSpanSuggested": boolean,
  "columnSpanSuggested": boolean,
  "backgroundColorSuggested": boolean,
  "borderLeftSuggested": boolean,
  "borderRightSuggested": boolean,
  "borderTopSuggested": boolean,
  "borderBottomSuggested": boolean,
  "paddingLeftSuggested": boolean,
  "paddingRightSuggested": boolean,
  "paddingTopSuggested": boolean,
  "paddingBottomSuggested": boolean,
  "contentAlignmentSuggested": boolean
}
Trường
rowSpanSuggested

boolean

Cho biết liệu có thay đổi được đề xuất đối với rowSpan hay không.
columnSpanSuggested

boolean

Cho biết liệu có thay đổi nào được đề xuất đối với columnSpan hay không.
backgroundColorSuggested

boolean

Cho biết liệu có thay đổi nào được đề xuất đối với backgroundColor hay không.
borderLeftSuggested

boolean

Cho biết liệu có thay đổi được đề xuất đối với borderLeft hay không.
borderRightSuggested

boolean

Cho biết liệu có thay đổi nào được đề xuất đối với borderRight hay không.
borderTopSuggested

boolean

Cho biết liệu có thay đổi nào được đề xuất đối với borderTop hay không.
borderBottomSuggested

boolean

Cho biết liệu có thay đổi nào được đề xuất đối với borderBottom hay không.
paddingLeftSuggested

boolean

Cho biết liệu có thay đổi nào được đề xuất đối với paddingLeft hay không.
paddingRightSuggested

boolean

Cho biết liệu có thay đổi nào được đề xuất đối với paddingRight hay không.
paddingTopSuggested

boolean

Cho biết liệu có thay đổi nào được đề xuất đối với paddingTop hay không.
paddingBottomSuggested

boolean

Cho biết liệu có thay đổi nào được đề xuất đối với paddingBottom hay không.
contentAlignmentSuggested

boolean

Cho biết liệu có thay đổi nào được đề xuất đối với contentAlignment hay không.

TableRowStyle

Kiểu áp dụng cho một hàng trong bảng.

Biểu diễn dưới dạng JSON 
{
  "minRowHeight": {
    object (Dimension)
  },
  "tableHeader": boolean,
  "preventOverflow": boolean
}
Trường
minRowHeight

object (Dimension)

Chiều cao tối thiểu của hàng. Hàng sẽ được hiển thị trong trình chỉnh sửa Tài liệu ở chiều cao bằng hoặc lớn hơn giá trị này để hiển thị tất cả nội dung trong các ô của hàng.
tableHeader

boolean

Liệu hàng đó có phải là tiêu đề bảng hay không.
preventOverflow

boolean

Liệu hàng có thể tràn sang ranh giới trang hoặc cột hay không.

SuggestedTableRowStyle

Đã đề xuất thay đổi đối với TableRowStyle.

Biểu diễn dưới dạng JSON 
{
  "tableRowStyle": {
    object (TableRowStyle)
  },
  "tableRowStyleSuggestionState": {
    object (TableRowStyleSuggestionState)
  }
}
Trường
tableRowStyle

object (TableRowStyle)

TableRowStyle chỉ bao gồm các thay đổi được thực hiện trong đề xuất này. Bạn có thể sử dụng hàm này cùng với tableRowStyleSuggestionState để xem những trường nào đã thay đổi và giá trị mới của các trường đó.
tableRowStyleSuggestionState

object (TableRowStyleSuggestionState)

Một mặt nạ cho biết trường nào trên TableRowStyle cơ sở đã được thay đổi trong đề xuất này.

TableRowStyleSuggestionState

Một mặt nạ cho biết trường nào trên TableRowStyle cơ sở đã được thay đổi trong đề xuất này. Bất kỳ trường nào được đặt thành true sẽ có một giá trị được đề xuất mới.

Biểu diễn dưới dạng JSON 
{
  "minRowHeightSuggested": boolean
}
Trường
minRowHeightSuggested

boolean

Cho biết liệu có thay đổi nào được đề xuất đối với minRowHeight hay không.

TableStyle

Kiểu áp dụng cho bảng.

Biểu diễn dưới dạng JSON 
{
  "tableColumnProperties": [
    {
      object (TableColumnProperties)
    }
  ]
}
Trường
tableColumnProperties[]

object (TableColumnProperties)

Các thuộc tính của mỗi cột.

Xin lưu ý rằng trong Tài liệu, bảng chứa các hàng và hàng chứa các ô, tương tự như HTML. Vì vậy, bạn có thể tìm thấy các thuộc tính của một hàng trên tableRowStyle của hàng đó.

TableColumnProperties

Thuộc tính của cột trong bảng.

Biểu diễn dưới dạng JSON 
{
  "widthType": enum (WidthType),
  "width": {
    object (Dimension)
  }
}
Trường
widthType

enum (WidthType)

Loại chiều rộng của cột.
width

object (Dimension)

Chiều rộng của cột. Đặt khi widthType của cột là FIXED_WIDTH.

WidthType

Loại chiều rộng của cột.

Enum
WIDTH_TYPE_UNSPECIFIED Loại chiều rộng cột chưa được chỉ định.
EVENLY_DISTRIBUTED

Chiều rộng cột được phân bổ đồng đều cho các cột khác được phân bổ đồng đều.

Chiều rộng của cột được xác định tự động và sẽ có một phần chiều rộng bằng nhau còn lại cho bảng sau khi tính đến tất cả các cột có chiều rộng được chỉ định.
FIXED_WIDTH Chiều rộng cột cố định. Thuộc tính [width][google.apps.docs.v1.TableColumnProperties.width] chứa chiều rộng của cột.

TableOfContents

StructuralElement đại diện cho mục lục.

Biểu diễn dưới dạng JSON 
{
  "content": [
    {
      object (StructuralElement)
    }
  ],
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ]
}
Trường
content[]

object (StructuralElement)

Nội dung của mục lục.
suggestedInsertionIds[]

string

Các mã chèn đề xuất. TableOfContents có thể có nhiều mã chèn nếu đó là một thay đổi đề xuất được lồng. Nếu trống, thì đây không phải là nội dung chèn được đề xuất.
suggestedDeletionIds[]

string

Mã nhận dạng được đề xuất xoá. Nếu trống, thì không có nội dung nào được đề xuất xoá.

Chú thích cuối trang

Chú thích cuối trang của tài liệu.

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

string

Mã của chú thích cuối trang.
content[]

object (StructuralElement)

Nội dung của chú thích cuối trang.

Chỉ mục cho nội dung của chú thích bắt đầu từ 0.

DocumentStyle

Kiểu của tài liệu.

Biểu diễn dưới dạng JSON 
{
  "background": {
    object (Background)
  },
  "defaultHeaderId": string,
  "defaultFooterId": string,
  "evenPageHeaderId": string,
  "evenPageFooterId": string,
  "firstPageHeaderId": string,
  "firstPageFooterId": string,
  "useFirstPageHeaderFooter": boolean,
  "useEvenPageHeaderFooter": boolean,
  "pageNumberStart": integer,
  "marginTop": {
    object (Dimension)
  },
  "marginBottom": {
    object (Dimension)
  },
  "marginRight": {
    object (Dimension)
  },
  "marginLeft": {
    object (Dimension)
  },
  "pageSize": {
    object (Size)
  },
  "marginHeader": {
    object (Dimension)
  },
  "marginFooter": {
    object (Dimension)
  },
  "useCustomHeaderFooterMargins": boolean,
  "flipPageOrientation": boolean
}
Trường
background

object (Background)

Nền của tài liệu. Tài liệu không được có màu nền trong suốt.
defaultHeaderId

string

Mã của tiêu đề mặc định. Nếu không được đặt, sẽ không có tiêu đề mặc định.

Thuộc tính này chỉ có thể đọc.
evenPageHeaderId

string

Mã của tiêu đề chỉ được dùng cho các trang chẵn. Giá trị của useEvenPageHeaderFooter xác định việc sử dụng defaultHeaderId hay giá trị này cho tiêu đề trên các trang chẵn. Nếu không được đặt, thì sẽ không có tiêu đề trang chẵn.

Thuộc tính này chỉ có thể đọc.
evenPageFooterId

string

Mã của chân trang chỉ dùng cho các trang chẵn. Giá trị của useEvenPageHeaderFooter xác định việc sử dụng defaultFooterId hay giá trị này cho chân trang trên các trang chẵn. Nếu bạn không đặt, thì sẽ không có chân trang của trang chẵn.

Thuộc tính này chỉ có thể đọc.
firstPageHeaderId

string

Mã của tiêu đề chỉ được dùng cho trang đầu tiên. Nếu bạn không đặt, thì tiêu đề duy nhất cho trang đầu tiên sẽ không tồn tại. Giá trị của useFirstPageHeaderFooter xác định việc sử dụng defaultHeaderId hay giá trị này cho tiêu đề trên trang đầu. Nếu bạn không đặt, thì sẽ không có tiêu đề trang đầu tiên.

Thuộc tính này chỉ có thể đọc.
firstPageFooterId

string

Mã của chân trang chỉ được dùng cho trang đầu tiên. Nếu bạn không đặt thuộc tính này, thì sẽ không có chân trang riêng biệt cho trang đầu tiên. Giá trị của useFirstPageHeaderFooter xác định việc sử dụng defaultFooterId hay giá trị này cho chân trang trên trang đầu tiên. Nếu bạn không đặt, thì sẽ không có chân trang của trang đầu tiên.

Tài sản này đang ở chế độ chỉ có thể đọc.
useFirstPageHeaderFooter

boolean

Cho biết liệu có sử dụng mã nhận dạng đầu trang / chân trang của trang đầu tiên cho trang đầu tiên hay không.
useEvenPageHeaderFooter

boolean

Cho biết có sử dụng mã nhận dạng đầu trang / chân trang của trang chẵn cho các trang chẵn hay không.
pageNumberStart

integer

Số trang bắt đầu đếm số trang.
marginTop

object (Dimension)

Lề trên cùng của trang.

Việc cập nhật lề trên cùng của trang trên kiểu tài liệu sẽ xoá lề trên cùng của trang trên tất cả kiểu mục.
marginBottom

object (Dimension)

Lề dưới cùng của trang.

Việc cập nhật lề trang dưới cùng trên kiểu tài liệu sẽ xoá lề trang dưới cùng trên tất cả kiểu mục.
marginRight

object (Dimension)

Lề phải của trang.

Cập nhật lề trang phải trên kiểu tài liệu sẽ xóa lề trang phải trên tất cả các kiểu mục. Điều này cũng có thể khiến các cột thay đổi kích thước trong tất cả các phần.
marginLeft

object (Dimension)

Lề trái của trang.

Việc cập nhật lề trang bên trái trên kiểu tài liệu sẽ xoá lề trang bên trái trên tất cả kiểu mục. Điều này cũng có thể khiến các cột đổi kích thước trong tất cả các phần.
pageSize

object (Size)

Kích thước của một trang trong tài liệu.
marginHeader

object (Dimension)

Khoảng cách giữa đầu trang và nội dung của tiêu đề.
flipPageOrientation

boolean

Không bắt buộc. Cho biết liệu có lật kích thước của pageSize hay không, cho phép thay đổi hướng trang giữa dọc và ngang.

Thông tin khái quát

Đại diện cho nền của một tài liệu.

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

object (OptionalColor)

Màu nền.

Kích thước

Chiều rộng và chiều cao.

Biểu diễn dưới dạng JSON 
{
  "height": {
    object (Dimension)
  },
  "width": {
    object (Dimension)
  }
}
Trường
height

object (Dimension)

Chiều cao của đối tượng.
width

object (Dimension)

Chiều rộng của đối tượng.

SuggestedDocumentStyle

Nội dung thay đổi đề xuất cho DocumentStyle.

Biểu diễn dưới dạng JSON 
{
  "documentStyle": {
    object (DocumentStyle)
  },
  "documentStyleSuggestionState": {
    object (DocumentStyleSuggestionState)
  }
}
Trường
documentStyle

object (DocumentStyle)

DocumentStyle chỉ bao gồm các thay đổi được thực hiện trong đề xuất này. Bạn có thể sử dụng hàm này cùng với documentStyleSuggestionState để xem những trường nào đã thay đổi và giá trị mới của các trường đó.
documentStyleSuggestionState

object (DocumentStyleSuggestionState)

Một mặt nạ cho biết trường nào trên DocumentStyle cơ sở đã được thay đổi trong đề xuất này.

DocumentStyleSuggestionState

Một mặt nạ cho biết trường nào trên DocumentStyle cơ sở đã được thay đổi trong đề xuất này. Đối với mọi trường được đặt thành đúng, sẽ có một giá trị đề xuất mới.

Biểu diễn dưới dạng JSON 
{
  "backgroundSuggestionState": {
    object (BackgroundSuggestionState)
  },
  "defaultHeaderIdSuggested": boolean,
  "defaultFooterIdSuggested": boolean,
  "evenPageHeaderIdSuggested": boolean,
  "evenPageFooterIdSuggested": boolean,
  "firstPageHeaderIdSuggested": boolean,
  "firstPageFooterIdSuggested": boolean,
  "useFirstPageHeaderFooterSuggested": boolean,
  "useEvenPageHeaderFooterSuggested": boolean,
  "pageNumberStartSuggested": boolean,
  "marginTopSuggested": boolean,
  "marginBottomSuggested": boolean,
  "marginRightSuggested": boolean,
  "marginLeftSuggested": boolean,
  "pageSizeSuggestionState": {
    object (SizeSuggestionState)
  },
  "marginHeaderSuggested": boolean,
  "marginFooterSuggested": boolean,
  "useCustomHeaderFooterMarginsSuggested": boolean,
  "flipPageOrientationSuggested": boolean
}
Trường
backgroundSuggestionState

object (BackgroundSuggestionState)

Một mặt nạ cho biết trường nào trong background đã được thay đổi trong đề xuất này.
defaultHeaderIdSuggested

boolean

Cho biết liệu có thay đổi nào được đề xuất đối với defaultHeaderId hay không.
evenPageHeaderIdSuggested

boolean

Cho biết liệu có thay đổi nào được đề xuất đối với evenPageHeaderId hay không.
evenPageFooterIdSuggested

boolean

Cho biết liệu có thay đổi nào được đề xuất đối với evenPageFooterId hay không.
firstPageHeaderIdSuggested

boolean

Cho biết liệu có thay đổi nào được đề xuất đối với firstPageHeaderId hay không.
firstPageFooterIdSuggested

boolean

Cho biết liệu có thay đổi nào được đề xuất đối với firstPageFooterId hay không.
useFirstPageHeaderFooterSuggested

boolean

Cho biết liệu có thay đổi được đề xuất đối với useFirstPageHeaderFooter hay không.
useEvenPageHeaderFooterSuggested

boolean

Cho biết liệu có thay đổi nào được đề xuất đối với useEvenPageHeaderFooter hay không.
pageNumberStartSuggested

boolean

Cho biết liệu có thay đổi nào được đề xuất đối với pageNumberStart hay không.
marginTopSuggested

boolean

Cho biết liệu có thay đổi nào được đề xuất đối với marginTop hay không.
marginBottomSuggested

boolean

Cho biết liệu có thay đổi nào được đề xuất đối với marginBottom hay không.
marginRightSuggested

boolean

Cho biết liệu có thay đổi nào được đề xuất đối với marginRight hay không.
marginLeftSuggested

boolean

Cho biết liệu có thay đổi nào được đề xuất đối với marginLeft hay không.
pageSizeSuggestionState

object (SizeSuggestionState)

Một mặt nạ cho biết trường nào trong [size] [google.apps.docs.v1.DocumentStyle.size] đã được thay đổi trong đề xuất này.
marginHeaderSuggested

boolean

Cho biết liệu có thay đổi nào được đề xuất đối với marginHeader hay không.
flipPageOrientationSuggested

boolean

Không bắt buộc. Cho biết liệu có thay đổi nào được đề xuất đối với flipPageOrientation hay không.

BackgroundSuggestionState

Một mặt nạ cho biết trường nào trên Background cơ sở đã được thay đổi trong đề xuất này. Đối với mọi trường được đặt thành true, Backgound sẽ có một giá trị đề xuất mới.

Biểu diễn dưới dạng JSON 
{
  "backgroundColorSuggested": boolean
}
Trường
backgroundColorSuggested

boolean

Cho biết liệu màu nền hiện tại có được sửa đổi trong đề xuất này hay không.

SizeSuggestionState

Một mặt nạ cho biết trường nào trên Size cơ sở đã được thay đổi trong đề xuất này. Đối với bất kỳ trường nào được đặt thành true, Size sẽ có một giá trị đề xuất mới.

Biểu diễn dưới dạng JSON 
{
  "heightSuggested": boolean,
  "widthSuggested": boolean
}
Trường
heightSuggested

boolean

Cho biết liệu có thay đổi nào được đề xuất đối với height hay không.
widthSuggested

boolean

Cho biết liệu có thay đổi nào được đề xuất đối với width hay không.

NamedStyles

Các kiểu được đặt tên. Các đoạn văn trong tài liệu có thể kế thừa TextStyle và ParagraphStyle từ các kiểu được đặt tên này.

Biểu diễn dưới dạng JSON 
{
  "styles": [
    {
      object (NamedStyle)
    }
  ]
}
Trường
styles[]

object (NamedStyle)

Các kiểu được đặt tên.

Có một mục nhập cho mỗi named style types có thể có.

NamedStyle

Kiểu được đặt tên. Các đoạn văn trong tài liệu có thể kế thừa TextStyle và ParagraphStyle từ kiểu có tên này khi chúng có cùng loại kiểu có tên.

Biểu diễn dưới dạng JSON 
{
  "namedStyleType": enum (NamedStyleType),
  "textStyle": {
    object (TextStyle)
  },
  "paragraphStyle": {
    object (ParagraphStyle)
  }
}
Trường
namedStyleType

enum (NamedStyleType)

Loại của kiểu được đặt tên này.
textStyle

object (TextStyle)

Kiểu văn bản của kiểu được đặt tên này.
paragraphStyle

object (ParagraphStyle)

Kiểu đoạn văn của kiểu được đặt tên này.

SuggestedNamedStyles

Nội dung thay đổi đề xuất cho NamedStyles.

Biểu diễn dưới dạng JSON 
{
  "namedStyles": {
    object (NamedStyles)
  },
  "namedStylesSuggestionState": {
    object (NamedStylesSuggestionState)
  }
}
Trường
namedStyles

object (NamedStyles)

NamedStyles chỉ bao gồm các thay đổi được thực hiện trong đề xuất này. Bạn có thể sử dụng hàm này cùng với namedStylesSuggestionState để xem những trường nào đã thay đổi và giá trị mới của các trường đó.
namedStylesSuggestionState

object (NamedStylesSuggestionState)

Một mặt nạ cho biết trường nào trên NamedStyles cơ sở đã được thay đổi trong đề xuất này.

NamedStylesSuggestionState

Trạng thái đề xuất của thông báo NamedStyles.

Biểu diễn dưới dạng JSON 
{
  "stylesSuggestionStates": [
    {
      object (NamedStyleSuggestionState)
    }
  ]
}
Trường
stylesSuggestionStates[]

object (NamedStyleSuggestionState)

Một mặt nạ cho biết trường nào trên NamedStyle tương ứng trong styles đã được thay đổi trong đề xuất này.

Thứ tự của các trạng thái đề xuất kiểu có tên này khớp với thứ tự của kiểu có tên tương ứng trong đề xuất named styles.

NamedStyleSuggestionState

Trạng thái đề xuất của thông báo NamedStyle.

Biểu diễn dưới dạng JSON 
{
  "namedStyleType": enum (NamedStyleType),
  "textStyleSuggestionState": {
    object (TextStyleSuggestionState)
  },
  "paragraphStyleSuggestionState": {
    object (ParagraphStyleSuggestionState)
  }
}
Trường
namedStyleType

enum (NamedStyleType)

Loại kiểu được đặt tên tương ứng với trạng thái đề xuất này.

Trường này được cung cấp để thuận tiện cho việc so khớp NamedStylesuggestedionState với NamedStyle tương ứng.
textStyleSuggestionState

object (TextStyleSuggestionState)

Một mặt nạ cho biết trường nào trong text style đã được thay đổi theo đề xuất này.
paragraphStyleSuggestionState

object (ParagraphStyleSuggestionState)

Một mặt nạ cho biết trường nào trong paragraph style đã được thay đổi trong đề xuất này.

Danh sách

Danh sách (List) đại diện cho các thuộc tính danh sách cho một nhóm các đoạn văn bản đều thuộc cùng một danh sách. Một đoạn thuộc danh sách có tham chiếu đến mã nhận dạng của danh sách trong bullet.

Biểu diễn dưới dạng JSON 
{
  "listProperties": {
    object (ListProperties)
  },
  "suggestedListPropertiesChanges": {
    string: {
      object (SuggestedListProperties)
    },
    ...
  },
  "suggestedInsertionId": string,
  "suggestedDeletionIds": [
    string
  ]
}
Trường
listProperties

object (ListProperties)

Các thuộc tính của danh sách.
suggestedListPropertiesChanges

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

Các thay đổi được đề xuất đối với thuộc tính danh sách, được khoá theo mã đề xuất.
suggestedInsertionId

string

Mã chèn được đề xuất. Nếu trống, thì đây không phải là nội dung chèn được đề xuất.
suggestedDeletionIds[]

string

Mã nhận dạng được đề xuất xoá. Nếu trống, thì không có đề xuất xoá danh sách này.

ListProperties

Các thuộc tính của list mô tả giao diện của dấu đầu dòng thuộc các đoạn văn bản liên kết với một danh sách.

Biểu diễn dưới dạng JSON 
{
  "nestingLevels": [
    {
      object (NestingLevel)
    }
  ]
}
Trường
nestingLevels[]

object (NestingLevel)

Mô tả các đặc điểm của dấu đầu dòng ở cấp tương ứng.

Một danh sách có tối đa 9 cấp độ lồng nhau, trong đó cấp độ lồng nhau 0 tương ứng với cấp cao nhất và cấp độ lồng nhau 8 tương ứng với cấp lồng nhau nhất. Các mức lồng nhau được trả về theo thứ tự tăng dần với mức lồng ghép ít nhất được trả về trước.

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 
{
  "bulletAlignment": enum (BulletAlignment),
  "glyphFormat": string,
  "indentFirstLine": {
    object (Dimension)
  },
  "indentStart": {
    object (Dimension)
  },
  "textStyle": {
    object (TextStyle)
  },
  "startNumber": integer,

  // Union field glyph_kind can be only one of the following:
  "glyphType": enum (GlyphType),
  "glyphSymbol": string
  // End of list of possible types for union field glyph_kind.
}
Trường
bulletAlignment

enum (BulletAlignment)

Cách căn chỉnh dấu đầu dòng trong không gian được phân bổ để hiển thị dấu đầu dòng.
glyphFormat

string

Chuỗi định dạng mà dấu đầu dòng sử dụng ở cấp độ lồng này.

Định dạng ký tự chứa một hoặc nhiều phần giữ chỗ và các phần giữ chỗ này được thay thế bằng các giá trị thích hợp tuỳ thuộc vào glyphType hoặc glyphSymbol. Phần giữ chỗ tuân theo mẫu %[nestingLevel]. Hơn nữa, phần giữ chỗ có thể có tiền tố và hậu tố. Do đó, định dạng ký tự tuân theo mẫu <prefix>%[nestingLevel]<suffix>. Xin lưu ý rằng tiền tố và hậu tố là không bắt buộc và có thể là chuỗi tuỳ ý.

Ví dụ: định dạng ký tự %0. cho biết ký tự được kết xuất sẽ thay thế phần giữ chỗ bằng ký tự tương ứng cho cấp lồng 0, theo sau là dấu chấm làm hậu tố. Vì vậy, một danh sách có loại ký tự là UPPER_ALPHA và định dạng ký tự là %0. ở cấp lồng 0 sẽ dẫn đến một danh sách có các ký tự được kết xuất

A.

B.

C.

Định dạng ký tự có thể chứa phần giữ chỗ cho cấp lồng hiện tại cũng như phần giữ chỗ cho các cấp lồng mẹ. Ví dụ: một danh sách có thể có định dạng ký tự là %0. ở cấp lồng 0 và định dạng ký tự là %0.%1. ở cấp lồng 1. Giả sử cả hai cấp lồng nhau đều có các loại ký tự DECIMAL, thì điều này sẽ dẫn đến một danh sách có các ký tự được kết xuất

1.

2.

2.1.

2.2.

3.

Đối với các cấp độ lồng được sắp xếp, chuỗi thay thế phần giữ chỗ ở định dạng ký tự cho một đoạn cụ thể phụ thuộc vào thứ tự của đoạn trong danh sách.
indentFirstLine

object (Dimension)

Khoảng thụt lề cho dòng đầu tiên của các đoạn ở cấp độ lồng này.
indentStart

object (Dimension)

Khoảng thụt lề cho các đoạn văn bản ở cấp độ lồng này. Áp dụng cho bên tương ứng với phần đầu văn bản, dựa trên hướng nội dung của đoạn.
textStyle

object (TextStyle)

Kiểu văn bản của dấu đầu dòng ở cấp lồng này.
startNumber

integer

Số của mục danh sách đầu tiên ở cấp lồng này.

Giá trị 0 được coi là giá trị 1 đối với danh sách chữ cái và danh sách chữ số La Mã. Đối với giá trị của cả 0 và 1, danh sách chữ cái và chữ số La Mã sẽ bắt đầu lần lượt tại a và i.

Giá trị này bị bỏ qua đối với các cấp độ lồng nhau có ký tự không theo thứ tự.
Trường hợp hợp nhất glyph_kind. Loại ký tự mà dấu đầu dòng sử dụng. Thao tác này xác định ký tự dấu đầu dòng thay thế phần giữ chỗ trong glyph_format. glyph_kind chỉ có thể là một trong những giá trị sau:
glyphType

enum (GlyphType)

Loại ký tự được sử dụng bởi dấu đầu dòng khi các đoạn văn ở cấp độ lồng nhau này được sắp xếp theo thứ tự.

Loại ký tự xác định loại ký tự dùng để thay thế phần giữ chỗ trong glyphFormat khi các đoạn văn ở cấp độ lồng này được sắp xếp. Ví dụ: nếu cấp độ lồng là 0, glyphFormat là %0. và loại ký tự là DECIMAL, thì ký tự được kết xuất sẽ thay thế phần giữ chỗ %0 ở định dạng ký tự bằng một số tương ứng với thứ tự của mục danh sách trong danh sách.
glyphSymbol

string

Biểu tượng ký tự tuỳ chỉnh được dấu đầu dòng sử dụng khi các đoạn văn ở cấp độ lồng này không theo thứ tự.

Ký hiệu glyph thay thế phần giữ chỗ trong glyphFormat. Ví dụ: nếu glyphSymbol là vòng tròn đặc tương ứng với điểm mã Unicode U+25cf và glyphFormat là %0, thì ký tự được kết xuất sẽ là vòng tròn đặc.

BulletAlignment

Các kiểu căn chỉnh cho dấu đầu dòng.

Enum
BULLET_ALIGNMENT_UNSPECIFIED Chưa chỉ định cách căn chỉnh dấu đầu dòng.
START Dấu đầu dòng được căn chỉnh với đầu không gian được phân bổ để hiển thị dấu đầ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 Dấu đầu dòng được căn chỉnh vào chính giữa không gian được phân bổ để hiển thị dấu đầu dòng.
END Dấu đầu dòng được căn chỉnh vào cuối không gian được phân bổ để hiển thị dấu đầu 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.

GlyphType

Các loại ký tự được dấu đầu dòng sử dụng khi các đoạn văn ở cấp độ lồng này được sắp xếp.

Enum
GLYPH_TYPE_UNSPECIFIED Loại ký tự không được chỉ định hoặc không được hỗ trợ.
NONE Chuỗi trống.
DECIMAL Một số, chẳng hạn như 1, 2 hoặc 3.
ZERO_DECIMAL Một số có tiền tố là số 0, chẳng hạn như 01, 02 hoặc 03. Số có nhiều chữ số không có tiền tố là số 0.
UPPER_ALPHA Một chữ cái viết hoa, chẳng hạn như A, B hoặc C.
ALPHA Một chữ cái viết thường, chẳng hạn như a, b hoặc c.
UPPER_ROMAN Chữ số La Mã viết hoa, chẳng hạn như I, II hoặc III.
ROMAN Số La Mã viết thường, chẳng hạn như i, ii hoặc iii.

SuggestedListProperties

Đã đề xuất thay đổi đối với ListProperties.

Biểu diễn dưới dạng JSON 
{
  "listProperties": {
    object (ListProperties)
  },
  "listPropertiesSuggestionState": {
    object (ListPropertiesSuggestionState)
  }
}
Trường
listProperties

object (ListProperties)

ListProperties chỉ bao gồm các thay đổi được thực hiện trong đề xuất này. Bạn có thể sử dụng hàm này cùng với listPropertiesSuggestionState để xem những trường nào đã thay đổi và giá trị mới của các trường đó.
listPropertiesSuggestionState

object (ListPropertiesSuggestionState)

Một mặt nạ cho biết trường nào trên ListProperties cơ sở đã được thay đổi trong đề xuất này.

ListPropertiesSuggestionState

Một mặt nạ cho biết trường nào trên ListProperties cơ sở đã được thay đổi trong đề xuất này. Đối với mọi trường được đặt thành đúng, sẽ có một giá trị mới được đề xuất.

Biểu diễn dưới dạng JSON 
{
  "nestingLevelsSuggestionStates": [
    {
      object (NestingLevelSuggestionState)
    }
  ]
}
Trường
nestingLevelsSuggestionStates[]

object (NestingLevelSuggestionState)

Một mặt nạ cho biết trường nào trên NestingLevel tương ứng trong nestingLevels đã được thay đổi trong đề xuất này.

Trạng thái đề xuất về mức lồng nhau được trả về theo thứ tự tăng dần của mức lồng nhau, trong đó mức lồng nhau ít nhất được trả về trước.

NestingLevelSuggestionState

Một mặt nạ cho biết trường nào trên NestingLevel cơ sở đã được thay đổi trong đề xuất này. Bất kỳ trường nào được đặt thành true sẽ có một giá trị được đề xuất mới.

Biểu diễn dưới dạng JSON 
{
  "bulletAlignmentSuggested": boolean,
  "glyphTypeSuggested": boolean,
  "glyphFormatSuggested": boolean,
  "glyphSymbolSuggested": boolean,
  "indentFirstLineSuggested": boolean,
  "indentStartSuggested": boolean,
  "textStyleSuggestionState": {
    object (TextStyleSuggestionState)
  },
  "startNumberSuggested": boolean
}
Trường
bulletAlignmentSuggested

boolean

Cho biết liệu có thay đổi nào được đề xuất đối với bulletAlignment hay không.
glyphTypeSuggested

boolean

Cho biết liệu có thay đổi được đề xuất đối với glyphType hay không.
glyphFormatSuggested

boolean

Cho biết liệu có thay đổi nào được đề xuất đối với glyphFormat hay không.
glyphSymbolSuggested

boolean

Cho biết liệu có thay đổi nào được đề xuất đối với glyphSymbol hay không.
indentFirstLineSuggested

boolean

Cho biết liệu có thay đổi nào được đề xuất đối với indentFirstLine hay không.
indentStartSuggested

boolean

Cho biết liệu có thay đổi được đề xuất đối với indentStart hay không.
textStyleSuggestionState

object (TextStyleSuggestionState)

Một mặt nạ cho biết trường nào trong text style đã được thay đổi trong đề xuất này.
startNumberSuggested

boolean

Cho biết liệu có thay đổi nào được đề xuất đối với startNumber hay không.

NamedRanges

Một tập hợp tất cả NamedRange trong tài liệu có cùng một tên.

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "namedRanges": [
    {
      object (NamedRange)
    }
  ]
}
Trường
name

string

Tên mà tất cả named ranges chia sẻ.
namedRanges[]

object (NamedRange)

Các NamedRange có cùng tên.

NamedRange

Một tập hợp gồm các Range có cùng mã dải ô được đặt tên.

Dải ô được đặt tên cho phép nhà phát triển liên kết các phần của tài liệu với một nhãn tuỳ ý do người dùng xác định để sau này có thể đọc hoặc chỉnh sửa nội dung của các phần đó theo phương thức lập trình. Một tài liệu có thể chứa nhiều dải ô được đặt tên có cùng tên, nhưng mỗi dải ô được đặt tên đều có mã nhận dạng duy nhất.

Một dải ô được đặt tên được tạo bằng một Range duy nhất và nội dung được chèn vào bên trong dải ô được đặt tên thường mở rộng dải ô đó. Tuy nhiên, một số thay đổi nhất định đối với tài liệu có thể khiến dải ô bị chia thành nhiều dải ô.

Dải ô được đặt tên không phải là dải ô riêng tư. Tất cả ứng dụng và cộng tác viên có quyền truy cập vào tài liệu đều có thể xem các dải ô được đặt tên.

Biểu diễn dưới dạng JSON 
{
  "namedRangeId": string,
  "name": string,
  "ranges": [
    {
      object (Range)
    }
  ]
}
Trường
namedRangeId

string

Mã của dải ô được đặt tên.
name

string

Tên của dải ô được đặt tên.
ranges[]

object (Range)

Các dải ô thuộc về dải ô được đặt tên này.

Phạm vi

Chỉ định một dải văn bản liền kề.

Biểu diễn dưới dạng JSON 
{
  "segmentId": string,
  "startIndex": integer,
  "endIndex": integer,
  "tabId": string
}
Trường
segmentId

string

Mã của đầu trang, chân trang hoặc chú thích cuối trang chứa dải ô này. Mã phân đoạn trống biểu thị phần nội dung của tài liệu.
startIndex

integer

Chỉ mục bắt đầu dựa trên 0 của dải ô này, tính theo đơn vị mã UTF-16.

Trong tất cả các trường hợp sử dụng hiện tại, bạn phải cung cấp chỉ mục bắt đầu. Trường này là Int32Value để phù hợp với các trường hợp sử dụng trong tương lai có phạm vi mở.
endIndex

integer

Chỉ mục kết thúc dựa trên 0 của phạm vi này, không bao gồm, trong các đơn vị mã UTF-16.

Trong mọi trường hợp sử dụng hiện tại, bạn phải cung cấp chỉ mục kết thúc. Trường này là Int32Value để phù hợp với các trường hợp sử dụng trong tương lai có phạm vi mở.
tabId

string

Thẻ chứa dải ô này. Khi bị bỏ qua, yêu cầu sẽ áp dụng cho thẻ đầu tiên.

Trong một tài liệu chứa một thẻ duy nhất:

  • Nếu được cung cấp, phải khớp với mã của thẻ đơn.

  • Nếu bị bỏ qua, yêu cầu sẽ áp dụng cho thẻ số ít.

Trong một tài liệu chứa nhiều thẻ:

  • Nếu được cung cấp, yêu cầu sẽ áp dụng cho thẻ được chỉ định.

  • Nếu bị bỏ qua, yêu cầu sẽ áp dụng cho thẻ đầu tiên trong tài liệu.

InlineObject

Một đối tượng xuất hiện cùng dòng với văn bản. InlineObject chứa một EmbeddedObject, chẳng hạn như hình ảnh.

Biểu diễn dưới dạng JSON 
{
  "objectId": string,
  "inlineObjectProperties": {
    object (InlineObjectProperties)
  },
  "suggestedInlineObjectPropertiesChanges": {
    string: {
      object (SuggestedInlineObjectProperties)
    },
    ...
  },
  "suggestedInsertionId": string,
  "suggestedDeletionIds": [
    string
  ]
}
Trường
objectId

string

Mã nhận dạng của đối tượng cùng dòng này. Có thể dùng để cập nhật thuộc tính của đối tượng.
inlineObjectProperties

object (InlineObjectProperties)

Các thuộc tính của đối tượng nội tuyến này.
suggestedInlineObjectPropertiesChanges

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

Các thay đổi được đề xuất đối với các thuộc tính đối tượng nội tuyến, được khoá bằng mã đề xuất.
suggestedInsertionId

string

Mã chèn được đề xuất. Nếu trống, thì đây không phải là nội dung chèn được đề xuất.
suggestedDeletionIds[]

string

Mã nhận dạng được đề xuất xoá. Nếu trống, thì không có nội dung nào được đề xuất xoá.

InlineObjectProperties

Thuộc tính của InlineObject.

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

object (EmbeddedObject)

Đối tượng được nhúng của đối tượng cùng dòng này.

EmbeddedObject

Một đối tượng được nhúng trong tài liệu.

Biểu diễn dưới dạng JSON 
{
  "title": string,
  "description": string,
  "embeddedObjectBorder": {
    object (EmbeddedObjectBorder)
  },
  "size": {
    object (Size)
  },
  "marginTop": {
    object (Dimension)
  },
  "marginBottom": {
    object (Dimension)
  },
  "marginRight": {
    object (Dimension)
  },
  "marginLeft": {
    object (Dimension)
  },
  "linkedContentReference": {
    object (LinkedContentReference)
  },

  // Union field properties can be only one of the following:
  "embeddedDrawingProperties": {
    object (EmbeddedDrawingProperties)
  },
  "imageProperties": {
    object (ImageProperties)
  }
  // End of list of possible types for union field properties.
}
Trường
title

string

Tiêu đề của đối tượng được nhúng. title và description đều được kết hợp để hiển thị văn bản thay thế.
description

string

Nội dung mô tả đối tượng được nhúng. title và description đều được kết hợp để hiển thị văn bản thay thế.
embeddedObjectBorder

object (EmbeddedObjectBorder)

Đường viền của đối tượng được nhúng.
size

object (Size)

Kích thước hiển thị của hình ảnh sau khi cắt.
marginTop

object (Dimension)

Lề trên của đối tượng được nhúng.
marginBottom

object (Dimension)

Lề dưới cùng của đối tượng được nhúng.
marginRight

object (Dimension)

Lề phải của đối tượng được nhúng.
marginLeft

object (Dimension)

Lề trái của đối tượng được nhúng.
linkedContentReference

object (LinkedContentReference)

Tham chiếu đến nội dung nguồn được liên kết bên ngoài. Ví dụ: tệp này chứa tham chiếu đến biểu đồ nguồn trên Google Trang tính khi đối tượng được nhúng là một biểu đồ được liên kết.

Nếu bạn không đặt chính sách này, thì đối tượng được nhúng sẽ không được liên kết.
Trường kết hợp properties. Các thuộc tính dành riêng cho từng loại đối tượng được nhúng. properties chỉ có thể là một trong những giá trị sau:
embeddedDrawingProperties

object (EmbeddedDrawingProperties)

Các thuộc tính của bản vẽ được nhúng.
imageProperties

object (ImageProperties)

Các thuộc tính của hình ảnh.

EmbeddedDrawingProperties

Loại này không có trường nào.

Các thuộc tính của bản vẽ được nhúng và dùng để phân biệt loại đối tượng. Bản vẽ được nhúng là bản vẽ được tạo và chỉnh sửa trong một tài liệu. Xin lưu ý rằng chúng tôi không hỗ trợ thông tin chi tiết quá mức.

ImageProperties

Thuộc tính của hình ảnh.

Biểu diễn dưới dạng JSON 
{
  "contentUri": string,
  "sourceUri": string,
  "brightness": number,
  "contrast": number,
  "transparency": number,
  "cropProperties": {
    object (CropProperties)
  },
  "angle": number
}
Trường
contentUri

string

URI đến hình ảnh có thời lượng mặc định là 30 phút. URI này được gắn thẻ với tài khoản của người yêu cầu. Bất cứ ai có URI đều có thể truy cập hiệu quả vào hình ảnh dưới vai trò là người yêu cầu ban đầu. Bạn có thể mất quyền truy cập vào hình ảnh nếu chế độ cài đặt cách chia sẻ của tài liệu thay đổi.
sourceUri

string

URI nguồn là URI dùng để chèn hình ảnh. URI nguồn có thể để trống.
brightness

number

Hiệu ứng độ sáng của hình ảnh. Giá trị phải nằm trong khoảng [-1.0, 1.0], trong đó 0 có nghĩa là không có hiệu lực.
contrast

number

Hiệu ứng tương phản của hình ảnh. Giá trị phải nằm trong khoảng [-1.0, 1.0], trong đó 0 có nghĩa là không có hiệu lực.
transparency

number

Hiệu ứng độ trong suốt của hình ảnh. Giá trị phải nằm trong khoảng [0,0, 1,0], trong đó 0 có nghĩa là không có hiệu ứng và 1 có nghĩa là trong suốt.
cropProperties

object (CropProperties)

Các thuộc tính cắt của hình ảnh.
angle

number

Góc xoay theo chiều kim đồng hồ của hình ảnh, tính bằng radian.

CropProperties

Thuộc tính cắt của hình ảnh.

Hình chữ nhật cắt được biểu thị bằng cách sử dụng độ dời phân đoạn từ 4 cạnh của nội dung gốc.

  • Nếu độ lệch nằm trong khoảng (0, 1), thì cạnh tương ứng của hình chữ nhật cắt sẽ được đặt bên trong hình chữ nhật giới hạn ban đầu của hình ảnh.
  • Nếu độ dời âm hoặc lớn hơn 1, thì cạnh tương ứng của hình chữ nhật cắt sẽ nằm bên ngoài hình chữ nhật giới hạn ban đầu của hình ảnh.
  • Nếu tất cả các độ dời và góc xoay đều bằng 0, thì hình ảnh sẽ không bị cắt.
Biểu diễn dưới dạng JSON 
{
  "offsetLeft": number,
  "offsetRight": number,
  "offsetTop": number,
  "offsetBottom": number,
  "angle": number
}
Trường
offsetLeft

number

Độ dời chỉ định khoảng cách từ cạnh trái của hình chữ nhật cắt đến cạnh trái của nội dung gốc dưới dạng một phân số của chiều rộng nội dung gốc.
offsetRight

number

Độ lệch chỉ định khoảng cách vào trong cạnh phải của hình chữ nhật cắt so với cạnh phải của nội dung gốc, dưới dạng một phần nhỏ chiều rộng của nội dung gốc.
offsetTop

number

Độ lệch chỉ định khoảng cách vào trong cạnh trên của hình chữ nhật cắt so với cạnh trên cùng của nội dung gốc, dưới dạng một phân đoạn chiều cao của nội dung gốc.
offsetBottom

number

Độ dời chỉ định khoảng cách từ cạnh dưới cùng của hình chữ nhật cắt đến cạnh dưới cùng của nội dung gốc dưới dạng một phân số của chiều cao nội dung gốc.
angle

number

Góc xoay theo chiều kim đồng hồ của hình chữ nhật cắt xung quanh tâm, tính bằng radian. Độ xoay được áp dụng sau độ dời.

EmbeddedObjectBorder

Đường viền xung quanh EmbeddedObject.

Biểu diễn dưới dạng JSON 
{
  "color": {
    object (OptionalColor)
  },
  "width": {
    object (Dimension)
  },
  "dashStyle": enum (DashStyle),
  "propertyState": enum (PropertyState)
}
Trường
color

object (OptionalColor)

Màu của đường viền.
width

object (Dimension)

Chiều rộng của đường viền.
dashStyle

enum (DashStyle)

Kiểu nét đứt của đường viền.
propertyState

enum (PropertyState)

Trạng thái thuộc tính của thuộc tính đường viền.

PropertyState

Các trạng thái có thể có của một cơ sở lưu trú.

Enum
RENDERED Nếu trạng thái của một thuộc tính là ĐÃ HIỂN THỊ, thì phần tử đó sẽ có thuộc tính tương ứng khi hiển thị trong tài liệu. Đây là giá trị mặc định.
NOT_RENDERED Nếu trạng thái của một thuộc tính là NOT_RENDERED, thì phần tử đó sẽ không có thuộc tính tương ứng khi hiển thị trong tài liệu.

LinkedContentReference

Nội dung tham chiếu đến nội dung nguồn được liên kết bên ngoài.

Biểu diễn dưới dạng JSON 
{

  // Union field reference can be only one of the following:
  "sheetsChartReference": {
    object (SheetsChartReference)
  }
  // End of list of possible types for union field reference.
}
Trường
Trường hợp hợp nhất reference. Thông tin tham chiếu dành riêng cho loại nội dung được liên kết. reference chỉ có thể là một trong những giá trị sau:
sheetsChartReference

object (SheetsChartReference)

Tham chiếu đến biểu đồ được liên kết.

SheetsChartReference

Tham chiếu đến một biểu đồ được liên kết được nhúng từ Google Trang tính.

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

string

Mã nhận dạng của bảng tính Google Trang tính chứa biểu đồ nguồn.
chartId

integer

Mã của biểu đồ cụ thể trong bảng tính Google Trang tính được nhúng.

SuggestedInlineObjectProperties

Nội dung thay đổi đề xuất cho InlineObjectProperties.

Biểu diễn dưới dạng JSON 
{
  "inlineObjectProperties": {
    object (InlineObjectProperties)
  },
  "inlineObjectPropertiesSuggestionState": {
    object (InlineObjectPropertiesSuggestionState)
  }
}
Trường
inlineObjectProperties

object (InlineObjectProperties)

InlineObjectProperties chỉ bao gồm các thay đổi được thực hiện trong đề xuất này. Bạn có thể sử dụng thuộc tính này cùng với inlineObjectPropertiesSuggestionState để xem trường nào đã thay đổi và giá trị mới của các trường đó.
inlineObjectPropertiesSuggestionState

object (InlineObjectPropertiesSuggestionState)

Một mặt nạ cho biết trường nào trên InlineObjectProperties cơ sở đã được thay đổi trong đề xuất này.

InlineObjectPropertiesSuggestionState

Một mặt nạ cho biết trường nào trên InlineObjectProperties cơ sở đã được thay đổi trong đề xuất này. Bất kỳ trường nào được đặt thành true sẽ có một giá trị được đề xuất mới.

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

object (EmbeddedObjectSuggestionState)

Một mặt nạ cho biết trường nào trong embeddedObject đã được thay đổi trong đề xuất này.

EmbeddedObjectSuggestionState

Một mặt nạ cho biết trường nào trên EmbeddedObject cơ sở đã được thay đổi trong đề xuất này. Đối với mọi trường được đặt thành đúng, sẽ có một giá trị mới được đề xuất.

Biểu diễn dưới dạng JSON 
{
  "embeddedDrawingPropertiesSuggestionState": {
    object (EmbeddedDrawingPropertiesSuggestionState)
  },
  "imagePropertiesSuggestionState": {
    object (ImagePropertiesSuggestionState)
  },
  "titleSuggested": boolean,
  "descriptionSuggested": boolean,
  "embeddedObjectBorderSuggestionState": {
    object (EmbeddedObjectBorderSuggestionState)
  },
  "sizeSuggestionState": {
    object (SizeSuggestionState)
  },
  "marginLeftSuggested": boolean,
  "marginRightSuggested": boolean,
  "marginTopSuggested": boolean,
  "marginBottomSuggested": boolean,
  "linkedContentReferenceSuggestionState": {
    object (LinkedContentReferenceSuggestionState)
  }
}
Trường
embeddedDrawingPropertiesSuggestionState

object (EmbeddedDrawingPropertiesSuggestionState)

Một mặt nạ cho biết trường nào trong embeddedDrawingProperties đã được thay đổi trong đề xuất này.
imagePropertiesSuggestionState

object (ImagePropertiesSuggestionState)

Một mặt nạ cho biết trường nào trong imageProperties đã được thay đổi trong đề xuất này.
titleSuggested

boolean

Cho biết liệu có thay đổi nào được đề xuất đối với title hay không.
descriptionSuggested

boolean

Cho biết liệu có thay đổi nào được đề xuất đối với description hay không.
embeddedObjectBorderSuggestionState

object (EmbeddedObjectBorderSuggestionState)

Một mặt nạ cho biết trường nào trong embeddedObjectBorder đã được thay đổi trong đề xuất này.
sizeSuggestionState

object (SizeSuggestionState)

Một mặt nạ cho biết trường nào trong size đã được thay đổi theo đề xuất này.
marginLeftSuggested

boolean

Cho biết liệu có thay đổi nào được đề xuất đối với marginLeft hay không.
marginRightSuggested

boolean

Cho biết liệu có thay đổi được đề xuất đối với marginRight hay không.
marginTopSuggested

boolean

Cho biết liệu có thay đổi nào được đề xuất đối với marginTop hay không.
marginBottomSuggested

boolean

Cho biết liệu có thay đổi được đề xuất đối với marginBottom hay không.
linkedContentReferenceSuggestionState

object (LinkedContentReferenceSuggestionState)

Một mặt nạ cho biết trường nào trong linkedContentReference đã được thay đổi trong đề xuất này.

EmbeddedDrawingPropertiesSuggestionState

Loại này không có trường nào.

Một mặt nạ cho biết trường nào trên EmbeddedDrawingProperties cơ sở đã được thay đổi trong đề xuất này. Bất kỳ trường nào được đặt thành true sẽ có một giá trị được đề xuất mới.

ImagePropertiesSuggestionState

Một mặt nạ cho biết trường nào trên ImageProperties cơ sở đã được thay đổi trong đề xuất này. Bất kỳ trường nào được đặt thành true sẽ có một giá trị được đề xuất mới.

Biểu diễn dưới dạng JSON 
{
  "contentUriSuggested": boolean,
  "sourceUriSuggested": boolean,
  "brightnessSuggested": boolean,
  "contrastSuggested": boolean,
  "transparencySuggested": boolean,
  "cropPropertiesSuggestionState": {
    object (CropPropertiesSuggestionState)
  },
  "angleSuggested": boolean
}
Trường
contentUriSuggested

boolean

Cho biết liệu có thay đổi nào được đề xuất đối với contentUri hay không.
sourceUriSuggested

boolean

Cho biết liệu có thay đổi nào được đề xuất đối với [sourceUri] [google.apps.docs.v1.EmbeddedObject.source_uri] hay không.
brightnessSuggested

boolean

Cho biết liệu có thay đổi nào được đề xuất đối với [brightness] [google.apps.docs.v1.EmbeddedObject.brightness] hay không.
contrastSuggested

boolean

Cho biết liệu có thay đổi nào được đề xuất đối với [contrast] [google.apps.docs.v1.EmbeddedObject.contrast] hay không.
transparencySuggested

boolean

Cho biết liệu có thay đổi nào được đề xuất đối với [transparency] [google.apps.docs.v1.EmbeddedObject.transparency] hay không.
cropPropertiesSuggestionState

object (CropPropertiesSuggestionState)

Một mặt nạ cho biết trường nào trong cropProperties đã được thay đổi theo đề xuất này.
angleSuggested

boolean

Cho biết liệu có thay đổi đề xuất nào đối với [angle] [google.apps.docs.v1.EmbeddedObject.angle] hay không.

CropPropertiesSuggestionState

Một mặt nạ cho biết trường nào trên CropProperties cơ sở đã được thay đổi trong đề xuất này. Đối với mọi trường được đặt thành đúng, sẽ có một giá trị mới được đề xuất.

Biểu diễn dưới dạng JSON 
{
  "offsetLeftSuggested": boolean,
  "offsetRightSuggested": boolean,
  "offsetTopSuggested": boolean,
  "offsetBottomSuggested": boolean,
  "angleSuggested": boolean
}
Trường
offsetLeftSuggested

boolean

Cho biết liệu có thay đổi nào được đề xuất đối với offsetLeft hay không.
offsetRightSuggested

boolean

Cho biết liệu có thay đổi nào được đề xuất đối với offsetRight hay không.
offsetTopSuggested

boolean

Cho biết liệu có thay đổi nào được đề xuất đối với offsetTop hay không.
offsetBottomSuggested

boolean

Cho biết liệu có thay đổi nào được đề xuất đối với offsetBottom hay không.
angleSuggested

boolean

Cho biết liệu có thay đổi được đề xuất đối với angle hay không.

EmbeddedObjectBorderSuggestionState

Một mặt nạ cho biết trường nào trên EmbeddedObjectBorder cơ sở đã được thay đổi trong đề xuất này. Bất kỳ trường nào được đặt thành true sẽ có một giá trị được đề xuất mới.

Biểu diễn dưới dạng JSON 
{
  "colorSuggested": boolean,
  "widthSuggested": boolean,
  "dashStyleSuggested": boolean,
  "propertyStateSuggested": boolean
}
Trường
colorSuggested

boolean

Cho biết liệu có thay đổi đề xuất nào đối với [color] [google.apps.docs.v1.EmbeddedBorderObject.color] hay không.
widthSuggested

boolean

Cho biết liệu có thay đổi đề xuất nào đối với [width] [google.apps.docs.v1.EmbeddedBorderObject.width] hay không.
dashStyleSuggested

boolean

Cho biết liệu có thay đổi đề xuất nào đối với [dashStyle] [google.apps.docs.v1.EmbeddedBorderObject.dash_style] hay không.
propertyStateSuggested

boolean

Cho biết liệu có thay đổi đề xuất nào đối với [propertyState] [google.apps.docs.v1.EmbeddedBorderObject.property_state] hay không.

LinkedContentReferenceSuggestionState

Một mặt nạ cho biết trường nào trên LinkedContentReference cơ sở đã được thay đổi trong đề xuất này. Bất kỳ trường nào được đặt thành true sẽ có một giá trị được đề xuất mới.

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

object (SheetsChartReferenceSuggestionState)

Một mặt nạ cho biết trường nào trong sheetsChartReference đã được thay đổi trong đề xuất này.

SheetsChartReferenceSuggestionState

Một mặt nạ cho biết trường nào trên SheetsChartReference cơ sở đã được thay đổi trong đề xuất này. Bất kỳ trường nào được đặt thành true sẽ có một giá trị được đề xuất mới.

Biểu diễn dưới dạng JSON 
{
  "spreadsheetIdSuggested": boolean,
  "chartIdSuggested": boolean
}
Trường
spreadsheetIdSuggested

boolean

Cho biết liệu có thay đổi nào được đề xuất đối với spreadsheetId hay không.
chartIdSuggested

boolean

Cho biết liệu có thay đổi nào được đề xuất đối với chartId hay không.

PositionedObject

Một đối tượng được chia sẻ Internet với Paragraph và được đặt tương ứng với đầu đoạn. PositionedObject chứa một EmbeddedObject như một hình ảnh.

Biểu diễn dưới dạng JSON 
{
  "objectId": string,
  "positionedObjectProperties": {
    object (PositionedObjectProperties)
  },
  "suggestedPositionedObjectPropertiesChanges": {
    string: {
      object (SuggestedPositionedObjectProperties)
    },
    ...
  },
  "suggestedInsertionId": string,
  "suggestedDeletionIds": [
    string
  ]
}
Trường
objectId

string

Mã của đối tượng được định vị này.
positionedObjectProperties

object (PositionedObjectProperties)

Các thuộc tính của đối tượng được định vị này.
suggestedPositionedObjectPropertiesChanges

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

Những thay đổi đề xuất cho các thuộc tính của đối tượng đã được định vị, được khoá theo mã đề xuất.
suggestedInsertionId

string

Mã chèn được đề xuất. Nếu trống, thì đây không phải là nội dung chèn được đề xuất.
suggestedDeletionIds[]

string

Mã xoá được đề xuất. Nếu trống, thì không có nội dung nào được đề xuất xoá.

PositionedObjectProperties

Các thuộc tính của PositionedObject.

Biểu diễn dưới dạng JSON 
{
  "positioning": {
    object (PositionedObjectPositioning)
  },
  "embeddedObject": {
    object (EmbeddedObject)
  }
}
Trường
positioning

object (PositionedObjectPositioning)

Vị trí của đối tượng được định vị này so với dòng mới của Paragraph tham chiếu đến đối tượng được định vị này.
embeddedObject

object (EmbeddedObject)

Đối tượng được nhúng của đối tượng được định vị này.

PositionedObjectPositioning

Vị trí của PositionedObject. Đối tượng được định vị được định vị tương ứng với vị trí bắt đầu của Paragraph mà đối tượng đó được liên kết.

Biểu diễn dưới dạng JSON 
{
  "layout": enum (PositionedObjectLayout),
  "leftOffset": {
    object (Dimension)
  },
  "topOffset": {
    object (Dimension)
  }
}
Trường
layout

enum (PositionedObjectLayout)

Bố cục của đối tượng được định vị này.
leftOffset

object (Dimension)

Độ lệch của cạnh bên trái của đối tượng được định vị so với điểm bắt đầu của Paragraph mà đối tượng được chia sẻ Internet. Vị trí chính xác của đối tượng có thể phụ thuộc vào nội dung khác trong tài liệu cũng như kiểu của tài liệu.
topOffset

object (Dimension)

Độ lệch của cạnh trên của đối tượng được định vị so với đầu Paragraph mà đối tượng đó được liên kết. Vị trí chính xác của đối tượng có thể phụ thuộc vào nội dung khác trong tài liệu và kiểu của tài liệu.

PositionedObjectLayout

Các bố cục có thể có của [PositionedObject][google.aps.docs.v1.PositionedObject].

Enum
POSITIONED_OBJECT_LAYOUT_UNSPECIFIED Bố cục chưa được chỉ định.
WRAP_TEXT Văn bản bao quanh đối tượng được định vị.
BREAK_LEFT Tách văn bản sao cho đối tượng được định vị ở bên trái và văn bản ở bên phải.
BREAK_RIGHT Tách văn bản sao cho đối tượng được định vị ở bên phải và văn bản ở bên trái.
BREAK_LEFT_RIGHT Tách văn bản sao cho không có văn bản nào ở bên trái hoặc bên phải của đối tượng được định vị.
IN_FRONT_OF_TEXT Đối tượng được định vị nằm ở phía trước văn bản.
BEHIND_TEXT Đối tượng đã định vị nằm phía sau văn bản.

SuggestedPositionedObjectProperties

Nội dung thay đổi đề xuất cho PositionedObjectProperties.

Biểu diễn dưới dạng JSON 
{
  "positionedObjectProperties": {
    object (PositionedObjectProperties)
  },
  "positionedObjectPropertiesSuggestionState": {
    object (PositionedObjectPropertiesSuggestionState)
  }
}
Trường
positionedObjectProperties

object (PositionedObjectProperties)

PositionedObjectProperties chỉ bao gồm các thay đổi được thực hiện trong đề xuất này. Bạn có thể sử dụng thuộc tính này cùng với positionedObjectPropertiesSuggestionState để xem trường nào đã thay đổi và giá trị mới của các trường đó.
positionedObjectPropertiesSuggestionState

object (PositionedObjectPropertiesSuggestionState)

Một mặt nạ cho biết trường nào trên PositionedObjectProperties cơ sở đã được thay đổi trong đề xuất này.

PositionedObjectPropertiesSuggestionState

Một mặt nạ cho biết trường nào trên PositionedObjectProperties cơ sở đã được thay đổi trong đề xuất này. Đối với mọi trường được đặt thành đúng, sẽ có một giá trị mới được đề xuất.

Biểu diễn dưới dạng JSON 
{
  "positioningSuggestionState": {
    object (PositionedObjectPositioningSuggestionState)
  },
  "embeddedObjectSuggestionState": {
    object (EmbeddedObjectSuggestionState)
  }
}
Trường
positioningSuggestionState

object (PositionedObjectPositioningSuggestionState)

Một mặt nạ cho biết trường nào trong positioning đã được thay đổi trong đề xuất này.
embeddedObjectSuggestionState

object (EmbeddedObjectSuggestionState)

Một mặt nạ cho biết trường nào trong embeddedObject đã được thay đổi trong đề xuất này.

PositionedObjectPositioningSuggestionState

Một mặt nạ cho biết trường nào trên PositionedObjectPositioning cơ sở đã được thay đổi trong đề xuất này. Bất kỳ trường nào được đặt thành true sẽ có một giá trị được đề xuất mới.

Biểu diễn dưới dạng JSON 
{
  "layoutSuggested": boolean,
  "leftOffsetSuggested": boolean,
  "topOffsetSuggested": boolean
}
Trường
layoutSuggested

boolean

Cho biết liệu có thay đổi nào được đề xuất đối với layout hay không.
leftOffsetSuggested

boolean

Cho biết liệu có thay đổi nào được đề xuất đối với leftOffset hay không.
topOffsetSuggested

boolean

Cho biết liệu có thay đổi nào được đề xuất đối với topOffset hay không.

SuggestionsViewMode

Chế độ xem đề xuất được áp dụng cho tài liệu cho biết cách hiển thị các thay đổi được đề xuất. Tùy chọn này cung cấp các lựa chọn để đọc tài liệu với tất cả các đề xuất cùng dòng, được chấp nhận hoặc bị từ chối.

Enum
DEFAULT_FOR_CURRENT_ACCESS SuggestionsViewMode áp dụng cho tài liệu được trả về tuỳ thuộc vào cấp truy cập hiện tại của người dùng. Nếu người dùng chỉ có quyền xem, thì PREVIEW_WITHOUT_SUGGESTIONS sẽ được áp dụng. Nếu không, SUGGESTIONS_INLINE sẽ được áp dụng. Đây là chế độ xem đề xuất mặc định.
SUGGESTIONS_INLINE

Tài liệu được trả về có các đề xuất cùng dòng. Nội dung thay đổi được đề xuất sẽ khác với nội dung cơ sở trong tài liệu.

Yêu cầu truy xuất tài liệu bằng chế độ này sẽ trả về lỗi 403 nếu người dùng không có quyền xem các thay đổi được đề xuất.
PREVIEW_SUGGESTIONS_ACCEPTED

Tài liệu được trả về là bản xem trước với tất cả các thay đổi được đề xuất đều được chấp nhận.

Yêu cầu truy xuất tài liệu bằng chế độ này sẽ trả về lỗi 403 nếu người dùng không có quyền xem các thay đổi được đề xuất.
PREVIEW_WITHOUT_SUGGESTIONS Tài liệu được trả về là bản xem trước, trong đó tất cả thay đổi được đề xuất đều bị từ chối nếu có đề xuất nào trong tài liệu.

Phương thức

batchUpdate

 Áp dụng một hoặc nhiều nội dung cập nhật cho tài liệu.

create

 Tạo một tài liệu trống bằng tiêu đề được cung cấp trong yêu cầu.

get

 Tải phiên bản mới nhất của tài liệu đã chỉ định.