REST Resource: documents

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

Một 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),
  "commentsViewMode": enum (CommentsViewMode),
  "comments": [
    {
      object (CommentThread)
    }
  ],
  "suggestions": [
    {
      object (SuggestionThread)
    }
  ],
  "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ã nhận dạng của tài liệu.
title

string

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

object (Tab)

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

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

string

Chỉ có đầu ra. Mã bản 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 phiên bản 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ừ phiên bản đó. Chỉ được điền sẵn nếu người dùng có quyền chỉnh sửa tài liệu.

Mã nhận dạng phiên bản không phải là một số tuần tự mà là một chuỗi không rõ ràng. Định dạng của mã nhận dạng bản sửa đổi có thể thay đổi theo thời gian. Chúng tôi chỉ đảm bảo mã phiên bản được trả về là hợp lệ trong 24 giờ sau khi được trả về và không thể chia sẻ mã này giữa các người dùng. Nếu mã phiên bản không thay đổi giữa các lệnh gọi, thì tức là tài liệu không thay đổi. Ngược lại, nếu mã nhận dạng thay đổi (đối với cùng một tài liệu và người dùng), thì điều đó thường có nghĩa là tài liệu đã được cập nhật. Tuy nhiên, mã nhận dạng thay đổi cũng có thể là 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.
commentsViewMode

enum (CommentsViewMode)

Chỉ có đầu ra. Chế độ xem nhận xét được áp dụng cho tài liệu.
comments[]

object (CommentThread)

Chỉ có đầu ra. Các bình luận liên kết với tài liệu. Chỉ được điền sẵn nếu bạn đặt tham số commentsViewMode thành yêu cầu bình luận (chẳng hạn như COMMENTS_VIEW_MODE_INCLUDED).
suggestions[]

object (SuggestionThread)

Chỉ có đầu ra. Các đề xuất liên quan đến tài liệu. Chỉ được điền sẵn nếu bạn đặt tham số commentsViewMode thành yêu cầu bình luận (chẳng hạn như COMMENTS_VIEW_MODE_INCLUDED).
body

object (Body)

Chỉ có đầu ra. 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. Trường này sẽ hiển thị nội dung thực tế của tài liệu từ tất cả các thẻ khi tham số includeTabsContent được đặt thành true. Nếu 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. Tiêu đề trong tài liệu, được khoá bằng mã nhận dạng tiêu đề.

Trường cũ: Thay vào đó, hãy sử dụng Document.tabs.documentTab.headers. Trường này cho thấy nội dung thực tế của tài liệu từ tất cả các thẻ khi tham số includeTabsContent được đặt thành true. Nếu 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. Phần chân trang trong tài liệu, được khoá bằng mã nhận dạng chân trang.

Trường cũ: Thay vào đó, hãy sử dụng Document.tabs.documentTab.footers. Trường này sẽ hiển thị nội dung thực tế của tài liệu từ tất cả các thẻ khi tham số includeTabsContent được đặt thành true. Nếu 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.
footnotes

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

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

Trường cũ: Thay vào đó, hãy sử dụng Document.tabs.documentTab.footnotes. Trường này sẽ hiển thị nội dung thực tế của tài liệu từ tất cả các thẻ khi tham số includeTabsContent được đặt thành true. Nếu 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 tài liệu.

Trường cũ: Thay vào đó, hãy sử dụng Document.tabs.documentTab.documentStyle. Trường này cho thấy nội dung thực tế của tài liệu từ tất cả các thẻ khi tham số includeTabsContent được đặt thành true. Nếu 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.
suggestedDocumentStyleChanges

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

Chỉ có đầu ra. Các thay đổi được đề xuất đối với kiểu 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.suggestedDocumentStyleChanges. Trường này sẽ hiển thị nội dung thực tế của tài liệu từ tất cả các thẻ khi tham số includeTabsContent được đặt thành true. Nếu 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.
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. Trường này cho thấy nội dung thực tế của tài liệu từ tất cả các thẻ khi tham số includeTabsContent được đặt thành true. Nếu 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 kiểu có tên của tài liệu, được khoá theo mã nhận dạng đề xuất.

Trường cũ: Thay vào đó, hãy sử dụng Document.tabs.documentTab.suggestedNamedStylesChanges. Trường này sẽ hiển thị nội dung thực tế của tài liệu từ tất cả các thẻ khi tham số includeTabsContent được đặt thành true. Nếu 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á bằng mã danh sách.

Trường cũ: Thay vào đó, hãy sử dụng Document.tabs.documentTab.lists. Trường này sẽ hiển thị nội dung thực tế của tài liệu từ tất cả các thẻ khi tham số includeTabsContent được đặt thành true. Nếu 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.
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. Trường này sẽ hiển thị nội dung thực tế của tài liệu từ tất cả các thẻ khi tham số includeTabsContent được đặt thành true. Nếu 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.
inlineObjects

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

Chỉ có đầu ra. Các đối tượng nội tuyến trong tài liệu, được khoá bằng mã nhận dạng đối tượng.

Trường cũ: Thay vào đó, hãy sử dụng Document.tabs.documentTab.inlineObjects. Trường này sẽ hiển thị nội dung thực tế của tài liệu từ tất cả các thẻ khi tham số includeTabsContent được đặt thành true. Nếu 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ã nhận dạng đối tượng.

Trường cũ: Thay vào đó, hãy sử dụng Document.tabs.documentTab.positionedObjects. Trường này cho thấy nội dung thực tế của tài liệu từ tất cả các thẻ khi tham số includeTabsContent được đặt thành true. Nếu 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.

Tab

Một thẻ trong tài liệu.

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

  "documentTab": {
    object (DocumentTab)
  }
}
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 nằm trong thẻ này.
Nội dung của thẻ. Sau đây là danh sách các trường loại trừ lẫn nhau. Tối đa một trong các trường sẽ được đặt trong phản hồi:
documentTab

object (DocumentTab)

Một thẻ chứa nội dung của tài liệu, chẳng hạn như văn bản và hình ảnh.
Kết thúc các trường loại trừ lẫn nhau.

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,
  "iconEmoji": string
}
Trường
tabId

string

Mã nhận dạng không thay đổi của thẻ.
title

string

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

string

Không bắt buộc. Mã nhận dạng của thẻ mẹ. Trống khi thẻ hiện tại là thẻ cấp gốc, tức là thẻ này không có thẻ mẹ.
index

integer

Chỉ mục dựa trên 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.
iconEmoji

string

Không bắt buộc. Biểu tượng cảm xúc xuất hiện cùng với thẻ. Biểu tượng cảm xúc hợp lệ được biểu thị bằng một chuỗi Unicode không trống. Mọi bộ ký tự không biểu thị một biểu tượng cảm xúc đều không hợp lệ.

Nếu biểu tượng cảm xúc không hợp lệ, hệ thống sẽ trả về lỗi 400 yêu cầu không hợp lệ.

Nếu giá trị này chưa được đặt hoặc trống, thẻ sẽ hiển thị biểu tượng thẻ mặc định.

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)
    },
    ...
  },
  "commentAnchors": {
    string: {
      object (CommentAnchor)
    },
    ...
  }
}
Trường
body

object (Body)

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

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

Tiêu đề trong thẻ tài liệu, được khoá bằng mã nhận dạng tiêu đề.
footers

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

Phần 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))

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

object (DocumentStyle)

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

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

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

object (NamedStyles)

Các kiểu có 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 kiểu có tên của thẻ tài liệu, được khoá bằng mã nhận dạng đề 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ã nhận dạng 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 khoá theo tên.
inlineObjects

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

Các đối tượng nội tuyến trong thẻ tài liệu, được khoá bằng 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ã nhận dạng đối tượng.
commentAnchors

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

Các điểm neo nhận xét trong thẻ tài liệu, được khoá theo mã nhận dạng điểm neo. Chỉ được điền sẵn nếu bạn đặt tham số commentsViewMode thành bắt buộc phải có bình luận (chẳng hạn như COMMENTS_VIEW_MODE_INCLUDED).

Nội dung

Nội dung tài liệu.

Nội dung thường chứa toàn bộ nội dung của 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 nội dung.

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,

  "paragraph": {
    object (Paragraph)
  },
  "sectionBreak": {
    object (SectionBreak)
  },
  "table": {
    object (Table)
  },
  "tableOfContents": {
    object (TableOfContents)
  }
}
Trường
startIndex

integer

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

integer

Chỉ mục kết thúc dựa trên 0 của phần tử cấu trúc này, không bao gồm, trong các đơn vị mã UTF-16.
Nội dung của phần tử cấu trúc. Sau đây là danh sách các trường loại trừ lẫn nhau. Tối đa một trong các trường sẽ được đặt trong phản hồi:
paragraph

object (Paragraph)

Một loại đoạn văn của phần tử cấu trúc.
sectionBreak

object (SectionBreak)

Một loại ngắt đoạ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)

Một loại mục lục của phần tử cấu trúc.
Kết thúc các trường loại trừ lẫn nhau.

Đoạn

StructuralElement đại diện cho một đoạn văn. Đoạn văn là một phạm vi nội dung được kết thúc bằng 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 thành các 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 được đề xuất sẽ thay đổi thành đoạn văn này, được khoá bằng mã nhận dạng đề xuất.
bullet

object (Bullet)

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

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

Các thay đổi được đề xuất đối với 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ị gắn 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ị mà bạn nên đính kèm vào đoạn văn này, được khoá theo mã nhận dạng đề xuất.

ParagraphElement

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

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

  "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)
  },
  "dateElement": {
    object (DateElement)
  }
}
Trường
startIndex

integer

Chỉ mục bắt đầu từ 0 của phần tử đoạn văn này, tính bằng đơ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ử đoạn văn này (loại trừ), tính bằng đơn vị mã UTF-16.
Nội dung của phần tử đoạn văn. Sau đây là danh sách các trường loại trừ lẫn nhau. Tối đa một trong các trường sẽ được đặt trong phản hồi:
textRun

object (TextRun)

Một phần tử đoạn văn bản.
autoText

object (AutoText)

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

object (PageBreak)

Một phần tử đoạn văn ngắt trang.
columnBreak

object (ColumnBreak)

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

object (FootnoteReference)

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

object (HorizontalRule)

Một phần tử đoạn văn theo quy tắc đường kẻ ngang.
equation

object (Equation)

Một phần tử đoạn phương trình.
inlineObjectElement

object (InlineObjectElement)

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

object (Person)

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

object (DateElement)

Một phần tử đoạn văn đại diện cho một ngày.
Kết thúc các trường loại trừ lẫn nhau.

TextRun

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

Biểu diễn dưới dạng JSON 
{
  "content": string,
  "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 đoạn đều được thay thế bằng ký tự Unicode U+E907.
suggestedInsertionIds[]

string

Mã chèn được đề xuất. Một TextRun 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à một đề xuất chèn.
suggestedDeletionIds[]

string

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

object (TextStyle)

Kiểu văn bản của đoạn này.
suggestedTextStyleChanges

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

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

TextStyle

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

Kiểu văn bả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. 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.
  • TextStyle trên named style kế thừa từ kiểu có tên là normal text.
  • TextStyle của kiểu được đặt tên normal text sẽ 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 một bảng có thể kế thừa kiểu văn bản của bảng.

Nếu kiểu văn bản không kế thừa từ một phần tử mẹ, thì việc huỷ đặt các trường sẽ chuyển kiểu về 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 
{
  "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

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

boolean

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

boolean

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

boolean

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

boolean

Văn bản có được viết bằng chữ hoa nhỏ 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 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 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ị này sẽ mặc định là 400.

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

enum (BaselineOffset)

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

Văn bản có độ lệch đường cơ sở SUPERSCRIPT hoặc SUBSCRIPT sẽ tự động được hiển thị ở cỡ chữ nhỏ hơn, được tính dựa trên trường fontSize. Những 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 không trong suốt 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, giá trị này sẽ được dùng làm màu sắc không trong suốt. Nếu không được đặt, giá trị này sẽ biểu thị một 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.0 đến 1.0.
blue

number

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

Phương diện

Một độ lớn theo một hướng duy nhất trong các đơn vị được chỉ định.

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

number

Độ lớn.
unit

enum (Unit)

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

Đơn vị

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

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

WeightedFontFamily

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

integer

Độ đậm củ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 (tính cả 2 giá trị đầu cuối). Phạm vi này tương ứng với các giá trị bằng số được mô tả trong Quy cách CSS 2.1, mục 15.6, trong đó các giá trị không phải bằng số sẽ không được phép.

Giá trị mặc định là 400 ("normal").

Độ đậm của phông chữ chỉ là 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 sẽ xác định trọng số được kết xuất, sau khi tính đến tính kế thừa:

  • Nếu văn bản được in đậm và trọng lượng nhỏ hơn 400, thì trọng lượng được kết xuất là 400.
  • Nếu văn bản được in đậm và trọng lượng lớn hơn hoặc bằng 400 nhưng nhỏ hơn 700, thì trọng lượng được kết xuất 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 với trọng số.
  • Nếu văn bản không được in đậm, thì trọng số được kết xuất sẽ bằng trọng số.

BaselineOffset

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

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

SuggestedTextStyle

Một thay đổi được đề xuất đối với TextStyle.

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

object (TextStyle)

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

object (TextStyleSuggestionState)

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

TextStyleSuggestionState

Mặt nạ cho biết những 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 true, sẽ có một giá trị mới được đề xuất.

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 nào đượ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 nào được đề xuất đối với underline hay không.
strikethroughSuggested

boolean

Cho biết liệu có thay đổi nào đượ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 nào đượ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 nào được đề xuất đối với baselineOffset hay không.

AutoText

Một ParagraphElement đại diện cho một vị trí trong văn bản được thay thế linh hoạt bằng nội dung có thể thay đổi theo thời gian, 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. Mộ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à một đề xuất chèn.
suggestedDeletionIds[]

string

Mã xoá được đề xuất. Nếu trống, tức là không có đề xuất xoá nội dung này.
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 được đề xuất sẽ thay đổi thành Văn bản tự động này, được khoá bằng mã nhận dạng đề xuất.

Loại

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

Enum
TYPE_UNSPECIFIED Một loại văn bản tự động không xác định.
PAGE_NUMBER Nhập để tạo văn bản tự động thể hiện số trang hiện tại.
PAGE_COUNT Loại văn bản tự động biểu thị tổng số trang trong tài liệu.

PageBreak

ParagraphElement đại diện cho một phần ngắt trang. Dấu ngắt trang sẽ khiến 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 được đề xuất lồng nhau. Nếu trống, thì đây không phải là một đề xuất chèn.
suggestedDeletionIds[]

string

Mã xoá được đề xuất. Nếu trống, tức là không có đề xuất xoá nội dung này.
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ư các đoạn văn bản và chú thích tham khảo, 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 dáng của 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á theo mã nhận dạng đề xuất.

ColumnBreak

ParagraphElement đại diện cho một phần ngắt cột. Ngắt cột sẽ khiến 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. Mộ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à một đề xuất chèn.
suggestedDeletionIds[]

string

Mã xoá được đề xuất. Nếu trống, tức là không có đề xuất xoá nội dung này.
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ư đoạn văn bản và chú thích cuối trang), kiểu văn bản của dấu ngắt cột có thể ảnh hưởng đến bố cục nội dung cũng như kiểu dáng của 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 ColumnBreak này, được khoá theo mã nhận dạng đề xuất.

FootnoteReference

ParagraphElement đại diện cho một phần 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ị bằng một con số và 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ã nhận dạng của footnote chứa nội dung của phần tham chiếu đến chú thích cuối trang này.
footnoteNumber

string

Số được hiển thị của chú thích này.
suggestedInsertionIds[]

string

Mã chèn được đề xuất. Mộ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à một đề xuất chèn.
suggestedDeletionIds[]

string

Mã xoá được đề xuất. Nếu trống, tức là 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 được đề xuất sẽ thay đổi thành FootnoteReference này, được khoá bằng mã nhận dạng đề xuất.

HorizontalRule

ParagraphElement biểu thị một đường kẻ 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. Một HorizontalRule 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à một đề xuất chèn.
suggestedDeletionIds[]

string

Mã xoá được đề xuất. Nếu trống, tức là không có đề xuất xoá nội dung này.
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ư đoạn văn bản và 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 dáng của 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 HorizontalRule này, được khoá bằng mã nhận dạng đề 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. Mộ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à một đề xuất chèn.
suggestedDeletionIds[]

string

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

InlineObjectElement

Một 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 được đề xuất lồng nhau. Nếu trống, thì đây không phải là một đề xuất chèn.
suggestedDeletionIds[]

string

Mã xoá được đề xuất. Nếu trống, tức là không có đề xuất xoá nội dung này.
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ư đoạn văn bản và chú thích cuối trang), kiểu văn bản của một phần tử đối tượng nội tuyến có thể ảnh hưởng đến bố cục nội dung cũng như kiểu dáng của 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ã nhận dạng đề xuất.

Người

Một người hoặc địa chỉ email được đề cập trong tài liệu. Những thông tin đề cập này hoạt động như một phần tử duy nhất, bất biến 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. Một Person có thể có nhiều mã nhận dạng chèn nếu đó là một thay đổi được đề xuất lồng nhau (ví dụ: một đề xuất trong đề xuất do một người dùng khác đưa ra). Nếu trống, thì đường liên kết đến người này không phải là một đề xuất chèn.
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, chẳng hạn như, nhiều người dùng đề xuất xoá đó. Nếu trống, thì đường liên kết đến người này sẽ không được đề xuất xoá.
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ã nhận dạng đề 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 xuất hiện.

PersonProperties

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

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

string

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

string

Đị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 một RichLink.

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

string

Tiêu đề của RichLink xuất hiện 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 nhất của đường liên kết. Trường này luôn xuất hiện.
uri

string

URI đến RichLink. Thông tin này luôn xuất hiện.
mimeType

string

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

DateElement

Một thực thể ngày được đề cập trong tài liệu.

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

string

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

string

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

string

Mã nhận dạng cho các đề xuất xoá ngày này khỏi tài liệu. DateElement có thể có nhiều mã xoá nếu, chẳng hạn như nhiều người dùng đề xuất xoá mã này. Nếu trống, thì ngày này không được đề xuất để xoá.
textStyle

object (TextStyle)

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

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

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

object (DateElementProperties)

Các thuộc tính của DateElement này.
suggestedDateElementPropertiesChanges

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

Các thay đổi được đề xuất đối với thuộc tính của phần tử ngày, được khoá theo mã nhận dạng đề xuất.

DateElementProperties

Thuộc tính của DateElement.

Biểu diễn dưới dạng JSON 
{
  "timestamp": string,
  "timeZoneId": string,
  "locale": string,
  "dateFormat": enum (DateFormat),
  "timeFormat": enum (TimeFormat),
  "displayText": string
}
Trường
timestamp

string (Timestamp format)

Thời điểm cần biểu thị, tính bằng giây và nano giây kể từ thời gian bắt đầu của hệ thống Unix: 00:00 ngày 1 tháng 1 năm 1970 theo giờ UTC.

Dấu thời gian dự kiến sẽ ở định dạng UTC. Nếu bạn đặt timeZoneId, dấu thời gian sẽ được điều chỉnh theo múi giờ. Ví dụ: dấu thời gian 18000 có định dạng ngày là DATE_FORMAT_ISO8601 và định dạng giờ là TIME_FORMAT_HOUR_MINUTE sẽ hiển thị dưới dạng 1970-01-01 5:00 AM. Dấu thời gian 18000 có định dạng ngày là DATE_FORMAT_ISO8601, định dạng giờ là TIME_FORMAT_HOUR_MINUTE và múi giờ được đặt thành America/New_York sẽ thay đổi thành 1970-01-01 12:00 AM.
timeZoneId

string

Múi giờ của DateElement, do dự án Kho lưu trữ dữ liệu chung về ngôn ngữ của Unicode (CLDR) xác định. Ví dụ: America/New_York. Nếu bạn không đặt, múi giờ mặc định sẽ là etc/UTC.
locale

string

Mã ngôn ngữ của DateElement. Ví dụ: en. Nếu bạn không đặt, ngôn ngữ mặc định sẽ là en.

Chỉ hỗ trợ các ngôn ngữ sau: af, am, ar, as, az, be, bg, bn, ca, cs, da, de, el, en, en-CA, en-GB, es, es-419, et, eu, fa, fi, fil, fr, fr-CA, gl, gu, hi, hr, hu, hy, id, is, it, iw, ja, ka, kk, km, kn, ko, lo, lt, lv, mk, ml, mn, mr, ms, ne, nl, no, or, pa, pl, pt-BR, pt-PT, ro, ru, si, sk, sl, sq, sr, sv, sw, ta, te, th, tr, uk, ur, uz, vi, zh-CN, zh-HK, zh-TW, zu, cy, my.
dateFormat

enum (DateFormat)

Xác định cách phần ngày của DateElement sẽ xuất hiện trong tài liệu.

Nếu chưa đặt, giá trị mặc định là DATE_FORMAT_MONTH_DAY_YEAR_ABBREVIATED, cho biết DateElement sẽ được định dạng là MMM d, y trong en hoặc giá trị tương đương theo ngôn ngữ cụ thể.
timeFormat

enum (TimeFormat)

Xác định cách phần thời gian của DateElement sẽ xuất hiện trong tài liệu.

Nếu bạn không đặt, giá trị mặc định là TIME_FORMAT_DISABLED, cho biết không có thời gian nào được hiển thị.
displayText

string

Chỉ có đầu ra. Cho biết cách DateElement xuất hiện trong tài liệu.

DateFormat

Các định dạng ngày có thể sử dụng của DateElement.

Enum
DATE_FORMAT_UNSPECIFIED Định dạng ngày không được chỉ định.
DATE_FORMAT_CUSTOM Chỉ có đầu ra. Định dạng ngày được nhập từ một nguồn bên ngoài.
DATE_FORMAT_MONTH_DAY_ABBREVIATED Định dạng ngày là tháng viết tắt, theo sau là ngày. Ví dụ: "Ngày 1 tháng 1".
DATE_FORMAT_MONTH_DAY_FULL Định dạng ngày là tháng, sau đó là ngày. Ví dụ: "Ngày 1 tháng 1".
DATE_FORMAT_MONTH_DAY_YEAR_ABBREVIATED Định dạng ngày là tháng viết tắt, theo sau là ngày và năm. Ví dụ: "1/1/1970".
DATE_FORMAT_ISO8601 Định dạng ngày là định dạng ISO 8601. Ví dụ: "1970-01-01".

TimeFormat

Các định dạng thời gian có thể có của DateElement.

Enum
TIME_FORMAT_UNSPECIFIED Định dạng thời gian không được chỉ định.
TIME_FORMAT_DISABLED Cho biết ngày không có thời gian.
TIME_FORMAT_HOUR_MINUTE Định dạng thời gian cho biết giờ và phút. Ví dụ: "1/1/1970 12:00 PM".
TIME_FORMAT_HOUR_MINUTE_TIMEZONE Định dạng thời gian cho biết giờ, phút và múi giờ. Ví dụ: "1/1/1970 12:00 PM UTC".

SuggestedDateElementProperties

Một thay đổi được đề xuất đối với DateElementProperties.

Biểu diễn dưới dạng JSON 
{
  "dateElementProperties": {
    object (DateElementProperties)
  },
  "dateElementPropertiesSuggestionState": {
    object (DateElementPropertiesSuggestionState)
  }
}
Trường
dateElementProperties

object (DateElementProperties)

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

object (DateElementPropertiesSuggestionState)

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

DateElementPropertiesSuggestionState

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

Biểu diễn dưới dạng JSON 
{
  "timestampSuggested": boolean,
  "timeZoneIdSuggested": boolean,
  "localeSuggested": boolean,
  "dateFormatSuggested": boolean,
  "timeFormatSuggested": boolean
}
Trường
timestampSuggested

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

ParagraphStyle

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

Các kiểu đoạn văn được kế thừa sẽ được biểu thị dưới dạng các trường chưa đặt trong thông báo này. Phần tử mẹ của kiểu đoạn văn phụ thuộc vào vị trí xác định kiểu đoạn văn:

  • 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.
  • ParagraphStyle 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.
  • ParagraphStyle trên phần tử Paragraph có trong bảng có thể kế thừa kiểu đoạn văn của phần tử đó 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ỷ đặt các trường sẽ chuyển kiểu về 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 văn. Nếu trống, thì đoạn này không phải là tiêu đề.

Thuộc tính này ở chế độ chỉ đọc.
namedStyleType

enum (NamedStyleType)

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

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

enum (Alignment)

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

number

Khoảng cách giữa các dòng, tính theo tỷ lệ phần trăm so với mức bình thường, trong đó mức bình thường được biểu thị là 100.0. Nếu bạn không đặt, giá trị sẽ được kế thừa từ đối tượng 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ị sẽ mặc định là LEFT_TO_RIGHT vì hướng đoạn văn không được kế thừa.
spacingMode

enum (SpacingMode)

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

object (Dimension)

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

object (Dimension)

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

object (ParagraphBorder)

Đường viền giữa đoạn này và đoạn tiếp theo cũng như đoạn trước đó. Nếu bạn không đặt, giá trị sẽ được kế thừa từ đối tượng mẹ.

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

Bạn 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 văn, bạn phải chỉ định toàn bộ đường viền mới.
borderTop

object (ParagraphBorder)

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

Đường viền trên cùng được kết xuất khi đoạn văn bản ở trên có các thuộc tính đường viền và thụt lề khác nhau.

Bạn 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 văn, bạn phải chỉ định toàn bộ đường viền mới.
borderBottom

object (ParagraphBorder)

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

Đường viền dưới được kết xuất khi đoạn văn bên dưới có các thuộc tính đường viền và thụt lề khác nhau.

Bạn 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 văn, bạn phải chỉ định toàn bộ đường viền mới.
borderLeft

object (ParagraphBorder)

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

Bạn 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 vă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 bạn không đặt, giá trị sẽ được kế thừa từ đối tượng mẹ.

Bạn 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 văn, bạn phải chỉ định toàn bộ đường viền mới.
indentFirstLine

object (Dimension)

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

object (Dimension)

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

object (Dimension)

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

object (TabStop)

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

Thuộc tính này ở chế độ chỉ đọ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 nếu có thể hay không. Nếu bạn không đặt, giá trị sẽ được kế thừa từ đối tượng mẹ.
keepWithNext

boolean

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

boolean

Có tránh các dòng đơn lẻ ở cuối đoạn và đầu đoạn hay không. Nếu bạn không đặt, giá trị sẽ được kế thừa từ đối tượng mẹ.
shading

object (Shading)

Màu tô bóng của đoạn. Nếu bạn không đặt, giá trị sẽ được kế thừa từ đối tượng mẹ.
pageBreakBefore

boolean

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

Việc cố gắng cập nhật pageBreakBefore cho các đoạn văn ở những 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 400 yêu cầu không hợp lệ.

NamedStyleType

Các loại kiểu có tên.

Enum
NAMED_STYLE_TYPE_UNSPECIFIED Chưa chỉ định loại kiểu có tên.
NORMAL_TEXT Văn bản 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 loại căn chỉnh văn bản cho một đoạn văn.

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

ContentDirection

Nội dung chỉ đường có thể xuất hiện.

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 sẽ đi từ phải sang trái.

SpacingMode

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

Enum
SPACING_MODE_UNSPECIFIED Chế độ giãn cách được kế thừa từ phần tử 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.

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 đường viền gạch ngang.

DashStyle

Các loại nét đứt mà hình học tuyến tính có thể được kết xuất. Những giá trị này dựa trên kiểu đơn giản "ST_PresetLineDashVal" được mô tả trong phần 20.1.10.49 của "Định dạng tệp Office Open XML – Nguyên tắ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 thứ 5.

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

TabStop

Một điểm dừng phím 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 điểm dừng của thẻ này và lề bắt đầu.
alignment

enum (TabStopAlignment)

Vị trí căn chỉnh của dấu dừng này. Nếu bạn không đặt, giá trị mặc định sẽ là START.

TabStopAlignment

Vị trí căn chỉnh của dấu tab.

Enum
TAB_STOP_ALIGNMENT_UNSPECIFIED Chưa chỉ định chế độ căn chỉnh dấu tab.
START Dấu tab được căn chỉnh theo đầu dòng. Đây là tuỳ chọn mặc định.
CENTER Điểm dừng của phím Tab được căn chỉnh ở giữa dòng.
END Điểm dừng của phím tab được căn chỉnh với cuối dòng.

Tạo bóng

Màu tô bóng của một đoạn vă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 bóng đổ này.

SuggestedParagraphStyle

Một thay đổi được đề 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)

Một ParagraphStyle chỉ bao gồm những thay đổi được thực hiện trong đề xuất này. Bạn có thể sử dụng tham số 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 nạ cho biết những trường nào trên ParagraphStyle cơ sở đã được thay đổi trong đề xuất này.

ParagraphStyleSuggestionState

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

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 nào đượ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 nào đượ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 nào được đề xuất đối với indentEnd hay không.
keepLinesTogetherSuggested

boolean

Cho biết liệu có thay đổi nào đượ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 nạ cho biết trường nào trong shading đã được thay đổi trong đề 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 nạ cho biết trường nào trên Shading cơ sở đã được thay đổi trong đề xuất thay đổi này. Đối với mọi trường được đặt thành true, 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.

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

string

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

integer

Cấp độ lồng ghép của đoạn văn này trong danh sách.
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

Một thay đổi được đề 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)

Một Bullet chỉ bao gồm những thay đổi được thực hiện trong đề xuất này. Bạn có thể sử dụng tham số 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 nạ cho biết những trường nào trên Bullet cơ sở đã được thay đổi trong đề xuất này.

BulletSuggestionState

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

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 nạ cho biết trường nào trong text style đã được thay đổi trong đề xuất này.

ObjectReferences

Một tập hợp 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 dấu ngắt đoạn. Phần là một phạm vi nội dung có cùng SectionStyle. Ngắt đoạn thể hiện điểm bắt đầu của một đoạn mới và kiểu đoạn sẽ áp dụng cho đoạn sau điểm ngắt đoạn.

Nội dung 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 được đề xuất lồng nhau. Nếu trống, thì đây không phải là một đề xuất chèn.
suggestedDeletionIds[]

string

Mã xoá được đề xuất. Nếu trống, tức là không có đề xuất xoá nội dung này.
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ế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 phần để 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ể. Nếu bạn huỷ đặt thuộc tính này, hệ thống sẽ trả về lỗi 400 yêu cầu không hợp lệ.
columnSeparatorStyle

enum (ColumnSeparatorStyle)

Kiểu của dấu 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 400 yêu cầu không hợp lệ.
contentDirection

enum (ContentDirection)

Hướng nội dung của phần này. Nếu bạn không đặt, 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 400 yêu cầu không hợp lệ.
marginTop

object (Dimension)

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

Nếu [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] là PAGELESS, thì thuộc tính này sẽ không được hiển thị.

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 400 yêu cầu không hợp lệ.
marginBottom

object (Dimension)

Lề dưới của trang trong phần. Nếu bạn không đặt, giá trị sẽ mặc định là marginBottom từ DocumentStyle.

Nếu [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] là PAGELESS, thì thuộc tính này sẽ không được hiển thị.

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 400 yêu cầu không hợp lệ.
marginRight

object (Dimension)

Lề phải của trang trong phần. Nếu bạn không đặt, giá trị sẽ mặc định là marginRight từ DocumentStyle. Khi bạn cập nhật lề phải, các cột trong phần này sẽ thay đổ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.

Nếu [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] là PAGELESS, thì thuộc tính này sẽ không được hiển thị.

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 400 yêu cầu không hợp lệ.
marginLeft

object (Dimension)

Lề trái của trang trong phần. Nếu bạn không đặt, giá trị sẽ mặc định là marginLeft từ DocumentStyle. Khi bạn cập nhật lề bên trái, các cột trong phần này sẽ thay đổ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.

Nếu [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] là PAGELESS, thì thuộc tính này sẽ không được hiển thị.

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 400 yêu cầu không hợp lệ.
marginHeader

object (Dimension)

Lề đầu trang của mục. Nếu bạn không đặt, giá trị sẽ mặc định là marginHeader từ DocumentStyle. 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.

Nếu [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] là PAGELESS, thì thuộc tính này sẽ không được hiển thị.

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 400 yêu cầu không hợp lệ.
sectionType

enum (SectionType)

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

string

Mã nhận dạng của tiêu đề mặc định. Nếu bạn không đặt, 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ừ defaultHeaderId của DocumentStyle.

Nếu [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] là PAGELESS, thì thuộc tính này sẽ không được hiển thị.

Thuộc tính này ở chế độ chỉ đọc.
firstPageHeaderId

string

Mã nhận dạng của tiêu đề chỉ được dùng cho trang đầu tiên của phần. Nếu useFirstPageHeaderFooter là true, giá trị này sẽ được dùng cho tiêu đề trên trang đầu tiên của phần. Nếu là false, tiêu đề trên trang đầu tiên của phần sẽ sử dụng defaultHeaderId. Nếu bạn không đặt, 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.

Nếu [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] là PAGELESS, thì thuộc tính này sẽ không được hiển thị.

Thuộc tính này ở chế độ chỉ đọc.
firstPageFooterId

string

Mã nhận dạng của chân trang chỉ được 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 trên trang đầu tiên của phần. Nếu giá trị là false, thì chân trang trên trang đầu tiên của phần sẽ sử dụng defaultFooterId. Nếu bạn không đặt, 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ừ firstPageFooterId của DocumentStyle.

Nếu [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] là PAGELESS, thì thuộc tính này sẽ không được hiển thị.

Thuộc tính này ở chế độ chỉ đọc.
evenPageHeaderId

string

Mã nhận dạng của tiêu đề chỉ được dùng cho các trang chẵn. Nếu giá trị của useEvenPageHeaderFooter trong DocumentStyle là true, thì giá trị này sẽ được dùng cho tiêu đề trên các trang chẵn trong phần. Nếu là false, tiêu đề trên các trang chẵn sẽ dùng defaultHeaderId. Nếu bạn không đặt, 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ừ evenPageHeaderId của DocumentStyle.

Nếu [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] là PAGELESS, thì thuộc tính này sẽ không được hiển thị.

Thuộc tính này ở chế độ chỉ đọc.
evenPageFooterId

string

Mã nhận dạng của chân trang chỉ dùng cho các trang chẵn. Nếu giá trị của useEvenPageHeaderFooter trong 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ếu là false, chân trang trên các trang chẵn sẽ sử dụng defaultFooterId. Nếu bạn không đặt, 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ừ evenPageFooterId của DocumentStyle.

Nếu [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] là PAGELESS, thì thuộc tính này sẽ không được hiển thị.

Thuộc tính này ở chế độ chỉ đọc.
useFirstPageHeaderFooter

boolean

Cho biết 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 của phần hay không. Nếu chưa đặt, thì thuộc tính này sẽ kế thừa từ useFirstPageHeaderFooter của DocumentStyle cho phần đầu tiên. Nếu bạn không đặt giá trị cho các ngành tiếp theo, thì giá trị đó sẽ được hiểu là false.

Nếu [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] là PAGELESS, thì thuộc tính này sẽ không được hiển thị.

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 400 yêu cầu không hợp lệ.
pageNumberStart

integer

Số trang bắt đầu đếm số trang cho phần này. Nếu bạn không đặt thuộc tính này, 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.

Nếu [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] là PAGELESS, thì thuộc tính này sẽ không được hiển thị.

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 400 yêu cầu không hợp lệ.
flipPageOrientation

boolean

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

Nếu [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] là PAGELESS, thì thuộc tính này sẽ không được hiển thị.

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 400 yêu cầu không hợp lệ.

SectionColumnProperties

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

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ấu phân cách cột giữa các cột.

Enum
COLUMN_SEPARATOR_STYLE_UNSPECIFIED Kiểu dấu phân cách cột không xác định.
NONE Không có đường phân cách cột giữa các cột.
BETWEEN_EACH_COLUMN Kết xuất một đườ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 Chưa chỉ định loại phần.
CONTINUOUS Phần này bắt đầu ngay sau đoạn văn cuối cùng của phần trước.
NEXT_PAGE Phần 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.

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ố ô khác nhau.
tableRows[]

object (TableRow)

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

string

Mã chèn được đề xuất. Một Table 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à một đề xuất chèn.
suggestedDeletionIds[]

string

Mã xoá được đề xuất. Nếu trống, tức là 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 từ 0 của hàng này, tính bằng đơn vị mã UTF-16.
endIndex

integer

Chỉ mục kết thúc dựa trên 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 là 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. Mộ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à một đề xuất chèn.
suggestedDeletionIds[]

string

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

object (TableRowStyle)

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

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

Các thay đổi về kiểu được đề xuất cho hàng này, được khoá bằng mã nhận dạng đề 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 từ 0 của ô này, tính bằng đơn vị mã UTF-16.
endIndex

integer

Chỉ mục kết thúc (dựa trên 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 ô.
suggestedInsertionIds[]

string

Mã chèn được đề xuất. Mộ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à một đề xuất chèn.
suggestedDeletionIds[]

string

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

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

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

TableCellStyle

Kiểu của TableCell.

Các kiểu ô trong bảng được kế thừa sẽ được biểu thị dưới dạng các trường chưa đặt trong thông báo này. 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

Số hàng mà ô này trải dài.

Thuộc tính này ở chế độ chỉ đọc.
columnSpan

integer

Khoảng cột của ô.

Thuộc tính này ở chế độ chỉ đọ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 bên phải của ô.
borderTop

object (TableCellBorder)

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

object (TableCellBorder)

Đường viền dưới cùng 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)

Sự căn chỉnh nội dung trong ô của bảng. Chế độ căn chỉnh mặc định sẽ khớp với chế độ 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.

Không thể để đường viền ô của bảng ở trạng thái trong suốt. Để ẩn đường viền của một ô trong bảng, hãy đặt chiều rộng của đường viền đó 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 thể trong suốt.
width

object (Dimension)

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

enum (DashStyle)

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

ContentAlignment

Các loại căn chỉnh nội dung.

Xuất phát từ một tập hợp con các giá trị của kiểu đơn giản "ST_TextAnchoringType" trong phần 20.1.10.60 của "Định dạng tệp Office Open XML – Nguyên tắ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 thứ 5.

Enum
CONTENT_ALIGNMENT_UNSPECIFIED Một chế độ căn chỉnh nội dung không xác định. Căn chỉnh nội dung được kế thừa từ phần tử mẹ (nếu có).
CONTENT_ALIGNMENT_UNSUPPORTED Căn chỉnh nội dung không được hỗ trợ.
TOP Một chế độ căn chỉnh giúp căn chỉnh nội dung với phần trên cùng của vùng chứa nội dung. Tương ứng với ECMA-376 ST_TextAnchoringType "t".
MIDDLE Một chế độ căn chỉnh giúp 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 Một chế độ căn chỉnh giúp căn chỉnh nội dung xuống cuối trình giữ nội dung. Tương ứng với ECMA-376 ST_TextAnchoringType "b".

SuggestedTableCellStyle

Một thay đổi được đề xuất đối với TableCellStyle.

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

object (TableCellStyle)

Một TableCellStyle chỉ bao gồm những thay đổi được thực hiện trong đề xuất này. Bạn có thể sử dụng tham số 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 nạ cho biết những trường nào trên TableCellStyle cơ sở đã được thay đổi trong đề xuất này.

TableCellStyleSuggestionState

Mặt nạ cho biết những 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 true, sẽ có một giá trị mới được đề xuất.

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 nào đượ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 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.
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 kết xuất 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

Hàng này có phải là tiêu đề bảng hay không.
preventOverflow

boolean

Hàng có thể không tràn qua ranh giới trang hoặc cột hay không.

SuggestedTableRowStyle

Một thay đổi được đề xuất đối với TableRowStyle.

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

object (TableRowStyle)

Một TableRowStyle chỉ bao gồm những thay đổi được thực hiện trong đề xuất này. Bạn có thể sử dụng tham số 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 nạ cho biết những trường nào trên TableRowStyle cơ sở đã được thay đổi trong đề xuất này.

TableRowStyleSuggestionState

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

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 từng 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

Các thuộc tính của một 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 Chưa chỉ định loại chiều rộng cột.
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ó 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

Mã chèn được đề xuất. Một TableOfContents 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à một đề xuất chèn.
suggestedDeletionIds[]

string

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

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ã nhận dạng 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 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,
  "documentFormat": {
    object (DocumentFormat)
  }
}
Trường
background

object (Background)

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

string

Mã nhận dạng của tiêu đề mặc định. Nếu bạn không đặt, sẽ không có tiêu đề mặc định.

Nếu [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] là PAGELESS, thì thuộc tính này sẽ không được hiển thị.

Thuộc tính này ở chế độ chỉ đọc.
evenPageHeaderId

string

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

Nếu [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] là PAGELESS, thì thuộc tính này sẽ không được hiển thị.

Thuộc tính này ở chế độ chỉ đọc.
evenPageFooterId

string

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

Nếu [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] là PAGELESS, thì thuộc tính này sẽ không được hiển thị.

Thuộc tính này ở chế độ chỉ đọc.
firstPageHeaderId

string

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

Nếu [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] là PAGELESS, thì thuộc tính này sẽ không được hiển thị.

Thuộc tính này ở chế độ chỉ đọc.
firstPageFooterId

string

Mã nhận dạng 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 cho trang đầu tiên. Giá trị của useFirstPageHeaderFooter xác định xem có sử dụng defaultFooterId hay giá trị này cho chân trang trên trang đầu tiên hay không. Nếu bạn không đặt chính sách này, sẽ không có chân trang ở trang đầu tiên.

Nếu [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] là PAGELESS, thì thuộc tính này sẽ không được hiển thị.

Thuộc tính này ở chế độ chỉ đọc.
useFirstPageHeaderFooter

boolean

Cho biết có sử dụng giá trị nhận dạng đầu trang / chân trang của trang đầu tiên cho trang đầu tiên hay không.

Nếu [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] là PAGELESS, thì thuộc tính này sẽ không được hiển thị.
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.

Nếu [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] là PAGELESS, thì thuộc tính này sẽ không được hiển thị.
pageNumberStart

integer

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

Nếu [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] là PAGELESS, thì thuộc tính này sẽ không được hiển thị.
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 trong kiểu tài liệu sẽ xoá lề trên cùng của trang trong tất cả kiểu phần.

Nếu [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] là PAGELESS, thì thuộc tính này sẽ không được hiển thị.
marginBottom

object (Dimension)

Lề dưới của trang.

Việc cập nhật lề dưới cùng của trang trong kiểu tài liệu sẽ xoá lề dưới cùng của trang trong tất cả kiểu phần.

Nếu [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] là PAGELESS, thì thuộc tính này sẽ không được hiển thị.
marginRight

object (Dimension)

Lề phải của trang.

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

Nếu [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] là PAGELESS, thì thuộc tính này sẽ không được hiển thị.
marginLeft

object (Dimension)

Lề trái của trang.

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

Nếu [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] là PAGELESS, thì thuộc tính này sẽ không được hiển thị.
pageSize

object (Size)

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

Nếu [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] là PAGELESS, thì thuộc tính này sẽ không được hiển thị.
marginHeader

object (Dimension)

Khoảng không gian giữa đầu trang và nội dung của tiêu đề.

Nếu [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] là PAGELESS, thì thuộc tính này sẽ không được hiển thị.
flipPageOrientation

boolean

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

Nếu [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] là PAGELESS, thì thuộc tính này sẽ không được hiển thị.
documentFormat

object (DocumentFormat)

Chỉ định các chế độ cài đặt định dạng ở cấp tài liệu, chẳng hạn như chế độ tài liệu (phân trang so với không phân trang).

Thông tin khái quát

Biểu thị 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.

DocumentFormat

Biểu thị chế độ cài đặt định dạng ở cấp tài liệu.

Biểu diễn dưới dạng JSON 
{
  "documentMode": enum (DocumentMode)
}
Trường
documentMode

enum (DocumentMode)

Tài liệu có phân trang hay không.

DocumentMode

Tài liệu có phân trang hay không.

Enum
DOCUMENT_MODE_UNSPECIFIED Chưa chỉ định chế độ tài liệu.
PAGES Tài liệu có các trang.
PAGELESS Tài liệu không có trang.

SuggestedDocumentStyle

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

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

object (DocumentStyle)

Một DocumentStyle chỉ bao gồm những thay đổi được thực hiện trong đề xuất này. Bạn có thể sử dụng tham số 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 nạ cho biết những trường nào trên DocumentStyle cơ sở đã được thay đổi trong đề xuất này.

DocumentStyleSuggestionState

Mặt nạ cho biết những 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 true, sẽ có một giá trị mới được đề xuất.

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 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 nào đượ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 nạ cho biết những 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 nạ cho biết những 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ị 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 màu nền hiện tại có được sửa đổi trong đề xuất này hay không.

SizeSuggestionState

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

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ừ những kiểu có 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 cho mỗi named style types có thể có.

NamedStyle

Một 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 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 kiểu có tên này.
textStyle

object (TextStyle)

Kiểu văn bản của kiểu có tên này.
paragraphStyle

object (ParagraphStyle)

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

SuggestedNamedStyles

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

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

object (NamedStyles)

Một NamedStyles chỉ bao gồm những thay đổi được thực hiện trong đề xuất này. Bạn có thể sử dụng tham số 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 nạ cho biết những 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 nạ cho biết trường nào trên NamedStyle tương ứng trong styles đã 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ên mà trạng thái đề xuất này tương ứng.

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

object (TextStyleSuggestionState)

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

object (ParagraphStyleSuggestionState)

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

Danh sách

List đại diện cho các thuộc tính danh sách của một nhóm đoạn văn, tất cả đều thuộc cùng một danh sách. Một đoạn văn thuộc danh sách có một 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ã nhận dạng đề xuất.
suggestedInsertionId

string

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

string

Mã xoá được đề xuất. Nếu trống, tức là không có đề xuất xoá nào cho 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 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 thuộc tính của dấu đầu dòng ở cấp độ được liên kết.

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

NestingLevel

Chứa các thuộc tính mô tả giao diện của dấu đầu dòng trong danh sách ở một cấp độ lồng ghép 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,

  "glyphType": enum (GlyphType),
  "glyphSymbol": string
}
Trường
bulletAlignment

enum (BulletAlignment)

Vị trí căn chỉnh của dấu đầu dòng trong khoảng trống được phân bổ để hiển thị dấu đầu dòng.
glyphFormat

string

Chuỗi định dạng được dùng cho dấu đầu dòng ở cấp độ lồng ghép này.

Định dạng glyph chứa một hoặc nhiều trình giữ chỗ và các trình 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]. Ngoài ra, phần giữ chỗ có thể có tiền tố và hậu tố. Do đó, định dạng glyph 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 ghép 0, sau đó là dấu chấm làm hậu tố. Vì vậy, một danh sách có loại ký tự UPPER_ALPHA và định dạng ký tự %0. ở cấp độ lồng ghép 0 sẽ tạo ra một danh sách có các ký tự được kết xuất

A.

B.

C.

Định dạng glyph có thể chứa phần giữ chỗ cho cấp độ lồng ghép hiện tại cũng như phần giữ chỗ cho các cấp độ lồng ghép gốc. Ví dụ: danh sách có thể có định dạng ký tự hình %0. ở cấp lồng 0 và định dạng ký tự hình %0.%1. ở cấp lồng 1. Giả sử cả hai cấp độ lồng nhau đều có kiểu 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 nhau được sắp xếp, chuỗi thay thế một phần giữ chỗ ở định dạng ký tự cho một đoạn văn cụ thể sẽ phụ thuộc vào thứ tự của đoạn văn đó trong danh sách.
indentFirstLine

object (Dimension)

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

object (Dimension)

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

object (TextStyle)

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

integer

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

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

Giá trị này sẽ bị bỏ qua đối với các cấp độ lồng ghép có ký tự không theo thứ tự.
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ế các phần giữ chỗ trong glyph_format. Sau đây là danh sách các trường loại trừ lẫn nhau. Tối đa một trong các trường sẽ được đặt trong phản hồi:
glyphType

enum (GlyphType)

Loại ký tự tượng hình mà dấu đầu dòng sử dụng khi các đoạn ở cấp độ lồng ghép 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 ở cấp độ lồng ghép này được sắp xếp theo thứ tự. Ví dụ: nếu cấp độ lồng nhau 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 trong đị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

Một biểu tượng glyph tuỳ chỉnh được dấu đầu dòng sử dụng khi các đoạn ở cấp độ lồng ghép này không theo thứ tự.

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

BulletAlignment

Các loại 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 theo phần đầu của khoảng trống được phân bổ để hiển thị dấu đầu dòng. Căn trái cho văn bản LTR, căn phải cho văn bản khác.
CENTER Dấu đầu dòng được căn chỉnh vào giữa khoảng trống được phân bổ để hiển thị dấu đầu dòng.
END Dấu đầu dòng được căn chỉnh ở cuối khoảng trống đượ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 trong trường hợp khác.

GlyphType

Các loại ký tự hình dùng cho dấu đầu dòng khi các đoạn ở cấp độ lồng ghép này được sắp xếp theo thứ tự.

Enum
GLYPH_TYPE_UNSPECIFIED Loại ký tự không được chỉ định hoặc không được hỗ trợ.
NONE Một chuỗi trống.
DECIMAL Một số, chẳng hạn như 1, 2 hoặc 3.
ZERO_DECIMAL Một số có các chữ số đơn lẻ được thêm tiền tố là số 0, chẳng hạn như 01, 02 hoặc 03. Các số có nhiều chữ số không có số 0 ở đầu.
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 Một chữ số La Mã viết hoa, chẳng hạn như I, II hoặc III.
ROMAN Một chữ số La Mã viết thường, chẳng hạn như i, ii hoặc iii.

SuggestedListProperties

Một thay đổi được đề xuất cho ListProperties.

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

object (ListProperties)

Một ListProperties chỉ bao gồm những thay đổi được thực hiện trong đề xuất này. Bạn có thể sử dụng tham số 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 nạ cho biết những trường nào trên ListProperties cơ sở đã được thay đổi trong đề xuất này.

ListPropertiesSuggestionState

Mặt nạ cho biết những 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 true, 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 nạ cho biết trường nào trên NestingLevel tương ứng trong nestingLevels đã thay đổi trong đề xuất này.

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

NestingLevelSuggestionState

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

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 nào đượ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 nào được đề xuất đối với indentStart hay không.
textStyleSuggestionState

object (TextStyleSuggestionState)

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 gồm tất cả cá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 đều dùng chung.
namedRanges[]

object (NamedRange)

NamedRangecó cùng tên.

NamedRange

Một tập hợp các Range có cùng mã nhận dạng 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 một tài liệu với một nhãn tuỳ ý do người dùng xác định để sau này họ có thể đọc hoặc chỉnh sửa nội dung theo cách 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ột mã nhận dạng riêng biệt.

Một dải ô được đặt tên sẽ được tạo bằng một Range và nội dung được chèn vào bên trong dải ô được đặt tên thường sẽ 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 ô được 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 của tài liệu đó.

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

string

Mã nhận dạng 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 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 tiêu đề, chân trang hoặc chú thích mà dải ô này nằm trong. Mã phân đoạn trống biểu thị nội dung của tài liệu.
startIndex

integer

Chỉ mục bắt đầu từ 0 của dải ô này, tính bằng đơ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 để đáp ứng các trường hợp sử dụng trong tương lai với các phạm vi mở.
endIndex

integer

Chỉ mục kết thúc dựa trên 0 của dải ô này (không bao gồm), tính bằng đơ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 cuối. Trường này là Int32Value để đáp ứng các trường hợp sử dụng trong tương lai với các phạm vi mở.
tabId

string

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

Trong một tài liệu chỉ có một thẻ:

  • Nếu được cung cấp, mã này phải khớp với mã nhận dạng của thẻ đơn.

  • Nếu bạn bỏ qua, yêu cầu sẽ áp dụng cho thẻ đơn.

Trong một tài liệu có 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ạn bỏ qua tham số này, 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 nội tuyến này. Có thể dùng để cập nhật các thuộc tính của một đố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 thuộc tính của đối tượng nội tuyến, được khoá theo mã nhận dạng đề xuất.
suggestedInsertionId

string

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

string

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

InlineObjectProperties

Thuộc tính của một 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 nội tuyến 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)
  },

  "embeddedDrawingProperties": {
    object (EmbeddedDrawingProperties)
  },
  "imageProperties": {
    object (ImageProperties)
  }
}
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ả về đố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ùng của đối tượng được nhúng.
marginBottom

object (Dimension)

Lề dưới 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ụ: thuộc tính này chứa thông tin 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, thì đối tượng được nhúng sẽ không được liên kết.
Các thuộc tính dành riêng cho từng loại đối tượng được nhúng. Sau đây là danh sách các trường loại trừ lẫn nhau. Tối đa một trong các trường sẽ được đặt trong phản hồi:
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.
Kết thúc các trường loại trừ lẫn nhau.

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 tài liệu. Xin lưu ý rằng chúng tôi không hỗ trợ thông tin chi tiết mở rộng.

ImageProperties

Các 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

Một URI đến hình ảnh có thời gian tồn tại mặc định là 30 phút. URI này được gắn thẻ bằng tài khoản của người yêu cầu. Bất kỳ ai có URI đều có thể truy cập vào hình ảnh với tư cách 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 ứng.
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 ứng.
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

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

Hình chữ nhật cắt được biểu thị bằng cách sử dụng các độ lệch phân số 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ẽ nằm bên trong hình chữ nhật gốc giới hạn của hình ảnh.
  • Nếu độ lệch là số â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 ngoài hình chữ nhật gốc giới hạn của hình ảnh.
  • Nếu tất cả độ lệch 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

Tham số offset 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 nguyên gốc dưới dạng một phần chiều rộng của nội dung nguyên gốc.
offsetRight

number

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

number

Tham số offset chỉ định khoảng cách từ cạnh trên của hình chữ nhật cắt đến cạnh trên của nội dung nguyên gốc theo tỷ lệ chiều cao của nội dung nguyên gốc.
offsetBottom

number

Độ lệch chỉ định khoảng cách từ cạnh dưới của hình chữ nhật cắt đến cạnh dưới của nội dung gốc dưới dạng một phần chiều cao của 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 của hình chữ nhật đó, tính bằng radian. Góc xoay được áp dụng sau các độ lệch.

EmbeddedObjectBorder

Đường viền xung quanh một 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 đường viền gạch ngang.
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à RENDERED, thì phần tử đó sẽ có thuộc tính tương ứng khi được 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 được kết xuất trong tài liệu.

LinkedContentReference

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 
{

  "sheetsChartReference": {
    object (SheetsChartReference)
  }
}
Trường
Thông tin tham chiếu dành riêng cho loại nội dung được liên kết. Sau đây là danh sách các trường loại trừ lẫn nhau. Tối đa một trong các trường sẽ được đặt trong phản hồi:
sheetsChartReference

object (SheetsChartReference)

Tham chiếu đến biểu đồ được liên kết.
Kết thúc các trường loại trừ lẫn nhau.

SheetsChartReference

Tham chiếu đến một biểu đồ được liên kết và 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ã nhận dạng của biểu đồ cụ thể trong bảng tính Google Trang tính được nhúng.

SuggestedInlineObjectProperties

Một thay đổi được đề xuất cho InlineObjectProperties.

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

object (InlineObjectProperties)

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

object (InlineObjectPropertiesSuggestionState)

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

InlineObjectPropertiesSuggestionState

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

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

object (EmbeddedObjectSuggestionState)

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

EmbeddedObjectSuggestionState

Mặt nạ cho biết những 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 true, 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 nạ cho biết trường nào trong embeddedDrawingProperties đã được thay đổi trong đề xuất này.
imagePropertiesSuggestionState

object (ImagePropertiesSuggestionState)

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 nạ cho biết trường nào trong embeddedObjectBorder đã được thay đổi trong đề xuất này.
sizeSuggestionState

object (SizeSuggestionState)

Mặt nạ cho biết trường nào trong size đã được thay đổi trong đề 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 nào đượ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 nào được đề xuất đối với marginBottom hay không.
linkedContentReferenceSuggestionState

object (LinkedContentReferenceSuggestionState)

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 nạ cho biết những trường nào trên EmbeddedDrawingProperties cơ sở đã được thay đổi trong đề xuất này. Đối với mọi trường được đặt thành true, sẽ có một giá trị mới được đề xuất.

ImagePropertiesSuggestionState

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

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 có thay đổi được đề xuất nào đối với [sourceUri] [google.apps.docs.v1.EmbeddedObject.source_uri] hay không.
brightnessSuggested

boolean

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

boolean

Cho biết liệu có thay đổi đượ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 được đề xuất đối với [độ trong suốt] hay không [google.apps.docs.v1.EmbeddedObject.transparency].
cropPropertiesSuggestionState

object (CropPropertiesSuggestionState)

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

boolean

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

CropPropertiesSuggestionState

Mặt nạ cho biết những 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 true, 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 nào được đề xuất đối với angle hay không.

EmbeddedObjectBorderSuggestionState

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

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 được đề xuất đối với [color] [google.apps.docs.v1.EmbeddedBorderObject.color] hay không.
widthSuggested

boolean

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

boolean

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

boolean

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

LinkedContentReferenceSuggestionState

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

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

object (SheetsChartReferenceSuggestionState)

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

SheetsChartReferenceSuggestionState

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

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 liên kết với Paragraph và được đặt tương ứng với phần đầu của đoạn văn. PositionedObject chứa một EmbeddedObject, chẳng hạn như 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ã nhận dạng 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))

Các thay đổi được đề xuất đối với thuộc tính của đối tượng được định vị, được khoá bằng mã nhận dạng đề xuất.
suggestedInsertionId

string

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

string

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

PositionedObjectProperties

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ị sẽ được định vị tương ứng với điểm 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 trái của đối tượng được định vị so với phần đầu của 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 dáng của tài liệu.
topOffset

object (Dimension)

Độ lệch của cạnh trên cùng của đối tượng được định vị so với phần đầu của 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 dáng của tài liệu.

PositionedObjectLayout

Các bố cục có thể có của một [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 Ngắt 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 Ngắt 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 Ngắt văn bản để không có văn bản ở 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 được định vị nằm phía sau văn bản.

SuggestedPositionedObjectProperties

Một thay đổi được đề xuất cho PositionedObjectProperties.

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

object (PositionedObjectProperties)

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

object (PositionedObjectPropertiesSuggestionState)

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

PositionedObjectPropertiesSuggestionState

Mặt nạ cho biết những 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 true, 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 nạ cho biết trường nào trong positioning đã được thay đổi trong đề xuất này.
embeddedObjectSuggestionState

object (EmbeddedObjectSuggestionState)

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

PositionedObjectPositioningSuggestionState

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

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.

CommentAnchor

Một hoặc nhiều vị trí trong tài liệu được liên kết với CommentThreads có cùng anchorId. Lưu ý: Nhiều điểm neo có thể tham chiếu đến cùng một vị trí.

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

string

Mã nhận dạng của điểm neo bình luận.
ranges[]

object (Range)

Một tập hợp các Range trong tài liệu được liên kết với điểm neo này.

SuggestionsViewMode

Chế độ xem đề xuất được áp dụng cho tài liệu, cho biết cách thể hiện các thay đổi được đề xuất. Chế độ này cung cấp các lựa chọn để đọc tài liệu với tất cả đề xuất được chèn vào dòng, được chấp nhận hoặc bị từ chối.

Enum
DEFAULT_FOR_CURRENT_ACCESS SuggestionsViewMode được áp dụng cho tài liệu 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 nội tuyến. Các thay đổi được đề xuất sẽ khác với nội dung cơ bản trong tài liệu.

Các 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 có tất cả các thay đổi được đề xuất đã được chấp nhận.

Các 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 với tất cả các thay đổi được đề xuất bị từ chối (nếu có đề xuất nào trong tài liệu).

CommentsViewMode

Chế độ xem bình luận được áp dụng cho tài liệu, cho biết liệu bình luận có được đưa vào hay không. Chế độ này cung cấp các lựa chọn để đọc tài liệu có hoặc không có bình luận và điểm neo bình luận.

Nếu đặt commentsViewMode thành bất kỳ giá trị nào, bạn cũng phải đặt includeTabsContent thành true hoặc sử dụng một mặt nạ trường tham chiếu đến trường Document.tabs (hoặc bất kỳ trường con nào).

Bạn chỉ có thể trả về nhận xét nếu các đề xuất được trả về cùng dòng. Nếu đặt commentsViewMode thành COMMENTS_VIEW_MODE_INCLUDED hoặc COMMENTS_VIEW_MODE_DEFAULT_FOR_CURRENT_ACCESS, bạn chỉ có thể đặt suggestionsViewMode thành PREVIEW_WITHOUT_SUGGESTIONS hoặc PREVIEW_SUGGESTIONS_ACCEPTED.

Enum
COMMENTS_VIEW_MODE_UNSPECIFIED CommentsViewMode chưa được chỉ định. COMMENTS_VIEW_MODE_OMITTED được áp dụng.
COMMENTS_VIEW_MODE_DEFAULT_FOR_CURRENT_ACCESS CommentsViewMode được á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ì COMMENTS_VIEW_MODE_OMITTED sẽ được áp dụng. Nếu không, COMMENTS_VIEW_MODE_INCLUDED sẽ được áp dụng.
COMMENTS_VIEW_MODE_OMITTED Tài liệu được trả về đã bị bỏ qua các bình luận.
COMMENTS_VIEW_MODE_INCLUDED

Tài liệu được trả về có chứa nhận xét.

Các 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 bình luận.

Khi được đặt, bạn cũng phải đặt suggestionsViewMode thành SUGGESTIONS_INLINE. Nếu không, hệ thống sẽ trả về lỗi 400 yêu cầu không hợp lệ.

CommentThread

Đại diện cho một chuỗi bình luận.

Biểu diễn dưới dạng JSON 
{
  "commentId": string,
  "anchorId": string,
  "headPost": {
    object (Post)
  },
  "replies": [
    {
      object (Post)
    }
  ],
  "status": enum (Status),

  "plainTextQuote": string
}
Trường
commentId

string

Mã nhận dạng duy nhất của chuỗi bình luận.
anchorId

string

Mã nhận dạng của CommentAnchor trong tài liệu mà luồng này được liên kết. Nhiều chuỗi bình luận có thể được liên kết với cùng một CommentAnchor.
headPost

object (Post)

Bài đăng đầu tiên trong chuỗi.
replies[]

object (Post)

Trả lời bài đăng gốc.
status

enum (Status)

Cho dù chuỗi thảo luận đang mở hay đã được giải quyết.
Văn bản được trích dẫn trong tài liệu khi bình luận được tạo. Sau đây là danh sách các trường loại trừ lẫn nhau. Tối đa một trong các trường sẽ được đặt trong phản hồi:
plainTextQuote

string

Văn bản được trích dẫn trong tài liệu khi bình luận được tạo, được định dạng dưới dạng văn bản thuần tuý.
Kết thúc các trường loại trừ lẫn nhau.

Đăng

Biểu thị một bài đăng trong chuỗi bình luận hoặc đề xuất.

Biểu diễn dưới dạng JSON 
{
  "postId": string,
  "content": string,
  "contentHtml": string,
  "author": {
    object (PostAuthor)
  },
  "createTime": string,
  "updateTime": string,
  "deleted": boolean,
  "fromImportedDocument": boolean,
  "fromCopiedDocument": boolean,
  "fromDocumentComparison": boolean,
  "assigneeEmail": string,

  "commentAction": enum (CommentActionType),
  "suggestionAction": enum (SuggestionActionType)
}
Trường
postId

string

Chỉ có đầu ra. Mã nhận dạng duy nhất của bài đăng.
content

string

Nội dung của bài đăng.

Bạn phải điền thông tin nếu commentAction không phải là RESOLVE hoặc REOPEN.

Nội dung văn bản này sẽ được xử lý tương tự như các bình luận được tạo trong trình chỉnh sửa Tài liệu. Thẻ này sẽ có các hành vi tương tự đối với việc định dạng, thông báo, v.v.

Không được vượt quá 2048 đơn vị mã UTF-8.
contentHtml

string

Chỉ có đầu ra. Nội dung của bài đăng dưới dạng HTML.
author

object (PostAuthor)

Chỉ có đầu ra. Người dùng đã tạo bài đăng.
createTime

string (Timestamp format)

Chỉ có đầu ra. Thời điểm tạo bài đăng.
updateTime

string (Timestamp format)

Chỉ có đầu ra. Thời gian cập nhật bài đăng gần đây nhất.
deleted

boolean

Chỉ có đầu ra. Bài đăng có bị xoá hay không. Nếu true, content và author, các trường này sẽ trống.
fromImportedDocument

boolean

Chỉ có đầu ra. Bài đăng có phải là từ một tài liệu được nhập hay không. Phương thức gọi không thể đặt trực tiếp trường này.
fromCopiedDocument

boolean

Chỉ có đầu ra. Bài đăng có phải là từ một tài liệu được sao chép hay không. Phương thức gọi không thể đặt trực tiếp trường này.
fromDocumentComparison

boolean

Chỉ có đầu ra. Bài đăng có phải là từ một bản so sánh tài liệu hay không. Phương thức gọi không thể đặt trực tiếp trường này.
assigneeEmail

string

Không bắt buộc. Email của người dùng mới được chỉ định cho chuỗi trong bài đăng này.

Trả về lỗi 400 yêu cầu không hợp lệ nếu:
Hành động được thực hiện trong quá trình tạo bài đăng. Sau đây là danh sách các trường loại trừ lẫn nhau. Tối đa một trong các trường sẽ được đặt trong phản hồi:
commentAction

enum (CommentActionType)

Không bắt buộc. Loại hành động đối với bài đăng bình luận.
suggestionAction

enum (SuggestionActionType)

Chỉ có đầu ra. Loại hành động cho bài đăng đề xuất.
Kết thúc các trường loại trừ lẫn nhau.

PostAuthor

Đại diện cho người dùng đã viết một bình luận hoặc bài đăng đề xuất.

Biểu diễn dưới dạng JSON 
{
  "displayName": string,
  "me": boolean,
  "anonymous": boolean,
  "user": string
}
Trường
displayName

string

Tên hiển thị của người dùng. Có thể không có nếu tác giả là người ẩn danh.
me

boolean

Người dùng có phải là người dùng đã xác thực đưa ra yêu cầu hay không.
anonymous

boolean

Người dùng có ẩn danh hay không.
user

string

Tên tài nguyên của người dùng là tác giả bài đăng. Tên này cũng có thể dùng để xác định người dùng trong Google People API. Định dạng: users/{user}. Sẽ không được điền sẵn nếu trường ẩn danh là true hoặc nếu bài đăng là từ một tài liệu được nhập.

CommentActionType

Hành động được thực hiện đối với câu trả lời này trong một chuỗi bình luận.

Enum
COMMENT_ACTION_TYPE_UNSPECIFIED Giá trị mặc định. Giá trị này không được dùng.
NO_COMMENT_ACTION_CHANGE Không có thay đổi nào về hành động trong bài đăng này.
RESOLVE Bài đăng này sẽ giải quyết vấn đề trong chuỗi.
REOPEN Bài đăng này sẽ mở lại chuỗi thảo luận.

SuggestionActionType

Hành động được thực hiện với câu trả lời này cho một chuỗi đề xuất.

Enum
SUGGESTION_ACTION_TYPE_UNSPECIFIED Giá trị mặc định. Giá trị này không được dùng.
NO_SUGGESTION_ACTION_CHANGE Không có thay đổi nào về hành động trong bài đăng này.
ACCEPT Bài đăng này chấp nhận đề xuất.
REJECT Bài đăng này từ chối đề xuất.

Trạng thái

Các lựa chọn về trạng thái của chuỗi bình luận.

Enum
STATUS_UNSPECIFIED Giá trị mặc định. Giá trị này không được dùng.
OPEN Chuỗi bình luận đang mở.
RESOLVED Chuỗi bình luận đã được giải quyết.

SuggestionThread

Đại diện cho một chuỗi đề xuất duy nhất. Các chuỗi đề xuất được tạo ra như một sản phẩm phụ của việc lưu các thay đổi đối với tài liệu ở chế độ đề xuất và không thể tạo trực tiếp.

Biểu diễn dưới dạng JSON 
{
  "suggestionId": string,
  "headPost": {
    object (Post)
  },
  "replies": [
    {
      object (Post)
    }
  ],
  "status": enum (Status),
  "summaryText": string,
  "summaryHtml": string
}
Trường
suggestionId

string

Mã nhận dạng duy nhất của đề xuất.
headPost

object (Post)

Bài đăng đầu tiên trong chuỗi.
replies[]

object (Post)

Trả lời bài đăng gốc.
status

enum (Status)

Cho biết luồng có đang mở, đã được chấp nhận hay bị từ chối hay không.
summaryText

string

Tóm tắt những điểm khác biệt được đề xuất trong tài liệu, ở dạng văn bản thuần tuý. Có thể trống.
summaryHtml

string

Tóm tắt những điểm khác biệt được đề xuất trong tài liệu, ở định dạng HTML. Có thể trống.

Trạng thái

Các lựa chọn về trạng thái của chuỗi đề xuất.

Enum
STATUS_UNSPECIFIED Giá trị mặc định. Giá trị này không được dùng.
OPEN Chuỗi đề xuất đang mở.
ACCEPTED Đề xuất đã được chấp nhận.
REJECTED Chuỗi đề xuất bị từ chối.

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

 Lấy phiên bản mới nhất của tài liệu được chỉ định.