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 của tài liệu cần áp dụng nội dung cập nhật và cách yêu cầu hoạt động nếu tài liệu đã được chỉnh sửa kể từ bản sửa đổi đó. Chỉ được điền nếu người dùng có quyền chỉnh sửa tài liệu.

Mã sửa đổi không phải là 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ỉ đảm bảo 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ã bản sửa đổi không thay đổi giữa các lệnh gọi, thì tài liệu đó chưa thay đổi. Ngược lại, giấy tờ tuỳ thân đã thay đổi (cho cùng một tài liệu và người dùng) thường có nghĩa là giấy tờ đó đã được cập nhật. Tuy nhiên, mã nhận dạng cũng có thể thay đổi do các yếu tố nội bộ, chẳng hạn như thay đổi định dạng mã nhận dạng.

suggestionsViewMode

enum (SuggestionsViewMode)

Chỉ có đầu ra. Đã áp dụng chế độ xem đề xuất 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 là false hoặc chưa đặt, trường này sẽ chứa thông tin về thẻ đầu tiên trong tài liệu.

headers

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

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

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

footnotes

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

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

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

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 là false hoặc chưa đặt, trường này sẽ chứa thông tin về thẻ đầu tiên trong tài liệu.

suggestedDocumentStyleChanges

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

Chỉ có đầu ra. Những thay đổi đề xuất cho kiểu của tài liệu, được khoá bởi mã đề xuất.

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

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 là false hoặc chưa đặt, trường này chứa thông tin về thẻ đầu tiên trong tài liệu.

suggestedNamedStylesChanges

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

Chỉ có đầu ra. Các thay đổi được đề xuất đối với kiểu được đặt 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 là false hoặc chưa đặt, trường này sẽ chứa thông tin về thẻ đầu tiên trong tài liệu.

lists

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

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

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

Trường cũ: Thay vào đó, hãy sử dụng Document.tabs.documentTab.namedRanges để hiển thị nội dung tài liệu thực tế 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ã nhận dạng đối tượng.

Trường cũ: Thay vào đó, hãy sử dụng Document.tabs.documentTab.inlineObjects để hiển thị nội dung tài liệu thực tế 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 hợp hợp nhất 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ã nhận dạng của thẻ. Bạn không thể thay đổi trường này.

title

string

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

parentTabId

string

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

index

integer

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

nestingLevel

integer

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

DocumentTab

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

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

object (Body)

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

headers

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

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

footers

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

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

footnotes

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

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

documentStyle

object (DocumentStyle)

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

suggestedDocumentStyleChanges

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

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

lists

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

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

namedRanges

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

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

inlineObjects

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

Các đối tượng cùng dòng trong thẻ tài liệu, được khoá theo mã đố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, footersfootnotes.

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

object (StructuralElement)

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

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

StructuralElement

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 hợp hợp nhất 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)

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

table

object (Table)

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

tableOfContents

object (TableOfContents)

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

Đoạn

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

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

object (ParagraphElement)

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

paragraphStyle

object (ParagraphStyle)

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

suggestedParagraphStyleChanges

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

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

bullet

object (Bullet)

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

suggestedBulletChanges

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

Nội dung thay đổi đề xuất cho dấu đầu dòng của đoạn vă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

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

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

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

integer

Chỉ mục bắt đầu 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 có cơ số 0 của phần tử đoạn này, không bao gồm, theo đơn vị mã UTF-16.

Trường kết hợp content. Nội dung của phần tử đoạn văn. content chỉ có thể là một trong những 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 văn bả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 dòng văn bản đều có cùng kiểu.

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

string

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

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

suggestedInsertionIds[]

string

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à nội dung chèn được đề xuất.

suggestedDeletionIds[]

string

Mã nhận dạng đề xuất xoá. 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))

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

TextStyle

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

Kiểu văn bản kế thừa được biểu thị dưới dạng các trường chưa đặt trong thông báo này. 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ì việc huỷ đặt các trường sẽ chuyển kiểu về một giá trị khớp với giá trị mặc định trong trình chỉnh sửa Tài liệu.

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

boolean

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

italic

boolean

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

underline

boolean

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

strikethrough

boolean

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

smallCaps

boolean

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

backgroundColor

object (OptionalColor)

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

foregroundColor

object (OptionalColor)

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

fontSize

object (Dimension)

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

weightedFontFamily

object (WeightedFontFamily)

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

Nếu một yêu cầu cập nhật chỉ định giá trị cho cả weightedFontFamilybold, 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 yêu cầu không hợp lệ 400.

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ột màu có thể hoàn toàn mờ hoặc hoàn toàn trong suốt.

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

object (Color)

Nếu được đặt, màu này sẽ được sử dụng làm màu mờ. Nếu 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 độ lớn.

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

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

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

string

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

Bộ phông chữ có thể là bất kỳ phông chữ nào trong trình đơn Phông chữ trong Tài liệu hoặc trong Google Fonts. Nếu không nhận dạng được tên phông chữ, văn bản sẽ được 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 kết xuất. Tổ hợp giá trị weightbold đã đượ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 hiển thị 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 văn bản có thể được dịch chuyển theo chiều dọc so với vị trí thông thường.

Enum
BASELINE_OFFSET_UNSPECIFIED Độ lệch đường cơ sở của văn bản được kế thừa từ thành phần mẹ.
NONE Văn bản không đượ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 xuống dưới theo chiều dọc (dấu dưới).

SuggestedTextStyle

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

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

object (TextStyle)

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

textStyleSuggestionState

object (TextStyleSuggestionState)

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

TextStyleSuggestionState

Một mặt nạ cho biết trường nào trên TextStyle cơ sở đã được thay đổi trong đề xuất này. 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 nào được đề xuất đối với underline hay không.

strikethroughSuggested

boolean

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

smallCapsSuggested

boolean

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

backgroundColorSuggested

boolean

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

foregroundColorSuggested

boolean

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

fontSizeSuggested

boolean

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

Văn bản tự động

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. AutoText có thể có nhiều mã chèn nếu đó là một thay đổi được đề xuất lồng nhau. Nếu trống thì đây không phải là phần chèn được đề xuất.

suggestedDeletionIds[]

string

Mã nhận dạng đề xuất xoá. 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 Văn bản tự động này.

suggestedTextStyleChanges

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

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

Loại

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

Enum
TYPE_UNSPECIFIED Loại văn bản tự động 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 dấu 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

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

suggestedDeletionIds[]

string

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

textStyle

object (TextStyle)

Kiểu văn bản của 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

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

suggestedDeletionIds[]

string

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

textStyle

object (TextStyle)

Kiểu văn bản của CộtBreak 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. Tham chiếu chú thích cuối trang là nội dung cùng dòng được hiển thị bằng 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ó nội dung nào được đề xuất xoá.

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

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

suggestedDeletionIds[]

string

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

textStyle

object (TextStyle)

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

Tương tự như nội dung văn bản, 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 sẽ thay đổi thành HorizontalRule này, được khoá bằng mã đề xuất.

Phương trình

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

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

string

Mã chèn được đề xuất. 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ã nhận dạng của InlineObject mà phần tử này chứa.

suggestedInsertionIds[]

string

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

suggestedDeletionIds[]

string

Mã nhận dạng đề xuất xoá. 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ư dòng văn bản và tệp tham chiếu chú thích cuối trang, kiểu văn bản của 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ử không thể thay đổi, chứa tên hoặc địa chỉ email của người đó.

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

string

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

suggestedInsertionIds[]

string

Mã nhận dạng cho các đề xuất chèn đường liên kết đến người này vào tài liệu. 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ã nhận dạng cho các đề xuất xoá đường liên kết đến người này khỏi tài liệu. Person có thể có nhiều mã xoá nếu, ví dụ: nhiều người dùng đề xuất xoá Person đó. Nếu trống, bạn không nên xoá đường liên kết đến người này.

textStyle

object (TextStyle)

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

suggestedTextStyleChanges

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

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

personProperties

object (PersonProperties)

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

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

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

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

string

Chỉ có đầu ra. Tiêu đề của RichLink như 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. Thuộc tính này luôn có.

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 văn được kế thừa được biểu thị dưới dạng các trường chưa đặt trong thông báo này. Phần tử mẹ của kiểu đoạn văn phụ thuộc vào vị trí định nghĩa kiểu đoạn văn:

  • Đ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 không kế thừa từ một kiểu mẹ, thì việc huỷ thiết lập các trường sẽ chuyển kiểu về một giá trị khớp với giá trị mặc định trong trình chỉnh sửa Tài liệu.

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

string

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

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 kiểu kiểu đã đặt tên ảnh hưởng đến các thuộc tính khác trong BreadcrumbStyle, nên loại kiểu đã đặt tên sẽ được áp dụng trước khi cập nhật các thuộc tính khác.

alignment

enum (Alignment)

Că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 không được đặt, giá trị sẽ được kế thừa từ phần tử mẹ.

direction

enum (ContentDirection)

Hướng văn bản của đoạn này. Nếu bạn không đặt 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 văn bả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)

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

borderBetween

object (ParagraphBorder)

Đường viền giữa đoạn văn này và đoạn văn tiếp theo cũng như đoạn văn 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 vă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 văn. Khi thay đổi đường viền của một đoạn văn bản, bạn phải chỉ định toàn bộ đường viền mới.

borderBottom

object (ParagraphBorder)

Đường viền ở cuối đoạn văn bả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 văn. Khi thay đổi đường viền của một đoạn văn bản, bạn phải chỉ định toàn bộ đường viền mới.

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 văn. Khi thay đổi đường viền của một đoạn văn bản, bạn phải chỉ định toàn bộ đường viền mới.

borderRight

object (ParagraphBorder)

Đường viền bên phải đoạn 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 vă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 không được đặt, giá trị sẽ được kế thừa từ phần tử mẹ.

tabStops[]

object (TabStop)

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

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 văn có nên được bố trí trên cùng một trang hoặc cột hay không nếu có thể. Nếu 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

Ít nhất một phần của đoạn văn này có được bố trí trên cùng một trang hoặc cột với đoạn vă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 chồng 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)

Độ đậm nhạt của đoạn văn bả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

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

Việc cố gắng cập nhật pageBreakBefore cho đoạn ở các khu vực không được hỗ trợ, chẳng hạn như Table, Header, FooterFootnote, 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 chỉ đị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 cho văn bản LTR, căn phải nếu không.
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, căn trái đối với văn bản RTL.
JUSTIFIED Đoạn văn được căn chỉnh.

ContentDirection

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

Enum
CONTENT_DIRECTION_UNSPECIFIED Chưa xác định hướng nội dung.
LEFT_TO_RIGHT Nội dung đi từ trái sang phải.
RIGHT_TO_LEFT Nội dung đi từ phải sang trái.

SpacingMode

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

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

ParagraphBorder

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

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

object (OptionalColor)

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

width

object (Dimension)

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

padding

object (Dimension)

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

dashStyle

enum (DashStyle)

Kiểu đường 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 về ngôn ngữ đánh dấu và kiến thức cơ bản", phần 1 của ECMA-376 phiên bản thứ 4.

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

TabStop

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

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

object (Dimension)

Độ dời giữa điểm dừng thẻ này 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 giá trị này, giá trị mặc định sẽ là START.

TabStopAlignment

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

Enum
TAB_STOP_ALIGNMENT_UNSPECIFIED Chưa chỉ định căn chỉnh 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 Dấu ngắt thẻ được căn chỉnh vào chính giữ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 trong đoạn văn này.

SuggestedParagraphStyle

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

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

object (ParagraphStyle)

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

paragraphStyleSuggestionState

object (ParagraphStyleSuggestionState)

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

ParagraphStyleSuggestionState

Một mặt nạ cho biết trường nào trên ParagraphStyle cơ sở đã được thay đổi trong đề xuất này. 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 nào được đề xuất đối với spaceBelow hay không.

borderBetweenSuggested

boolean

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

borderTopSuggested

boolean

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

borderBottomSuggested

boolean

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

borderLeftSuggested

boolean

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

indentStartSuggested

boolean

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

indentEndSuggested

boolean

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

keepLinesTogetherSuggested

boolean

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

keepWithNextSuggested

boolean

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

avoidWidowAndOrphanSuggested

boolean

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

shadingSuggestionState

object (ShadingSuggestionState)

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

pageBreakBeforeSuggested

boolean

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

ShadingSuggestionState

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

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

boolean

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

Dấu đầu dòng

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

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

string

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

nestingLevel

integer

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

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

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

object (Bullet)

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

bulletSuggestionState

object (BulletSuggestionState)

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

BulletSuggestionState

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

Biểu diễn dưới dạng JSON
{
  "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à nội dung chèn được đề xuất.

suggestedDeletionIds[]

string

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

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ế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 mộ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 một giá trị cụ thể. Việc huỷ đặt thuộc tính này sẽ dẫn đến lỗi yêu cầu không hợp lệ 400.

marginTop

object (Dimension)

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

Khi cập nhật thuộc tính này, bạn phải đặt một giá trị cụ thể. Việc 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ề dưới cùng của trang trong phần. Nếu bạn không đặt giá trị, giá trị mặc định sẽ là marginBottom từ DocumentStyle.

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

marginRight

object (Dimension)

Lề trang phải của mục. Nếu bạn không đặt giá trị, giá trị mặc định sẽ là marginRight từ DocumentStyle. Việc cập nhật lề phải sẽ khiến các cột trong 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 giá trị, giá trị mặc định sẽ là marginHeader từ DocumentStyle. Nếu được cập nhật, useCustomHeaderFooterMargins sẽ được đặt thành true trên DocumentStyle. Giá trị của useCustomHeaderFooterMargins trên DocumentStyle cho biết liệu lề tiêu đề có được tuân thủ cho phần này hay không.

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

sectionType

enum (SectionType)

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

defaultHeaderId

string

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

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

firstPageHeaderId

string

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

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

evenPageHeaderId

string

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

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

pageNumberStart

integer

Số trang bắt đầu đếm số trang cho mục này. Nếu bạn không đặt giá trị, thì việc đánh số trang sẽ tiếp tục từ phần trước. Nếu giá trị 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 các kích thước của pageSize của DocumentStyle cho phần này hay không, cho phép thay đổi hướng trang giữa dọc và ngang. Nếu không được đặt, giá trị này sẽ kế thừa từ flipPageOrientation của DocumentStyle.

Khi cập nhật thuộc tính này, bạn phải đặt 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 chưa chỉ đị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ị một đường phân cách cột giữa mỗi cột.

SectionType

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

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

Bảng

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

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

integer

Số hàng trong bảng.

columns

integer

Số cột trong bảng.

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

tableRows[]

object (TableRow)

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

suggestedInsertionIds[]

string

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

suggestedDeletionIds[]

string

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

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.

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

suggestedInsertionIds[]

string

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à nội dung chèn được đề xuất.

suggestedDeletionIds[]

string

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

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 dựa trên 0 của ô này, tính 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ã nhận dạng đề xuất xoá. Nếu trống, thì không có nội dung nào được đề xuất xoá.

suggestedTableCellStyleChanges

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

Các thay đổi đề 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

Chiều rộ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ùng của ô.

borderBottom

object (TableCellBorder)

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

paddingLeft

object (Dimension)

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

paddingRight

object (Dimension)

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

paddingTop

object (Dimension)

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

paddingBottom

object (Dimension)

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

contentAlignment

enum (ContentAlignment)

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

TableCellBorder

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

Đường viền ô trong bảng không được trong suốt. Để ẩn đường viền ô trong bảng, hãy đặt chiều rộng của đườ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 đường 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ách căn chỉnh nội dung không được hỗ trợ.
TOP Cách căn chỉnh nội dung với phần đầu của phần giữ nội dung. Tương ứng với ECMA-376 ST_TextAnchoringType 't'.
MIDDLE Că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 nội dung với phần dưới cùng của phần giữ nội dung. Tương ứng với ECMA-376 ST_TextAnchoringType "b".

SuggestedTableCellStyle

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

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

object (TableCellStyle)

TableCellStyle chỉ bao gồm các thay đổi được thực hiện trong đề xuất này. Bạn có thể sử dụng 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 nào đượ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 nào được đề xuất đối với paddingLeft hay không.

paddingRightSuggested

boolean

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

paddingTopSuggested

boolean

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

paddingBottomSuggested

boolean

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

contentAlignmentSuggested

boolean

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

TableRowStyle

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

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

object (Dimension)

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

tableHeader

boolean

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

preventOverflow

boolean

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

SuggestedTableRowStyle

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

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

object (TableRowStyle)

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

tableRowStyleSuggestionState

object (TableRowStyleSuggestionState)

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

TableRowStyleSuggestionState

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

Biểu diễn dưới dạng JSON
{
  "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 của một hàng trên tableRowStyle của hàng đó.

TableColumnProperties

Các thuộc tính của một cột trong bảng.

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

enum (WidthType)

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

width

object (Dimension)

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

WidthType

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

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

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

Chiều rộng của cột được xác định tự động và sẽ có một phần chiều rộng bằng nhau còn lại cho bảng sau khi tính đến tất cả các cột có chiều rộng được chỉ định.

FIXED_WIDTH Chiều rộng cột cố định. Thuộc tính [width][google.apps.docs.v1.TableColumnProperties.width chứa chiều rộng của cột.

TableOfContents

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

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

object (StructuralElement)

Nội dung của mục lục.

suggestedInsertionIds[]

string

Các mã chèn đề xuất. 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à nội dung chèn được đề xuất.

suggestedDeletionIds[]

string

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

Chú thích cuối trang

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

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

string

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

content[]

object (StructuralElement)

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

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

DocumentStyle

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

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

object (Background)

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

defaultHeaderId

string

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

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

evenPageHeaderId

string

Mã của tiêu đề chỉ được dùng cho các trang chẵn. Giá trị của useEvenPageHeaderFooter xác định 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 không được đặt, thì sẽ không có tiêu đề 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, thì tiêu đề duy nhất cho trang đầu tiên sẽ không tồn tại. Giá trị của useFirstPageHeaderFooter xác định 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, thì sẽ không có tiêu đề trang đầu tiên.

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

pageNumberStart

integer

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

marginTop

object (Dimension)

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

Việc cập nhật lề 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 trên kiểu tài liệu sẽ xoá 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.

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

pageSize

object (Size)

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

marginHeader

object (Dimension)

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

flipPageOrientation

boolean

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

Thông tin khái quát

Đại diện cho nền của 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 hàm này cùng với documentStyleSuggestionState để xem những trường nào đã thay đổi và giá trị mới của các trường đó.

documentStyleSuggestionState

object (DocumentStyleSuggestionState)

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

DocumentStyleSuggestionState

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

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

object (BackgroundSuggestionState)

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

defaultHeaderIdSuggested

boolean

Cho biết liệu có thay đổi đượ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.

firstPageHeaderIdSuggested

boolean

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

flipPageOrientationSuggested

boolean

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

BackgroundSuggestionState

Một mặt nạ cho biết trường nào trên Background cơ sở đã được thay đổi trong đề xuất này. Đối với 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 nào được đề xuất đối với width hay không.

NamedStyles

Các kiểu được đặt tên. Các đoạn văn trong tài liệu có thể kế thừa TextStyleParagraphStyle 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 TextStyleParagraphStyle 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 được đặt tên này.

paragraphStyle

object (ParagraphStyle)

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

SuggestedNamedStyles

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

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

object (NamedStyles)

NamedStyles chỉ bao gồm các thay đổi được thực hiện trong đề xuất này. Bạn có thể sử dụng 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 NamedStyleSuggestionState với NamedStyle tương ứng.

textStyleSuggestionState

object (TextStyleSuggestionState)

Một mặt nạ cho biết trường nào trong text style đã được thay đổi 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 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 thuộc tính của dấu đầu dòng ở cấp độ được liên kết.

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

NestingLevel

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

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

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

enum (BulletAlignment)

Căn chỉnh dấu đầu dòng trong không gian được phân bổ để 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 phông chữ 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ự là %0. ở cấp lồng 0 sẽ dẫn đến một danh sách có các ký tự được kết xuất

A.

B.

C.

Định dạng ký tự có thể chứa phần giữ chỗ cho 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)

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

indentStart

object (Dimension)

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

textStyle

object (TextStyle)

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

startNumber

integer

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

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

Giá trị này bị bỏ qua đối với các cấp độ lồng nhau có ký tự không theo thứ tự.

Trường hợp hợp nhất glyph_kind. Loại ký tự được sử dụng cho 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 loại sau:
glyphType

enum (GlyphType)

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

Loại ký tự xác định loại ký tự dùng để thay thế phần giữ chỗ trong glyphFormat khi các đoạn văn ở cấp độ lồng nhau này được sắp xếp theo thứ tự. Ví dụ: nếu mức lồng ghép là 0, glyphFormat%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

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

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%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 cho văn bản LTR, căn phải nếu không.
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ào cuối không gian được phân bổ để hiển thị dấu đầu dòng. Căn phải đối với văn bản LTR, căn trái đối với văn bản RTL.

GlyphType

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

Enum
GLYPH_TYPE_UNSPECIFIED Loại ký tự chưa được chỉ định hoặc không được hỗ trợ.
NONE Chuỗi trống.
DECIMAL Một số, chẳng hạn như 1, 2 hoặc 3.
ZERO_DECIMAL Một số có tiền tố là số 0, chẳng hạn như 01, 02 hoặc 03. Số có nhiều chữ số không có tiền tố là số 0.
UPPER_ALPHA Một chữ cái viết hoa, chẳng hạn như A, B hoặc C.
ALPHA Một chữ cái viết thường, chẳng hạn như a, b hoặc c.
UPPER_ROMAN 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

Nội dung thay đổi đề xuất cho 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. Đối với mọi trường được đặt thành đúng, sẽ có một giá trị mới được đề xuất.

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

object (NestingLevelSuggestionState)

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

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

NestingLevelSuggestionState

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

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

boolean

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

glyphTypeSuggested

boolean

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

glyphFormatSuggested

boolean

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

glyphSymbolSuggested

boolean

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

indentFirstLineSuggested

boolean

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

indentStartSuggested

boolean

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

textStyleSuggestionState

object (TextStyleSuggestionState)

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

startNumberSuggested

boolean

Cho biết liệu có thay đổi đượ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.

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

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

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

string

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

name

string

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

ranges[]

object (Range)

Các dải ô thuộc 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à Int32Value để phù hợp với các trường hợp sử dụng trong tương lai có phạm vi mở.

endIndex

integer

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

Trong 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. Nếu bạn bỏ qua, yêu cầu này 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ẻ số í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ạn bỏ qua, yêu cầu này 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 đố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 được đề xuất đối với các thuộc tính đối tượng nội tuyến, đượ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. titledescription đề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. titledescription đề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)

Nội dung 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 thông tin tham chiếu đến biểu đồ nguồn trên Google Trang tính khi đối tượng được nhúng là một biểu đồ được liên kết.

Nếu bạn không đặt thuộc tính 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 loại sau:
embeddedDrawingProperties

object (EmbeddedDrawingProperties)

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

imageProperties

object (ImageProperties)

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 lượng mặc định là 30 phút. URI này được gắn thẻ với tài khoản của người yêu cầu. Bất cứ ai có URI đều có thể truy cập hiệu quả vào hình ảnh dưới vai trò là người yêu cầu ban đầu. 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

Độ dời chỉ định khoảng cách từ cạnh phải của hình chữ nhật cắt đến cạnh phải của nội dung gốc dưới dạng một phân số của chiều rộng 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. Độ xoay được áp dụng sau các độ dời.

EmbeddedObjectBorder

Đường viền xung quanh EmbeddedObject.

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

object (OptionalColor)

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

width

object (Dimension)

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

dashStyle

enum (DashStyle)

Kiểu 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 hợp hợp nhất 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 một biểu đồ được liên kết được nhúng từ Google Trang tính.

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

string

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

chartId

integer

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

SuggestedInlineObjectProperties

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

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

object (InlineObjectProperties)

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

inlineObjectPropertiesSuggestionState

object (InlineObjectPropertiesSuggestionState)

Một 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. Đối với mọi trường được đặt thành đúng, sẽ có một giá trị mới được đề xuất.

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

object (EmbeddedObjectSuggestionState)

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

EmbeddedObjectSuggestionState

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

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

object (EmbeddedDrawingPropertiesSuggestionState)

Một mặt nạ cho biết trường nào trong embeddedDrawingProperties đã được thay đổi 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 nào đượ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 trong đề 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 nào đượ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 nào được đề xuất đối với [brightness] [google.apps.docs.v1.EmbeddedObject.brightness] hay không.

contrastSuggested

boolean

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

transparencySuggested

boolean

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

cropPropertiesSuggestionState

object (CropPropertiesSuggestionState)

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

angleSuggested

boolean

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

CropPropertiesSuggestionState

Một mặt nạ cho biết trường nào trên CropProperties cơ sở đã được thay đổi trong đề xuất này. 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 liệu có thay đổi đề xuất nào đối với [width] [google.apps.docs.v1.EmbeddedBorderObject.width] hay không.

dashStyleSuggested

boolean

Cho biết 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 đề xuất nào đối với [propertyState] [google.apps.docs.v1.EmbeddedBorderObject.property_state] hay không.

LinkedContentReferenceSuggestionState

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

Biểu diễn dưới dạng JSON
{
  "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, chẳng hạn như hình ảnh.

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

string

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

positionedObjectProperties

object (PositionedObjectProperties)

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

suggestedPositionedObjectPropertiesChanges

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

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

suggestedInsertionId

string

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

suggestedDeletionIds[]

string

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

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 đặt tương ứng với phần đầu của Paragraph mà đối tượng được chia sẻ kết nối.

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

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

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

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

object (PositionedObjectProperties)

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

positionedObjectPropertiesSuggestionState

object (PositionedObjectPropertiesSuggestionState)

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

PositionedObjectPropertiesSuggestionState

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

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

object (PositionedObjectPositioningSuggestionState)

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

embeddedObjectSuggestionState

object (EmbeddedObjectSuggestionState)

Một mặt nạ cho biết trường nào trong embeddedObject đã được thay đổi 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 nào đượ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 đề xuất được áp dụng cho tài liệu cho biết cách hiển thị các thay đổi được đề xuất. Tùy chọn này cung cấp các lựa chọn để đọc tài liệu với tất cả các đề xuất cùng dòng, được chấp nhận hoặc bị từ chối.

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

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

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

PREVIEW_SUGGESTIONS_ACCEPTED

Tài liệu được trả về là bản xem trước 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

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