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,
  "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)
    },
    ...
  },
  "revisionId": string,
  "suggestionsViewMode": enum (SuggestionsViewMode),
  "inlineObjects": {
    string: {
      object (InlineObject)
    },
    ...
  },
  "positionedObjects": {
    string: {
      object (PositionedObject)
    },
    ...
  }
}
Các trường
documentId

string

Chỉ kết quả. Mã nhận dạng của tài liệu.

title

string

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

body

object (Body)

Chỉ kết quả. Phần nội dung chính của tài liệu.

headers

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

Chỉ kết quả. Tiêu đề trong tài liệu, được khoá theo mã tiêu đề.

footers

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

Chỉ kết quả. Chân trang trong tài liệu, được khoá theo mã chân trang.

footnotes

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

Chỉ kết quả. Chú thích cuối trang trong tài liệu, được tạo mã chú thích cuối trang.

documentStyle

object (DocumentStyle)

Chỉ kết quả. Kiểu tài liệu.

suggestedDocumentStyleChanges

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

Chỉ kết quả. Những thay đổi được đề xuất đối với kiểu của tài liệu, được đề xuất theo mã đề xuất.

namedStyles

object (NamedStyles)

Chỉ kết quả. Các kiểu được đặt tên của tài liệu.

suggestedNamedStylesChanges

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

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

lists

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

Chỉ kết quả. Các danh sách trong tài liệu, được khoá theo mã danh sách.

namedRanges

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

Chỉ kết quả. Dải ô được đặt tên trong tài liệu, được khoá theo tên.

revisionId

string

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

Mã bản sửa đổi không phải là một số tuần tự mà là một chuỗi mờ. Định dạng của mã sửa đổi có thể thay đổi theo thời gian. Mã bản sửa đổi được trả về chỉ được đảm bảo 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ã sửa đổi không thay đổi giữa các lần gọi thì tài liệu sẽ không thay đổi. Ngược lại, giấy tờ tuỳ thân được thay đổi (cho cùng 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 bị thay đổi cũng có thể do các yếu tố nội bộ, chẳng hạn như việc thay đổi định dạng mã nhận dạng.

suggestionsViewMode

enum (SuggestionsViewMode)

Chỉ kết quả. 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.

inlineObjects

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

Chỉ kết quả. Các đối tượng cùng dòng trong tài liệu, được khoá theo mã đối tượng.

positionedObjects

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

Chỉ kết quả. Các đối tượng đã định vị trong tài liệu, được khoá theo mã đối tượng.

Nội dung

Phần nội dung tài liệu.

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)
    }
  ]
}
Các trường
content[]

object (StructuralElement)

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

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

Thành phần cấu trúc

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

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

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

integer

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

endIndex

integer

Chỉ mục kết thúc tính từ 0 của phần tử cấu trúc này (dành riêng cho các đơn vị mã UTF-16).

Trường nhóm content. Nội dung của thành phần cấu trúc. content chỉ có thể là một trong những trạng thái sau đây:
paragraph

object (Paragraph)

Một loại thành phần cấu trúc đoạn văn bản.

sectionBreak

object (SectionBreak)

Kiểu ngắt mục của phần tử cấu trúc.

table

object (Table)

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

tableOfContents

object (TableOfContents)

Mục lục loại phần tử cấu trúc.

Đoạn

StructuralElement đại diện cho một đoạn văn bản. Đoạn văn là một loạt 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)
    },
    ...
  }
}
Các trường
elements[]

object (ParagraphElement)

Nội dung của đoạn văn được chia nhỏ thành các 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 được đề xuất sẽ thay đổi thành đoạn này, được khoá theo mã đề xuất.

bullet

object (Bullet)

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

suggestedBulletChanges

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

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

positionedObjectIds[]

string

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

suggestedPositionedObjectIds

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

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

Phần tử Đoạn

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.
}
Các trường
startIndex

integer

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

endIndex

integer

Chỉ mục kết thúc cơ số 0 của phần tử đoạn này (bao gồm cả chỉ số cuối cùng ở đơn vị mã UTF-16).

Trường nhóm content. Nội dung của thành phần đoạn. content chỉ có thể là một trong những trạng thái sau đây:
textRun

object (TextRun)

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

autoText

object (AutoText)

Một thành phần của đoạn văn bản tự động.

pageBreak

object (PageBreak)

Một thành phần của đoạn ngắt trang.

columnBreak

object (ColumnBreak)

Thành phần của đoạn ngắt cột.

footnoteReference

object (FootnoteReference)

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

horizontalRule

object (HorizontalRule)

Một phần tử đoạn quy tắc ngang.

equation

object (Equation)

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

inlineObjectElement

object (InlineObjectElement)

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

person

object (Person)

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

TextRun (Chạy văn bản)

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

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

string

Nội dung của lần chạy này.

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

suggestedInsertionIds[]

string

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

suggestedDeletionIds[]

string

Mã xoá đề xuất. Nếu trống thì hệ thống sẽ không đề 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 đề xuất sẽ thay đổi thành lần chạy này, được tạo theo mã đề xuất.

TextStyle

Đại diện cho kiểu có thể áp dụng cho văn bản.

Kiểu văn bản kế thừa được biểu thị dưới dạng các trường chưa được đặt trong thông báo này. Nguồn gốc của 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.
  • TextStyle trên named style kế thừa từ kiểu có 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ừ kiểu gốc, các trường huỷ thiết lập sẽ hoàn nguyên kiểu đó về một giá trị phù hợp với giá trị mặc định trong trình chỉnh sửa Tài liệu.

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

boolean

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

italic

boolean

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

underline

boolean

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

strikethrough

boolean

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

smallCaps

boolean

Liệu văn bản có được viết hoa bằng chữ cái nhỏ hay không.

backgroundColor

object (OptionalColor)

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

foregroundColor

object (OptionalColor)

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

fontSize

object (Dimension)

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

weightedFontFamily

object (WeightedFontFamily)

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

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

Nếu bạn không đặt weightedFontFamily#weight thì chế độ mặc định sẽ là 400.

Nếu đặt weightedFontFamily thì bạn cũng phải đặt weightedFontFamily#fontFamily với 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 đường 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.

Màu không bắt buộc

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

Biểu diễn dưới dạng JSON
{
  "color": {
    object (Color)
  }
}
Các 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ẽ đại diện cho một màu trong suốt.

Màu

Một màu đồng nhất.

Biểu diễn dưới dạng JSON
{
  "rgbColor": {
    object (RgbColor)
  }
}
Các trường
rgbColor

object (RgbColor)

Giá trị màu RGB.

Màu RGB

Màu RGB.

Biểu diễn dưới dạng JSON
{
  "red": number,
  "green": number,
  "blue": number
}
Các trường
red

number

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

green

number

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

blue

number

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

Phương diện

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

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

number

Cường độ.

unit

enum (Unit)

Đơn vị của độ lớn.

Đơn vị

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

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

Nhóm phông chữ có trọng số

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

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

string

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

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

weight

integer

Độ đậm của phông chữ. Trường này có thể chứa 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 Quy cách CSS 2.1, phần 15.6, với các giá trị không phải dạng số không được phép.

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

Độ đậm phông chữ chỉ chiếm một thành phần trong độ đậm phông chữ được hiển thị. Việc kết hợp giá trị weight và giá trị bold đã phân giải của kiểu văn bản sẽ xác định trọng số được hiển thị, sau khi tính đến tính kế thừa:

  • Nếu văn bản được in đậm và độ đậm nhỏ hơn 400, thì độ đậm kết xuất 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 kết xuất 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 in đậm, độ đậm hiển thị sẽ bằng độ đậm.

Chênh lệch đường cơ sở

Cách mà 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 cơ sở của văn bản được kế thừa từ đơn vị gốc.
NONE Văn bản không được bù trừ theo chiều dọc.
SUPERSCRIPT Văn bản được bù trừ theo chiều dọc hướng lên trên (chỉ số trên).
SUBSCRIPT Văn bản được bù trừ theo chiều dọc xuống dưới (chỉ số dưới).

Kiểu văn bản đề xuất

Thay đổi được đề xuất cho TextStyle.

Biểu diễn dưới dạng JSON
{
  "textStyle": {
    object (TextStyle)
  },
  "textStyleSuggestionState": {
    object (TextStyleSuggestionState)
  }
}
Các 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ể dùng thông tin này cùng với textStyleSuggestionState để xem những trường nào đã thay đổi và giá trị mới của trường.

textStyleSuggestionState

object (TextStyleSuggestionState)

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

TextStylesuggestedionState

Một mặt nạ cho biết trường nào trên TextStyle cơ sở đã bị thay đổi trong đề xuất này. Đối với 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
}
Các trường
boldSuggested

boolean

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

italicSuggested

boolean

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

underlineSuggested

boolean

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

strikethroughSuggested

boolean

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

smallCapsSuggested

boolean

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

backgroundColorSuggested

boolean

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

foregroundColorSuggested

boolean

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

fontSizeSuggested

boolean

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

weightedFontFamilySuggested

boolean

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

baselineOffsetSuggested

boolean

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

Văn bản tự động

ParagraphElement đại diện cho một vị trí trong văn bản mà được thay thế độ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)
    },
    ...
  }
}
Các trường
type

enum (Type)

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

suggestedInsertionIds[]

string

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

suggestedDeletionIds[]

string

Mã xoá đề xuất. Nếu trống thì hệ thống sẽ không đề xuất xoá nội dung này.

textStyle

object (TextStyle)

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

suggestedTextStyleChanges

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

Kiểu văn bản đề xuất sẽ thay đổi thành AutoText 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 cho văn bản tự động đại diện cho số trang hiện tại.
PAGE_COUNT Nhập cho văn bản tự động biểu thị tổng số trang trong tài liệu.

Ngắt trang

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

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

string

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

suggestedDeletionIds[]

string

Mã xoá đề xuất. Nếu trống thì hệ thống sẽ không đề xuất xoá nội dung này.

textStyle

object (TextStyle)

Kiểu văn bản của Ngắt trang 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 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 của văn bản được chèn bên cạnh.

suggestedTextStyleChanges

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

Kiểu văn bản đề xuất sẽ đổi thành Ngắt trang này, được khoá theo mã đề xuất.

Ngắt cột

ParagraphElement đại diện cho một phần 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)
    },
    ...
  }
}
Các trường
suggestedInsertionIds[]

string

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

suggestedDeletionIds[]

string

Mã xoá đề xuất. Nếu trống thì hệ thống sẽ không đề xuất xoá nội dung này.

textStyle

object (TextStyle)

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

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

suggestedTextStyleChanges

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

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

Chú thích cuối trang

ParagraphElement đại diện cho phần tham chiếu đến chú thích cuối trang. Phần tham chiếu đến chú thích cuối trang là nội dung cùng dòng được hiển thị bằng 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)
    },
    ...
  }
}
Các trường
footnoteId

string

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

footnoteNumber

string

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

suggestedInsertionIds[]

string

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

suggestedDeletionIds[]

string

Mã xoá đề xuất. Nếu trống thì hệ thống sẽ không đề xuất xoá nội dung này.

textStyle

object (TextStyle)

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

suggestedTextStyleChanges

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

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

HorizontalRule (Quy tắc ngang)

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)
    },
    ...
  }
}
Các trường
suggestedInsertionIds[]

string

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

suggestedDeletionIds[]

string

Mã xoá đề xuất. Nếu trống thì hệ thống sẽ không đề xuất xoá nội dung này.

textStyle

object (TextStyle)

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

Tương tự như nội dung văn bản, chẳng hạn như chạy văn bản và tham chiếu chú thích cuối trang, kiểu văn bản của quy tắc theo chiều 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 đề xuất sẽ thay đổi thành HorizontalRule này, được mã theo 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
  ]
}
Các trường
suggestedInsertionIds[]

string

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

suggestedDeletionIds[]

string

Mã xoá đề xuất. Nếu trống thì hệ thống sẽ không đề 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)
    },
    ...
  }
}
Các trường
inlineObjectId

string

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

suggestedInsertionIds[]

string

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

suggestedDeletionIds[]

string

Mã xoá đề xuất. Nếu trống thì hệ thống sẽ không đề 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ư chạy văn bản và tham chiếu chú thích cuối trang, kiểu văn bản của một thành phần đối tượng cùng dòng có thể ảnh hưởng đến bố cục nội dung cũng như kiểu của văn bản được chèn bên cạnh.

suggestedTextStyleChanges

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

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

Người

Người hoặc địa chỉ email được đề cập trong một tài liệu. Những lượt đề cập này hoạt động như một phần tử duy nhất, không thể thay đổi chứa tên hoặc địa chỉ email của người dùng.

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)
  }
}
Các trường
personId

string

Chỉ kết quả. 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 những đề 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 đề xuất lồng nhau (ví dụ: đề xuất trong đề xuất do một người dùng khác đưa ra). Nếu để trống, thì đường liên kết đến người này không phải là quảng cáo chèn đề xuất.

suggestedDeletionIds[]

string

Mã nhận dạng cho những đề 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 nhiều người dùng đề xuất xoá mã đó chẳng hạn. Nếu trống, thì đường liên kết đến người này sẽ không được đề xuất để xoá.

textStyle

object (TextStyle)

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

suggestedTextStyleChanges

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

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

personProperties

object (PersonProperties)

Chỉ kết quả. Các thuộc tính của Person này. Trường này luôn hiển thị.

Thuộc tính cá nhân

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

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

string

Chỉ kết quả. Tên của một người nếu tên đó hiển thị trong văn bản liên kết thay vì địa chỉ email của người đó.

email

string

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

Thuộc tính liên kết đa dạng

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
}
Các trường
title

string

Chỉ kết quả. 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 lần 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ỉ kết quả. URI cho RichLink. Điều này luôn hiển thị.

mimeType

string

Chỉ kết quả. 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 cả một đoạn văn.

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

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

Nếu kiểu đoạn văn bản không kế thừa từ kiểu gốc, các trường huỷ cài đặt sẽ hoàn nguyên kiểu về một giá trị phù hợp với giá trị mặc định trong trình chỉnh sửa Tài liệu.

Biểu diễn dưới dạng JSON
{
  "headingId": string,
  "namedStyleType": enum (NamedStyleType),
  "alignment": enum (Alignment),
  "lineSpacing": number,
  "direction": enum (ContentDirection),
  "spacingMode": enum (SpacingMode),
  "spaceAbove": {
    object (Dimension)
  },
  "spaceBelow": {
    object (Dimension)
  },
  "borderBetween": {
    object (ParagraphBorder)
  },
  "borderTop": {
    object (ParagraphBorder)
  },
  "borderBottom": {
    object (ParagraphBorder)
  },
  "borderLeft": {
    object (ParagraphBorder)
  },
  "borderRight": {
    object (ParagraphBorder)
  },
  "indentFirstLine": {
    object (Dimension)
  },
  "indentStart": {
    object (Dimension)
  },
  "indentEnd": {
    object (Dimension)
  },
  "tabStops": [
    {
      object (TabStop)
    }
  ],
  "keepLinesTogether": boolean,
  "keepWithNext": boolean,
  "avoidWidowAndOrphan": boolean,
  "shading": {
    object (Shading)
  },
  "pageBreakBefore": boolean
}
Các 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 đề.

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

namedStyleType

enum (NamedStyleType)

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

alignment

enum (Alignment)

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

lineSpacing

number

Khoảng không gian giữa các dòng, dưới dạng phần trăm bình thường, trong đó bình thường được biểu thị dưới dạng 100. Nếu bạn không đặt chính sách này thì giá trị này sẽ được kế thừa từ mẫu gốc.

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 thì giá trị mặc định là LEFT_TO_RIGHT vì hướng của đoạn văn bản không được kế thừa.

spacingMode

enum (SpacingMode)

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

spaceAbove

object (Dimension)

Khoảng trống thừa phía trên đoạn. Nếu bạn không đặt chính sách này thì giá trị này sẽ được kế thừa từ mẫu gốc.

spaceBelow

object (Dimension)

Khoảng trống thừa phía dưới đoạn. Nếu bạn không đặt chính sách này thì giá trị này sẽ được kế thừa từ mẫu gốc.

borderBetween

object (ParagraphBorder)

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

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

borderTop

object (ParagraphBorder)

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

Đường viền trên đượ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. Khi thay đổi đường viền của đ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 này. Nếu bạn không đặt chính sách này thì giá trị này sẽ được kế thừa từ mẫu gốc.

Đường viền dưới đượ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. Khi thay đổi đường viền của đ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 đoạn này. Nếu bạn không đặt chính sách này thì giá trị này sẽ được kế thừa từ mẫu gốc.

Không thể cập nhật một phần đường viền đoạn. Khi thay đổi đường viền của đ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ị này sẽ được kế thừa từ mẫu gốc.

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

indentFirstLine

object (Dimension)

Số lượng 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ị này sẽ được kế thừa từ mẫu gốc.

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 hiện tại. Nếu bạn không đặt chính sách này thì giá trị này sẽ được kế thừa từ mẫu gốc.

indentEnd

object (Dimension)

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

tabStops[]

object (TabStop)

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

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

keepLinesTogether

boolean

Liệu tất cả các dòng của đoạn có nên được bố trí trên cùng một trang hoặc trên cùng một 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ị này sẽ được kế thừa từ mẫu gốc.

keepWithNext

boolean

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

avoidWidowAndOrphan

boolean

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

shading

object (Shading)

Tô bóng đoạn. Nếu bạn không đặt chính sách này thì giá trị này sẽ được kế thừa từ mẫu gốc.

pageBreakBefore

boolean

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

Việc cố gắng cập nhật pageBreakBefore cho các đoạn trong khu vực không được hỗ trợ, bao gồm 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.

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

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

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

Căn chỉnh

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

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

Hướng nội dung

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

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

Chế độ giãn cách

Các chế độ giãn cách đoạn.

Enum
SPACING_MODE_UNSPECIFIED Chế độ giãn cách được kế thừa từ mẫu gốc.
NEVER_COLLAPSE Giãn cách đoạn luôn hiển thị.
COLLAPSE_LISTS Giãn cách đoạn bị bỏ qua giữa các phần tử danh sách.

Đường viền Đoạn

Đườ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)
}
Các trường
color

object (OptionalColor)

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

width

object (Dimension)

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

padding

object (Dimension)

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

dashStyle

enum (DashStyle)

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

Kiểu gạch ngang

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 loại đơn giản "ST_PresetLineDashVal" được mô tả trong phần 20.1.10.48 của "Định dạng tệp mở XML Office – Kiến thức cơ bản và Tham khảo ngôn ngữ đánh dấu", phần 1 của ECMA-376 phiên bản thứ 4.

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

Chặn thẻ

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

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

object (Dimension)

Mức chênh lệch giữa điểm dừng thẻ này và lề bắt đầu.

alignment

enum (TabStopAlignment)

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

TabStopAlignment

Căn chỉnh thẻ dừng.

Enum
TAB_STOP_ALIGNMENT_UNSPECIFIED Chưa xác định việc căn chỉnh tab dừng.
START Điểm dừng thẻ được căn chỉnh với đầu dòng. Đây là lựa chọn mặc định.
CENTER Điểm dừng thẻ được căn chỉnh với giữa dòng.
END Điểm dừng thẻ được căn chỉnh với cuối dòng.

Tô bóng

Tô bóng đoạn.

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

object (OptionalColor)

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

Kiểu Đoạn được Đề xuất

Thay đổi được đề xuất cho ParagraphStyle.

Biểu diễn dưới dạng JSON
{
  "paragraphStyle": {
    object (ParagraphStyle)
  },
  "paragraphStyleSuggestionState": {
    object (ParagraphStyleSuggestionState)
  }
}
Các 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ể dùng thông tin này cùng với paragraphStyleSuggestionState để xem những trường nào đã thay đổi và giá trị mới của trường.

paragraphStyleSuggestionState

object (ParagraphStyleSuggestionState)

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

ParagraphStylesuggestedionState

Một mặt nạ cho biết trường nào trên ParagraphStyle cơ sở đã bị thay đổi trong đề xuất này. Đối với 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
}
Các trường
headingIdSuggested

boolean

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

namedStyleTypeSuggested

boolean

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

alignmentSuggested

boolean

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

lineSpacingSuggested

boolean

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

directionSuggested

boolean

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

spacingModeSuggested

boolean

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

spaceAboveSuggested

boolean

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

spaceBelowSuggested

boolean

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

borderBetweenSuggested

boolean

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

borderTopSuggested

boolean

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

borderBottomSuggested

boolean

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

borderLeftSuggested

boolean

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

borderRightSuggested

boolean

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

indentFirstLineSuggested

boolean

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

indentStartSuggested

boolean

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

indentEndSuggested

boolean

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

keepLinesTogetherSuggested

boolean

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

keepWithNextSuggested

boolean

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

avoidWidowAndOrphanSuggested

boolean

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

pageBreakBeforeSuggested

boolean

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

Trạng thái đổ bóng

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

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

boolean

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

Biểu đồ bullet

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)
  }
}
Các trường
listId

string

Mã của danh sách chứa đoạn văn bả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 theo đoạn cụ thể được áp dụng cho dấu đầu dòng này.

Dấu đầu dòng được đề xuất

Thay đổi được đề xuất cho Bullet.

Biểu diễn dưới dạng JSON
{
  "bullet": {
    object (Bullet)
  },
  "bulletSuggestionState": {
    object (BulletSuggestionState)
  }
}
Các 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ể dùng thông tin này cùng với bulletSuggestionState để xem những trường nào đã thay đổi và giá trị mới của trường.

bulletSuggestionState

object (BulletSuggestionState)

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

Trạng thái Dấu đầu dòng

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

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

boolean

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

nestingLevelSuggested

boolean

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

Tham chiếu đối tượng

Một tập hợp các mã nhận dạng đối tượng.

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

string

Mã đối tượng.

Ngắt mục

Một StructuralElement đại diện cho một dấu 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ị sự bắt đầu của một phần mới và kiểu mục áp dụng cho phần sau dấu ngắt mục.

Phần thân tài liệu luôn bắt đầu bằng dấu ngắt mục.

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

string

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

suggestedDeletionIds[]

string

Mã xoá đề xuất. Nếu trống thì hệ thống sẽ không đề xuất xoá nội dung này.

sectionStyle

object (SectionStyle)

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

Phần

Kiểu áp dụng cho một mục.

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
}
Các trường
columnProperties[]

object (SectionColumnProperties)

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

Nếu trống, mục này 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 cần phải thiết lập 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 400 không hợp lệ.

columnSeparatorStyle

enum (ColumnSeparatorStyle)

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

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

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

contentDirection

enum (ContentDirection)

Hướng nội dung của phần này. Nếu bạn không đặt 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 cần phải thiết lập một giá trị cụ thể. Việc không đặt thuộc tính này dẫn đến lỗi yêu cầu 400 không hợp lệ.

marginTop

object (Dimension)

Lề trang trên cùng của phần. Nếu bạn không đặt chính sách 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 cần phải thiết lập một giá trị cụ thể. Việc không đặt thuộc tính này dẫn đến lỗi yêu cầu 400 không hợp lệ.

marginBottom

object (Dimension)

Lề trang dưới cùng của phần. Nếu bạn không đặt chính sách 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 cần phải thiết lập một giá trị cụ thể. Việc không đặt thuộc tính này dẫn đến lỗi yêu cầu 400 không hợp lệ.

marginRight

object (Dimension)

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

marginLeft

object (Dimension)

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

marginHeader

object (Dimension)

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

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

sectionType

enum (SectionType)

Chỉ kết quả. Loại phần.

defaultHeaderId

string

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

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

firstPageHeaderId

string

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

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

evenPageHeaderId

string

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

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

pageNumberStart

integer

Số trang bắt đầu đếm số trang cho phần này. Nếu bạn không đặt chính sách này, thì quá trình đánh số trang sẽ tiếp tục từ phần trước. Nếu giá trị này 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 cần phải thiết lập một giá trị cụ thể. Việc không đặt thuộc tính này dẫn đến lỗi yêu cầu 400 không hợp lệ.

flipPageOrientation

boolean

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

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

Thuộc tính mục

Thuộc tính áp dụng cho cột của một mục.

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

object (Dimension)

Chỉ kết quả. Chiều rộng của cột.

paddingEnd

object (Dimension)

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

Kiểu phân cách cột

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

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

Loại phần

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

Enum
SECTION_TYPE_UNSPECIFIED Chưa xác định loại mục.
CONTINUOUS Phần này bắt đầu ngay sau đoạn cuối cùng của phần trước.
NEXT_PAGE Phần này bắt đầu ở 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)
  }
}
Các 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

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

suggestedDeletionIds[]

string

Mã xoá đề xuất. Nếu trống thì hệ thống sẽ không đề 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)
    },
    ...
  }
}
Các trường
startIndex

integer

Chỉ số bắt đầu từ giá trị 0 của hàng này, tính bằng đơn vị mã UTF-16.

endIndex

integer

Chỉ mục kết thúc dạng 0 của hàng này (loại trừ chỉ số này bằng đơn vị mã UTF-16).

tableCells[]

object (TableCell)

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

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

suggestedInsertionIds[]

string

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

suggestedDeletionIds[]

string

Mã xoá đề xuất. Nếu trống thì hệ thống sẽ không đề 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 đề xuất sẽ thay đổi thành hàng này, được khoá theo mã đề xuất.

Ô để bàn

Nội dung và kiểu của một ô trong Table.

Biểu diễn dưới dạng JSON
{
  "startIndex": integer,
  "endIndex": integer,
  "content": [
    {
      object (StructuralElement)
    }
  ],
  "tableCellStyle": {
    object (TableCellStyle)
  },
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "suggestedTableCellStyleChanges": {
    string: {
      object (SuggestedTableCellStyle)
    },
    ...
  }
}
Các trường
startIndex

integer

Chỉ mục bắt đầu từ giá trị 0 của ô này, bằng đơn vị mã UTF-16.

endIndex

integer

Chỉ mục kết thúc dạng 0 (dành riêng cho ô này) bằng đơn vị mã UTF-16.

content[]

object (StructuralElement)

Nội dung của ô.

tableCellStyle

object (TableCellStyle)

Kiểu của ô.

suggestedInsertionIds[]

string

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

suggestedDeletionIds[]

string

Mã xoá đề xuất. Nếu trống thì hệ thống sẽ không đề xuất xoá nội dung này.

suggestedTableCellStyleChanges

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

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

Kiểu văn bản để bàn

Kiểu của TableCell.

Kiểu ô kế thừa trong bảng đượ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)
}
Các trường
rowSpan

integer

Kéo dài hàng của ô.

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

columnSpan

integer

Khoảng cột của ô.

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

backgroundColor

object (OptionalColor)

Màu nền của ô.

borderLeft

object (TableCellBorder)

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

borderRight

object (TableCellBorder)

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

borderTop

object (TableCellBorder)

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

borderBottom

object (TableCellBorder)

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

paddingLeft

object (Dimension)

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

paddingRight

object (Dimension)

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

paddingTop

object (Dimension)

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

paddingBottom

object (Dimension)

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

contentAlignment

enum (ContentAlignment)

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

Đường viền Bảng Cell

Đườ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 ô của 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)
}
Các 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 đường viền.

dashStyle

enum (DashStyle)

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

Căn chỉnh nội dung

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

Bắt nguồn từ tập hợp con các giá trị của loại đơn giản "ST_TextanchoringType" trong phần 20.1.10.59 của "Định dạng tệp mở XML Office - Nguyên tắc cơ bản và Tham khảo 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ăn chỉnh nội dung được kế thừa từ mẫu gốc nếu có.
CONTENT_ALIGNMENT_UNSUPPORTED Căn chỉnh nội dung không được hỗ trợ.
TOP Căn chỉnh sẽ căn chỉnh nội dung với đầu trình giữ nội dung. Tương ứng với ECMA-376 ST_TextanchoringType 't'.
MIDDLE Căn chỉnh sẽ căn chỉnh nội dung với phần giữa của trình sở hữu nội dung. Tương ứng với ECMA-376 ST_TextanchoringType 'ctr'.
BOTTOM Căn chỉnh sẽ căn chỉnh nội dung với phần dưới cùng của trình sở hữu nội dung. Tương ứng với ECMA-376 ST_TextanchoringType 'b'.

Đề xuấtTableCellStyle

Thay đổi được đề xuất cho TableCellStyle.

Biểu diễn dưới dạng JSON
{
  "tableCellStyle": {
    object (TableCellStyle)
  },
  "tableCellStyleSuggestionState": {
    object (TableCellStyleSuggestionState)
  }
}
Các 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ể dùng thông tin này cùng với tableCellStyleSuggestionState để xem những trường nào đã thay đổi và giá trị mới của trường.

tableCellStyleSuggestionState

object (TableCellStyleSuggestionState)

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

TableCellStylesuggestedionState

Một mặt nạ cho biết trường nào trên TableCellStyle cơ sở đã bị thay đổi trong đề xuất này. Đối với 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
}
Các trường
rowSpanSuggested

boolean

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

columnSpanSuggested

boolean

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

backgroundColorSuggested

boolean

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

borderLeftSuggested

boolean

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

borderRightSuggested

boolean

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

borderTopSuggested

boolean

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

borderBottomSuggested

boolean

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

paddingLeftSuggested

boolean

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

paddingRightSuggested

boolean

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

paddingTopSuggested

boolean

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

paddingBottomSuggested

boolean

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

contentAlignmentSuggested

boolean

Cho biết liệu có thay đổi đề 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
}
Các trường
minRowHeight

object (Dimension)

Chiều cao tối thiểu của hàng. Hàng sẽ xuất hiện 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à một tiêu đề bảng hay không.

preventOverflow

boolean

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

Đề xuấtTableRowStyle

Thay đổi được đề xuất cho TableRowStyle.

Biểu diễn dưới dạng JSON
{
  "tableRowStyle": {
    object (TableRowStyle)
  },
  "tableRowStyleSuggestionState": {
    object (TableRowStyleSuggestionState)
  }
}
Các 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ể dùng thông tin này cùng với tableRowStyleSuggestionState để xem những trường nào đã thay đổi và giá trị mới của trường.

tableRowStyleSuggestionState

object (TableRowStyleSuggestionState)

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

TableRowStylesuggestedionState

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

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

boolean

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

Kiểu bàn

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

Biểu diễn dưới dạng JSON
{
  "tableColumnProperties": [
    {
      object (TableColumnProperties)
    }
  ]
}
Các 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 cũ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

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)
  }
}
Các 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.

Loại chiều rộng

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

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

Chiều rộng của cột được phân bổ đồng đều giữa các cột được phân phối đồ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 bằng chiều rộng 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.

Mục lục

StructuralElement biểu thị mục lục.

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

object (StructuralElement)

Nội dung mục lục.

suggestedInsertionIds[]

string

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

suggestedDeletionIds[]

string

Mã xoá đề xuất. Nếu trống thì hệ thống sẽ không đề xuất xoá nội dung này.

Chú thích cuối trang

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

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

string

Mã chú thích cuối trang.

content[]

object (StructuralElement)

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

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

Kiểu tài liệu

Kiểu tài liệu.

Biểu diễn dưới dạng JSON
{
  "background": {
    object (Background)
  },
  "defaultHeaderId": string,
  "defaultFooterId": string,
  "evenPageHeaderId": string,
  "evenPageFooterId": string,
  "firstPageHeaderId": string,
  "firstPageFooterId": string,
  "useFirstPageHeaderFooter": boolean,
  "useEvenPageHeaderFooter": boolean,
  "pageNumberStart": integer,
  "marginTop": {
    object (Dimension)
  },
  "marginBottom": {
    object (Dimension)
  },
  "marginRight": {
    object (Dimension)
  },
  "marginLeft": {
    object (Dimension)
  },
  "pageSize": {
    object (Size)
  },
  "marginHeader": {
    object (Dimension)
  },
  "marginFooter": {
    object (Dimension)
  },
  "useCustomHeaderFooterMargins": boolean,
  "flipPageOrientation": boolean
}
Các 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, thì sẽ không có tiêu đề mặc định.

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

evenPageHeaderId

string

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

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

firstPageHeaderId

string

Mã của tiêu đề chỉ được dùng cho trang đầu tiên. Nếu bạn không đặt giá trị này 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 liệu 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 đang ở chế độ chỉ đọ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ề trên cùng theo kiểu tài liệu sẽ xoá lề trên cùng của tất cả các kiểu mục.

marginBottom

object (Dimension)

Lề dưới cùng của trang.

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

marginRight

object (Dimension)

Lề phải của trang.

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

marginLeft

object (Dimension)

Lề trang bên trái.

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

pageSize

object (Size)

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

marginHeader

object (Dimension)

Khoảng không gian 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, điều này 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 một tài liệu.

Biểu diễn dưới dạng JSON
{
  "color": {
    object (OptionalColor)
  }
}
Các 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)
  }
}
Các trường
height

object (Dimension)

Chiều cao của đối tượng.

width

object (Dimension)

Chiều rộng của đối tượng.

Đề xuấtTài liệuStyle

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)
  }
}
Các 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ể dùng thông tin này cùng với documentStyleSuggestionState để xem những trường nào đã thay đổi và giá trị mới của trường.

documentStyleSuggestionState

object (DocumentStyleSuggestionState)

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

DocumentStylesuggestedionState

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

Biểu diễn dưới dạng JSON
{
  "backgroundSuggestionState": {
    object (BackgroundSuggestionState)
  },
  "defaultHeaderIdSuggested": boolean,
  "defaultFooterIdSuggested": boolean,
  "evenPageHeaderIdSuggested": boolean,
  "evenPageFooterIdSuggested": boolean,
  "firstPageHeaderIdSuggested": boolean,
  "firstPageFooterIdSuggested": boolean,
  "useFirstPageHeaderFooterSuggested": boolean,
  "useEvenPageHeaderFooterSuggested": boolean,
  "pageNumberStartSuggested": boolean,
  "marginTopSuggested": boolean,
  "marginBottomSuggested": boolean,
  "marginRightSuggested": boolean,
  "marginLeftSuggested": boolean,
  "pageSizeSuggestionState": {
    object (SizeSuggestionState)
  },
  "marginHeaderSuggested": boolean,
  "marginFooterSuggested": boolean,
  "useCustomHeaderFooterMarginsSuggested": boolean,
  "flipPageOrientationSuggested": boolean
}
Các 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 đề xuất đối với defaultHeaderId hay không.

evenPageHeaderIdSuggested

boolean

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

firstPageHeaderIdSuggested

boolean

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

pageNumberStartSuggested

boolean

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

marginTopSuggested

boolean

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

marginBottomSuggested

boolean

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

marginRightSuggested

boolean

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

marginLeftSuggested

boolean

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

pageSizeSuggestionState

object (SizeSuggestionState)

Một mặt nạ cho biết trường nào trong [size] [google.apps.docs.v1.DocumentStyle.size] đã bị thay đổi trong đề xuất này.

marginHeaderSuggested

boolean

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

Trạng thái đề xuất nền

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

Biểu diễn dưới dạng JSON
{
  "backgroundColorSuggested": boolean
}
Các 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.

Trạng thái kích thước đề xuất

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

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

boolean

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

widthSuggested

boolean

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

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

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

Biểu diễn dưới dạng JSON
{
  "styles": [
    {
      object (NamedStyle)
    }
  ]
}
Các 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.

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

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 kiểu được đặt tên.

Biểu diễn dưới dạng JSON
{
  "namedStyleType": enum (NamedStyleType),
  "textStyle": {
    object (TextStyle)
  },
  "paragraphStyle": {
    object (ParagraphStyle)
  }
}
Các 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 bản của kiểu được đặt tên này.

Đề xuấtNamedStyles

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

Biểu diễn dưới dạng JSON
{
  "namedStyles": {
    object (NamedStyles)
  },
  "namedStylesSuggestionState": {
    object (NamedStylesSuggestionState)
  }
}
Các 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ể dùng thông tin này cùng với namedStylesSuggestionState để xem những trường nào đã thay đổi và giá trị mới của trường.

namedStylesSuggestionState

object (NamedStylesSuggestionState)

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

NamedStylessuggestedionState

Trạng thái đề xuất của tin nhắn NamedStyles.

Biểu diễn dưới dạng JSON
{
  "stylesSuggestionStates": [
    {
      object (NamedStyleSuggestionState)
    }
  ]
}
Các 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 đã bị thay đổi trong đề xuất này.

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

NamedStylesuggestedionState

Trạng thái đề xuất của tin nhắn NamedStyle.

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

enum (NamedStyleType)

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

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

textStyleSuggestionState

object (TextStyleSuggestionState)

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

paragraphStyleSuggestionState

object (ParagraphStyleSuggestionState)

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

Danh sách

Danh sách đại diện cho các thuộc tính danh sách của một nhóm các đoạn văn, tất cả đều thuộc về cùng một danh sách. Một đoạn thuộc danh sách sẽ 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
  ]
}
Các 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 được đề xuất đối với thuộc tính của danh sách, được khoá theo mã đề xuất.

suggestedInsertionId

string

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

suggestedDeletionIds[]

string

Mã xoá đề xuất. Nếu trống thì danh sách này sẽ không có đề xuất xoá.

Thuộc tính danh sách

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 liên kết với một danh sách.

Biểu diễn dưới dạng JSON
{
  "nestingLevels": [
    {
      object (NestingLevel)
    }
  ]
}
Các 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 với cấp lồng nhau 0 tương ứng với cấp cao nhất và cấp độ lồng 8 tương ứng với cấp lồng nhiều nhất. Cấp độ lồng được trả về theo thứ tự tăng dần, trong đó cấp độ lồng ghép ít nhất được trả về trước.

Cấp độ Nest

Chứa các thuộc tính mô tả giao diện của 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.
}
Các trường
bulletAlignment

enum (BulletAlignment)

Căn chỉnh của dấu đầu dòng trong không gian được phân bổ để hiển thị dấu đầu dòng.

glyphFormat

string

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

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

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

A.

B.

C.

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

1.

2.

2.1.

2.2.

3.

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

indentFirstLine

object (Dimension)

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

indentStart

object (Dimension)

Số lượng thụt lề cho các đoạn ở cấp độ lồng nhau này. Được á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 văn bản.

textStyle

object (TextStyle)

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

startNumber

integer

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

Giá trị 0 được coi là giá trị 1 đối với danh sách có chữ và danh sách dạng chữ số La Mã. Đối với các giá trị của cả số 0 và 1, danh sách chữ số La Mã 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 ghép có ký tự không theo thứ tự.

Trường nhóm glyph_kind. Loại ký tự mà dấu đầu dòng sử dụng. Thao tác này xác định ký tự đầu dòng thay thế phần giữ chỗ trong glyph_format. glyph_kind chỉ có thể là một trong những trạng thái sau đây:
glyphType

enum (GlyphType)

Loại ký tự mà dấu đầu dòng sử dụng khi sắp xếp các đoạn ở cấp độ lồng ghép này.

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

glyphSymbol

string

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

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

Căn chỉnh dấu đầu dòng

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

Enum
BULLET_ALIGNMENT_UNSPECIFIED Cách căn chỉnh dấu đầu dòng chưa xác định.
START Dấu đầu dòng được căn chỉnh với đầu không gian được chia để hiển thị dấu đầu dòng. Căn trái đối với văn bản LTR, nếu không thì căn phải.
CENTER Dấu đầu dòng được căn chỉnh vào giữa không gian được chia để hiển thị dấu đầu dòng.
END Dấu đầu dòng được căn chỉnh vào cuối không gian được chia để hiển thị dấu đầu dòng. Căn phải đối với văn bản LTR, nếu không thì căn trái.

Loại Glyph

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

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

Thuộc tính danh sách đề xuất

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

Biểu diễn dưới dạng JSON
{
  "listProperties": {
    object (ListProperties)
  },
  "listPropertiesSuggestionState": {
    object (ListPropertiesSuggestionState)
  }
}
Các 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ể dùng thông tin này cùng với listPropertiesSuggestionState để xem những trường nào đã thay đổi và giá trị mới của trường.

listPropertiesSuggestionState

object (ListPropertiesSuggestionState)

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

Danh sách Thuộc tính Đề nghịState

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

Biểu diễn dưới dạng JSON
{
  "nestingLevelsSuggestionStates": [
    {
      object (NestingLevelSuggestionState)
    }
  ]
}
Các 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 đã bị thay đổi trong đề xuất này.

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

Trạng thái NestingLevelsuggestedion

Một mặt nạ cho biết trường nào trên NestingLevel cơ sở đã bị thay đổi trong đề xuất này. Đối với 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
}
Các trường
bulletAlignmentSuggested

boolean

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

glyphTypeSuggested

boolean

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

glyphFormatSuggested

boolean

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

glyphSymbolSuggested

boolean

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

indentFirstLineSuggested

boolean

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

indentStartSuggested

boolean

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

Dải ô được đặt tên

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

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

string

Tên mà tất cả named ranges đều có chung.

namedRanges[]

object (NamedRange)

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

Dải ô được đặt tên

Tập hợp 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 tuỳ ý do người dùng xác định để nội dung trong đó có thể được lập trình đọc hoặc chỉnh sửa sau. Một tài liệu có thể chứa nhiều dải ô được đặt tên có cùng tên, nhưng mỗi dải ô được đặt tên đều có một mã nhận dạng duy nhất.

Dải ô được đặt tên được tạo bằng một Range duy nhất và nội dung được chèn bên trong một dải ô được đặt tên thường mở rộng dải ô đó. Tuy nhiên, một số thay đổi nhất định trong 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 phải là dải ô riêng tư. Tất cả ứng dụng và cộng tác viên có quyền truy cập vào tài liệu đều có thể thấy các dải ô được đặt tên của tài liệu.

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

string

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

name

string

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

ranges[]

object (Range)

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

Phạm vi

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

Biểu diễn dưới dạng JSON
{
  "segmentId": string,
  "startIndex": integer,
  "endIndex": integer
}
Các trường
segmentId

string

Mã của đầu trang, chân trang hoặc chú thích cuối trang có chứa dải ô này. 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ính theo giá trị 0 của phạm vi này, tính bằng đơn vị mã UTF-16.

Trong mọi 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 với phạm vi mở.

endIndex

integer

Chỉ mục kết thúc dạng 0 (dành riêng cho phạm vi này) bằng đơn vị mã UTF-16.

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

Chế độ xem đề xuất

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

Enum
DEFAULT_FOR_CURRENT_ACCESS TopicsViewMode áp dụng cho tài liệu được trả về phụ thuộc vào cấp truy cập hiện tại của người dùng. Nếu người dùng chỉ có quyền xem, 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ó nội dung đề xuất nội tuyến. Các thay đổi được đề xuất sẽ khác với nội dung cơ sở trong tài liệu.

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

PREVIEW_SUGGESTIONS_ACCEPTED

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

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

PREVIEW_WITHOUT_SUGGESTIONS Tài liệu được trả về là bản xem trước với tất cả các thay đổi được đề xuất sẽ bị từ chối nếu có bất kỳ đề xuất nào trong tài liệu.

InlineObject

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

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

string

Mã của đối tượng cùng dòng này. Có thể dùng để cập nhật các 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 thuộc tính của đối tượng cùng dòng, được khoá theo mã đề xuất.

suggestedInsertionId

string

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

suggestedDeletionIds[]

string

Mã xoá đề xuất. Nếu trống thì hệ thống sẽ không đề xuất xoá nội dung này.

InlineObjectProperties

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

Biểu diễn dưới dạng JSON
{
  "embeddedObject": {
    object (EmbeddedObject)
  }
}
Các 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 nhúng)

Đố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.
}
Các trường
title

string

Tiêu đề của đối tượng được nhúng. Cả titledescription đượ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. Cả titledescription đượ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ùng của đối tượng được nhúng.

marginRight

object (Dimension)

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

marginLeft

object (Dimension)

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

linkedContentReference

object (LinkedContentReference)

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

Nếu bạn không đặt chính sách này thì đối tượng được nhúng sẽ không được liên kết.

Trường nhóm properties. Các thuộc tính dành riêng cho từng loại đối tượng được nhúng. properties chỉ có thể là một trong những trạng thái sau đây:
embeddedDrawingProperties

object (EmbeddedDrawingProperties)

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

imageProperties

object (ImageProperties)

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

EmbeddedDrawingProperties

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

Các thuộc tính của bản vẽ được nhúng và dùng để phân biệt loại đối tượng. Bản vẽ được nhúng là bản vẽ được tạo và chỉnh sửa trong tài liệu. Xin lưu ý rằng chúng tôi không hỗ trợ nhiều thông tin chi tiết.

Thuộc tính hình ảnh

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
}
Các trường
contentUri

string

URI cho hình ảnh có thời gian tồn tại mặc định là 30 phút. URI này được gắn thẻ với tài khoản của người yêu cầu. Bất kỳ ai có URI đó truy cập một cách hiệu quả hình ảnh với tư cách là người yêu cầu ban đầu. Bạn có thể mất quyền truy cập vào hình ảnh nếu chế độ cài đặt cách chia sẻ của tài liệu thay đổi.

sourceUri

string

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

brightness

number

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

contrast

number

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

transparency

number

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

cropProperties

object (CropProperties)

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.

Thuộc tính Crop

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

Hình chữ nhật cắt được biểu thị bằng độ dời phân số so với 4 cạnh của nội dung gốc.

  • Nếu độ lệch nằm trong khoảng (0, 1), 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 bao quanh ban đầu của hình ảnh.
  • Nếu độ lệch âm hoặc lớn hơn 1, 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 bao quanh ban đầu của hình ảnh.
  • Nếu tất cả độ lệch và góc xoay bằng 0, hình ảnh không bị cắt.
Biểu diễn dưới dạng JSON
{
  "offsetLeft": number,
  "offsetRight": number,
  "offsetTop": number,
  "offsetBottom": number,
  "angle": number
}
Các trường
offsetLeft

number

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

offsetRight

number

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

offsetTop

number

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

offsetBottom

number

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

angle

number

Góc xoay theo chiều kim đồng hồ của hình chữ nhật cắt quanh tâm của nó, tính bằng radian. Chế độ xoay được áp dụng sau độ lệch.

EmbeddedObjectBorder

Đường viền xung quanh EmbeddedObject.

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

object (OptionalColor)

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

width

object (Dimension)

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

dashStyle

enum (DashStyle)

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

propertyState

enum (PropertyState)

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

Trạng thái thuộc tính

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 thuộc tính 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 thuộc tính là NOT_RENDERED, thì phần tử không có thuộc tính tương ứng khi hiển thị trong tài liệu.

Tài liệu tham khảo về LinkedIn

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.
}
Các trường
Trường nhóm reference. Tệp đối 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.

Tài liệu tham khảo về trang tính

Tham chiếu đến một biểu đồ 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
}
Các trường
spreadsheetId

string

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

Đề xuấtInlineObjectProperties

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

Biểu diễn dưới dạng JSON
{
  "inlineObjectProperties": {
    object (InlineObjectProperties)
  },
  "inlineObjectPropertiesSuggestionState": {
    object (InlineObjectPropertiesSuggestionState)
  }
}
Các 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ể dùng thông tin này cùng với inlineObjectPropertiesSuggestionState để xem những trường nào đã thay đổi và giá trị mới của trường.

inlineObjectPropertiesSuggestionState

object (InlineObjectPropertiesSuggestionState)

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

InlineObjectPropertiesRequestionState

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

Biểu diễn dưới dạng JSON
{
  "embeddedObjectSuggestionState": {
    object (EmbeddedObjectSuggestionState)
  }
}
Các 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.

EmbeddedObjectsuggestedionState

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

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

object (EmbeddedDrawingPropertiesSuggestionState)

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

imagePropertiesSuggestionState

object (ImagePropertiesSuggestionState)

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

titleSuggested

boolean

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

descriptionSuggested

boolean

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

sizeSuggestionState

object (SizeSuggestionState)

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

marginLeftSuggested

boolean

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

marginRightSuggested

boolean

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

marginTopSuggested

boolean

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

marginBottomSuggested

boolean

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

EmbeddedDrawingPropertiesRequestionState

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

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

Trạng thái thuộc tính hình ảnh đề xuất

Một mặt nạ cho biết trường nào trên ImageProperties cơ sở đã bị thay đổi trong đề xuất này. Đối với 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
}
Các trường
contentUriSuggested

boolean

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

sourceUriSuggested

boolean

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

brightnessSuggested

boolean

Cho biết liệu có thay đổi đề xuất đối với [độ sáng] [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 tính năng [tương phản] hay không [google.apps.docs.v1.EmbeddedObject.ref].

transparencySuggested

boolean

Cho biết có thay đổi đề xuất đối với [transparency] [google.apps.docs.v1.EmbeddedObject.transparency] hay chưa.

cropPropertiesSuggestionState

object (CropPropertiesSuggestionState)

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

angleSuggested

boolean

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

CropPropertiessuggestedionState

Một mặt nạ cho biết trường nào trên CropProperties cơ sở đã bị thay đổi trong đề xuất này. Đối với 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
}
Các trường
offsetLeftSuggested

boolean

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

offsetRightSuggested

boolean

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

offsetTopSuggested

boolean

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

offsetBottomSuggested

boolean

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

angleSuggested

boolean

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

EmbeddedObjectBordersuggestedionState

Một mặt nạ cho biết trường nào trên EmbeddedObjectBorder cơ sở đã bị thay đổi trong đề xuất này. Đối với 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
}
Các trường
colorSuggested

boolean

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

widthSuggested

boolean

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

dashStyleSuggested

boolean

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

propertyStateSuggested

boolean

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

LinkedInReferencesuggestedionState

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

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

object (SheetsChartReferenceSuggestionState)

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

SheetsChartReferencesuggestedionState

Một mặt nạ cho biết trường nào trên SheetsChartReference cơ sở đã bị thay đổi trong đề xuất này. Đối với 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
}
Các trường
spreadsheetIdSuggested

boolean

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

chartIdSuggested

boolean

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

PositionedObject (Đối tượng vị trí)

Một đối tượng được chia sẻ Internet với Paragraph và được đặt ở vị trí tương ứng với đầu đoạn. Một 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
  ]
}
Các trường
objectId

string

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

positionedObjectProperties

object (PositionedObjectProperties)

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

suggestedPositionedObjectPropertiesChanges

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

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

suggestedInsertionId

string

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

suggestedDeletionIds[]

string

Mã xoá đề xuất. Nếu trống thì hệ thống sẽ không đề xuất xoá nội dung này.

PositionedObjectProperties

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

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

object (PositionedObjectPositioning)

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

embeddedObject

object (EmbeddedObject)

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

PositionedObjectPositioning

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

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

enum (PositionedObjectLayout)

Bố cục của đối tượng có vị trí này.

leftOffset

object (Dimension)

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

topOffset

object (Dimension)

Độ lệch của cạnh trên của đối tượng đã định vị so với phần đầu của Paragraph mà đối tượng này đượ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 và kiểu 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 đã đị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 đã đị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 ở bên trái hoặc bên phải của đối tượng đã định vị.
IN_FRONT_OF_TEXT Đối tượng đã định vị nằm ở phía trước văn bản.
BEHIND_TEXT Đối tượng đã định vị nằm phía sau văn bản.

Đề xuấtPositionedObjectProperties

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

Biểu diễn dưới dạng JSON
{
  "positionedObjectProperties": {
    object (PositionedObjectProperties)
  },
  "positionedObjectPropertiesSuggestionState": {
    object (PositionedObjectPropertiesSuggestionState)
  }
}
Các 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ể dùng thông tin này cùng với positionedObjectPropertiesSuggestionState để xem những trường nào đã thay đổi và giá trị mới của trường.

positionedObjectPropertiesSuggestionState

object (PositionedObjectPropertiesSuggestionState)

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

PositionedObjectPropertiesRequestionState

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

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

object (PositionedObjectPositioningSuggestionState)

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

embeddedObjectSuggestionState

object (EmbeddedObjectSuggestionState)

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

PositionedObjectPositioningsuggestedionState

Một mặt nạ cho biết trường nào trên PositionedObjectPositioning cơ sở đã bị thay đổi trong đề xuất này. Đối với 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
}
Các trường
layoutSuggested

boolean

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

leftOffsetSuggested

boolean

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

topOffsetSuggested

boolean

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

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 tiêu đề được cung cấp trong yêu cầu.

get

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