REST Resource: documents

{
  "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)
    },
    ...
  }
}

string

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

string

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

object (Tab)

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

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

string

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

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

enum (SuggestionsViewMode)

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

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

object (Body)

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

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

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

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

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

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

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

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

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

object (DocumentStyle)

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

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

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

Chỉ có đầu ra. Các thay đổi được đề xuất đối với kiểu của tài liệu, được khoá bằng 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.

object (NamedStyles)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

{
  "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.
}

object (TabProperties)

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

object (Tab)

Các thẻ con lồng trong thẻ này.

object (DocumentTab)

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

{
  "tabId": string,
  "title": string,
  "parentTabId": string,
  "index": integer,
  "nestingLevel": integer
}

string

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

string

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

string

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

integer

Chỉ mục dựa trên 0 của thẻ trong thẻ mẹ.

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.

{
  "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)
    },
    ...
  }
}

object (Body)

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

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

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

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.

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

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

object (DocumentStyle)

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

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

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

object (NamedStyles)

Các kiểu có tên của thẻ tài liệu.

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.

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

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

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.

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

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

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

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

{
  "content": [
    {
      object (StructuralElement)
    }
  ]
}

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.

{
  "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.
}

integer

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

integer

Chỉ mục kết thúc dựa trên số 0 của phần tử cấu trúc này, riêng biệt, trong các đơn vị mã UTF-16.

object (Paragraph)

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

object (SectionBreak)

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

object (Table)

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

object (TableOfContents)

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

{
  "elements": [
    {
      object (ParagraphElement)
    }
  ],
  "paragraphStyle": {
    object (ParagraphStyle)
  },
  "suggestedParagraphStyleChanges": {
    string: {
      object (SuggestedParagraphStyle)
    },
    ...
  },
  "bullet": {
    object (Bullet)
  },
  "suggestedBulletChanges": {
    string: {
      object (SuggestedBullet)
    },
    ...
  },
  "positionedObjectIds": [
    string
  ],
  "suggestedPositionedObjectIds": {
    string: {
      object (ObjectReferences)
    },
    ...
  }
}

object (ParagraphElement)

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

object (ParagraphStyle)

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

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.

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.

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.

string

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

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

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

{
  "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.
}

integer

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

integer

Chỉ mục kết thúc dựa trên số 0 của phần tử đoạn văn này, riêng biệt, trong các đơn vị mã UTF-16.

object (TextRun)

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

object (AutoText)

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

object (PageBreak)

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

object (ColumnBreak)

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

object (FootnoteReference)

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

object (HorizontalRule)

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

object (Equation)

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

object (InlineObjectElement)

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

object (Person)

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

object (RichLink)

Một phần tử đoạn văn liên kết đến một tài nguyên của Google (chẳng hạn như tệp trong Google Drive, video trên YouTube hoặc sự kiện trên Lịch).

{
  "content": string,
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}

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 này sẽ được thay thế bằng ký tự Unicode U+E907.

string

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

string

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

object (TextStyle)

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

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.

{
  "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)
  }
}

boolean

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

boolean

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

boolean

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

boolean

Liệu văn bản có bị gạch ngang hay không.

boolean

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

object (OptionalColor)

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

object (OptionalColor)

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

object (Dimension)

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

object (WeightedFontFamily)

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

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

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

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

enum (BaselineOffset)

Độ dời theo chiều dọc của văn bản so với vị trí thông thường.

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

object (Link)

Đích đến của đường siêu liên kết của văn bản. Nếu bạn không đặt giá trị, thì sẽ không có đường liên kết nào. Đường liên kết không được kế thừa từ văn bản mẹ.

Việc thay đổi đường liên kết trong yêu cầu cập nhật sẽ gây ra một số thay đổi khác đối với kiểu văn bản của dải ô:

• Khi thiết lập đường liên kết, màu nền trước của văn bản sẽ được cập nhật thành màu đường liên kết mặc định và văn bản sẽ được gạch chân. Nếu các trường này được sửa đổi trong cùng một yêu cầu, thì các giá trị đó sẽ được sử dụng thay vì giá trị mặc định của đường liên kết.
• Việc đặt đường liên kết trên một dải văn bản trùng lặp với một đường liên kết hiện có cũng sẽ cập nhật đường liên kết hiện có để trỏ đến URL mới.
• Không thể đặt đường liên kết trên ký tự dòng mới. Do đó, việc đặt đường liên kết trên một dải văn bản vượt qua ranh giới đoạn văn, chẳng hạn như "ABC\n123", sẽ tách(các) ký tự dòng mới thành các dòng văn bản riêng. Đường liên kết sẽ được áp dụng riêng cho các lần chạy trước và sau dòng mới.
• Việc xoá một đường liên kết sẽ cập nhật kiểu văn bản của dải ô để khớp với kiểu của văn bản trước đó (hoặc kiểu văn bản mặc định nếu văn bản trước đó là một đường liên kết khác), trừ phi bạn đang đặt các kiểu khác nhau trong cùng một yêu cầu.

{
  "color": {
    object (Color)
  }
}

object (Color)

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

{
  "rgbColor": {
    object (RgbColor)
  }
}

object (RgbColor)

Giá trị màu RGB.

{
  "red": number,
  "green": number,
  "blue": number
}

number

Thành phần màu đỏ của màu, từ 0 đến 1.

number

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

number

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

{
  "magnitude": number,
  "unit": enum (Unit)
}

number

Magnitude.

enum (Unit)

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

{
  "fontFamily": string,
  "weight": integer
}

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.

integer

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

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

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

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

{

  // Union field destination can be only one of the following:
  "url": string,
  "tabId": string,
  "bookmark": {
    object (BookmarkLink)
  },
  "heading": {
    object (HeadingLink)
  },
  "bookmarkId": string,
  "headingId": string
  // End of list of possible types for union field destination.
}

string

URL bên ngoài.

string

Mã của một thẻ trong tài liệu này.

object (BookmarkLink)

Dấu trang trong tài liệu này.

Trong các tài liệu chứa một thẻ duy nhất, các đường liên kết đến dấu trang trong thẻ duy nhất đó sẽ tiếp tục trả về Link.bookmarkId khi tham số includeTabsContent được đặt thành false hoặc không được đặt. Nếu không, trường này sẽ được trả về.

object (HeadingLink)

Một tiêu đề trong tài liệu này.

Trong các tài liệu chứa một thẻ duy nhất, các đường liên kết đến tiêu đề trong thẻ duy nhất đó sẽ tiếp tục trả về Link.headingId khi tham số includeTabsContent được đặt thành false hoặc không được đặt. Nếu không, trường này sẽ được trả về.

string

Mã của một dấu trang trong tài liệu này.

Trường cũ: Thay vào đó, hãy đặt includeTabsContent thành true và sử dụng Link.bookmark cho các thao tác đọc và ghi. Trường này chỉ được trả về khi includeTabsContent được đặt thành false trong các tài liệu chứa một thẻ và đường liên kết đến một dấu trang trong thẻ đó. Nếu không, Link.bookmark sẽ được trả về.

Nếu trường này được sử dụng trong yêu cầu ghi, thì dấu trang được coi là từ mã thẻ được chỉ định trong yêu cầu. Nếu bạn không chỉ định mã thẻ trong yêu cầu, thì mã thẻ sẽ được coi là từ thẻ đầu tiên trong tài liệu.

string

Mã của một tiêu đề trong tài liệu này.

Trường cũ: Thay vào đó, hãy đặt includeTabsContent thành true và sử dụng Link.heading cho các thao tác đọc và ghi. Trường này chỉ được trả về khi includeTabsContent được đặt thành false trong các tài liệu chứa một thẻ và liên kết đến một tiêu đề trong thẻ đó. Nếu không, Link.heading sẽ được trả về.

Nếu trường này được dùng trong yêu cầu ghi, tiêu đề được coi là từ mã thẻ được chỉ định trong yêu cầu. Nếu bạn không chỉ định mã thẻ trong yêu cầu, thì mã thẻ sẽ được coi là từ thẻ đầu tiên trong tài liệu.

{
  "id": string,
  "tabId": string
}

string

Mã của một dấu trang trong tài liệu này.

string

Mã của thẻ chứa dấu trang này.

{
  "id": string,
  "tabId": string
}

string

Mã của một tiêu đề trong tài liệu này.

string

Mã của thẻ chứa tiêu đề này.

{
  "textStyle": {
    object (TextStyle)
  },
  "textStyleSuggestionState": {
    object (TextStyleSuggestionState)
  }
}

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

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.

{
  "boldSuggested": boolean,
  "italicSuggested": boolean,
  "underlineSuggested": boolean,
  "strikethroughSuggested": boolean,
  "smallCapsSuggested": boolean,
  "backgroundColorSuggested": boolean,
  "foregroundColorSuggested": boolean,
  "fontSizeSuggested": boolean,
  "weightedFontFamilySuggested": boolean,
  "baselineOffsetSuggested": boolean,
  "linkSuggested": boolean
}

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

{
  "type": enum (Type),
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}

enum (Type)

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

string

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

string

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

object (TextStyle)

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

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

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

{
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}

string

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

string

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

object (TextStyle)

Kiểu văn bản của dòng phân trang này.

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

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

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

{
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}

string

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

string

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

object (TextStyle)

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

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

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

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

{
  "footnoteId": string,
  "footnoteNumber": string,
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}

string

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

string

Số được hiển thị của chú thích cuối trang này.

string

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

string

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

object (TextStyle)

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

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

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

{
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}

string

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

string

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

object (TextStyle)

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

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

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.

{
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ]
}

string

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

string

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

{
  "inlineObjectId": string,
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}

string

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

string

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

string

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

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ử đó.

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

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

{
  "personId": string,
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  },
  "personProperties": {
    object (PersonProperties)
  }
}

string

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

string

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

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.

object (TextStyle)

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

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.

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.

{
  "name": string,
  "email": string
}

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 đó.

string

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

{
  "richLinkId": string,
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  },
  "richLinkProperties": {
    object (RichLinkProperties)
  }
}

string

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

string

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

string

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

object (TextStyle)

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

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

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

object (RichLinkProperties)

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

{
  "title": string,
  "uri": string,
  "mimeType": string
}

string

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

string

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

string

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

{
  "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
}

string

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

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

enum (NamedStyleType)

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

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

enum (Alignment)

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

number

Khoảng cách giữa các dòng, tính theo tỷ lệ phần trăm của giá trị thông thường, trong đó giá trị thông 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ẹ.

enum (ContentDirection)

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

enum (SpacingMode)

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

object (Dimension)

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

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

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

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

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

object (ParagraphBorder)

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

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

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.

object (ParagraphBorder)

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

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

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

object (ParagraphBorder)

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

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

object (ParagraphBorder)

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

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

object (Dimension)

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

object (Dimension)

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

object (Dimension)

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

object (TabStop)

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

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

boolean

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

boolean

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

boolean

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

object (Shading)

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

boolean

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

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

{
  "color": {
    object (OptionalColor)
  },
  "width": {
    object (Dimension)
  },
  "padding": {
    object (Dimension)
  },
  "dashStyle": enum (DashStyle)
}

object (OptionalColor)

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

object (Dimension)

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

object (Dimension)

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

enum (DashStyle)

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

{
  "offset": {
    object (Dimension)
  },
  "alignment": enum (TabStopAlignment)
}

object (Dimension)

Độ dời giữa điểm dừng thẻ này và lề bắt đầu.

enum (TabStopAlignment)

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

{
  "backgroundColor": {
    object (OptionalColor)
  }
}

object (OptionalColor)

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

{
  "paragraphStyle": {
    object (ParagraphStyle)
  },
  "paragraphStyleSuggestionState": {
    object (ParagraphStyleSuggestionState)
  }
}

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 đó.

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.

{
  "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
}

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

object (ShadingSuggestionState)

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

boolean

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

{
  "backgroundColorSuggested": boolean
}

boolean

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

{
  "listId": string,
  "nestingLevel": integer,
  "textStyle": {
    object (TextStyle)
  }
}

string

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

integer

Cấp độ lồng ghép của đoạn văn này trong danh sách.

object (TextStyle)

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

{
  "bullet": {
    object (Bullet)
  },
  "bulletSuggestionState": {
    object (BulletSuggestionState)
  }
}

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 đó.

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.

{
  "listIdSuggested": boolean,
  "nestingLevelSuggested": boolean,
  "textStyleSuggestionState": {
    object (TextStyleSuggestionState)
  }
}

boolean

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

boolean

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

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.

{
  "objectIds": [
    string
  ]
}

string

Mã đối tượng.

{
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "sectionStyle": {
    object (SectionStyle)
  }
}

string

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

string

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

object (SectionStyle)

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

{
  "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
}

object (SectionColumnProperties)

Thuộc tính cột của mục.

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

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

enum (ColumnSeparatorStyle)

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

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

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

enum (ContentDirection)

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

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

object (Dimension)

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

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

object (Dimension)

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

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

object (Dimension)

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

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

object (Dimension)

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

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

object (Dimension)

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

object (Dimension)

Lề chân trang của mục. Nếu bạn không đặt giá trị này, giá trị mặc định sẽ là marginFooter 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ề chân trang có được tuân thủ cho phần này hay không

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

enum (SectionType)

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

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 giá trị không được đặt trong SectionBreak đầu tiên, thì giá trị đó sẽ kế thừa từ defaultHeaderId của DocumentStyle.

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

string

Mã của chân trang 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 giá trị không được đặt trong SectionBreak đầu tiên, thì giá trị đó sẽ kế thừa từ defaultFooterId của DocumentStyle.

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

string

Mã nhận dạng của tiêu đề chỉ được dùng cho trang đầu tiên của mục. Nếu useFirstPageHeaderFooter là đúng, giá trị này sẽ được dùng cho tiêu đề trên trang đầu tiên của phần. Nếu giá trị này là false, thì tiêu đề trên trang đầu tiên của phần sẽ sử dụng defaultHeaderId. Nếu 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ừ firstPageHeaderId của DocumentStyle.

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

string

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

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

string

Mã của tiêu đề chỉ dùng cho các trang chẵn. Nếu giá trị của useEvenPageHeaderFooter của DocumentStyle là true, thì giá trị này sẽ được dùng cho tiêu đề trên các trang chẵn trong mục. Nếu giá trị này là false, 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.

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

string

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

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

boolean

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

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

integer

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

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

boolean

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

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

{
  "width": {
    object (Dimension)
  },
  "paddingEnd": {
    object (Dimension)
  }
}

object (Dimension)

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

object (Dimension)

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

{
  "rows": integer,
  "columns": integer,
  "tableRows": [
    {
      object (TableRow)
    }
  ],
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "tableStyle": {
    object (TableStyle)
  }
}

integer

Số hàng trong bảng.

integer

Số cột trong bảng.

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

object (TableRow)

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

string

Mã chèn được đề 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.

string

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

object (TableStyle)

Kiểu của bảng.

{
  "startIndex": integer,
  "endIndex": integer,
  "tableCells": [
    {
      object (TableCell)
    }
  ],
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "tableRowStyle": {
    object (TableRowStyle)
  },
  "suggestedTableRowStyleChanges": {
    string: {
      object (SuggestedTableRowStyle)
    },
    ...
  }
}

integer

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

integer

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

object (TableCell)

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

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

string

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

string

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

object (TableRowStyle)

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

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

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

{
  "startIndex": integer,
  "endIndex": integer,
  "content": [
    {
      object (StructuralElement)
    }
  ],
  "tableCellStyle": {
    object (TableCellStyle)
  },
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "suggestedTableCellStyleChanges": {
    string: {
      object (SuggestedTableCellStyle)
    },
    ...
  }
}

integer

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

integer

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

object (StructuralElement)

Nội dung của ô.

object (TableCellStyle)

Kiểu của ô.

string

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

string

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

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

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

{
  "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)
}

integer

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

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

integer

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

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

object (OptionalColor)

Màu nền của ô.

object (TableCellBorder)

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

object (TableCellBorder)

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

object (TableCellBorder)

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

object (TableCellBorder)

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

object (Dimension)

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

object (Dimension)

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

object (Dimension)

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

object (Dimension)

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

enum (ContentAlignment)

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

{
  "color": {
    object (OptionalColor)
  },
  "width": {
    object (Dimension)
  },
  "dashStyle": enum (DashStyle)
}

object (OptionalColor)

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

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

object (Dimension)

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

enum (DashStyle)

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

{
  "tableCellStyle": {
    object (TableCellStyle)
  },
  "tableCellStyleSuggestionState": {
    object (TableCellStyleSuggestionState)
  }
}

object (TableCellStyle)

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

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.

{
  "rowSpanSuggested": boolean,
  "columnSpanSuggested": boolean,
  "backgroundColorSuggested": boolean,
  "borderLeftSuggested": boolean,
  "borderRightSuggested": boolean,
  "borderTopSuggested": boolean,
  "borderBottomSuggested": boolean,
  "paddingLeftSuggested": boolean,
  "paddingRightSuggested": boolean,
  "paddingTopSuggested": boolean,
  "paddingBottomSuggested": boolean,
  "contentAlignmentSuggested": boolean
}

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

{
  "minRowHeight": {
    object (Dimension)
  },
  "tableHeader": boolean,
  "preventOverflow": boolean
}

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.

boolean

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

boolean

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

{
  "tableRowStyle": {
    object (TableRowStyle)
  },
  "tableRowStyleSuggestionState": {
    object (TableRowStyleSuggestionState)
  }
}

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 đó.

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.

{
  "minRowHeightSuggested": boolean
}

boolean

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

{
  "tableColumnProperties": [
    {
      object (TableColumnProperties)
    }
  ]
}

object (TableColumnProperties)

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

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

{
  "widthType": enum (WidthType),
  "width": {
    object (Dimension)
  }
}

enum (WidthType)

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

object (Dimension)

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

{
  "content": [
    {
      object (StructuralElement)
    }
  ],
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ]
}

object (StructuralElement)

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

string

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

string

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

{
  "headerId": string,
  "content": [
    {
      object (StructuralElement)
    }
  ]
}

string

Mã của tiêu đề.

object (StructuralElement)

Nội dung của tiêu đề.

Chỉ mục cho nội dung của tiêu đề bắt đầu từ 0.

{
  "footerId": string,
  "content": [
    {
      object (StructuralElement)
    }
  ]
}

string

Mã của chân trang.