REST Resource: documents

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

Một tài liệu Google Tài liệu.

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

string

Chỉ có đầu ra. Mã nhận dạng của chứng từ.
title

string

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

object (Tab)

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ã phiên bản 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 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ã 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. Mã nhận dạng bản sửa đổi được trả về chỉ được đảm bảo là hợp lệ trong 24 giờ sau khi được trả về và không thể chia sẻ giữa các người dùng. Nếu mã nhận dạng 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, một mã nhận dạng đã thay đổi (cho cùng một tài liệu và người dùng) 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.
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 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.
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 cuối trang trong tài liệu, được khoá bằng mã nhận dạng chú thích cuối trang.

Trường cũ: Thay vào đó, hãy sử dụng Document.tabs.documentTab.footnotes. 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 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.
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 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.
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á bằng 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ã nhận dạng 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á theo 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 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.

Tab

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

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

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

object (TabProperties)

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

object (Tab)

Các thẻ con nằm trong thẻ này.
Trường nhóm content. Nội dung của thẻ. content chỉ có thể là một trong những trạng thái sau:
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.

TabProperties

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

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

string

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

string

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

string

Không bắt buộc. Mã của thẻ mẹ. Trống khi thẻ hiện tại là thẻ cấp 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.

DocumentTab

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

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

object (Body)

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))

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

object (DocumentStyle)

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

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

Các thay đổi được đề xuất đối với kiểu của thẻ tài liệu, được khoá theo mã đề 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.

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.

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

StructuralElement

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

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

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

integer

Chỉ mục bắt đầu dựa trên 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 số 0 của phần tử cấu trúc này, độc quyền, trong các đơn vị mã UTF-16.
Trường nhóm content. Nội dung của phần tử cấu trúc. content chỉ có thể là một trong những trạng thái sau:
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)

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

Đoạn

StructuralElement đại diện cho một đoạn văn. Đ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 phần cấu thành.
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 cho dấu đầu dòng của đoạn vă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 Paragraph.

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

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

integer

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

integer

Chỉ mục kết thúc cơ sở bằng 0 của phần tử đoạn văn này, độc quyền, trong các đơn vị mã UTF-16.
Trường nhóm content. Nội dung của phần tử đoạn văn. content chỉ có thể là một trong những trạng thái sau:
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.

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 vă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ã nhận dạng đề xuất xoá. Nếu trống, tức là không có đề xuất nào về việc xoá nội dung này.
textStyle

object (TextStyle)

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

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

Kiểu văn bản được đề xuất thay đổi thành kiểu 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.

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

Cỡ chữ của văn bản.
weightedFontFamily

object (WeightedFontFamily)

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

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

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

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

enum (BaselineOffset)

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

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

OptionalColor

Một màu có thể hoàn toàn 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 bạn không đặt, thì 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

Độ 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

Cường độ.
unit

enum (Unit)

Đơn vị đo độ 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. Phạm vi này tương ứng với các giá trị bằng số được mô tả trong mục 15.6 của Quy cách CSS 2.1, trong đó các giá trị không phải bằng 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 số nhỏ hơn 400, thì trọng số đượ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 lượng lớn hơn hoặc bằng 700, thì trọng lượng được hiển thị sẽ bằng trọng lượng.
  • Nếu văn bản không được in đậm, thì trọng lượng được hiển thị sẽ bằng trọng lượng.

BaselineOffset

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

Enum
BASELINE_OFFSET_UNSPECIFIED Độ lệch đường cơ sở của văn bản được kế thừa từ phần tử mẹ.
NONE Văn bản không bị lệch theo chiều dọc.
SUPERSCRIPT Văn bản được bù theo chiều dọc lên trên (chỉ số trên).
SUBSCRIPT Văn bản được bù 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 cho bold hay không.
italicSuggested

boolean

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

boolean

Cho biết liệu có thay đổi nào được đề xuất cho underline hay không.
strikethroughSuggested

boolean

Cho biết liệu có thay đổi nào được đề xuất cho strikethrough hay không.
smallCapsSuggested

boolean

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

boolean

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

boolean

Cho biết liệu có thay đổi nào được đề xuất cho foregroundColor hay không.
fontSizeSuggested

boolean

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

boolean

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

boolean

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

string

Mã nhận dạng đề xuất xoá. Nếu trống, tức là không có đề xuất nào về việc 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 AutoText 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 chưa được chỉ đị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 thể hiện tổng số trang trong tài liệu.

PageBreak

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

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

string

Mã chèn được đề xuất. Một PageBreak có thể có nhiều mã chèn nếu đó là một thay đổi đượ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ã nhận dạng đề xuất xoá. Nếu trống, tức là không có đề xuất nào về việc 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ư đ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á bằng mã nhận dạng đề xuất.

ColumnBreak

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

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

string

Mã chèn được đề xuất. 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ã nhận dạng đề xuất xoá. Nếu trống, tức là không có đề xuất nào về việc 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ư các đ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á bằng 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 chú thích cuối trang này.
footnoteNumber

string

Số được kết xuất 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ã nhận dạng đề xuất xoá. Nếu trống, tức là không có đề xuất nào về việc 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ã nhận dạng 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ã nhận dạng đề xuất xoá. Nếu trống, tức là không có đề xuất nào về việc 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ư các đoạn văn bản và chú thích cuối trang), kiểu văn bản của một đườ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 đường kẻ đó.
suggestedTextStyleChanges

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

Kiểu văn bản được đề xuất sẽ thay đổi thành HorizontalRule này, được khoá bằng mã 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 đề xuất thay đổi lồng nhau. Nếu trống, thì đây không phải là một đề xuất chèn.
suggestedDeletionIds[]

string

Mã nhận dạng đề xuất xoá. Nếu trống, tức là không có đề xuất nào về việc 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 đề xuất thay đổi lồng nhau. Nếu trống, thì đây không phải là một đề xuất chèn.
suggestedDeletionIds[]

string

Mã nhận dạng đề xuất xoá. Nếu trống, tức là không có đề xuất nào về việc 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ư các đ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 một đề 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á mối liên kết của 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á mã đó. 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 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

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

string

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

string

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

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 sẽ 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ỉ có thể đọc.
namedStyleType

enum (NamedStyleType)

Loại kiểu có 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 khoảng cách bình thường, trong đó khoảng cách bình thường được biểu thị là 100.0. Nếu bạn không đặt, giá trị sẽ được kế thừa từ phần tử mẹ.
direction

enum (ContentDirection)

Hướng văn bản của đoạn này. Nếu bạn không đặt, giá trị mặc định sẽ là LEFT_TO_RIGHT vì hướng đ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ừ phần tử mẹ.
spaceBelow

object (Dimension)

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

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

Không thể cập nhật một phần đường viền đoạn 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ừ phần tử mẹ.

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

Không thể cập nhật một phần đường viền đoạn văn. Khi thay đổi đường viền đoạn 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ừ phần tử mẹ.

Đường viền dưới cùng sẽ đượ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.

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ừ phần tử mẹ.

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ừ phần tử mẹ.

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ừ phần tử 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ừ phần tử 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ừ phần tử 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 phím Tab không được kế thừa.

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

boolean

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

boolean

Liệu ít nhất một phần của đoạn này có nên được bố trí 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ừ phần tử mẹ.
avoidWidowAndOrphan

boolean

Có tránh các dòng đơn lẻ và dòng cuối đoạn cho đoạn văn hay không. Nếu bạn không đặt, giá trị sẽ được kế thừa từ phần tử 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ừ phần tử 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ừ phần tử 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 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 Loại kiểu có tên chưa được chỉ định.
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 từ trái sang phải, căn trái trong trường hợp khác.
JUSTIFIED Đoạn văn được căn đều.

ContentDirection

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

Enum
CONTENT_DIRECTION_UNSPECIFIED Hướng nội dung chưa được chỉ định.
LEFT_TO_RIGHT Nội dung sẽ xuất hiện từ trái sang phải.
RIGHT_TO_LEFT Nội dung sẽ di chuyển 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 đoạn vă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 đường né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 kẻ liền. 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ị ECMA-376 ST_PresetLineDashVal "dash".

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 tab 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 Bạn chưa chỉ định chế độ căn chỉnh điểm dừng của thẻ.
START Điểm dừng phím 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 thẻ được căn chỉnh vào 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ô 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 đổ cho đoạn văn 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 cho headingId hay không.
namedStyleTypeSuggested

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

Cho biết liệu có thay đổi nào được đề xuất cho spaceAbove hay không.
spaceBelowSuggested

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

Cho biết liệu có thay đổi nào được đề xuất cho indentEnd hay không.
keepLinesTogetherSuggested

boolean

Cho biết liệu có thay đổi nào được đề xuất cho keepLinesTogether hay không.
keepWithNextSuggested

boolean

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

boolean

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

object (ShadingSuggestionState)

Một 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 cho 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 cho 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ã 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 cho listId hay không.
nestingLevelSuggested

boolean

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

object (TextStyleSuggestionState)

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

ObjectReferences

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ã nhận dạng đối tượng.

SectionBreak

StructuralElement đại diện cho một điểm ngắt đoạn. Phần là một phạm vi nội dung có cùng SectionStyle. Dấu 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 dấu ngắt đoạn.

Nội dung tài liệu luôn bắt đầu bằng một dấu ngắt đoạ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ã nhận dạng đề xuất xoá. Nếu trống, tức là không có đề xuất nào về việc 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 phần.

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ể. 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ệ.
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ị mặc định sẽ là marginTop trong 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ị mặc định sẽ là marginBottom trong 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ị mặc định sẽ là marginRight trong 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ị mặc định sẽ là marginLeft trong 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 phần. Nếu bạn không đặt, giá trị mặc định sẽ là marginHeader trong 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 tôn trọng 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 phần.
defaultHeaderId

string

Mã của tiêu đề mặc định. Nếu bạn không đặt, giá trị sẽ kế thừa từ SectionBreak's SectionStyle 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ỉ có thể đọc.
firstPageHeaderId

string

Mã nhận dạng của tiêu đề chỉ được dùng cho trang đầu tiên của phần. Nếu useFirstPageHeaderFooter là true, thì 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ừ SectionBreak's SectionStyle 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ỉ có thể đọ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ị này 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ừ SectionBreak's SectionStyle 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ỉ có thể đọc.
evenPageHeaderId

string

Mã nhận dạng của tiêu đề 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 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ẽ sử dụng defaultHeaderId. Nếu bạn không đặt, giá trị sẽ kế thừa từ SectionBreak's SectionStyle 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ỉ có thể đọ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ừ SectionBreak's SectionStyle 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ỉ có thể đọ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 được đặ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 khu vực 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 chính sách này, việc đánh số trang sẽ tiếp tục từ phần trước. Nếu giá trị chưa đượ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 pageSize của DocumentStyle cho phần này hay không. Nhờ đó, bạn có thể 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 Một kiểu dấu phân cách cột chưa chỉ đị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 Mục này bắt đầu trên trang tiếp theo.

Bảng

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

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

integer

Số hàng trong bảng.
columns

integer

Số cột trong bảng.

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ố lượng ô 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ã nhận dạng đề xuất xoá. Nếu trống, tức là không có đề xuất nào về việc 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ã nhận dạng đề xuất xoá. Nếu trống, tức là không có đề xuất nào về việc 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 của ô.
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ã nhận dạng đề xuất xoá. Nếu trống, tức là không có đề xuất nào về việc 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à ô trải dài.

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

integer

Khoảng cột của ô.

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

object (OptionalColor)

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

object (TableCellBorder)

Đường viền bê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ủ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. 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ể đặt đường viền ô của bảng ở chế độ 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 – Kiến thức cơ bản và tài liệu tham khảo về ngôn ngữ đánh dấu", phần 1 của ECMA-376 phiên bản 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 cho rowSpan hay không.
columnSpanSuggested

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

Cho biết liệu có thay đổi nào được đề xuất cho 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ó 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 cho 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)

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 giữa các cột được phân bổ đồng đều khác.

Chiều rộng của cột được xác định tự động và sẽ có phần chiều rộng còn lại bằng nhau 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 biểu thị 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ã nhận dạng 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ã nhận dạng đề xuất xoá. Nếu trống, tức là không có đề xuất nào về việc 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.
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. Tài liệu không được có màu nền trong suốt.
defaultHeaderId

string

Mã của tiêu đề mặc định. Nếu 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ỉ có thể đọ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, thì sẽ không có đầu trang của 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ỉ có thể đọ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, thì sẽ không có chân trang của 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ỉ có thể đọc.
firstPageHeaderId

string

Mã nhận dạng của tiêu đề chỉ dùng cho trang đầu tiên. Nếu bạn không đặt chính sách này, thì sẽ không có tiêu đề riêng 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, thì sẽ không có đầu trang của 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ỉ có thể đọ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 chính sách 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, thì sẽ không có chân trang của 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ỉ có thể đọ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ủ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ả cá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. Thao tác này cũng có thể khiến các cột đổi kích thước trong tất cả các phần.

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ả các kiểu phần. Thao tác này cũng có thể khiến các cột đổi kích thước trong tất cả các phần.

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 vật thể.
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 phân trang.

DocumentMode

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

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

Một 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 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 cho defaultHeaderId hay không.
evenPageHeaderIdSuggested

boolean

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

boolean

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

boolean

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

boolean

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

boolean

Cho biết liệu có thay đổi nào được đề xuất cho useFirstPageHeaderFooter hay không.
useEvenPageHeaderFooterSuggested

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

Cho biết liệu có thay đổi nào được đề xuất cho 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 tên này.

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

object (NamedStyle)

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

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

NamedStyle

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 loại kiểu có tên.

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

enum (NamedStyleType)

Loại kiểu có tên này.
textStyle

object (TextStyle)

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

object (ParagraphStyle)

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

SuggestedNamedStyles

Một 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 đã được thay đổi trong đề xuất này.

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

NamedStyleSuggestionState

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

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

enum (NamedStyleType)

Loại kiểu được đặt tên 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 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 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 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ã 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ã nhận dạng đề xuất xoá. 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 độ lồng nhau ít 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 ở 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,

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

enum (BulletAlignment)

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 mà dấu đầu dòng sử 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. Các 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 của 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 bất kỳ.

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 các trình giữ chỗ cho cấp độ lồng ghép hiện tại cũng như các trình giữ chỗ cho cấp độ lồng ghép mẹ. Ví dụ: danh sách có thể có định dạng ký tự %0. ở cấp lồng 0 và định dạng ký tự %0.%1. ở cấp lồng 1. Giả sử cả hai cấp độ lồng nhau đều có các loại ký tự DECIMAL, thì điều này sẽ dẫn đến một danh sách có các ký tự được kết xuất

1.

2.

2.1.

2.2.

3.

Đối với các cấp lồng nhau được sắp xếp, chuỗi thay thế một phần giữ chỗ trong đị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 các đ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ó các glyph không theo thứ tự.
Trường nhóm glyph_kind. Loại ký tự mà dấu đầu dòng sử dụng. Thuộc tính này xác định ký tự dấu đầu dòng thay thế các phần giữ chỗ trong glyph_format. glyph_kind chỉ có thể là một trong những trạng thái sau:
glyphType

enum (GlyphType)

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ự.

Loại ký tự xác định loại ký tự được 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.

BulletAlignment

Các loại căn chỉnh cho dấu đầu dòng.

Enum
BULLET_ALIGNMENT_UNSPECIFIED Bạn chưa chỉ định cách căn chỉnh dấu đầu dòng.
START Dấu đầu dòng được căn chỉnh với 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 chính 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 vào 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 từ trái sang phải, 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 glyph chưa đượ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 số 0 ở phía trước, 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 Chữ số La Mã viết thường, chẳng hạn như i, ii hoặc iii.

SuggestedListProperties

Một thay đổi đề xuất đối với 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 đã được 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 cho bulletAlignment hay không.
glyphTypeSuggested

boolean

Cho biết liệu có thay đổi nào được đề xuất cho glyphType hay không.
glyphFormatSuggested

boolean

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

boolean

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

boolean

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

boolean

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

object (TextStyleSuggestionState)

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

boolean

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

NamedRanges

Một tập hợp tất cả các NamedRange trong tài liệu có cùng 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 có thể đọc hoặc chỉnh sửa nội dung của các phần đó 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 một dải ô được đặt tên thường sẽ mở rộng dải ô đó. Tuy nhiên, một số thay đổi đố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ã nhận dạng 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 dựa trên 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 (loại trừ), 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ị bỏ qua, yêu cầu sẽ áp dụng cho thẻ đầu tiên.

Trong 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 lẻ.

  • Nếu 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á bằng mã nhận dạng đề xuất.
suggestedInsertionId

string

Mã 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ã nhận dạng đề xuất xoá. Nếu trống, tức là không có đề xuất nào về việc xoá nội dung này.

InlineObjectProperties

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

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

object (EmbeddedObject)

Đối tượng được nhúng của đối tượng 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)
  },

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

string

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

string

Nội dung mô tả 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)

Thông tin tham chiếu đến nội dung nguồn được liên kết bên ngoài. Ví dụ: thông tin này chứa đường liên kết đế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.
Trường nhóm properties. Các thuộc tính dành riêng cho từng loại đối tượng được nhúng. properties chỉ có thể là một trong những trạng thái sau:
embeddedDrawingProperties

object (EmbeddedDrawingProperties)

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

object (ImageProperties)

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

EmbeddedDrawingProperties

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

Các thuộc tính của bản vẽ được nhúng và dùng để phân biệt loại đối tượng. Bản vẽ được nhúng là bản vẽ được tạo và chỉnh sửa trong 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 cứ ai có URI đều có thể truy cập vào hình ảnh như 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 chia sẻ của tài liệu thay đổi.
sourceUri

string

URI nguồn là URI dùng để chèn hình ảnh. Bạn có thể để trống URI nguồn.
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 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 giới hạn ban đầu 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ả cá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 gốc dưới dạng một phần chiều rộng của nội dung gốc.
offsetRight

number

Tham số offset 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

Khoảng chênh lệch này 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 gốc theo tỷ lệ chiều cao của nội dung gốc.
offsetBottom

number

Độ lệch chỉ định khoảng cách vào trong của cạnh dưới của hình chữ nhật cắt so với 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

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

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

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

object (SheetsChartReference)

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

SheetsChartReference

Tham chiếu đến một biểu đồ được liên kết 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 đề xuất đối với 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 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 mặt nạ cho biết trường nào trong embeddedDrawingProperties đã được thay đổi trong đề xuất này.
imagePropertiesSuggestionState

object (ImagePropertiesSuggestionState)

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

boolean

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

boolean

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

object (EmbeddedObjectBorderSuggestionState)

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

object (SizeSuggestionState)

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

boolean

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

boolean

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

boolean

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

boolean

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

object (LinkedContentReferenceSuggestionState)

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

EmbeddedDrawingPropertiesSuggestionState

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

Mặt 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 cho contentUri hay không.
sourceUriSuggested

boolean

Cho biết có thay đổi được đề xuất đố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 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 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 có thay đổi được đề xuất nào đố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 cho offsetLeft hay không.
offsetRightSuggested

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

PositionedObject

Một đối tượng được liên kết với Paragraph và được đặt tương đối so 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ã 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ã nhận dạng đề xuất xoá. Nếu trống, tức là không có đề xuất nào về việc xoá nội dung này.

PositionedObjectProperties

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

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

object (PositionedObjectPositioning)

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

object (EmbeddedObject)

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

PositionedObjectPositioning

Vị trí của PositionedObject. Đối tượng được định vị 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 điểm bắt đầ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 sẽ bao quanh đối tượng được định vị.
BREAK_LEFT Ngắt văn bản để đố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 đặt ở 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 đề xuất đối với 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 mặt nạ cho biết trường nào trong positioning đã được thay đổi trong đề xuất này.
embeddedObjectSuggestionState

object (EmbeddedObjectSuggestionState)

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

PositionedObjectPositioningSuggestionState

Mặt 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 cho layout hay không.
leftOffsetSuggested

boolean

Cho biết liệu có thay đổi nào được đề xuất cho leftOffset hay không.
topOffsetSuggested

boolean

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

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 đượ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ì biểu tượng 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ó bất kỳ đề xuất nào trong tài liệu.

Phương thức

batchUpdate

 Áp dụng một hoặc nhiều nội dung cập nhật cho tài liệu.

create

 Tạo một tài liệu trống bằng tiêu đề được cung cấp trong yêu cầu.

get

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