REST Resource: documents

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

Một tài liệu trên Google Tài liệu.

Biểu diễn dưới dạng JSON 
{
  "documentId": string,
  "title": string,
  "tabs": [
    {
      object (Tab)
    }
  ],
  "revisionId": string,
  "suggestionsViewMode": enum (SuggestionsViewMode),
  "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 giấy tờ.
title

string

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

object (Tab)

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

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

string

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

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

enum (SuggestionsViewMode)

Chỉ có đầu ra. Chế độ xem đề xuất đã á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 để hiển thị nội dung tài liệu thực tế trên tất cả các thẻ khi tham số includeTabsContent được đặt thành true. Nếu bạn đặt chính sách false hoặc không đặt, trường này sẽ chứa thông tin về thẻ đầu tiên trong tài liệu.
headers

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

Chỉ có đầu ra. Các tiêu đề trong tài liệu, được nhập bởi mã tiêu đề.

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

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

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

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

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

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

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

object (DocumentStyle)

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

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

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

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

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

object (NamedStyles)

Chỉ có đầu ra. Kiểu được đặt tên của tài liệu.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

object (DocumentTab)

Một thẻ có nội dung tài liệu, chẳng hạn như văn bản và hình ảnh.

TabProperties

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

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

string

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

string

Tên thẻ mà người dùng nhìn thấy.
parentTabId

string

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

integer

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

integer

Chỉ có đầu ra. Chiều 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))

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

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

Chân trang trong thẻ tài liệu, có 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ó mã nhận dạng chú thích cuối trang.
documentStyle

object (DocumentStyle)

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

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

Những thay đổi đề xuất cho kiểu của thẻ tài liệu, được khoá bởi mã đề xuất.
namedStyles

object (NamedStyles)

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

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

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

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

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

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

Dải ô được đặt tên trong thẻ tài liệu, được nhập theo tên.
inlineObjects

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

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

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

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

Nội dung

Nội dung tài liệu.

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

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

object (StructuralElement)

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

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

StructuralElement

Cấu trúc mô tả nội dung tạo nên 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ỉ số bắt đầu từ 0 của phần tử cấu trúc này, theo đơn vị mã UTF-16.
endIndex

integer

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

object (Paragraph)

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

object (SectionBreak)

Kiểu 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 bản. Đoạn là một dải nội dung được kết thúc bằng một ký tự dòng mới.

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

object (ParagraphElement)

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

object (ParagraphStyle)

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

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

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

object (Bullet)

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

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

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

string

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

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

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

ParagraphElement

ĐoạnElement mô tả nội dung trong một 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 từ 0 của phần tử đoạn này, theo đơn vị mã UTF-16.
endIndex

integer

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

object (TextRun)

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

object (AutoText)

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

object (PageBreak)

Phần tử đoạn ngắt trang.
columnBreak

object (ColumnBreak)

Một phần tử của đoạn có ngắt cột.
footnoteReference

object (FootnoteReference)

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

object (HorizontalRule)

Phần tử đoạn quy tắc ngang.
equation

object (Equation)

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

object (InlineObjectElement)

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

object (Person)

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

TextRun

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

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

string

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

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

string

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

string

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

object (TextStyle)

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

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

Các thay đổi kiểu văn bản đề xuất cho lần chạy này, được khoá bởi mã đề xuất.

TextStyle

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

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

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

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

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

boolean

Văn bản có hiển thị ở dạng in đậm hay không.
italic

boolean

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

boolean

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

boolean

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

boolean

Liệu văn bản có được viết hoa cỡ 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 màu trong suốt, tuỳ thuộc vào trường color.
foregroundColor

object (OptionalColor)

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

object (Dimension)

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

object (WeightedFontFamily)

Bộ phông chữ và độ đậm hiển thị của văn bản.

Nếu yêu cầu cập nhật chỉ định các 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, thì giá trị mặc định sẽ là 400.

Nếu bạn đặt weightedFontFamily, thì weightedFontFamily#fontFamily cũng phải được đặt bằng một giá trị không trống. Nếu không, hệ thống sẽ trả về lỗi 400 với yêu cầu không hợp lệ.
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 cơ sở SUPERSCRIPT hoặc SUBSCRIPT được tự động hiển thị ở cỡ chữ nhỏ hơn, được tính toán dựa trên trường fontSize. Các thay đổi trong trường này không ảnh hưởng đến fontSize.

OptionalColor

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

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

object (Color)

Nếu được đặt, màu này sẽ được sử dụng làm màu mờ. Nếu bạn không đặt chính sách này thì màu này sẽ là 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 sắc, từ 0,0 đến 1,0.

Phương diện

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

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

number

Cường độ.
unit

enum (Unit)

Đơn vị cho cường độ.

Đơn vị

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

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

WeightedFontFamily

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

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

string

Bộ phông chữ của văn bản.

Bộ phông chữ có thể là bất kỳ phông chữ nào từ trình đơn Phông chữ trong Tài liệu hoặc trong Google Fonts. Nếu không nhận dạng được tên phông chữ, thì văn bản sẽ hiển thị trong Arial.
weight

integer

Độ đậm của phông chữ. Trường này có thể có bất kỳ giá trị nào là bội số của 100 từ 100 đến 900. Phạm vi này tương ứng với các giá trị số được mô tả trong Thông số kỹ thuật CSS 2.1, mục 15.6, với các giá trị không phải là số không được phép.

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

Độ đậm phông chữ chỉ chiếm một thành phần của độ đậm phông chữ được hiển thị. Tổ hợp giá trị weight và bold đã được phân giải của kiểu văn bản sẽ xác định trọng số hiển thị, 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ì độ đậm được kết xuất sẽ là 400.
  • Nếu văn bản được in đậm và trọng số lớn hơn hoặc bằng 400 nhưng nhỏ hơn 700, thì độ đậm hiển thị sẽ là 700.
  • Nếu trọng số lớn hơn hoặc bằng 700 thì trọng số được kết xuất sẽ bằng trọng số.
  • Nếu văn bản không được in đậm, thì độ đậm sẽ bằng trọng lượng.

BaselineOffset

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

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

SuggestedTextStyle

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

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

object (TextStyle)

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

object (TextStyleSuggestionState)

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

TextStyleSuggestionState

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

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

AutoText

ParagraphElement thể hiện một vị trí trong văn bản và được thay thế linh động bằng nội dung có thể thay đổi theo thời gian, 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

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

string

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

object (TextStyle)

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

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

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

Loại

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

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

PageBreak

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

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

string

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

string

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

object (TextStyle)

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

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

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

Các thay đổi kiểu văn bản được đề xuất cho Ngắt trang này, được khóa theo mã đề xuất.

ColumnBreak

ParagraphElement đại diện cho một ngắt cột. 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

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

string

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

object (TextStyle)

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

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

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

Các thay đổi kiểu văn bản được đề xuất cho CộtBreak này, được khoá theo mã đề xuất.

FootnoteReference

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

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

string

Mã nhận dạng của footnote chứa nội dung của phần tham chiếu đến chú thích cuối trang này.
footnoteNumber

string

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

string

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

string

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

object (TextStyle)

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

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

Các thay đổi kiểu văn bản đề xuất cho FootnoteReference này, được khóa theo mã đề xuất.

HorizontalRule

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

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

string

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

string

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

object (TextStyle)

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

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

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

Kiểu văn bản được đề xuất thay đổi thành HorizontalRule này, được khoá bởi ID đề 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

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

string

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

InlineObjectElement

ParagraphElement chứa InlineObject.

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

string

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

string

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

string

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

object (TextStyle)

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

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

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

Các thay đổi kiểu văn bản được đề xuất cho InlineObject này, được khóa theo mã đề xuất.

Người

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

string

Mã của các đề xuất xoá đường liên kết đến người này khỏi tài liệu. Một Person có thể có nhiều mã xoá nếu có nhiều người dùng đề xuất xoá. Nếu trống, thì hệ thống sẽ không đề xuất đường liên kết đến người này để 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 đề xuất thay đổi thành Person này, được khoá theo mã đề xuất.
personProperties

object (PersonProperties)

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

PersonProperties

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

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

string

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

string

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

RichLinkProperties

Thuộc tính dành riêng cho RichLink.

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

string

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

string

Chỉ có đầu ra. URI đến RichLink. Điều này luôn tồn tại.
mimeType

string

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

ParagraphStyle

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

Kiểu đoạn kế thừa được biểu thị dưới dạng các trường chưa được đặt trong thông báo này. Cấp độ gốc của kiểu đoạn phụ thuộc vào nơi kiểu đoạn được xác định:

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

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

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

string

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

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

enum (NamedStyleType)

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

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

enum (Alignment)

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

number

Khoảng cách giữa các dòng, dưới dạng tỷ lệ phần trăm bình thường, trong khi bình thường được biểu thị là 100,0. Nếu bạn không đặt chính sách này, thì giá trị sẽ được kế thừa từ đơn vị tổ chức mẹ.
direction

enum (ContentDirection)

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

enum (SpacingMode)

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

object (Dimension)

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

object (Dimension)

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

object (ParagraphBorder)

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

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

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

object (ParagraphBorder)

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

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

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

object (ParagraphBorder)

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

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

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

object (ParagraphBorder)

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

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

object (ParagraphBorder)

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

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

object (Dimension)

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

object (Dimension)

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

object (Dimension)

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

object (TabStop)

Danh sách thẻ sẽ dừng cho đoạn này. Danh sách tab dừng không được kế thừa.

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

boolean

Liệu tất cả các dòng của đoạn có được bố trí trên cùng một trang hoặc cột hay không (nếu có thể). Nếu bạn không đặt chính sách này, thì giá trị sẽ được kế thừa từ đơn vị tổ chức mẹ.
keepWithNext

boolean

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

boolean

Liệu có tránh góa phụ và trẻ mồ côi cho đoạn văn hay không. Nếu bạn không đặt chính sách này, thì giá trị sẽ được kế thừa từ đơn vị tổ chức mẹ.
shading

object (Shading)

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

boolean

Đoạn hiện tại có phải luôn bắt đầu ở đầu trang hay không. Nếu bạn không đặt chính sách này, thì giá trị sẽ được kế thừa từ đơn vị tổ chức mẹ.

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

NamedStyleType

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

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

Căn chỉnh

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

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

ContentDirection

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

Enum
CONTENT_DIRECTION_UNSPECIFIED Chưa xác định hướng nội dung.
LEFT_TO_RIGHT Nội dung di chuyể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ế độ giãn cách đoạn.

Enum
SPACING_MODE_UNSPECIFIED Chế độ giãn cách được kế thừa từ chế độ mẹ.
NEVER_COLLAPSE Độ giãn cách đoạn luôn được hiển thị.
COLLAPSE_LISTS Bỏ qua khoảng cách đoạn giữa các phần tử danh sách.

ParagraphBorder

Đường viền xung quanh đoạn.

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

object (OptionalColor)

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

object (Dimension)

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

object (Dimension)

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

enum (DashStyle)

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

DashStyle

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

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

TabStop

Thẻ dừng trong một đoạn.

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

object (Dimension)

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

enum (TabStopAlignment)

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

TabStopAlignment

Căn chỉnh tab dừng.

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

Tô bóng

Tô bóng một đoạn.

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

object (OptionalColor)

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

SuggestedParagraphStyle

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

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

object (ParagraphStyle)

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

object (ParagraphStyleSuggestionState)

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

ParagraphStyleSuggestionState

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

Biểu diễn dưới dạng JSON 
{
  "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 được đề xuất đối với headingId hay không.
namedStyleTypeSuggested

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

object (ShadingSuggestionState)

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

boolean

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

ShadingSuggestionState

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

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

boolean

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

Dấu đầu dòng

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

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

string

Mã của danh sách chứa đoạn này.
nestingLevel

integer

Mức độ lồng ghép của đoạn này trong danh sách.
textStyle

object (TextStyle)

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

SuggestedBullet

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

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

object (Bullet)

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

object (BulletSuggestionState)

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

BulletSuggestionState

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

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

boolean

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

boolean

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

object (TextStyleSuggestionState)

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

ObjectReferences

Một tập hợp mã đối tượng.

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

string

Mã đối tượng.

SectionBreak

StructuralElement đại diện cho một điểm ngắt mục. Phần là một dải nội dung có cùng SectionStyle. Ngắt mục biểu thị điểm bắt đầu một mục mới và kiểu ngắt mục áp dụng cho mục sau ngắt mục.

Nội dung tài liệu luôn bắt đầu bằng một dấu ngắt mục.

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

string

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

string

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

object (SectionStyle)

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

SectionStyle

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

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

object (SectionColumnProperties)

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

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

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

enum (ColumnSeparatorStyle)

Kiểu 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 mục.

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

enum (ContentDirection)

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

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

object (Dimension)

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

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

object (Dimension)

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

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

object (Dimension)

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

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

object (Dimension)

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

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

object (Dimension)

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

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

enum (SectionType)

Chỉ có đầu ra. Loại phần.
defaultHeaderId

string

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

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

string

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

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

string

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

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

string

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

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

string

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

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

boolean

Cho biết liệu có sử dụng mã nhận dạng đầu trang / chân trang đầu tiên cho trang đầu tiên của mục hay không. Nếu bạn không đặt chính sách này, phần tử đầu tiên sẽ kế thừa từ useFirstPageHeaderFooter của DocumentStyle. 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.

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

integer

Số trang bắt đầu đếm số trang cho mục 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 ở 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.

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

boolean

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

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

SectionColumnProperties

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

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

object (Dimension)

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

object (Dimension)

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

ColumnSeparatorStyle

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

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

SectionType

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

Enum
SECTION_TYPE_UNSPECIFIED Loại phần chưa được chỉ định.
CONTINUOUS Phần này bắt đầu ngay sau đoạ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.

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

object (TableRow)

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

string

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

string

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

object (TableStyle)

Kiểu 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ỉ số bắt đầu dựa trên 0 của hàng này, theo đơn vị mã UTF-16.
endIndex

integer

Chỉ số kết thúc bằng 0 của hàng này, không bao gồm, theo đơn vị mã UTF-16.
tableCells[]

object (TableCell)

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

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

string

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

string

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

object (TableRowStyle)

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

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

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

TableCell

Nội dung và kiểu của ô 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, theo đơn vị mã UTF-16.
endIndex

integer

Chỉ số kết thúc bằng 0 của ô này (không bao gồm giá trị) theo đơn vị mã UTF-16.
content[]

object (StructuralElement)

Nội dung của ô.
tableCellStyle

object (TableCellStyle)

Kiểu của ô.
suggestedInsertionIds[]

string

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

string

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

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

Các thay đổi đề xuất cho kiểu ô của bảng, được khoá theo mã đề xuất.

TableCellStyle

Kiểu của TableCell.

Kiểu ô bảng kế thừa được biểu thị dưới dạng các trường chưa được đặ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

Khoảng cách hàng của ô.

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

integer

Khoảng cột của ô.

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

object (OptionalColor)

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

object (TableCellBorder)

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

object (TableCellBorder)

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

object (TableCellBorder)

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

object (TableCellBorder)

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

object (Dimension)

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

object (Dimension)

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

object (Dimension)

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

object (Dimension)

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

enum (ContentAlignment)

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

TableCellBorder

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

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

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

object (OptionalColor)

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

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

object (Dimension)

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

enum (DashStyle)

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

ContentAlignment

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

Được lấy từ một tập hợp con các giá trị của "ST_TextAnchoringType" loại đơn giản trong phần 20.1.10.59 của "Định dạng tệp Office Open XML – Tài liệu tham khảo về cơ bản và ngôn ngữ đánh dấu", phần 1 của ECMA-376 phiên bản thứ 4.

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

SuggestedTableCellStyle

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

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

object (TableCellStyle)

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

object (TableCellStyleSuggestionState)

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

TableCellStyleSuggestionState

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

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

TableRowStyle

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

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

object (Dimension)

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

boolean

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

boolean

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

SuggestedTableRowStyle

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

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

object (TableRowStyle)

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

object (TableRowStyleSuggestionState)

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

TableRowStyleSuggestionState

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

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

boolean

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

TableStyle

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

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

object (TableColumnProperties)

Thuộc tính của mỗi cột.

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

TableColumnProperties

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

TableOfContents

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

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

object (StructuralElement)

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

string

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

string

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

Chú thích cuối trang

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

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

string

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

object (StructuralElement)

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

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

DocumentStyle

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

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

object (Background)

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

string

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

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

string

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

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

string

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

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

string

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

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

string

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

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

boolean

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

boolean

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

integer

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

object (Dimension)

Lề trang trên cùng.

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

object (Dimension)

Lề trang dưới cùng.

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

object (Dimension)

Lề trang phải.

Cập nhật lề trang phải trên kiểu tài liệu sẽ xóa lề trang phải trên tất cả các kiểu mục. Việ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.
marginLeft

object (Dimension)

Lề trang bên trái.

Cập nhật lề trang bên trái trên kiểu tài liệu sẽ xóa lề trang bên trái trên tất cả các kiểu mục. Việ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.
pageSize

object (Size)

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

object (Dimension)

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

boolean

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

Thông tin khái quát

Đại diện cho nền của 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.

SuggestedDocumentStyle

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

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

object (DocumentStyle)

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

object (DocumentStyleSuggestionState)

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

DocumentStyleSuggestionState

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

Biểu diễn dưới dạng JSON 
{
  "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 theo đề xuất này.
defaultHeaderIdSuggested

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

object (SizeSuggestionState)

Mặt nạ cho biết trường nào có giá trị [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 được đề xuất đối với marginHeader hay không.
flipPageOrientationSuggested

boolean

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

BackgroundSuggestionState

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

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

boolean

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

SizeSuggestionState

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

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

boolean

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

boolean

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

NamedStyles

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

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

object (NamedStyle)

Kiểu được đặt tên.

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

NamedStyle

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

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

enum (NamedStyleType)

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

object (TextStyle)

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

object (ParagraphStyle)

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

SuggestedNamedStyles

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

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

object (NamedStyles)

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

object (NamedStylesSuggestionState)

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

NamedStylesSuggestionState

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

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

object (NamedStyleSuggestionState)

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

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

NamedStyleSuggestionState

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

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

enum (NamedStyleType)

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

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

object (TextStyleSuggestionState)

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

object (ParagraphStyleSuggestionState)

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

Danh sách

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

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

object (ListProperties)

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

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

Những thay đổi đề xuất đối với thuộc tính của danh sách, được khoá bởi mã đề xuất.
suggestedInsertionId

string

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

string

Mã xoá được đề xuất. Nếu trống, thì không có đề xuất xóa 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 bản liên kết với một danh sách.

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

object (NestingLevel)

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

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

NestingLevel

Chứa các thuộc tính mô tả giao diện của một dấu đầu dòng danh sách ở một cấp độ lồng nhau nhất định.

Biểu diễn dưới dạng JSON 
{
  "bulletAlignment": enum (BulletAlignment),
  "glyphFormat": string,
  "indentFirstLine": {
    object (Dimension)
  },
  "indentStart": {
    object (Dimension)
  },
  "textStyle": {
    object (TextStyle)
  },
  "startNumber": integer,

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

enum (BulletAlignment)

Căn chỉnh dấu đầu dòng trong không gian được chia để kết xuất dấu đầu dòng.
glyphFormat

string

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

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

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

A.

B.

C.

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

1.

2.

2.1.

2.2.

3.

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

object (Dimension)

Số lượng thụt lề cho dòng đầu tiên của đoạn ở cấp độ lồng nhau này.
indentStart

object (Dimension)

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

object (TextStyle)

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

integer

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

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

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

enum (GlyphType)

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

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

string

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

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

BulletAlignment

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

Enum
BULLET_ALIGNMENT_UNSPECIFIED Chưa xác đị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 không gian được phân bổ để kết xuất dấu đầu dòng. Căn trái đối với văn bản LTR, nếu không thì căn phải.
CENTER Dấu đầu dòng được căn chỉnh với chính giữa của không gian được phân bổ để kết xuất dấu đầu dòng.
END Dấu đầu dòng được căn chỉnh với cuối không gian được phân bổ để kết xuất dấu đầu dòng. Căn phải đối với văn bản LTR, nếu không thì căn trái.

GlyphType

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

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

SuggestedListProperties

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

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

object (ListProperties)

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

object (ListPropertiesSuggestionState)

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

ListPropertiesSuggestionState

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

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

object (NestingLevelSuggestionState)

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

Các trạng thái đề xuất mức lồng ghép được trả về theo thứ tự tăng dần của mức lồng nhau với mức lồng ghép ít nhất được trả về đầu tiên.

NestingLevelSuggestionState

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

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

object (TextStyleSuggestionState)

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

boolean

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

NamedRanges

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

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

string

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

object (NamedRange)

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

NamedRange

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

Dải ô được đặt tên cho phép nhà phát triển liên kết các phần của tài liệu với nhãn do người dùng xác định tuỳ ý để nội dung của chúng có thể được đọc hoặc chỉnh sửa bằng chương trình vào lúc khác. 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 duy nhất.

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

Dải ô được đặt tên không riêng tư. Tất cả cá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 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ã của dải ô được đặt tên.
name

string

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

object (Range)

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

Phạm vi

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

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

integer

Chỉ số bắt đầu từ 0 của dải ô này, theo đơn vị mã UTF-16.

Trong tất 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à một Int32Value để phù hợp với các trường hợp sử dụng sau này với phạm vi kết thúc mở.
endIndex

integer

Chỉ số kết thúc bằng 0 của dải ô này, không bao gồm, theo đơn vị mã UTF-16.

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

string

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

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

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

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

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

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

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

InlineObject

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

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

string

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

object (InlineObjectProperties)

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

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

Các thay đổi đề xuất đối với các thuộc tính của đối tượng cùng dòng, được khoá theo mã đề xuất.
suggestedInsertionId

string

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

string

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

InlineObjectProperties

Thuộc tính của InlineObject.

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

object (EmbeddedObject)

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

EmbeddedObject

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

object (Dimension)

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

object (Dimension)

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

object (Dimension)

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

object (LinkedContentReference)

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

Nếu bạn không đặt chính sách này, thì đối tượng được nhúng sẽ không được liên kết.
Trường kết hợp properties. Các thuộc tính dành riêng cho từng loại đối tượng được nhúng. properties chỉ có thể là một trong những trạng thái sau đây:
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 thông tin chi tiết không được hỗ trợ.

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

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ẻ với tài khoản của người yêu cầu. Bất cứ ai có URI đều truy cập hiệu quả hình ảnh đó với tư cách là người yêu cầu ban đầu. Quyền truy cập vào hình ảnh có thể bị mất nếu chế độ cài đặt cách chia sẻ của tài liệu thay đổi.
sourceUri

string

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

number

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

number

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

number

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

object (CropProperties)

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

number

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

CropProperties

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

Hình chữ nhật cắt được biểu thị bằng độ 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ẽ được đặt 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ẽ được đặt bên ngoài hình chữ nhật ranh giới ban đầu của hình ảnh.
  • Nếu tất cả các giá trị bù trừ và góc xoay 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

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

number

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

number

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

number

Độ lệch chỉ định khoảng cách vào trong cạnh dưới của hình chữ nhật cắt so với cạnh dưới cùng của nội dung gốc, tính bằng tỷ lệ 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, tính bằng radian. Chế độ xoay được áp dụng sau độ lệch.

EmbeddedObjectBorder

Đường viền xung quanh EmbeddedObject.

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

object (OptionalColor)

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

object (Dimension)

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

enum (DashStyle)

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

enum (PropertyState)

Trạng thái thuộc tính của thuộc tính biên giới.

PropertyState

Các trạng thái có thể có của một thuộc tính.

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

LinkedContentReference

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 kết hợp reference. Tệp tham chiếu cụ thể 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 đây:
sheetsChartReference

object (SheetsChartReference)

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

SheetsChartReference

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

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

string

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

integer

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

SuggestedInlineObjectProperties

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

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

object (InlineObjectProperties)

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

object (InlineObjectPropertiesSuggestionState)

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

InlineObjectPropertiesSuggestionState

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

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

object (EmbeddedObjectSuggestionState)

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

EmbeddedObjectSuggestionState

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

Biểu diễn dưới dạng JSON 
{
  "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 theo đề xuất này.
imagePropertiesSuggestionState

object (ImagePropertiesSuggestionState)

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

boolean

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

boolean

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

object (EmbeddedObjectBorderSuggestionState)

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

object (SizeSuggestionState)

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

boolean

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

boolean

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

boolean

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

boolean

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

object (LinkedContentReferenceSuggestionState)

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

EmbeddedDrawingPropertiesSuggestionState

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

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

ImagePropertiesSuggestionState

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

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

boolean

Cho biết liệu có thay đổi được đề xuất đối với 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].
brightnessSuggested

boolean

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

boolean

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

boolean

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

object (CropPropertiesSuggestionState)

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

boolean

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

CropPropertiesSuggestionState

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

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

EmbeddedObjectBorderSuggestionState

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

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

boolean

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

boolean

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

boolean

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

boolean

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

LinkedContentReferenceSuggestionState

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

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

object (SheetsChartReferenceSuggestionState)

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

SheetsChartReferenceSuggestionState

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

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

boolean

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

boolean

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

PositionedObject

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

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

string

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

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

string

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

string

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

PositionedObjectProperties

Thuộc tính của PositionedObject.

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

object (PositionedObjectPositioning)

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

object (EmbeddedObject)

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

PositionedObjectPositioning

Vị trí của PositionedObject. Đối tượng đã định vị được định vị tương ứng với phần đầu của Paragraph mà đối tượng được chia sẻ Internet.

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

enum (PositionedObjectLayout)

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

object (Dimension)

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

object (Dimension)

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

PositionedObjectLayout

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

Enum
POSITIONED_OBJECT_LAYOUT_UNSPECIFIED Chưa xác định bố cục.
WRAP_TEXT Văn bản bao quanh đối tượng được định vị.
BREAK_LEFT Ngắt văn bản sao cho đối tượng được định vị nằm ở 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ị nằm ở bên phải và văn bản ở bên trái.
BREAK_LEFT_RIGHT Ngắt văn bản sao cho không có văn bản nào ở bên trái hoặc bên phải của đối tượng được định vị.
IN_FRONT_OF_TEXT Đối tượng được định vị nằm ở phía trước văn bản.
BEHIND_TEXT Đối tượng được định vị nằm phía sau văn bản.

SuggestedPositionedObjectProperties

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

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

object (PositionedObjectProperties)

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

object (PositionedObjectPropertiesSuggestionState)

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

PositionedObjectPropertiesSuggestionState

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

Biểu diễn dưới dạng JSON 
{
  "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 theo đề xuất này.
embeddedObjectSuggestionState

object (EmbeddedObjectSuggestionState)

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

PositionedObjectPositioningSuggestionState

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

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

boolean

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

boolean

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

boolean

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

SuggestionsViewMode

Chế độ xem nội dung đề 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. Tính năng này cung cấp các lựa chọn để đọc tài liệu cùng tất cả các đề xuất cùng dòng, chấp nhận hoặc từ chối.

Enum
DEFAULT_FOR_CURRENT_ACCESS Đề xuấtViewMode được áp dụng cho tài liệu được trả về phụ thuộc vào cấp truy cập hiện tại của người dùng. Nếu người dùng chỉ có quyền xem, thì PREVIEW_WITHOUT_SUGGESTIONS sẽ được áp dụng. Nếu không, SUGGESTIONS_INLINE sẽ được áp dụng. Đây là chế độ xem đề xuất mặc định.
SUGGESTIONS_INLINE

Tài liệu được trả về có các đề xuất cùng dòng. Các thay đổi được đề xuất sẽ được phân biệt với nội dung cơ sở trong tài liệu.

Yêu cầu truy xuất tài liệu bằng chế độ này sẽ trả về lỗi 403 nếu người dùng không có quyền xem các thay đổi được đề xuất.
PREVIEW_SUGGESTIONS_ACCEPTED

Tài liệu được trả về là bản xem trước có tất cả các thay đổi đề xuất đã được chấp nhận.

Yêu cầu truy xuất tài liệu bằng chế độ này sẽ trả về lỗi 403 nếu người dùng không có quyền xem các thay đổi được đề xuất.
PREVIEW_WITHOUT_SUGGESTIONS Tài liệu được trả về là bản xem trước trong đó tất cả các thay đổi được đề xuất đều 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 tài liệu trống bằng cách sử dụng tiêu đề đã cung cấp trong yêu cầu.

get

 Tải phiên bản mới nhất của tài liệu đã chỉ định.