REST Resource: documents

ทรัพยากร: เอกสาร

เอกสารใน Google เอกสาร

การแสดง 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)
    },
    ...
  }
}
ช่อง
documentId

string

เอาต์พุตเท่านั้น รหัสของเอกสาร
title

string

ชื่อเอกสาร
body

object (Body)

เอาต์พุตเท่านั้น เนื้อหาหลักของเอกสาร
headers

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

เอาต์พุตเท่านั้น ส่วนหัวในเอกสาร ซึ่งผูกกับรหัสส่วนหัว
footers

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

เอาต์พุตเท่านั้น ส่วนท้ายในเอกสารซึ่งผูกกับรหัสส่วนท้าย
footnotes

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

เอาต์พุตเท่านั้น เชิงอรรถในเอกสารที่มีรหัสเชิงอรรถ
documentStyle

object (DocumentStyle)

เอาต์พุตเท่านั้น รูปแบบของเอกสาร
suggestedDocumentStyleChanges

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

เอาต์พุตเท่านั้น การเปลี่ยนแปลงที่แนะนำสำหรับรูปแบบของเอกสาร ซึ่งกำหนดด้วยรหัสคำแนะนำ
namedStyles

object (NamedStyles)

เอาต์พุตเท่านั้น รูปแบบที่มีชื่อของเอกสาร
suggestedNamedStylesChanges

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

เอาต์พุตเท่านั้น การเปลี่ยนแปลงที่แนะนำกับสไตล์ที่มีชื่อของเอกสาร ซึ่งกำหนดตามรหัสคำแนะนำ
lists

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

เอาต์พุตเท่านั้น รายการในเอกสารซึ่งผูกกับรหัสรายการ
namedRanges

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

เอาต์พุตเท่านั้น ช่วงที่ตั้งชื่อแล้วในเอกสารโดยอ้างอิงตามชื่อ
revisionId

string

เอาต์พุตเท่านั้น รหัสการแก้ไขของเอกสาร ใช้ในคำขออัปเดตเพื่อระบุการแก้ไขของเอกสารที่จะใช้การอัปเดต และคำขอควรทำงานอย่างไรหากมีการแก้ไขเอกสารหลังจากการแก้ไขนั้น ระบบจะป้อนข้อมูลเฉพาะในกรณีที่ผู้ใช้มีสิทธิ์แก้ไขเอกสารเท่านั้น

รหัสการแก้ไขไม่ใช่ตัวเลขตามลำดับ แต่เป็นสตริงทึบแสง รูปแบบของรหัสการแก้ไขอาจเปลี่ยนแปลงเมื่อเวลาผ่านไป เราจะรับประกันว่ารหัสการแก้ไขที่ส่งคืนจะใช้งานได้ภายใน 24 ชั่วโมงหลังจากที่ส่งคืน และจะไม่สามารถแชร์กับผู้ใช้อื่นๆ ได้ ถ้ารหัสการแก้ไขไม่มีการเปลี่ยนแปลงระหว่างการเรียก แสดงว่าเอกสารไม่มีการเปลี่ยนแปลง ในทางกลับกัน รหัสที่มีการเปลี่ยนแปลง (สำหรับเอกสารและผู้ใช้เดียวกัน) มักจะหมายความว่าเอกสารได้รับการอัปเดตแล้ว อย่างไรก็ตาม รหัสที่มีการเปลี่ยนแปลงก็อาจเกิดจากปัจจัยภายใน เช่น การเปลี่ยนแปลงรูปแบบรหัสด้วย
suggestionsViewMode

enum (SuggestionsViewMode)

เอาต์พุตเท่านั้น โหมดมุมมองคำแนะนำที่ใช้กับเอกสาร

หมายเหตุ: เมื่อแก้ไขเอกสาร การเปลี่ยนแปลงต้องอ้างอิงจากเอกสารที่มี SUGGESTIONS_INLINE
inlineObjects

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

เอาต์พุตเท่านั้น ออบเจ็กต์ในบรรทัดในเอกสาร ซึ่งคีย์ตามรหัสออบเจ็กต์
positionedObjects

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

เอาต์พุตเท่านั้น ออบเจ็กต์ที่จัดวางตำแหน่งในเอกสาร ซึ่งคีย์ตามรหัสออบเจ็กต์

เนื้อหา

เนื้อหาเอกสาร

โดยทั่วไปส่วนเนื้อหาจะมีเนื้อหาเอกสารทั้งหมด ยกเว้น headers, footers และ footnotes

การแสดง JSON 
{
  "content": [
    {
      object (StructuralElement)
    }
  ]
}
ช่อง
content[]

object (StructuralElement)

เนื้อหาของส่วนเนื้อหา

ดัชนีสำหรับเนื้อหาของเนื้อความเริ่มต้นที่ศูนย์

องค์ประกอบโครงสร้าง

StructuralElement อธิบายเนื้อหาที่มอบโครงสร้างของเอกสาร

การแสดง 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.
}
ช่อง
startIndex

integer

ดัชนีเริ่มต้นแบบศูนย์ของเอลิเมนต์โครงสร้างนี้ในหน่วยโค้ด UTF-16
endIndex

integer

ดัชนีสิ้นสุดแบบเลขศูนย์ของเอลิเมนต์โครงสร้างนี้ อยู่ในหน่วยโค้ด UTF-16 โดยเฉพาะ
ฟิลด์การรวม content เนื้อหาขององค์ประกอบโครงสร้าง content ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
paragraph

object (Paragraph)

ประเภทย่อหน้าขององค์ประกอบโครงสร้าง
sectionBreak

object (SectionBreak)

ประเภทตัวแบ่งส่วนขององค์ประกอบโครงสร้าง
table

object (Table)

ประเภทตารางขององค์ประกอบโครงสร้าง
tableOfContents

object (TableOfContents)

ประเภทสารบัญขององค์ประกอบโครงสร้าง

ย่อหน้า

StructuralElement แสดงถึงย่อหน้า ย่อหน้าคือช่วงของเนื้อหาที่สิ้นสุดด้วยอักขระขึ้นบรรทัดใหม่

การแสดง JSON 
{
  "elements": [
    {
      object (ParagraphElement)
    }
  ],
  "paragraphStyle": {
    object (ParagraphStyle)
  },
  "suggestedParagraphStyleChanges": {
    string: {
      object (SuggestedParagraphStyle)
    },
    ...
  },
  "bullet": {
    object (Bullet)
  },
  "suggestedBulletChanges": {
    string: {
      object (SuggestedBullet)
    },
    ...
  },
  "positionedObjectIds": [
    string
  ],
  "suggestedPositionedObjectIds": {
    string: {
      object (ObjectReferences)
    },
    ...
  }
}
ช่อง
elements[]

object (ParagraphElement)

เนื้อหาของย่อหน้าแบ่งออกเป็นองค์ประกอบต่างๆ
paragraphStyle

object (ParagraphStyle)

รูปแบบของย่อหน้านี้
suggestedParagraphStyleChanges

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

รูปแบบย่อหน้าที่แนะนำเปลี่ยนแปลงในย่อหน้านี้ ซึ่งคีย์ตามรหัสคำแนะนำ
bullet

object (Bullet)

หัวข้อย่อยของย่อหน้านี้ หากไม่มี แสดงว่าย่อหน้าไม่อยู่ในรายการ
suggestedBulletChanges

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

การเปลี่ยนแปลงที่แนะนำในหัวข้อย่อยของย่อหน้านี้
positionedObjectIds[]

string

รหัสของออบเจ็กต์ที่กำหนดตำแหน่งที่เชื่อมโยงกับย่อหน้านี้
suggestedPositionedObjectIds

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

รหัสของออบเจ็กต์ที่กำหนดตำแหน่งซึ่งแนะนำให้แนบมากับย่อหน้านี้ ซึ่งกำหนดด้วยรหัสคำแนะนำ

องค์ประกอบย่อหน้า

ParagraphElement จะอธิบายเนื้อหาภายใน Paragraph

การแสดง 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.
}
ช่อง
startIndex

integer

ดัชนีเริ่มต้นแบบศูนย์ขององค์ประกอบย่อหน้านี้ในหน่วยโค้ด UTF-16
endIndex

integer

ดัชนีสิ้นสุดฐานเป็นศูนย์ขององค์ประกอบย่อหน้านี้โดยเฉพาะในหน่วยโค้ด UTF-16
ฟิลด์การรวม content เนื้อหาขององค์ประกอบย่อหน้า content ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
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)

องค์ประกอบย่อหน้าที่ลิงก์ไปยังบุคคลหรือที่อยู่อีเมล

เรียกใช้ข้อความ

ParagraphElement ที่แสดงถึงข้อความทั้งหมดมีรูปแบบเดียวกัน

การแสดง JSON 
{
  "content": string,
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}
ช่อง
content

string

ข้อความของการเรียกใช้นี้

องค์ประกอบที่ไม่ใช่ข้อความในการเรียกใช้จะถูกแทนที่ด้วยอักขระ Unicode U+E907
suggestedInsertionIds[]

string

รหัสการแทรกที่แนะนำ TextRun อาจมีรหัสการแทรกหลายรหัสหากเป็นการเปลี่ยนแปลงที่แนะนําแบบซ้อนกัน หากเว้นว่างไว้ ค่านี้ไม่ใช่การแทรกที่แนะนำ
suggestedDeletionIds[]

string

รหัสการลบที่แนะนำ หากว่างเปล่า หมายความว่าไม่มีการลบเนื้อหานี้ตามที่แนะนำ
textStyle

object (TextStyle)

รูปแบบข้อความของการเรียกใช้นี้
suggestedTextStyleChanges

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

การเปลี่ยนแปลงรูปแบบข้อความที่แนะนำในการเรียกใช้นี้ ซึ่งคีย์ตามรหัสคำแนะนำ

รูปแบบข้อความ

แสดงการจัดรูปแบบที่นำไปใช้กับข้อความได้

รูปแบบข้อความที่รับมาจะแสดงเป็นช่องที่ยังไม่ได้ตั้งค่าในข้อความนี้ ระดับบนสุดของรูปแบบข้อความจะขึ้นอยู่กับตําแหน่งที่กำหนดรูปแบบข้อความ ดังนี้

  • TextStyle ของข้อความใน Paragraph จะรับค่าจาก named style type ที่เกี่ยวข้องของย่อหน้า
  • TextStyle ใน named style จะรับค่าจากรูปแบบที่มีชื่อ normal text
  • TextStyle ของรูปแบบที่มีชื่อ normal text จะรับค่าจากรูปแบบข้อความเริ่มต้นในเครื่องมือแก้ไขเอกสาร
  • TextStyle ในองค์ประกอบ Paragraph ที่อยู่ในตารางอาจรับค่ารูปแบบข้อความจากรูปแบบตาราง

หากรูปแบบข้อความไม่ได้รับช่วงมาจากระดับบนสุด การยกเลิกการตั้งค่าช่องจะเปลี่ยนสไตล์กลับไปเป็นค่าเริ่มต้นในเครื่องมือแก้ไขเอกสาร

การแสดง 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)
  }
}
ช่อง
bold

boolean

ข้อความจะแสดงผลเป็นตัวหนาหรือไม่
italic

boolean

ข้อความเป็นตัวเอียงหรือไม่
underline

boolean

มีการขีดเส้นใต้ข้อความหรือไม่
strikethrough

boolean

ข้อความถูกขีดทับหรือไม่
smallCaps

boolean

ข้อความเป็นอักษรตัวพิมพ์ใหญ่ขนาดเล็กหรือไม่
backgroundColor

object (OptionalColor)

สีพื้นหลังของข้อความ หากตั้งค่าไว้ สีจะเป็นสี RGB หรือโปร่งใส ทั้งนี้ขึ้นอยู่กับช่อง color
foregroundColor

object (OptionalColor)

สีพื้นหน้าของข้อความ หากตั้งค่าไว้ สีจะเป็นสี RGB หรือโปร่งใส ทั้งนี้ขึ้นอยู่กับช่อง color
fontSize

object (Dimension)

ขนาดแบบอักษรของข้อความ
weightedFontFamily

object (WeightedFontFamily)

ชุดแบบอักษรและน้ำหนักในการแสดงผลของข้อความ

หากคำขออัปเดตระบุค่าสำหรับทั้ง weightedFontFamily และ bold ระบบจะใช้ weightedFontFamily ก่อน จากนั้นตามด้วย bold

หากไม่ได้ตั้งค่า weightedFontFamily#weight ไว้ ค่าเริ่มต้นจะเป็น 400

หากตั้งค่า weightedFontFamily ไว้ ก็จะต้องตั้งค่า weightedFontFamily#fontFamily ด้วยค่าที่ไม่ว่างเปล่าด้วย มิฉะนั้น ระบบจะแสดงข้อผิดพลาด 400 คำขอที่ไม่ถูกต้อง
baselineOffset

enum (BaselineOffset)

ระยะห่างในแนวตั้งของข้อความจากตำแหน่งปกติ

ข้อความที่มีออฟเซ็ตพื้นฐาน SUPERSCRIPT หรือ SUBSCRIPT จะแสดงผลโดยอัตโนมัติในขนาดแบบอักษรที่เล็กกว่า ซึ่งคํานวณตามช่อง fontSize การเปลี่ยนแปลงในช่องนี้จะไม่ส่งผลต่อ fontSize

สีที่เลือกได้

สีที่สามารถทึบแสงเต็มที่หรือโปร่งใสก็ได้

การแสดง JSON 
{
  "color": {
    object (Color)
  }
}
ช่อง
color

object (Color)

หากตั้งค่า ระบบจะใช้เป็นสีทึบ หากไม่ได้ตั้งค่า จะแสดงเป็นสีโปร่งใส

สี

สีทึบ

การแสดง JSON 
{
  "rgbColor": {
    object (RgbColor)
  }
}
ช่อง
rgbColor

object (RgbColor)

ค่าสี RGB

สี RGB

สี RGB

การแสดง JSON 
{
  "red": number,
  "green": number,
  "blue": number
}
ช่อง
red

number

องค์ประกอบสีแดงของสี ตั้งแต่ 0.0 ถึง 1.0
green

number

องค์ประกอบสีเขียวของสี ตั้งแต่ 0.0 ถึง 1.0
blue

number

องค์ประกอบสีฟ้าของสีตั้งแต่ 0.0 ถึง 1.0

มิติข้อมูล

ขนาดในทิศทางเดียวในหน่วยที่ระบุ

การแสดง JSON 
{
  "magnitude": number,
  "unit": enum (Unit)
}
ช่อง
magnitude

number

ขนาด
unit

enum (Unit)

หน่วยสำหรับขนาด

หน่วย

หน่วยวัด

Enum
UNIT_UNSPECIFIED ไม่รู้จักหน่วย
PT หนึ่งจุด ขนาด 1/72 นิ้ว

ตระกูลแบบอักษรถ่วงน้ำหนัก

หมายถึงชุดแบบอักษรและน้ำหนักของข้อความ

การแสดง JSON 
{
  "fontFamily": string,
  "weight": integer
}
ช่อง
fontFamily

string

ชุดแบบอักษรของข้อความ

ชุดแบบอักษรสามารถใช้แบบอักษรใดก็ได้จากเมนูแบบอักษรในเอกสารหรือจาก Google Fonts หากไม่รู้จักชื่อแบบอักษร ข้อความจะแสดงผลเป็น Arial
weight

integer

น้ำหนักของแบบอักษร ช่องนี้จะมีค่าใดก็ได้ที่เป็นผลคูณของ 100 ระหว่าง 100 ถึง 900 ช่วงนี้สอดคล้องกับค่าตัวเลขที่อธิบายไว้ในข้อกำหนด CSS 2.1 ส่วนที่ 15.6 ซึ่งไม่อนุญาตให้ใช้ค่าที่ไม่ใช่ตัวเลข

ค่าเริ่มต้นคือ 400 ("ปกติ")

น้ำหนักแบบอักษรเป็นเพียงองค์ประกอบหนึ่งของน้ำหนักแบบอักษรที่แสดงผล การรวมกันของ weight และค่า bold ที่ได้รับการแก้ไขของรูปแบบข้อความจะเป็นตัวกำหนดน้ำหนักที่แสดงผล หลังจากพิจารณาการสืบทอดแล้ว ดังนี้

  • หากข้อความเป็นตัวหนาและน้ำหนักน้อยกว่า 400 น้ำหนักที่แสดงผลคือ 400
  • หากข้อความเป็นตัวหนาและน้ำหนักมากกว่าหรือเท่ากับ 400 แต่น้อยกว่า 700 น้ำหนักที่แสดงผลจะเป็น 700
  • หากน้ำหนักมากกว่าหรือเท่ากับ 700 น้ำหนักที่แสดงจะเท่ากับน้ำหนัก
  • หากข้อความไม่เป็นตัวหนา น้ำหนักที่แสดงจะเท่ากับน้ำหนัก

ออฟเซ็ตพื้นฐาน

วิธีที่ใช้ออฟเซ็ตข้อความในแนวตั้งจากตำแหน่งปกติ

Enum
BASELINE_OFFSET_UNSPECIFIED ออฟเซ็ตเส้นฐานของข้อความจะรับค่ามาจากระดับบนสุด
NONE ข้อความไม่ได้ถูกออฟเซ็ตในแนวตั้ง
SUPERSCRIPT ข้อความถูกออฟเซ็ตในแนวตั้งขึ้น (ตัวยก)
SUBSCRIPT ข้อความออฟเซ็ตแนวตั้งลงด้านล่าง (ตัวห้อย)

รูปแบบข้อความที่แนะนำ

แนะนำให้ทำการเปลี่ยนแปลงกับ TextStyle

การแสดง JSON 
{
  "textStyle": {
    object (TextStyle)
  },
  "textStyleSuggestionState": {
    object (TextStyleSuggestionState)
  }
}
ช่อง
textStyle

object (TextStyle)

TextStyle ที่มีเฉพาะการเปลี่ยนแปลงในคำแนะนำนี้ ซึ่งสามารถใช้ร่วมกับ textStyleSuggestionState เพื่อดูว่าช่องใดมีการเปลี่ยนแปลงและค่าใหม่
textStyleSuggestionState

object (TextStyleSuggestionState)

มาสก์ที่ระบุว่ามีการเปลี่ยนแปลงช่องใดบนฐาน TextStyle ในคำแนะนำนี้

สถานะคำแนะนำรูปแบบข้อความ

มาสก์ที่ระบุว่ามีการเปลี่ยนแปลงช่องใดบนฐาน TextStyle ในคำแนะนำนี้ จะมีค่าที่แนะนำใหม่สำหรับทุกช่องที่ตั้งค่าเป็น "จริง"

การแสดง JSON 
{
  "boldSuggested": boolean,
  "italicSuggested": boolean,
  "underlineSuggested": boolean,
  "strikethroughSuggested": boolean,
  "smallCapsSuggested": boolean,
  "backgroundColorSuggested": boolean,
  "foregroundColorSuggested": boolean,
  "fontSizeSuggested": boolean,
  "weightedFontFamilySuggested": boolean,
  "baselineOffsetSuggested": boolean,
  "linkSuggested": boolean
}
ช่อง
boldSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ bold หรือไม่
italicSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ italic หรือไม่
underlineSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ underline หรือไม่
strikethroughSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ strikethrough หรือไม่
smallCapsSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ smallCaps หรือไม่
backgroundColorSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ backgroundColor หรือไม่
foregroundColorSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ foregroundColor หรือไม่
fontSizeSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ fontSize หรือไม่
weightedFontFamilySuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ weightedFontFamily หรือไม่
baselineOffsetSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ baselineOffset หรือไม่

ข้อความอัตโนมัติ

ParagraphElement ที่แทนจุดในข้อความที่มีการเปลี่ยนแปลงแบบไดนามิกด้วยเนื้อหาที่เปลี่ยนแปลงเมื่อเวลาผ่านไป เช่น เลขหน้า

การแสดง JSON 
{
  "type": enum (Type),
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}
ช่อง
type

enum (Type)

ประเภทของข้อความอัตโนมัตินี้
suggestedInsertionIds[]

string

รหัสการแทรกที่แนะนำ AutoText อาจมีรหัสการแทรกหลายรหัสหากเป็นการเปลี่ยนแปลงที่แนะนําแบบซ้อนกัน หากเว้นว่างไว้ ค่านี้ไม่ใช่การแทรกที่แนะนำ
suggestedDeletionIds[]

string

รหัสการลบที่แนะนำ หากว่างเปล่า หมายความว่าไม่มีการลบเนื้อหานี้ตามที่แนะนำ
textStyle

object (TextStyle)

รูปแบบข้อความของ AutoText นี้
suggestedTextStyleChanges

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

การเปลี่ยนแปลงรูปแบบข้อความที่แนะนำกับข้อความอัตโนมัตินี้ ซึ่งคีย์ตามรหัสคำแนะนำ

ประเภท

ประเภทของข้อความอัตโนมัติ

Enum
TYPE_UNSPECIFIED ประเภทข้อความอัตโนมัติที่ไม่ระบุ
PAGE_NUMBER พิมพ์ข้อความอัตโนมัติที่แสดงถึงหมายเลขหน้าปัจจุบัน
PAGE_COUNT พิมพ์ข้อความอัตโนมัติที่แสดงถึงจำนวนหน้าทั้งหมดในเอกสาร

ตัวแบ่งหน้า

ParagraphElement แสดงตัวแบ่งหน้า ตัวแบ่งหน้าจะทำให้ข้อความที่ตามมาเริ่มต้นที่ด้านบนสุดของหน้าถัดไป

การแสดง JSON 
{
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}
ช่อง
suggestedInsertionIds[]

string

รหัสการแทรกที่แนะนำ PageBreak อาจมีรหัสการแทรกหลายรหัสหากเป็นการเปลี่ยนแปลงที่แนะนําแบบซ้อนกัน หากเว้นว่างไว้ ค่านี้ไม่ใช่การแทรกที่แนะนำ
suggestedDeletionIds[]

string

รหัสการลบที่แนะนำ หากว่างเปล่า หมายความว่าไม่มีการลบเนื้อหานี้ตามที่แนะนำ
textStyle

object (TextStyle)

รูปแบบข้อความของตัวแบ่งหน้านี้

เช่นเดียวกับเนื้อหาข้อความ เช่น การวิ่งข้อความและการอ้างอิงเชิงอรรถ สไตล์ข้อความของตัวแบ่งหน้าอาจส่งผลต่อเค้าโครงเนื้อหาและการจัดรูปแบบข้อความที่แทรกอยู่ข้างๆ
suggestedTextStyleChanges

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

การเปลี่ยนแปลงรูปแบบข้อความที่แนะนำในตัวแบ่งหน้านี้ ซึ่งคีย์ตามรหัสคำแนะนำ

ตัวแบ่งคอลัมน์

ParagraphElement ที่แสดงถึงตัวแบ่งคอลัมน์ ตัวแบ่งคอลัมน์จะทำให้ข้อความที่ตามมาเริ่มต้นที่ด้านบนของคอลัมน์ถัดไป

การแสดง JSON 
{
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}
ช่อง
suggestedInsertionIds[]

string

รหัสการแทรกที่แนะนำ ColumnBreak อาจมีรหัสการแทรกหลายรหัสหากเป็นการเปลี่ยนแปลงที่แนะนําแบบซ้อนกัน หากเว้นว่างไว้ ค่านี้ไม่ใช่การแทรกที่แนะนำ
suggestedDeletionIds[]

string

รหัสการลบที่แนะนำ หากว่างเปล่า หมายความว่าไม่มีการลบเนื้อหานี้ตามที่แนะนำ
textStyle

object (TextStyle)

รูปแบบข้อความของ ColumnBreak นี้

เช่นเดียวกับเนื้อหาข้อความ เช่น การวิ่งข้อความและการอ้างอิงเชิงอรรถ ลักษณะข้อความของตัวแบ่งคอลัมน์อาจส่งผลต่อเลย์เอาต์เนื้อหาและการจัดรูปแบบข้อความที่แทรกอยู่ข้างๆ
suggestedTextStyleChanges

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

การเปลี่ยนแปลงรูปแบบข้อความที่แนะนำใน ColumnBreak นี้ ซึ่งคีย์ตามรหัสคำแนะนำ

การอ้างอิงในเชิงอรรถ

ParagraphElement ที่แสดงการอ้างอิงเชิงอรรถ การอ้างอิงเชิงอรรถคือเนื้อหาในบรรทัดที่แสดงผลด้วยตัวเลขและใช้เพื่อระบุเชิงอรรถ

การแสดง JSON 
{
  "footnoteId": string,
  "footnoteNumber": string,
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}
ช่อง
footnoteId

string

รหัสของ footnote ที่มีเนื้อหาของการอ้างอิงเชิงอรรถนี้
footnoteNumber

string

จำนวนที่แสดงผลของเชิงอรรถนี้
suggestedInsertionIds[]

string

รหัสการแทรกที่แนะนำ FootnoteReference อาจมีรหัสการแทรกหลายรหัสหากเป็นการเปลี่ยนแปลงที่แนะนําแบบซ้อนกัน หากเว้นว่างไว้ ค่านี้ไม่ใช่การแทรกที่แนะนำ
suggestedDeletionIds[]

string

รหัสการลบที่แนะนำ หากว่างเปล่า หมายความว่าไม่มีการลบเนื้อหานี้ตามที่แนะนำ
textStyle

object (TextStyle)

รูปแบบข้อความของ FootnoteReference นี้
suggestedTextStyleChanges

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

รูปแบบข้อความที่แนะนำจะเปลี่ยนไปใน FootnoteReference นี้ ซึ่งคีย์ตามรหัสคำแนะนำ

เส้นแนวนอน

ParagraphElement แทนเส้นแนวนอน

การแสดง JSON 
{
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}
ช่อง
suggestedInsertionIds[]

string

รหัสการแทรกที่แนะนำ HorizontalRule อาจมีรหัสการแทรกหลายรหัส หากเป็นการเปลี่ยนแปลงที่แนะนำแบบซ้อนหลายระดับ หากเว้นว่างไว้ ค่านี้ไม่ใช่การแทรกที่แนะนำ
suggestedDeletionIds[]

string

รหัสการลบที่แนะนำ หากว่างเปล่า หมายความว่าไม่มีการลบเนื้อหานี้ตามที่แนะนำ
textStyle

object (TextStyle)

รูปแบบข้อความของกฎแนวนอนนี้

เช่นเดียวกับเนื้อหาข้อความ เช่น การทำงานของข้อความและการอ้างอิงเชิงอรรถ รูปแบบข้อความของกฎแนวนอนอาจส่งผลต่อเค้าโครงเนื้อหาและการจัดรูปแบบข้อความที่แทรกอยู่ข้างๆ
suggestedTextStyleChanges

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

การเปลี่ยนแปลงรูปแบบข้อความที่แนะนำใน HorizontalRule นี้ ซึ่งคีย์ตามรหัสคำแนะนำ

สมการ

ParagraphElement แทนสมการ

การแสดง JSON 
{
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ]
}
ช่อง
suggestedInsertionIds[]

string

รหัสการแทรกที่แนะนำ Equation อาจมีรหัสการแทรกหลายรหัสหากเป็นการเปลี่ยนแปลงที่แนะนําแบบซ้อนกัน หากเว้นว่างไว้ ค่านี้ไม่ใช่การแทรกที่แนะนำ
suggestedDeletionIds[]

string

รหัสการลบที่แนะนำ หากว่างเปล่า หมายความว่าไม่มีการลบเนื้อหานี้ตามที่แนะนำ

inlineObjectElement

ParagraphElement ที่มี InlineObject

การแสดง JSON 
{
  "inlineObjectId": string,
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}
ช่อง
inlineObjectId

string

รหัสของ InlineObject องค์ประกอบนี้
suggestedInsertionIds[]

string

รหัสการแทรกที่แนะนำ InlineObjectElement อาจมีรหัสการแทรกหลายรหัสหากเป็นการเปลี่ยนแปลงที่แนะนําแบบซ้อนกัน หากเว้นว่างไว้ ค่านี้ไม่ใช่การแทรกที่แนะนำ
suggestedDeletionIds[]

string

รหัสการลบที่แนะนำ หากว่างเปล่า หมายความว่าไม่มีการลบเนื้อหานี้ตามที่แนะนำ
textStyle

object (TextStyle)

รูปแบบข้อความของ inlineObjectElement นี้

เช่นเดียวกับเนื้อหาข้อความ เช่น การทำงานแบบข้อความและการอ้างอิงเชิงอรรถ รูปแบบข้อความขององค์ประกอบออบเจ็กต์แบบอินไลน์สามารถส่งผลต่อเค้าโครงเนื้อหาและการจัดรูปแบบข้อความที่แทรกอยู่ข้างๆ
suggestedTextStyleChanges

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

รูปแบบข้อความที่แนะนำจะเปลี่ยนแปลงไปกับ inlineObject นี้ ซึ่งคีย์ตามรหัสคำแนะนำ

บุคคล

บุคคลหรืออีเมลที่กล่าวถึงในเอกสาร การพูดถึงเหล่านี้จะทำงานเป็นองค์ประกอบเดียวที่เปลี่ยนแปลงไม่ได้ซึ่งมีชื่อหรืออีเมลของบุคคลนั้น

การแสดง JSON 
{
  "personId": string,
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  },
  "personProperties": {
    object (PersonProperties)
  }
}
ช่อง
personId

string

เอาต์พุตเท่านั้น รหัสที่ไม่ซ้ำกันของลิงก์นี้
suggestedInsertionIds[]

string

รหัสสำหรับคำแนะนำที่แทรกลิงก์ของบุคคลนี้ลงในเอกสาร Person อาจมีรหัสการแทรกหลายรหัสหากเป็นการเปลี่ยนแปลงที่แนะนำที่ซ้อนกัน (เช่น คำแนะนำภายในคำแนะนำของผู้ใช้รายอื่น) หากเว้นว่างไว้ หมายความว่าลิงก์บุคคลนี้ไม่ใช่การแทรกที่แนะนำ
suggestedDeletionIds[]

string

รหัสสำหรับคำแนะนำที่นำลิงก์ของบุคคลนี้ออกจากเอกสาร Person อาจมีรหัสการลบหลายรหัส เช่น ในกรณีที่ผู้ใช้หลายคนแนะนำให้ลบ หากเว้นว่างไว้ ระบบจะไม่แนะนำให้ลบลิงก์นี้
textStyle

object (TextStyle)

รูปแบบข้อความของ Person นี้
suggestedTextStyleChanges

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

การเปลี่ยนแปลงรูปแบบข้อความที่แนะนำใน Person นี้ ซึ่งคีย์ตามรหัสคำแนะนำ
personProperties

object (PersonProperties)

เอาต์พุตเท่านั้น คุณสมบัติของ Person นี้ ช่องนี้แสดงอยู่เสมอ

พร็อพเพอร์ตี้บุคคล

พร็อพเพอร์ตี้เฉพาะของ Person ที่ลิงก์

การแสดง JSON 
{
  "name": string,
  "email": string
}
ช่อง
name

string

เอาต์พุตเท่านั้น ชื่อของบุคคลหากปรากฏในข้อความลิงก์แทนอีเมลของบุคคลนั้น
email

string

เอาต์พุตเท่านั้น อีเมลที่ลิงก์กับ Person นี้ ช่องนี้แสดงอยู่เสมอ

RichLinkProperties

พร็อพเพอร์ตี้เฉพาะของ RichLink

การแสดง JSON 
{
  "title": string,
  "uri": string,
  "mimeType": string
}
ช่อง
title

string

เอาต์พุตเท่านั้น ชื่อของ RichLink ตามที่แสดงในลิงก์ ชื่อนี้ตรงกับชื่อของทรัพยากรที่ลิงก์ขณะที่แทรกหรืออัปเดตลิงก์ครั้งล่าสุด ช่องนี้แสดงอยู่เสมอ
uri

string

เอาต์พุตเท่านั้น URI ไปยัง RichLink จะปรากฏขึ้นเสมอ
mimeType

string

เอาต์พุตเท่านั้น ประเภท MIME ของ RichLink หากมี (เช่น เมื่อเป็นไฟล์ในไดรฟ์)

รูปแบบย่อหน้า

รูปแบบที่ใช้กับทั้งย่อหน้า

รูปแบบย่อหน้าที่รับมาจะแสดงเป็นช่องที่ยังไม่ได้ตั้งค่าในข้อความนี้ ลักษณะของย่อหน้าจะขึ้นอยู่กับว่ามีการกำหนดรูปแบบย่อหน้าไว้ที่ไหน ดังนี้

  • ParagraphStyle ใน Paragraph จะรับค่าจาก named style type ที่ตรงกันของย่อหน้า
  • ParagraphStyle ใน named style รับค่าจากรูปแบบที่มีชื่อ normal text
  • ParagraphStyle ของรูปแบบที่มีชื่อ normal text จะรับค่าจากรูปแบบย่อหน้าเริ่มต้นในเครื่องมือแก้ไขเอกสาร
  • ParagraphStyle ในองค์ประกอบ Paragraph ที่อยู่ในตารางอาจรับค่ารูปแบบย่อหน้ามาจากรูปแบบตาราง

ถ้ารูปแบบย่อหน้าไม่ได้รับช่วงมาจากระดับบนสุด การยกเลิกการตั้งค่าช่องจะเปลี่ยนสไตล์กลับไปเป็นค่าเริ่มต้นในเครื่องมือแก้ไขเอกสาร

การแสดง 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
}
ช่อง
headingId

string

รหัสส่วนหัวของย่อหน้า หากว่างเปล่า แสดงว่าย่อหน้านี้ไม่ใช่ส่วนหัว

พร็อพเพอร์ตี้นี้เป็นแบบอ่านอย่างเดียว
namedStyleType

enum (NamedStyleType)

ประเภทสไตล์ที่มีชื่อของย่อหน้า

เนื่องจากการอัปเดตประเภทสไตล์ที่มีชื่อจะส่งผลต่อพร็อพเพอร์ตี้อื่นๆ ภายใน ParagraphStyle ประเภทสไตล์ที่มีชื่อจึงจะมีผลก่อนที่จะมีการอัปเดตคุณสมบัติอื่นๆ
alignment

enum (Alignment)

การจัดข้อความสำหรับย่อหน้านี้
lineSpacing

number

ระยะห่างระหว่างบรรทัด คิดเป็นเปอร์เซ็นต์ของปกติ ส่วนปกติจะแสดงเป็น 100.0 หากไม่ได้ตั้งค่า ระบบจะรับค่าจากระดับบนสุด
direction

enum (ContentDirection)

ทิศทางข้อความในย่อหน้านี้ หากไม่ได้ตั้งค่า ค่าเริ่มต้นจะเป็น LEFT_TO_RIGHT เนื่องจากจะไม่มีการรับทิศทางของย่อหน้า
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

ย่อหน้าปัจจุบันควรเริ่มต้นในช่วงต้นของหน้าเว็บเสมอหรือไม่ หากไม่ได้ตั้งค่า ระบบจะรับค่าจากระดับบนสุด

การพยายามอัปเดต pageBreakBefore สำหรับย่อหน้าในภูมิภาคที่ไม่รองรับ รวมถึง Table, Header, Footer และ Footnote อาจทำให้สถานะของเอกสารไม่ถูกต้องและแสดงผลข้อผิดพลาด 400 ผิดพลาด

ประเภทสไตล์ที่มีชื่อ

ประเภทของรูปแบบที่มีชื่อ

Enum
NAMED_STYLE_TYPE_UNSPECIFIED ไม่ได้ระบุประเภทของรูปแบบที่มีชื่อ
NORMAL_TEXT ข้อความปกติ
TITLE ชื่อ
SUBTITLE คำบรรยาย
HEADING_1 หัวข้อ 1
HEADING_2 หัวข้อ 2
HEADING_3 หัวข้อ 3.
HEADING_4 หัวข้อ 4.
HEADING_5 หัวข้อ 5.
HEADING_6 หัวข้อ 6.

การจัดข้อความ

ประเภทการจัดข้อความสำหรับย่อหน้า

Enum
ALIGNMENT_UNSPECIFIED การจัดข้อความย่อหน้าจะรับช่วงมาจากระดับบนสุด
START ย่อหน้าจะอยู่ในแนวเดียวกับจุดเริ่มต้นของบรรทัด จัดชิดซ้ายสำหรับข้อความ LTR, จัดชิดขวาหากไม่ใช่
CENTER จัดย่อหน้าให้อยู่ตรงกลาง
END จัดย่อหน้าอยู่ท้ายบรรทัด จัดชิดขวาสำหรับข้อความ LTR, จัดชิดซ้ายหากไม่ใช่
JUSTIFIED ย่อหน้าได้รับการยอมรับ

ทิศทางเนื้อหา

เนื้อหาเส้นทางเข้ามาได้

Enum
CONTENT_DIRECTION_UNSPECIFIED ไม่ได้ระบุทิศทางเนื้อหา
LEFT_TO_RIGHT เนื้อหาจะเปลี่ยนจากซ้ายไปขวา
RIGHT_TO_LEFT เนื้อหาจะเปลี่ยนจากด้านขวาไปซ้าย

โหมดช่องว่าง

โหมดต่างๆ สำหรับระยะห่างระหว่างย่อหน้า

Enum
SPACING_MODE_UNSPECIFIED โหมดระยะห่างจะรับค่ามาจากระดับบนสุด
NEVER_COLLAPSE ระบบจะแสดงระยะห่างของย่อหน้าเสมอ
COLLAPSE_LISTS ระบบจะข้ามระยะห่างระหว่างย่อหน้าระหว่างองค์ประกอบรายการ

เส้นขอบย่อหน้า

เส้นขอบรอบย่อหน้า

การแสดง JSON 
{
  "color": {
    object (OptionalColor)
  },
  "width": {
    object (Dimension)
  },
  "padding": {
    object (Dimension)
  },
  "dashStyle": enum (DashStyle)
}
ช่อง
color

object (OptionalColor)

สีของเส้นขอบ
width

object (Dimension)

ความกว้างของเส้นขอบ
padding

object (Dimension)

ระยะห่างจากขอบของเส้นขอบ
dashStyle

enum (DashStyle)

รูปแบบเส้นประของเส้นขอบ

รูปแบบเส้นประ

ประเภทของเครื่องหมายขีดกลางที่แสดงเรขาคณิตเชิงเส้นได้ ค่าเหล่านี้อิงตามประเภทแบบง่าย "ST_PresetLineDashVal" ที่อธิบายไว้ในส่วน 20.1.10.48 ของ "รูปแบบไฟล์ XML แบบเปิดของ Office - การอ้างอิงภาษามาร์กอัปพื้นฐาน" ตอนที่ 1 ของ ECMA-376 รุ่นที่ 4

Enum
DASH_STYLE_UNSPECIFIED รูปแบบขีดที่ไม่ระบุ
SOLID เส้นทึบ ตรงกับค่า ECMA-376 ST_PresetLineDashVal "คงที่" นี่คือรูปแบบขีดคั่นเริ่มต้น
DOT เส้นจุด เป็นไปตามค่า ECMA-376 ST_PresetLineDashVal "จุด"
DASH เส้นประ ตรงกับค่า "dash" ของ ECMA-376 ST_PresetLineDashVal

การหยุดแท็บ

แท็บหยุดภายในย่อหน้า

การแสดง JSON 
{
  "offset": {
    object (Dimension)
  },
  "alignment": enum (TabStopAlignment)
}
ช่อง
offset

object (Dimension)

ระยะห่างระหว่างตัวกั้นแท็บนี้กับระยะขอบเริ่มต้น
alignment

enum (TabStopAlignment)

การจัดแนวของแท็บนี้จะหยุดลง หากไม่ได้ตั้งค่า ค่าเริ่มต้นจะเป็น START

การจัดแนวแท็บหยุด

การจัดแนวตัวกั้นแท็บ

Enum
TAB_STOP_ALIGNMENT_UNSPECIFIED ไม่ได้ระบุการจัดแนวแท็บ
START ตัวกั้นแท็บจะอยู่ในแนวเดียวกับจุดเริ่มต้นของเส้น โดยตัวเลือกนี้คือค่าเริ่มต้น
CENTER ตัวกั้นแท็บจะอยู่ในแนวเดียวกับกึ่งกลางของเส้น
END ตัวกั้นแท็บจะอยู่ในแนวเดียวกับจุดสิ้นสุดของเส้น

การไล่เฉดสี

เฉดสีของย่อหน้า

การแสดง JSON 
{
  "backgroundColor": {
    object (OptionalColor)
  }
}
ช่อง
backgroundColor

object (OptionalColor)

สีพื้นหลังของการแรเงาย่อหน้านี้

รูปแบบย่อหน้าที่แนะนำ

แนะนำให้ทำการเปลี่ยนแปลงกับ ParagraphStyle

การแสดง JSON 
{
  "paragraphStyle": {
    object (ParagraphStyle)
  },
  "paragraphStyleSuggestionState": {
    object (ParagraphStyleSuggestionState)
  }
}
ช่อง
paragraphStyle

object (ParagraphStyle)

ParagraphStyle ที่มีเฉพาะการเปลี่ยนแปลงในคำแนะนำนี้ ซึ่งสามารถใช้ร่วมกับ paragraphStyleSuggestionState เพื่อดูว่าช่องใดมีการเปลี่ยนแปลงและค่าใหม่
paragraphStyleSuggestionState

object (ParagraphStyleSuggestionState)

มาสก์ที่ระบุว่ามีการเปลี่ยนแปลงช่องใดบนฐาน ParagraphStyle ในคำแนะนำนี้

สถานะคำแนะนำรูปแบบย่อหน้า

มาสก์ที่ระบุว่ามีการเปลี่ยนแปลงช่องใดบนฐาน ParagraphStyle ในคำแนะนำนี้ จะมีค่าที่แนะนำใหม่สำหรับทุกช่องที่ตั้งค่าเป็น "จริง"

การแสดง 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
}
ช่อง
headingIdSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ headingId หรือไม่
namedStyleTypeSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ namedStyleType หรือไม่
alignmentSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ alignment หรือไม่
lineSpacingSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ lineSpacing หรือไม่
directionSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ direction หรือไม่
spacingModeSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ spacingMode หรือไม่
spaceAboveSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ spaceAbove หรือไม่
spaceBelowSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ spaceBelow หรือไม่
borderBetweenSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ borderBetween หรือไม่
borderTopSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ borderTop หรือไม่
borderBottomSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ borderBottom หรือไม่
borderLeftSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ borderLeft หรือไม่
borderRightSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ borderRight หรือไม่
indentFirstLineSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ indentFirstLine หรือไม่
indentStartSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ indentStart หรือไม่
indentEndSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ indentEnd หรือไม่
keepLinesTogetherSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ keepLinesTogether หรือไม่
keepWithNextSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ keepWithNext หรือไม่
avoidWidowAndOrphanSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ avoidWidowAndOrphan หรือไม่
shadingSuggestionState

object (ShadingSuggestionState)

มาสก์ที่ระบุว่าช่องใดใน shading ที่มีการเปลี่ยนแปลงในคำแนะนำนี้
pageBreakBeforeSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ pageBreakBefore หรือไม่

สถานะคำแนะนำการแรเงา

มาสก์ที่ระบุว่ามีการเปลี่ยนแปลงช่องใดบนฐาน Shading ในการเปลี่ยนแปลงที่แนะนำนี้ จะมีค่าที่แนะนำใหม่สำหรับทุกช่องที่ตั้งค่าเป็น "จริง"

การแสดง JSON 
{
  "backgroundColorSuggested": boolean
}
ช่อง
backgroundColorSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำใน Shading หรือไม่

สัญลักษณ์หัวข้อย่อย

อธิบายหัวข้อย่อยของย่อหน้า

การแสดง JSON 
{
  "listId": string,
  "nestingLevel": integer,
  "textStyle": {
    object (TextStyle)
  }
}
ช่อง
listId

string

รหัสของรายการของย่อหน้านี้
nestingLevel

integer

ระดับการซ้อนของย่อหน้านี้ในรายการ
textStyle

object (TextStyle)

รูปแบบข้อความเฉพาะย่อหน้าที่ใช้กับหัวข้อย่อยนี้

หัวข้อย่อยที่แนะนำ

แนะนำให้ทำการเปลี่ยนแปลงกับ Bullet

การแสดง JSON 
{
  "bullet": {
    object (Bullet)
  },
  "bulletSuggestionState": {
    object (BulletSuggestionState)
  }
}
ช่อง
bullet

object (Bullet)

Bullet ที่มีเฉพาะการเปลี่ยนแปลงในคำแนะนำนี้ ซึ่งสามารถใช้ร่วมกับ bulletSuggestionState เพื่อดูว่าช่องใดมีการเปลี่ยนแปลงและค่าใหม่
bulletSuggestionState

object (BulletSuggestionState)

มาสก์ที่ระบุว่ามีการเปลี่ยนแปลงช่องใดบนฐาน Bullet ในคำแนะนำนี้

สถานะคำแนะนำหัวข้อย่อย

มาสก์ที่ระบุว่ามีการเปลี่ยนแปลงช่องใดบนฐาน Bullet ในคำแนะนำนี้ จะมีค่าที่แนะนำใหม่สำหรับทุกช่องที่ตั้งค่าเป็น "จริง"

การแสดง JSON 
{
  "listIdSuggested": boolean,
  "nestingLevelSuggested": boolean,
  "textStyleSuggestionState": {
    object (TextStyleSuggestionState)
  }
}
ช่อง
listIdSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำใน listId หรือไม่
nestingLevelSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำใน nestingLevel หรือไม่
textStyleSuggestionState

object (TextStyleSuggestionState)

มาสก์ที่ระบุว่าช่องใดใน text style ที่มีการเปลี่ยนแปลงในคำแนะนำนี้

ObjectReference

คอลเล็กชันของรหัสออบเจ็กต์

การแสดง JSON 
{
  "objectIds": [
    string
  ]
}
ช่อง
objectIds[]

string

รหัสออบเจ็กต์

ตัวแบ่งส่วน

StructuralElement ที่แสดงถึงตัวแบ่งส่วน ส่วนคือช่วงของเนื้อหาที่มี SectionStyle เหมือนกัน ตัวแบ่งส่วนแสดงถึงการเริ่มต้นส่วนใหม่ และรูปแบบของส่วนจะใช้กับส่วนหลังจากตัวแบ่งส่วน

เนื้อหาเอกสารจะเริ่มต้นด้วยตัวแบ่งส่วนเสมอ

การแสดง JSON 
{
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "sectionStyle": {
    object (SectionStyle)
  }
}
ช่อง
suggestedInsertionIds[]

string

รหัสการแทรกที่แนะนำ SectionBreak อาจมีรหัสการแทรกหลายรหัสหากเป็นการเปลี่ยนแปลงที่แนะนําแบบซ้อนกัน หากเว้นว่างไว้ ค่านี้ไม่ใช่การแทรกที่แนะนำ
suggestedDeletionIds[]

string

รหัสการลบที่แนะนำ หากว่างเปล่า หมายความว่าไม่มีการลบเนื้อหานี้ตามที่แนะนำ
sectionStyle

object (SectionStyle)

รูปแบบของส่วนหลังจากตัวแบ่งส่วนนี้

รูปแบบของส่วน

การจัดรูปแบบที่ใช้กับส่วน

การแสดง 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
}
ช่อง
columnProperties[]

object (SectionColumnProperties)

คุณสมบัติของคอลัมน์ของส่วน

ถ้าเว้นว่างไว้ ส่วนนี้จะมีคอลัมน์ 1 คอลัมน์ที่มีพร็อพเพอร์ตี้เริ่มต้นในเครื่องมือแก้ไขเอกสาร อัปเดตส่วนให้มีคอลัมน์ได้ไม่เกิน 3 คอลัมน์

เมื่ออัปเดตพร็อพเพอร์ตี้นี้ คุณจะต้องตั้งค่าค่าที่เป็นรูปธรรม การยกเลิกการตั้งค่าพร็อพเพอร์ตี้นี้จะทำให้เกิดข้อผิดพลาดเกี่ยวกับคำขอที่ไม่ถูกต้อง 400
columnSeparatorStyle

enum (ColumnSeparatorStyle)

รูปแบบของตัวแบ่งคอลัมน์

สไตล์นี้ตั้งค่าได้แม้ว่าจะมีคอลัมน์เดียวในส่วนก็ตาม

เมื่ออัปเดตพร็อพเพอร์ตี้นี้ คุณจะต้องตั้งค่าค่าที่เป็นรูปธรรม การยกเลิกการตั้งค่าพร็อพเพอร์ตี้นี้จะทำให้เกิดข้อผิดพลาด 400 คำขอผิดพลาด
contentDirection

enum (ContentDirection)

ทิศทางเนื้อหาของหัวข้อนี้ หากไม่ได้ตั้งค่า ค่าเริ่มต้นจะเป็น LEFT_TO_RIGHT

เมื่ออัปเดตพร็อพเพอร์ตี้นี้ คุณจะต้องตั้งค่าค่าที่เป็นรูปธรรม การยกเลิกการตั้งค่าพร็อพเพอร์ตี้นี้จะทำให้เกิดข้อผิดพลาด 400 คำขอผิดพลาด
marginTop

object (Dimension)

ระยะขอบหน้าบนของส่วน หากไม่ได้ตั้งค่า ค่าเริ่มต้นจาก DocumentStyle จะเป็น marginTop

เมื่ออัปเดตพร็อพเพอร์ตี้นี้ คุณจะต้องตั้งค่าค่าที่เป็นรูปธรรม การยกเลิกการตั้งค่าพร็อพเพอร์ตี้นี้จะทำให้เกิดข้อผิดพลาด 400 คำขอผิดพลาด
marginBottom

object (Dimension)

ขอบล่างของส่วน หากไม่ได้ตั้งค่า ค่าเริ่มต้นจาก DocumentStyle จะเป็น marginBottom

เมื่ออัปเดตพร็อพเพอร์ตี้นี้ คุณจะต้องตั้งค่าค่าที่เป็นรูปธรรม การยกเลิกการตั้งค่าพร็อพเพอร์ตี้นี้จะทำให้เกิดข้อผิดพลาด 400 คำขอผิดพลาด
marginRight

object (Dimension)

ขอบหน้าด้านขวาของส่วนนี้ หากไม่ได้ตั้งค่า ค่าเริ่มต้นจาก DocumentStyle จะเป็น marginRight การอัปเดตขอบด้านขวาจะทำให้คอลัมน์ในส่วนนี้ปรับขนาด เนื่องจากระยะขอบมีผลต่อความกว้างของคอลัมน์ จึงใช้ก่อนคุณสมบัติของคอลัมน์

เมื่ออัปเดตพร็อพเพอร์ตี้นี้ คุณจะต้องตั้งค่าค่าที่เป็นรูปธรรม การยกเลิกการตั้งค่าพร็อพเพอร์ตี้นี้จะทำให้เกิดข้อผิดพลาด 400 คำขอผิดพลาด
marginLeft

object (Dimension)

ขอบหน้าด้านซ้ายของส่วนนี้ หากไม่ได้ตั้งค่า ค่าเริ่มต้นจาก DocumentStyle จะเป็น marginLeft การอัปเดตขอบด้านซ้ายจะทำให้คอลัมน์ในส่วนนี้ปรับขนาด เนื่องจากระยะขอบมีผลต่อความกว้างของคอลัมน์ จึงใช้ก่อนคุณสมบัติของคอลัมน์

เมื่ออัปเดตพร็อพเพอร์ตี้นี้ คุณจะต้องตั้งค่าค่าที่เป็นรูปธรรม การยกเลิกการตั้งค่าพร็อพเพอร์ตี้นี้จะทำให้เกิดข้อผิดพลาด 400 คำขอผิดพลาด
marginHeader

object (Dimension)

ระยะขอบส่วนหัวของส่วนนี้ หากไม่ได้ตั้งค่า ค่าเริ่มต้นจาก DocumentStyle จะเป็น marginHeader หากอัปเดตแล้ว ระบบจะตั้งค่า useCustomHeaderFooterMargins เป็น "จริง" ใน DocumentStyle ค่าของ useCustomHeaderFooterMargins ใน DocumentStyle ระบุว่ามีการใช้ระยะขอบส่วนหัวสำหรับส่วนนี้หรือไม่

เมื่ออัปเดตพร็อพเพอร์ตี้นี้ คุณจะต้องตั้งค่าค่าที่เป็นรูปธรรม การยกเลิกการตั้งค่าพร็อพเพอร์ตี้นี้จะทำให้เกิดข้อผิดพลาด 400 คำขอผิดพลาด
sectionType

enum (SectionType)

เอาต์พุตเท่านั้น ประเภทของส่วน
defaultHeaderId

string

รหัสของส่วนหัวเริ่มต้น หากไม่ได้ตั้งค่า ค่าจะรับช่วงจาก SectionBreak'sSectionStyle ก่อนหน้า หากไม่มีการตั้งค่าในSectionBreak แรก ระบบจะรับค่าจาก defaultHeaderId ของ DocumentStyle

พร็อพเพอร์ตี้นี้เป็นแบบอ่านอย่างเดียว
firstPageHeaderId

string

รหัสของส่วนหัวใช้กับหน้าแรกของส่วนเท่านั้น หาก useFirstPageHeaderFooter เป็นจริง ระบบจะใช้ค่านี้เป็นส่วนหัวในหน้าแรกของส่วนนั้นๆ ถ้าเป็นเท็จ ส่วนหัวในหน้าแรกของส่วนจะใช้ defaultHeaderId หากไม่ได้ตั้งค่า ค่าจะรับช่วงจาก SectionBreak'sSectionStyle ก่อนหน้า หากไม่มีการตั้งค่าในSectionBreak แรก ระบบจะรับค่าจาก firstPageHeaderId ของ DocumentStyle

พร็อพเพอร์ตี้นี้เป็นแบบอ่านอย่างเดียว
firstPageFooterId

string

รหัสของส่วนท้ายใช้สำหรับหน้าแรกของส่วนเท่านั้น หาก useFirstPageHeaderFooter เป็นจริง ระบบจะใช้ค่านี้กับส่วนท้ายในหน้าแรกของส่วนดังกล่าว หากตั้งค่าเป็นเท็จ ส่วนท้ายในหน้าแรกของส่วนจะใช้ defaultFooterId หากไม่ได้ตั้งค่า ค่าจะรับช่วงจาก SectionBreak'sSectionStyle ก่อนหน้า หากไม่มีการตั้งค่าในSectionBreak แรก ระบบจะรับค่าจาก firstPageFooterId ของ DocumentStyle

พร็อพเพอร์ตี้นี้เป็นแบบอ่านอย่างเดียว
evenPageHeaderId

string

รหัสของส่วนหัวใช้สำหรับหน้าเลขคู่เท่านั้น หากค่า useEvenPageHeaderFooter ของ DocumentStyle เป็นจริง ระบบจะใช้ค่านี้สำหรับส่วนหัวของหน้าเลขคู่ในส่วน หากตั้งค่าเป็นเท็จ ส่วนหัวในหน้าเลขคู่จะใช้ defaultHeaderId หากไม่ได้ตั้งค่า ค่าจะรับช่วงจาก SectionBreak'sSectionStyle ก่อนหน้า หากไม่มีการตั้งค่าในSectionBreak แรก ระบบจะรับค่าจาก evenPageHeaderId ของ DocumentStyle

พร็อพเพอร์ตี้นี้เป็นแบบอ่านอย่างเดียว
evenPageFooterId

string

รหัสของส่วนท้ายใช้เฉพาะสำหรับหน้าเลขคู่ หากค่า useEvenPageHeaderFooter ของ DocumentStyle เป็นจริง ระบบจะใช้ค่านี้กับส่วนท้ายของหน้าเลขคู่ในส่วนดังกล่าว หากตั้งค่าเป็นเท็จ ส่วนท้ายของหน้าเลขคู่จะใช้ defaultFooterId หากไม่ได้ตั้งค่า ค่าจะรับช่วงจาก SectionBreak'sSectionStyle ก่อนหน้า หากไม่มีการตั้งค่าในSectionBreak แรก ระบบจะรับค่าจาก evenPageFooterId ของ DocumentStyle

พร็อพเพอร์ตี้นี้เป็นแบบอ่านอย่างเดียว
useFirstPageHeaderFooter

boolean

ระบุว่าจะใช้รหัสส่วนหัว / ส่วนท้ายของหน้าแรกสำหรับหน้าแรกของส่วนหรือไม่ หากไม่ได้ตั้งค่า ระบบจะรับค่าจาก useFirstPageHeaderFooter ของ DocumentStyle สำหรับส่วนแรก หากไม่ได้ตั้งค่าไว้สำหรับภาคส่วนต่อๆ ไป ควรตีความว่าเป็นเท็จ

เมื่ออัปเดตพร็อพเพอร์ตี้นี้ คุณจะต้องตั้งค่าค่าที่เป็นรูปธรรม การยกเลิกการตั้งค่าพร็อพเพอร์ตี้นี้จะทำให้เกิดข้อผิดพลาด 400 คำขอผิดพลาด
pageNumberStart

integer

หมายเลขหน้าที่จะเริ่มนับจํานวนหน้าสําหรับส่วนนี้ หากไม่ได้ตั้งค่า การจัดเลขหน้าจะดำเนินการต่อจากส่วนก่อนหน้า หากไม่ได้ตั้งค่าใน SectionBreak แรก โปรดดู pageNumberStart ของ DocumentStyle

เมื่ออัปเดตพร็อพเพอร์ตี้นี้ คุณจะต้องตั้งค่าค่าที่เป็นรูปธรรม การยกเลิกการตั้งค่าพร็อพเพอร์ตี้นี้จะทำให้เกิดข้อผิดพลาด 400 คำขอผิดพลาด
flipPageOrientation

boolean

ไม่บังคับ ระบุว่าจะพลิกขนาดของ pageSize ของ DocumentStyle สำหรับส่วนนี้หรือไม่ ซึ่งจะช่วยให้เปลี่ยนการวางแนวของหน้าระหว่างแนวตั้งและแนวนอนได้ หากไม่ได้ตั้งค่า จะรับค่าจาก flipPageOrientation ของ DocumentStyle

เมื่ออัปเดตพร็อพเพอร์ตี้นี้ คุณจะต้องตั้งค่าค่าที่เป็นรูปธรรม การยกเลิกการตั้งค่าพร็อพเพอร์ตี้นี้จะทำให้เกิดข้อผิดพลาด 400 คำขอผิดพลาด

พร็อพเพอร์ตี้ส่วนคอลัมน์

พร็อพเพอร์ตี้ที่ใช้กับคอลัมน์ของส่วน

การแสดง JSON 
{
  "width": {
    object (Dimension)
  },
  "paddingEnd": {
    object (Dimension)
  }
}
ช่อง
width

object (Dimension)

เอาต์พุตเท่านั้น ความกว้างของคอลัมน์
paddingEnd

object (Dimension)

ระยะห่างจากขอบที่ปลายคอลัมน์

สไตล์ตัวแบ่งคอลัมน์

รูปแบบของตัวแบ่งคอลัมน์ระหว่างคอลัมน์

Enum
COLUMN_SEPARATOR_STYLE_UNSPECIFIED รูปแบบตัวคั่นคอลัมน์ที่ไม่ระบุ
NONE ไม่มีเส้นแบ่งคอลัมน์ระหว่างคอลัมน์
BETWEEN_EACH_COLUMN แสดงเส้นแบ่งคอลัมน์ระหว่างแต่ละคอลัมน์

ประเภทส่วน

แสดงการจัดตำแหน่งจุดเริ่มต้นของส่วนปัจจุบันเมื่อเทียบกับส่วนก่อนหน้า

Enum
SECTION_TYPE_UNSPECIFIED ไม่ได้ระบุประเภทหัวข้อ
CONTINUOUS ส่วนนี้จะเริ่มต้นทันทีหลังจากย่อหน้าสุดท้ายของส่วนก่อนหน้า
NEXT_PAGE ส่วนนี้จะเริ่มต้นในหน้าถัดไป

ตาราง

StructuralElement แทนตาราง

การแสดง JSON 
{
  "rows": integer,
  "columns": integer,
  "tableRows": [
    {
      object (TableRow)
    }
  ],
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "tableStyle": {
    object (TableStyle)
  }
}
ช่อง
rows

integer

จำนวนแถวในตาราง
columns

integer

จำนวนคอลัมน์ในตาราง

แต่ตารางอาจไม่ได้เป็นสี่เหลี่ยมผืนผ้า ดังนั้นบางแถวอาจมีจำนวนเซลล์ต่างกัน
tableRows[]

object (TableRow)

เนื้อหาและรูปแบบของแต่ละแถว
suggestedInsertionIds[]

string

รหัสการแทรกที่แนะนำ Table อาจมีรหัสการแทรกหลายรหัสหากเป็นการเปลี่ยนแปลงที่แนะนําแบบซ้อนกัน หากเว้นว่างไว้ ค่านี้ไม่ใช่การแทรกที่แนะนำ
suggestedDeletionIds[]

string

รหัสการลบที่แนะนำ หากว่างเปล่า หมายความว่าไม่มีการลบเนื้อหานี้ตามที่แนะนำ
tableStyle

object (TableStyle)

รูปแบบของตาราง

แถวบนโต๊ะ

เนื้อหาและรูปแบบของแถวใน Table

การแสดง JSON 
{
  "startIndex": integer,
  "endIndex": integer,
  "tableCells": [
    {
      object (TableCell)
    }
  ],
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "tableRowStyle": {
    object (TableRowStyle)
  },
  "suggestedTableRowStyleChanges": {
    string: {
      object (SuggestedTableRowStyle)
    },
    ...
  }
}
ช่อง
startIndex

integer

ดัชนีเริ่มต้นแบบศูนย์ของแถวนี้ในหน่วยโค้ด UTF-16
endIndex

integer

ดัชนีปิดท้ายแบบศูนย์ของแถวนี้ อยู่ในหน่วยโค้ด UTF-16 โดยเฉพาะ
tableCells[]

object (TableCell)

เนื้อหาและรูปแบบของแต่ละเซลล์ในแถวนี้

แต่ตารางอาจไม่ได้เป็นสี่เหลี่ยมผืนผ้า ดังนั้นบางแถวอาจมีจำนวนเซลล์แตกต่างจากแถวอื่นๆ ในตารางเดียวกัน
suggestedInsertionIds[]

string

รหัสการแทรกที่แนะนำ TableRow อาจมีรหัสการแทรกหลายรหัสหากเป็นการเปลี่ยนแปลงที่แนะนําแบบซ้อนกัน หากเว้นว่างไว้ ค่านี้ไม่ใช่การแทรกที่แนะนำ
suggestedDeletionIds[]

string

รหัสการลบที่แนะนำ หากว่างเปล่า หมายความว่าไม่มีการลบเนื้อหานี้ตามที่แนะนำ
tableRowStyle

object (TableRowStyle)

รูปแบบของแถวในตาราง
suggestedTableRowStyleChanges

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

การเปลี่ยนแปลงสไตล์ที่แนะนำในแถวนี้ ซึ่งคีย์ตามรหัสคำแนะนำ

เซลล์บนโต๊ะ

เนื้อหาและรูปแบบของเซลล์ใน Table

การแสดง JSON 
{
  "startIndex": integer,
  "endIndex": integer,
  "content": [
    {
      object (StructuralElement)
    }
  ],
  "tableCellStyle": {
    object (TableCellStyle)
  },
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "suggestedTableCellStyleChanges": {
    string: {
      object (SuggestedTableCellStyle)
    },
    ...
  }
}
ช่อง
startIndex

integer

ดัชนีเริ่มต้นแบบศูนย์ของเซลล์นี้ในหน่วยโค้ด UTF-16
endIndex

integer

ดัชนีสิ้นสุดแบบฐานศูนย์ของเซลล์นี้ อยู่ในหน่วยโค้ด UTF-16 โดยเฉพาะ
content[]

object (StructuralElement)

เนื้อหาของเซลล์
tableCellStyle

object (TableCellStyle)

รูปแบบของเซลล์
suggestedInsertionIds[]

string

รหัสการแทรกที่แนะนำ TableCell อาจมีรหัสการแทรกหลายรหัสหากเป็นการเปลี่ยนแปลงที่แนะนําแบบซ้อนกัน หากเว้นว่างไว้ ค่านี้ไม่ใช่การแทรกที่แนะนำ
suggestedDeletionIds[]

string

รหัสการลบที่แนะนำ หากว่างเปล่า หมายความว่าไม่มีการลบเนื้อหานี้ตามที่แนะนำ
suggestedTableCellStyleChanges

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

การเปลี่ยนแปลงที่แนะนำในรูปแบบเซลล์ตาราง ซึ่งคีย์ตามรหัสคำแนะนำ

รูปแบบเซลล์โต๊ะ

รูปแบบของ TableCell

รูปแบบเซลล์ของตารางที่รับค่ามาจะแสดงเป็นช่องที่ยังไม่ได้ตั้งค่าในข้อความนี้ รูปแบบเซลล์ของตารางจะรับค่าจากรูปแบบของตาราง

การแสดง 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)
}
ช่อง
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)

การจัดแนวของเนื้อหาในเซลล์ตาราง การจัดข้อความเริ่มต้นจะตรงกับการจัดข้อความของเซลล์ตารางที่สร้างขึ้นใหม่ในเครื่องมือแก้ไขเอกสาร

เส้นขอบของเซลล์ในตาราง

เส้นขอบรอบเซลล์ของตาราง

เส้นขอบของเซลล์ตารางต้องไม่โปร่งใส หากต้องการซ่อนเส้นขอบของเซลล์ตาราง ให้กำหนดความกว้างเป็น 0

การแสดง JSON 
{
  "color": {
    object (OptionalColor)
  },
  "width": {
    object (Dimension)
  },
  "dashStyle": enum (DashStyle)
}
ช่อง
color

object (OptionalColor)

สีของเส้นขอบ

สีนี้ต้องไม่โปร่งใส
width

object (Dimension)

ความกว้างของเส้นขอบ
dashStyle

enum (DashStyle)

รูปแบบเส้นประของเส้นขอบ

ความสอดคล้องของเนื้อหา

ประเภทการจัดแนวเนื้อหา

ดึงมาจากค่าย่อยของประเภทแบบง่าย "ST_TextAnchoringType" ในส่วน 20.1.10.59 ของ "Office Open XML File Formats - Fundamentals and Markup Language Reference" ตอนที่ 1 ของ ECMA-376 4th Edition

Enum
CONTENT_ALIGNMENT_UNSPECIFIED การจัดแนวเนื้อหาที่ไม่ระบุ การจัดแนวเนื้อหาจะรับค่ามาจากระดับบนสุด (หากมี)
CONTENT_ALIGNMENT_UNSUPPORTED การวางแนวเนื้อหาที่ไม่รองรับ
TOP การจัดแนวเนื้อหาให้อยู่ด้านบนสุดของเจ้าของเนื้อหา ตรงกับ ECMA-376 ST_TextAnchoringType "t"
MIDDLE การจัดแนวเนื้อหาให้อยู่กึ่งกลางของเจ้าของเนื้อหา ตรงกับ ECMA-376 ST_TextAnchoringType 'ctr'
BOTTOM การจัดแนวเนื้อหาให้อยู่ด้านล่างของเจ้าของเนื้อหา ตรงกับ ECMA-376 ST_TextAnchoringType 'b'

รูปแบบเซลล์ตารางที่แนะนำ

แนะนำให้ทำการเปลี่ยนแปลงกับ TableCellStyle

การแสดง JSON 
{
  "tableCellStyle": {
    object (TableCellStyle)
  },
  "tableCellStyleSuggestionState": {
    object (TableCellStyleSuggestionState)
  }
}
ช่อง
tableCellStyle

object (TableCellStyle)

TableCellStyle ที่มีเฉพาะการเปลี่ยนแปลงในคำแนะนำนี้ ซึ่งสามารถใช้ร่วมกับ tableCellStyleSuggestionState เพื่อดูว่าช่องใดมีการเปลี่ยนแปลงและค่าใหม่
tableCellStyleSuggestionState

object (TableCellStyleSuggestionState)

มาสก์ที่ระบุว่ามีการเปลี่ยนแปลงช่องใดบนฐาน TableCellStyle ในคำแนะนำนี้

สถานะคำแนะนำรูปแบบเซลล์ของตาราง

มาสก์ที่ระบุว่ามีการเปลี่ยนแปลงช่องใดบนฐาน TableCellStyle ในคำแนะนำนี้ จะมีค่าที่แนะนำใหม่สำหรับทุกช่องที่ตั้งค่าเป็น "จริง"

การแสดง 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
}
ช่อง
rowSpanSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ rowSpan หรือไม่
columnSpanSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ columnSpan หรือไม่
backgroundColorSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ backgroundColor หรือไม่
borderLeftSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ borderLeft หรือไม่
borderRightSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ borderRight หรือไม่
borderTopSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ borderTop หรือไม่
borderBottomSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ borderBottom หรือไม่
paddingLeftSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ paddingLeft หรือไม่
paddingRightSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ paddingRight หรือไม่
paddingTopSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ paddingTop หรือไม่
paddingBottomSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ paddingBottom หรือไม่
contentAlignmentSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ contentAlignment หรือไม่

รูปแบบแถวโต๊ะ

รูปแบบที่ใช้กับแถวในตาราง

การแสดง JSON 
{
  "minRowHeight": {
    object (Dimension)
  },
  "tableHeader": boolean,
  "preventOverflow": boolean
}
ช่อง
minRowHeight

object (Dimension)

ความสูงต่ำสุดของแถว ระบบจะแสดงแถวในเครื่องมือแก้ไขเอกสารที่ความสูงเท่ากับหรือมากกว่าค่านี้ เพื่อแสดงเนื้อหาทั้งหมดในเซลล์ของแถว
tableHeader

boolean

แถวเป็นส่วนหัวของตารางหรือไม่
preventOverflow

boolean

ระบุว่าแถวต้องไม่ซ้ำกับขอบเขตหน้าหรือคอลัมน์

รูปแบบแถวตารางที่แนะนำ

แนะนำให้ทำการเปลี่ยนแปลงกับ TableRowStyle

การแสดง JSON 
{
  "tableRowStyle": {
    object (TableRowStyle)
  },
  "tableRowStyleSuggestionState": {
    object (TableRowStyleSuggestionState)
  }
}
ช่อง
tableRowStyle

object (TableRowStyle)

TableRowStyle ที่มีเฉพาะการเปลี่ยนแปลงในคำแนะนำนี้ ซึ่งสามารถใช้ร่วมกับ tableRowStyleSuggestionState เพื่อดูว่าช่องใดมีการเปลี่ยนแปลงและค่าใหม่
tableRowStyleSuggestionState

object (TableRowStyleSuggestionState)

มาสก์ที่ระบุว่ามีการเปลี่ยนแปลงช่องใดบนฐาน TableRowStyle ในคำแนะนำนี้

สถานะคำแนะนำรูปแบบแถวของตาราง

มาสก์ที่ระบุว่ามีการเปลี่ยนแปลงช่องใดบนฐาน TableRowStyle ในคำแนะนำนี้ จะมีค่าที่แนะนำใหม่สำหรับทุกช่องที่ตั้งค่าเป็น "จริง"

การแสดง JSON 
{
  "minRowHeightSuggested": boolean
}
ช่อง
minRowHeightSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ minRowHeight หรือไม่

รูปแบบตาราง

รูปแบบที่ใช้กับตาราง

การแสดง JSON 
{
  "tableColumnProperties": [
    {
      object (TableColumnProperties)
    }
  ]
}
ช่อง
tableColumnProperties[]

object (TableColumnProperties)

คุณสมบัติของแต่ละคอลัมน์

โปรดทราบว่าในเอกสาร ตารางจะมีแถวและแถวที่มีเซลล์ ซึ่งคล้ายกับ HTML พร็อพเพอร์ตี้สำหรับแถวจะอยู่ใน tableRowStyle ของแถว

พร็อพเพอร์ตี้คอลัมน์ของตาราง

คุณสมบัติของคอลัมน์ในตาราง

การแสดง JSON 
{
  "widthType": enum (WidthType),
  "width": {
    object (Dimension)
  }
}
ช่อง
widthType

enum (WidthType)

ประเภทความกว้างของคอลัมน์
width

object (Dimension)

ความกว้างของคอลัมน์ ตั้งค่าเมื่อ widthType ของคอลัมน์เป็น FIXED_WIDTH

ประเภทความกว้าง

ประเภทความกว้างของคอลัมน์

Enum
WIDTH_TYPE_UNSPECIFIED ไม่ได้ระบุประเภทความกว้างของคอลัมน์
EVENLY_DISTRIBUTED

ความกว้างของคอลัมน์จะกระจายไปยังคอลัมน์อื่นๆ ที่กระจายอย่างเท่าๆ กัน

ความกว้างของคอลัมน์จะถูกกำหนดโดยอัตโนมัติและจะมีส่วนที่เท่ากันของความกว้างที่เหลืออยู่สำหรับตารางหลังจากพิจารณาคอลัมน์ทั้งหมดซึ่งมีความกว้างที่ระบุไว้
FIXED_WIDTH ความกว้างของคอลัมน์คงที่ พร็อพเพอร์ตี้ [width][google.apps.docs.v1.TableColumnProperties.width] มีความกว้างของคอลัมน์

สารบัญ

StructuralElement แสดงสารบัญ

การแสดง JSON 
{
  "content": [
    {
      object (StructuralElement)
    }
  ],
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ]
}
ช่อง
content[]

object (StructuralElement)

เนื้อหาของสารบัญ
suggestedInsertionIds[]

string

รหัสการแทรกที่แนะนำ TableOfContents อาจมีรหัสการแทรกหลายรหัส หากเป็นการเปลี่ยนแปลงที่แนะนำแบบซ้อนหลายระดับ หากเว้นว่างไว้ ค่านี้ไม่ใช่การแทรกที่แนะนำ
suggestedDeletionIds[]

string

รหัสการลบที่แนะนำ หากว่างเปล่า หมายความว่าไม่มีการลบเนื้อหานี้ตามที่แนะนำ

หมายเหตุ

เชิงอรรถของเอกสาร

การแสดง JSON 
{
  "footnoteId": string,
  "content": [
    {
      object (StructuralElement)
    }
  ]
}
ช่อง
footnoteId

string

รหัสของเชิงอรรถ
content[]

object (StructuralElement)

เนื้อหาของเชิงอรรถ

ดัชนีสำหรับเนื้อหาของเชิงอรรถเริ่มต้นที่ศูนย์

รูปแบบเอกสาร

รูปแบบของเอกสาร

การแสดง 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
}
ช่อง
background

object (Background)

พื้นหลังของเอกสาร เอกสารต้องไม่มีสีพื้นหลังแบบโปร่งใส
defaultHeaderId

string

รหัสของส่วนหัวเริ่มต้น หากไม่ได้ตั้งค่า จะไม่มีส่วนหัวเริ่มต้น

พร็อพเพอร์ตี้นี้เป็นแบบอ่านอย่างเดียว
evenPageHeaderId

string

รหัสของส่วนหัวใช้สำหรับหน้าเลขคู่เท่านั้น ค่าของ useEvenPageHeaderFooter จะเป็นตัวกำหนดว่าจะใช้ defaultHeaderId หรือค่านี้สำหรับส่วนหัวในหน้าเลขคู่ หากไม่ได้ตั้งค่า จะไม่มีส่วนหัวหน้าเลขคู่

พร็อพเพอร์ตี้นี้เป็นแบบอ่านอย่างเดียว
evenPageFooterId

string

รหัสของส่วนท้ายใช้เฉพาะสำหรับหน้าเลขคู่ ค่าของ useEvenPageHeaderFooter จะเป็นตัวกำหนดว่าจะใช้ defaultFooterId หรือค่านี้สำหรับส่วนท้ายในหน้าเลขคู่ หากไม่ได้ตั้งค่า จะไม่มีส่วนท้ายของหน้าเลขคู่

พร็อพเพอร์ตี้นี้เป็นแบบอ่านอย่างเดียว
firstPageHeaderId

string

รหัสของส่วนหัวใช้กับหน้าแรกเท่านั้น หากไม่ได้ตั้งค่า จะไม่มีส่วนหัวที่ไม่ซ้ำกันสำหรับหน้าแรก ค่าของ useFirstPageHeaderFooter จะเป็นตัวกำหนดว่าจะใช้ defaultHeaderId หรือค่านี้สำหรับส่วนหัวของหน้าแรก หากไม่ได้ตั้งค่า จะไม่มีส่วนหัวของหน้าแรก

พร็อพเพอร์ตี้นี้เป็นแบบอ่านอย่างเดียว
firstPageFooterId

string

รหัสของส่วนท้ายใช้กับหน้าแรกเท่านั้น หากไม่ได้ตั้งค่า จะไม่มีส่วนท้ายที่ไม่ซ้ำกันสำหรับหน้าแรก ค่าของ useFirstPageHeaderFooter จะเป็นตัวกำหนดว่าจะใช้ defaultFooterId หรือค่านี้สำหรับส่วนท้ายของหน้าแรก หากไม่ได้ตั้งค่า จะไม่มีส่วนท้ายของหน้าแรก

พร็อพเพอร์ตี้นี้เป็นแบบอ่านอย่างเดียว
useFirstPageHeaderFooter

boolean

ระบุว่าจะใช้รหัสส่วนหัว / ส่วนท้ายของหน้าแรกสำหรับหน้าแรกหรือไม่
useEvenPageHeaderFooter

boolean

ระบุว่าจะใช้รหัสส่วนหัว / ส่วนท้ายของหน้าเลขคู่สำหรับหน้าเลขคู่หรือไม่
pageNumberStart

integer

หมายเลขหน้าที่จะเริ่มนับจำนวนหน้า
marginTop

object (Dimension)

ระยะขอบหน้าบน

การอัปเดตระยะขอบหน้าด้านบนของรูปแบบเอกสารจะลบขอบหน้าบนสุดในรูปแบบของส่วนทั้งหมด
marginBottom

object (Dimension)

ขอบล่างของหน้า

การอัปเดตขอบล่างในรูปแบบเอกสารจะลบขอบล่างของสไตล์ส่วนทั้งหมด
marginRight

object (Dimension)

ขอบหน้าที่ถูกต้อง

การอัปเดตขอบหน้าด้านขวาในรูปแบบเอกสารจะลบขอบหน้าด้านขวาในรูปแบบของส่วนทั้งหมด และอาจทำให้คอลัมน์ปรับขนาดในทุกส่วนด้วย
marginLeft

object (Dimension)

ขอบหน้าด้านซ้าย

การอัปเดตขอบหน้าด้านซ้ายในรูปแบบเอกสารจะลบขอบหน้าด้านซ้ายในรูปแบบของส่วนทั้งหมด และอาจทำให้คอลัมน์ปรับขนาดในทุกส่วนด้วย
pageSize

object (Size)

ขนาดของหน้าในเอกสาร
marginHeader

object (Dimension)

ระยะห่างระหว่างด้านบนของหน้าและเนื้อหาของส่วนหัว
flipPageOrientation

boolean

ไม่บังคับ ระบุว่าจะพลิกขนาดของ pageSize หรือไม่ ซึ่งจะช่วยให้เปลี่ยนการวางแนวของหน้าระหว่างแนวตั้งและแนวนอนได้

ที่มา

แสดงพื้นหลังของเอกสาร

การแสดง JSON 
{
  "color": {
    object (OptionalColor)
  }
}
ช่อง
color

object (OptionalColor)

สีพื้นหลัง

ขนาด

ความกว้างและความสูง

การแสดง JSON 
{
  "height": {
    object (Dimension)
  },
  "width": {
    object (Dimension)
  }
}
ช่อง
height

object (Dimension)

ความสูงของวัตถุ
width

object (Dimension)

ความกว้างของวัตถุ

รูปแบบเอกสารที่แนะนำ

การเปลี่ยนแปลงที่แนะนำสำหรับ DocumentStyle

การแสดง JSON 
{
  "documentStyle": {
    object (DocumentStyle)
  },
  "documentStyleSuggestionState": {
    object (DocumentStyleSuggestionState)
  }
}
ช่อง
documentStyle

object (DocumentStyle)

DocumentStyle ที่มีเฉพาะการเปลี่ยนแปลงในคำแนะนำนี้ ซึ่งสามารถใช้ร่วมกับ documentStyleSuggestionState เพื่อดูว่าช่องใดมีการเปลี่ยนแปลงและค่าใหม่
documentStyleSuggestionState

object (DocumentStyleSuggestionState)

มาสก์ที่ระบุว่ามีการเปลี่ยนแปลงช่องใดบนฐาน DocumentStyle ในคำแนะนำนี้

สถานะคำแนะนำรูปแบบเอกสาร

มาสก์ที่ระบุว่ามีการเปลี่ยนแปลงช่องใดบนฐาน DocumentStyle ในคำแนะนำนี้ จะมีค่าที่แนะนำใหม่สำหรับทุกช่องที่ตั้งค่าเป็น "จริง"

การแสดง 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
}
ช่อง
backgroundSuggestionState

object (BackgroundSuggestionState)

มาสก์ที่ระบุว่าช่องใดใน background ที่มีการเปลี่ยนแปลงในคำแนะนำนี้
defaultHeaderIdSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ defaultHeaderId หรือไม่
evenPageHeaderIdSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ evenPageHeaderId หรือไม่
evenPageFooterIdSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ evenPageFooterId หรือไม่
firstPageHeaderIdSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ firstPageHeaderId หรือไม่
firstPageFooterIdSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ firstPageFooterId หรือไม่
useFirstPageHeaderFooterSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ useFirstPageHeaderFooter หรือไม่
useEvenPageHeaderFooterSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ useEvenPageHeaderFooter หรือไม่
pageNumberStartSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ pageNumberStart หรือไม่
marginTopSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ marginTop หรือไม่
marginBottomSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ marginBottom หรือไม่
marginRightSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ marginRight หรือไม่
marginLeftSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ marginLeft หรือไม่
pageSizeSuggestionState

object (SizeSuggestionState)

มาสก์ที่ระบุว่าช่องใดใน [size] [google.apps.docs.v1.DOCUMENTStyle.size] มีการเปลี่ยนแปลงในคำแนะนำนี้
marginHeaderSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ marginHeader หรือไม่
flipPageOrientationSuggested

boolean

ไม่บังคับ ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ flipPageOrientation หรือไม่

สถานะคำแนะนำพื้นหลัง

มาสก์ที่ระบุว่ามีการเปลี่ยนแปลงช่องใดบนฐาน Background ในคำแนะนำนี้ สำหรับช่องที่ตั้งค่าเป็น "จริง" Backgound จะมีค่าที่แนะนำใหม่

การแสดง JSON 
{
  "backgroundColorSuggested": boolean
}
ช่อง
backgroundColorSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงสีพื้นหลังปัจจุบันในคำแนะนำนี้หรือไม่

สถานะคำแนะนำขนาด

มาสก์ที่ระบุว่ามีการเปลี่ยนแปลงช่องใดบนฐาน Size ในคำแนะนำนี้ สำหรับช่องที่ตั้งค่าเป็น "จริง" Size จะมีค่าที่แนะนำใหม่

การแสดง JSON 
{
  "heightSuggested": boolean,
  "widthSuggested": boolean
}
ช่อง
heightSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ height หรือไม่
widthSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ width หรือไม่

รูปแบบที่มีชื่อ

รูปแบบที่มีชื่อ ย่อหน้าในเอกสารจะรับค่า TextStyle และ ParagraphStyle จากรูปแบบที่มีชื่อเหล่านี้

การแสดง JSON 
{
  "styles": [
    {
      object (NamedStyle)
    }
  ]
}
ช่อง
styles[]

object (NamedStyle)

รูปแบบที่มีชื่อ

จะมีรายการสำหรับ named style types ที่เป็นไปได้แต่ละรายการ

รูปแบบที่มีชื่อ

สไตล์ที่มีชื่อ ย่อหน้าในเอกสารจะรับค่า TextStyle และ ParagraphStyle จากรูปแบบที่มีชื่อนี้ได้ เมื่อมีประเภทสไตล์ที่มีชื่อเหมือนกัน

การแสดง JSON 
{
  "namedStyleType": enum (NamedStyleType),
  "textStyle": {
    object (TextStyle)
  },
  "paragraphStyle": {
    object (ParagraphStyle)
  }
}
ช่อง
namedStyleType

enum (NamedStyleType)

ประเภทของรูปแบบที่มีชื่อนี้
textStyle

object (TextStyle)

รูปแบบข้อความของรูปแบบที่มีชื่อนี้
paragraphStyle

object (ParagraphStyle)

รูปแบบย่อหน้าของรูปแบบที่มีชื่อนี้

รูปแบบชื่อที่แนะนำ

การเปลี่ยนแปลงที่แนะนำสำหรับ NamedStyles

การแสดง JSON 
{
  "namedStyles": {
    object (NamedStyles)
  },
  "namedStylesSuggestionState": {
    object (NamedStylesSuggestionState)
  }
}
ช่อง
namedStyles

object (NamedStyles)

NamedStyles ที่มีเฉพาะการเปลี่ยนแปลงในคำแนะนำนี้ ซึ่งสามารถใช้ร่วมกับ namedStylesSuggestionState เพื่อดูว่าช่องใดมีการเปลี่ยนแปลงและค่าใหม่
namedStylesSuggestionState

object (NamedStylesSuggestionState)

มาสก์ที่ระบุว่ามีการเปลี่ยนแปลงช่องใดบนฐาน NamedStyles ในคำแนะนำนี้

สถานะคำแนะนำของรูปแบบที่มีชื่อ

สถานะการแนะนำของข้อความ NamedStyles

การแสดง JSON 
{
  "stylesSuggestionStates": [
    {
      object (NamedStyleSuggestionState)
    }
  ]
}
ช่อง
stylesSuggestionStates[]

object (NamedStyleSuggestionState)

มาสก์ที่ระบุว่าช่องใดของ NamedStyle ที่สอดคล้องกันใน styles มีการเปลี่ยนแปลงในคำแนะนำนี้

ลำดับของสถานะคำแนะนำรูปแบบที่มีชื่อเหล่านี้ตรงกับลำดับของสไตล์ที่มีชื่อที่สอดคล้องกันในคำแนะนำ named styles

สถานะคำแนะนำสไตล์ที่มีชื่อ

สถานะคำแนะนำของข้อความ NamedStyle

การแสดง JSON 
{
  "namedStyleType": enum (NamedStyleType),
  "textStyleSuggestionState": {
    object (TextStyleSuggestionState)
  },
  "paragraphStyleSuggestionState": {
    object (ParagraphStyleSuggestionState)
  }
}
ช่อง
namedStyleType

enum (NamedStyleType)

ประเภทรูปแบบที่มีชื่อซึ่งสถานะของคำแนะนำนี้สอดคล้องกับสถานะ

ช่องนี้มีไว้เพื่ออำนวยความสะดวกในการจับคู่ NamedStyleSuggestionState กับ NamedStyle ที่เกี่ยวข้อง
textStyleSuggestionState

object (TextStyleSuggestionState)

มาสก์ที่ระบุว่าช่องใดใน text style ที่มีการเปลี่ยนแปลงในคำแนะนำนี้
paragraphStyleSuggestionState

object (ParagraphStyleSuggestionState)

มาสก์ที่ระบุว่าช่องใดใน paragraph style ที่มีการเปลี่ยนแปลงในคำแนะนำนี้

รายการ

รายการหมายถึงแอตทริบิวต์รายการสำหรับกลุ่มย่อหน้าที่ทั้งหมดอยู่ในรายการเดียวกัน ย่อหน้าที่เป็นส่วนหนึ่งของรายการมีการอ้างอิงไปยังรหัสของรายการใน bullet

การแสดง JSON 
{
  "listProperties": {
    object (ListProperties)
  },
  "suggestedListPropertiesChanges": {
    string: {
      object (SuggestedListProperties)
    },
    ...
  },
  "suggestedInsertionId": string,
  "suggestedDeletionIds": [
    string
  ]
}
ช่อง
listProperties

object (ListProperties)

คุณสมบัติของรายการ
suggestedListPropertiesChanges

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

การเปลี่ยนแปลงที่แนะนำกับพร็อพเพอร์ตี้รายการ ซึ่งคีย์ตามรหัสคำแนะนำ
suggestedInsertionId

string

รหัสการแทรกที่แนะนำ หากเว้นว่างไว้ ค่านี้ไม่ใช่การแทรกที่แนะนำ
suggestedDeletionIds[]

string

รหัสการลบที่แนะนำ หากว่างเปล่า หมายความว่าจะไม่มีการแนะนำให้ลบรายการนี้

แสดงรายการพร็อพเพอร์ตี้

คุณสมบัติของ list ที่อธิบายรูปลักษณ์ของหัวข้อย่อยที่เป็นของย่อหน้าที่เชื่อมโยงกับรายการ

การแสดง JSON 
{
  "nestingLevels": [
    {
      object (NestingLevel)
    }
  ]
}
ช่อง
nestingLevels[]

object (NestingLevel)

อธิบายคุณสมบัติของหัวข้อย่อยในระดับที่เกี่ยวข้อง

รายการมีการซ้อนสูงสุด 9 ระดับโดยมีระดับการซ้อน 0 ที่สอดคล้องกับระดับบนสุด และระดับที่ซ้อน 8 ที่สอดคล้องกับระดับการซ้อนสูงสุด ระดับการซ้อนจะแสดงตามลําดับจากน้อยไปมากโดยมีการส่งคืนที่ซ้อนน้อยที่สุดก่อน

ระดับ Nest

ประกอบด้วยพร็อพเพอร์ตี้ที่อธิบายรูปลักษณ์ของหัวข้อย่อยแบบรายการในระดับการซ้อนที่ระบุ

การแสดง 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.
}
ช่อง
bulletAlignment

enum (BulletAlignment)

การจัดแนวของหัวข้อย่อยภายในพื้นที่ที่จัดสรรไว้เพื่อแสดงหัวข้อย่อย
glyphFormat

string

สตริงรูปแบบที่ใช้โดยหัวข้อย่อยที่ระดับการซ้อนนี้

รูปแบบรูปอักขระนี้มีตัวยึดตำแหน่งอย่างน้อย 1 ตัว และตัวยึดตำแหน่งเหล่านี้จะถูกแทนที่ด้วยค่าที่เหมาะสมโดยขึ้นอยู่กับ glyphType หรือ glyphSymbol ตัวยึดตำแหน่งจะเป็นไปตามรูปแบบ %[nestingLevel] นอกจากนี้ ตัวยึดตำแหน่งสามารถมีคำนำหน้าและคำต่อท้ายได้ ดังนั้น รูปแบบรูปอักขระจึงเป็นไปตามรูปแบบ <prefix>%[nestingLevel]<suffix> โปรดทราบว่าคำนำหน้าและคำต่อท้ายนั้นไม่บังคับและเป็นสตริงที่กำหนดเองได้

ตัวอย่างเช่น รูปแบบรูปอักขระ %0. บ่งบอกว่ารูปอักขระที่แสดงผลจะแทนที่ตัวยึดตำแหน่งด้วยรูปอักขระที่สอดคล้องกันสำหรับการซ้อนระดับ 0 ตามด้วยเครื่องหมายจุดเป็นส่วนต่อท้าย ดังนั้นรายการที่มีประเภทรูปอักขระเป็น UPPER_ALPHA และรูปแบบรูปอักขระ %0. ที่การซ้อน 0 จะทำให้เป็นรายการที่มีรูปอักขระที่แสดงผล

A.

B.

C.

โดยรูปแบบรูปอักขระสามารถประกอบด้วยตัวยึดตําแหน่งสําหรับระดับการซ้อนปัจจุบัน รวมถึงตัวยึดตำแหน่งสําหรับระดับการซ้อนระดับบนสุด ตัวอย่างเช่น รายการอาจมีรูปแบบรูปอักขระเป็น %0. ที่ระดับการซ้อน 0 และมีรูปแบบรูปอักขระ %0.%1. ที่ระดับการซ้อน 1 ได้ สมมติว่าระดับการซ้อนทั้ง 2 ระดับมีประเภทอักขระ DECIMAL ประเภท ผลลัพธ์จะเป็นรายการที่มีอักขระที่แสดงผล

1.

2.

2.1.

2.2.

3.

สำหรับการซ้อนหลายระดับที่มีลำดับ สตริงที่แทนที่ตัวยึดตำแหน่งในรูปแบบรูปอักขระสำหรับย่อหน้าหนึ่งๆ จะขึ้นอยู่กับลำดับของย่อหน้าภายในรายการ
indentFirstLine

object (Dimension)

จำนวนการเยื้องสำหรับบรรทัดแรกของย่อหน้าที่ระดับซ้อนนี้
indentStart

object (Dimension)

จำนวนการเยื้องสำหรับย่อหน้าที่ระดับการซ้อนนี้ ใช้กับด้านที่สอดคล้องกับจุดเริ่มต้นของข้อความ โดยอิงตามทิศทางเนื้อหาของย่อหน้า
textStyle

object (TextStyle)

รูปแบบข้อความของหัวข้อย่อยที่ระดับการซ้อนนี้
startNumber

integer

จำนวนของรายการแรกในระดับการซ้อนนี้

ค่า 0 จะถือเป็นค่า 1 สำหรับรายการที่มีตัวอักษรและรายการตัวเลขโรมัน สำหรับค่าทั้ง 0 และ 1 รายการที่มีตัวอักษรและตัวเลขโรมันจะเริ่มต้นที่ a และ i ตามลำดับ

ระบบจะละเว้นค่านี้สำหรับระดับการซ้อนที่มีรูปอักขระที่ไม่เรียงลำดับ
ฟิลด์การรวม glyph_kind ประเภทของรูปอักขระที่ใช้โดยสัญลักษณ์หัวข้อย่อย ซึ่งจะกำหนดสัญลักษณ์หัวข้อย่อยที่แทนที่ตัวยึดตำแหน่งใน glyph_format glyph_kind ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
glyphType

enum (GlyphType)

ประเภทของรูปอักขระที่ใช้โดยหัวข้อย่อยเมื่อมีการเรียงลำดับย่อหน้าในระดับที่ซ้อนกันนี้

ประเภทรูปอักขระจะกำหนดประเภทของรูปอักขระที่ใช้แทนที่ตัวยึดตำแหน่งภายใน glyphFormat เมื่อมีการเรียงลำดับย่อหน้าในระดับการซ้อนนี้ ตัวอย่างเช่น หากระดับการซ้อนคือ 0 ค่า glyphFormat จะเป็น %0. และประเภทรูปอักขระคือ DECIMAL รูปอักขระที่แสดงผลจะแทนที่ตัวยึดตำแหน่ง %0 ในรูปแบบรูปอักขระด้วยตัวเลขที่สอดคล้องกับลำดับของรายการภายในรายการ
glyphSymbol

string

สัญลักษณ์รูปอักขระที่กำหนดเองซึ่งใช้โดยหัวข้อย่อยเมื่อไม่มีลำดับย่อหน้าในระดับที่ซ้อนกันนี้

สัญลักษณ์รูปอักขระจะแทนที่ตัวยึดตำแหน่งภายใน glyphFormat ตัวอย่างเช่น หาก glyphSymbol เป็นวงกลมทึบที่ตรงกับจุดรหัส Unicode U+25cf และ glyphFormat เป็น %0 รูปอักขระที่แสดงผลจะเป็นวงกลมทึบ

การจัดข้อความหัวข้อย่อย

ประเภทการจัดข้อความหัวข้อย่อย

Enum
BULLET_ALIGNMENT_UNSPECIFIED ไม่ได้ระบุการปรับแนวสัญลักษณ์หัวข้อย่อย
START หัวข้อย่อยจะอยู่ในแนวเดียวกับจุดเริ่มต้นของพื้นที่ที่จัดสรรไว้สำหรับการแสดงหัวข้อย่อย จัดชิดซ้ายสำหรับข้อความ LTR, จัดชิดขวาหากไม่ใช่
CENTER หัวข้อย่อยจะอยู่ในแนวเดียวกับพื้นที่ตรงกลางที่จัดสรรไว้เพื่อแสดงหัวข้อย่อย
END หัวข้อย่อยจะอยู่ในแนวเดียวกับช่องว่างที่จัดสรรไว้เพื่อแสดงหัวข้อย่อย จัดชิดขวาสำหรับข้อความ LTR, จัดชิดซ้ายหากไม่ใช่

ประเภท Glyph

ประเภทของรูปอักขระที่ใช้โดยหัวข้อย่อยเมื่อมีการเรียงลำดับย่อหน้าในระดับที่ซ้อนกันนี้

Enum
GLYPH_TYPE_UNSPECIFIED ไม่ได้ระบุหรือไม่รองรับรูปอักขระประเภทนี้
NONE สตริงว่าง
DECIMAL หมายเลข เช่น 1, 2 หรือ 3
ZERO_DECIMAL ตัวเลขที่มีเลข 0 หลักเดียวนำหน้า เช่น 01, 02 หรือ 03 ตัวเลขที่มีมากกว่า 1 หลักจะไม่แสดงเลขศูนย์นำหน้า
UPPER_ALPHA อักษรตัวพิมพ์ใหญ่ เช่น A, B หรือ C
ALPHA ตัวอักษรพิมพ์เล็ก เช่น a, b หรือ c
UPPER_ROMAN ตัวเลขโรมันตัวพิมพ์ใหญ่ เช่น I, II หรือ III
ROMAN ตัวเลขโรมันที่เป็นตัวอักษรพิมพ์เล็ก เช่น i, ii หรือ iii

พร็อพเพอร์ตี้รายการที่แนะนำ

การเปลี่ยนแปลงที่แนะนำกับ ListProperties

การแสดง JSON 
{
  "listProperties": {
    object (ListProperties)
  },
  "listPropertiesSuggestionState": {
    object (ListPropertiesSuggestionState)
  }
}
ช่อง
listProperties

object (ListProperties)

ListProperties ที่มีเฉพาะการเปลี่ยนแปลงในคำแนะนำนี้ ซึ่งสามารถใช้ร่วมกับ listPropertiesSuggestionState เพื่อดูว่าช่องใดมีการเปลี่ยนแปลงและค่าใหม่
listPropertiesSuggestionState

object (ListPropertiesSuggestionState)

มาสก์ที่ระบุว่ามีการเปลี่ยนแปลงช่องใดบนฐาน ListProperties ในคำแนะนำนี้

สถานะคำแนะนำรายการพร็อพเพอร์ตี้

มาสก์ที่ระบุว่ามีการเปลี่ยนแปลงช่องใดบนฐาน ListProperties ในคำแนะนำนี้ จะมีค่าที่แนะนำใหม่สำหรับทุกช่องที่ตั้งค่าเป็น "จริง"

การแสดง JSON 
{
  "nestingLevelsSuggestionStates": [
    {
      object (NestingLevelSuggestionState)
    }
  ]
}
ช่อง
nestingLevelsSuggestionStates[]

object (NestingLevelSuggestionState)

มาสก์ที่ระบุว่าช่องใดของ NestingLevel ที่สอดคล้องกันใน nestingLevels มีการเปลี่ยนแปลงในคำแนะนำนี้

สถานะของคำแนะนำระดับการซ้อนจะแสดงตามลําดับจากน้อยไปมากของระดับการซ้อนโดยมีการแสดงรายการที่ฝังน้อยที่สุดก่อน

สถานะคำแนะนำระดับ Nest

มาสก์ที่ระบุว่ามีการเปลี่ยนแปลงช่องใดบนฐาน NestingLevel ในคำแนะนำนี้ จะมีค่าที่แนะนำใหม่สำหรับทุกช่องที่ตั้งค่าเป็น "จริง"

การแสดง JSON 
{
  "bulletAlignmentSuggested": boolean,
  "glyphTypeSuggested": boolean,
  "glyphFormatSuggested": boolean,
  "glyphSymbolSuggested": boolean,
  "indentFirstLineSuggested": boolean,
  "indentStartSuggested": boolean,
  "textStyleSuggestionState": {
    object (TextStyleSuggestionState)
  },
  "startNumberSuggested": boolean
}
ช่อง
bulletAlignmentSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ bulletAlignment หรือไม่
glyphTypeSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ glyphType หรือไม่
glyphFormatSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ glyphFormat หรือไม่
glyphSymbolSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ glyphSymbol หรือไม่
indentFirstLineSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ indentFirstLine หรือไม่
indentStartSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ indentStart หรือไม่
textStyleSuggestionState

object (TextStyleSuggestionState)

มาสก์ที่ระบุว่าช่องใดใน text style ที่มีการเปลี่ยนแปลงในคำแนะนำนี้
startNumberSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ startNumber หรือไม่

ช่วงที่มีชื่อ

คอลเล็กชันของ NamedRange ทั้งหมดในเอกสารที่ใช้ชื่อร่วมกัน

การแสดง JSON 
{
  "name": string,
  "namedRanges": [
    {
      object (NamedRange)
    }
  ]
}
ช่อง
name

string

ชื่อที่ named ranges ใช้ร่วมกัน
namedRanges[]

object (NamedRange)

NamedRange ที่ใช้ชื่อเดียวกัน

ช่วงที่มีชื่อ

คอลเล็กชันของ Range ที่มีรหัสช่วงที่มีชื่อเดียวกัน

ช่วงที่ตั้งชื่อแล้วจะช่วยให้นักพัฒนาซอฟต์แวร์เชื่อมโยงส่วนต่างๆ ของเอกสารกับป้ายกำกับที่ผู้ใช้กำหนดเองได้เพื่อให้อ่านหรือแก้ไขเนื้อหาในภายหลังโดยใช้โปรแกรมได้ เอกสารอาจมีช่วงที่ตั้งชื่อหลายช่วงที่ใช้ชื่อเดียวกัน แต่ทุกช่วงที่ตั้งชื่อแล้วจะมีรหัสที่ไม่ซ้ำกัน

ช่วงที่ตั้งชื่อแล้วจะสร้างขึ้นด้วย Range เดี่ยว และโดยทั่วไปแล้วเนื้อหาที่แทรกในช่วงที่ตั้งชื่อจะขยายช่วงดังกล่าว แต่การเปลี่ยนแปลงเอกสารบางอย่างอาจทำให้ระบบแยกช่วงออกเป็นหลายช่วงได้

ช่วงที่มีชื่อจะไม่เป็นส่วนตัว แอปพลิเคชันและผู้ทำงานร่วมกันทั้งหมดที่มีสิทธิ์เข้าถึงเอกสารจะเห็นช่วงที่ตั้งชื่อแล้ว

การแสดง JSON 
{
  "namedRangeId": string,
  "name": string,
  "ranges": [
    {
      object (Range)
    }
  ]
}
ช่อง
namedRangeId

string

รหัสของช่วงที่ตั้งชื่อแล้ว
name

string

ชื่อของช่วงที่ตั้งชื่อแล้ว
ranges[]

object (Range)

ช่วงที่อยู่ในช่วงที่ตั้งชื่อนี้

ช่วง

ระบุช่วงข้อความที่ต่อเนื่อง

การแสดง JSON 
{
  "segmentId": string,
  "startIndex": integer,
  "endIndex": integer
}
ช่อง
segmentId

string

รหัสของส่วนหัว ส่วนท้าย หรือเชิงอรรถที่มีช่วงนี้ ส่วนรหัสกลุ่มที่ว่างเปล่าจะหมายถึงส่วนเนื้อหาของเอกสาร
startIndex

integer

ดัชนีเริ่มต้นแบบศูนย์ของช่วงนี้ในหน่วยโค้ด UTF-16

ในการใช้งานปัจจุบันทั้งหมด ต้องระบุดัชนีเริ่มต้น ช่องนี้คือ Int32Value เพื่อรองรับกรณีการใช้งานในอนาคตที่มีช่วงปลายเปิด
endIndex

integer

ดัชนีสิ้นสุดแบบศูนย์ของช่วงนี้ อยู่ในหน่วยโค้ด UTF-16 โดยเฉพาะ

ในการใช้งานปัจจุบันทั้งหมด ต้องระบุดัชนีสิ้นสุด ช่องนี้คือ Int32Value เพื่อรองรับกรณีการใช้งานในอนาคตที่มีช่วงปลายเปิด

โหมดมุมมองคำแนะนำ

โหมดมุมมองคำแนะนำที่ใช้กับเอกสารซึ่งแสดงถึงการเปลี่ยนแปลงที่แนะนำจะแสดงขึ้นมา โดยจะมีตัวเลือกสำหรับการอ่านเอกสารพร้อมคำแนะนำทั้งหมดแบบแทรกในบรรทัด ยอมรับ หรือปฏิเสธ

Enum
DEFAULT_FOR_CURRENT_ACCESS OffersViewMode ที่ใช้กับเอกสารที่ส่งกลับมาจะขึ้นอยู่กับระดับการเข้าถึงปัจจุบันของผู้ใช้ หากผู้ใช้มีสิทธิ์ดูอย่างเดียว ระบบจะใช้ PREVIEW_WITHOUT_SUGGESTIONS มิฉะนั้น ระบบจะใช้ SUGGESTIONS_INLINE โหมดนี้จะเป็นโหมดมุมมองคำแนะนำเริ่มต้น
SUGGESTIONS_INLINE

เอกสารที่แสดงผลมีคำแนะนำในบรรทัด การเปลี่ยนแปลงที่แนะนำจะแตกต่างจากเนื้อหาพื้นฐานภายในเอกสาร

คำขอในการเรียกเอกสารโดยใช้โหมดนี้จะแสดงข้อผิดพลาด 403 หากผู้ใช้ไม่มีสิทธิ์ดูการเปลี่ยนแปลงที่แนะนำ
PREVIEW_SUGGESTIONS_ACCEPTED

เอกสารที่แสดงผลเป็นหน้าตัวอย่างที่ยอมรับการเปลี่ยนแปลงที่แนะนำทั้งหมดแล้ว

คำขอในการเรียกเอกสารโดยใช้โหมดนี้จะแสดงข้อผิดพลาด 403 หากผู้ใช้ไม่มีสิทธิ์ดูการเปลี่ยนแปลงที่แนะนำ
PREVIEW_WITHOUT_SUGGESTIONS เอกสารที่ส่งคืนจะเป็นหน้าตัวอย่างที่การเปลี่ยนแปลงที่แนะนำทั้งหมดถูกปฏิเสธหากมีคำแนะนำใดๆ ในเอกสารนั้น

inlineObject

ออบเจ็กต์ที่ปรากฏในบรรทัดข้อความ inlineObject มี EmbeddedObject เช่น รูปภาพ

การแสดง JSON 
{
  "objectId": string,
  "inlineObjectProperties": {
    object (InlineObjectProperties)
  },
  "suggestedInlineObjectPropertiesChanges": {
    string: {
      object (SuggestedInlineObjectProperties)
    },
    ...
  },
  "suggestedInsertionId": string,
  "suggestedDeletionIds": [
    string
  ]
}
ช่อง
objectId

string

รหัสของออบเจ็กต์ในบรรทัดนี้ ใช้เพื่ออัปเดตคุณสมบัติของออบเจ็กต์
inlineObjectProperties

object (InlineObjectProperties)

คุณสมบัติของออบเจ็กต์ในบรรทัดนี้
suggestedInlineObjectPropertiesChanges

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

การเปลี่ยนแปลงที่แนะนำกับพร็อพเพอร์ตี้ออบเจ็กต์ในบรรทัด ซึ่งคีย์ตามรหัสคำแนะนำ
suggestedInsertionId

string

รหัสการแทรกที่แนะนำ หากเว้นว่างไว้ ค่านี้ไม่ใช่การแทรกที่แนะนำ
suggestedDeletionIds[]

string

รหัสการลบที่แนะนำ หากว่างเปล่า หมายความว่าไม่มีการลบเนื้อหานี้ตามที่แนะนำ

inlineObjectProperties

คุณสมบัติของ InlineObject

การแสดง JSON 
{
  "embeddedObject": {
    object (EmbeddedObject)
  }
}
ช่อง
embeddedObject

object (EmbeddedObject)

ออบเจ็กต์ที่ฝังของออบเจ็กต์ในบรรทัดนี้

EmbeddedObject

วัตถุที่ฝังอยู่ในเอกสาร

การแสดง 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.
}
ช่อง
title

string

ชื่อของออบเจ็กต์ที่ฝัง ทั้ง title และ description ต้องรวมเข้าด้วยกันเพื่อแสดงข้อความแสดงแทน
description

string

คำอธิบายของออบเจ็กต์ที่ฝัง ทั้ง title และ description ต้องรวมเข้าด้วยกันเพื่อแสดงข้อความแสดงแทน
embeddedObjectBorder

object (EmbeddedObjectBorder)

เส้นขอบของวัตถุที่ฝัง
size

object (Size)

ขนาดที่มองเห็นได้ของรูปภาพหลังจากครอบตัด
marginTop

object (Dimension)

ระยะขอบด้านบนของออบเจ็กต์ที่ฝัง
marginBottom

object (Dimension)

ระยะขอบด้านล่างของออบเจ็กต์ที่ฝัง
marginRight

object (Dimension)

ระยะขอบด้านขวาของออบเจ็กต์ที่ฝัง
marginLeft

object (Dimension)

ระยะขอบด้านซ้ายของออบเจ็กต์ที่ฝัง
linkedContentReference

object (LinkedContentReference)

การอ้างอิงเนื้อหาแหล่งที่มาที่ลิงก์ไว้ภายนอก เช่น มีการอ้างอิงแผนภูมิต้นฉบับใน Google ชีตเมื่อออบเจ็กต์ที่ฝังเป็นแผนภูมิที่ลิงก์

หากไม่ได้ตั้งค่า ระบบจะไม่ลิงก์ออบเจ็กต์ที่ฝัง
ฟิลด์การรวม properties พร็อพเพอร์ตี้ที่เฉพาะเจาะจงสำหรับออบเจ็กต์ที่ฝังแต่ละประเภท properties ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
embeddedDrawingProperties

object (EmbeddedDrawingProperties)

คุณสมบัติของภาพวาดที่ฝัง
imageProperties

object (ImageProperties)

คุณสมบัติของรูปภาพ

คุณสมบัติของภาพวาดแบบฝัง

ประเภทนี้ไม่มีช่อง

คุณสมบัติของภาพวาดที่ฝังและใช้เพื่อแยกแยะประเภทของวัตถุ ภาพวาดที่ฝังคือภาพวาดที่สร้างและแก้ไขภายในเอกสาร โปรดทราบว่าระบบไม่รองรับรายละเอียดที่ครอบคลุม

คุณสมบัติของรูปภาพ

คุณสมบัติของรูปภาพ

การแสดง JSON 
{
  "contentUri": string,
  "sourceUri": string,
  "brightness": number,
  "contrast": number,
  "transparency": number,
  "cropProperties": {
    object (CropProperties)
  },
  "angle": number
}
ช่อง
contentUri

string

URI ไปยังรูปภาพที่มีอายุการใช้งานเริ่มต้น 30 นาที URI นี้ติดแท็กด้วยบัญชีของผู้ขอ ทุกคนที่มี URI จะเข้าถึงรูปภาพได้อย่างมีประสิทธิภาพในฐานะผู้ส่งคำขอต้นทาง คุณอาจสูญเสียสิทธิ์เข้าถึงรูปภาพหากการตั้งค่าการแชร์ของเอกสารมีการเปลี่ยนแปลง
sourceUri

string

URI แหล่งที่มาคือ URI ที่ใช้ในการแทรกรูปภาพ URI ต้นทางอาจว่างเปล่า
brightness

number

เอฟเฟกต์ความสว่างของรูปภาพ ค่าควรอยู่ในช่วง [-1.0, 1.0] โดยที่ 0 หมายถึงไม่มีผลกระทบใดๆ
contrast

number

เอฟเฟ็กต์คอนทราสต์ของรูปภาพ ค่าควรอยู่ในช่วง [-1.0, 1.0] โดยที่ 0 หมายถึงไม่มีผลกระทบใดๆ
transparency

number

เอฟเฟกต์ความโปร่งใสของรูปภาพ ค่าควรอยู่ในช่วง [0.0, 1.0] โดยที่ 0 หมายถึงไม่มีผล และ 1 หมายถึงโปร่งใส
cropProperties

object (CropProperties)

คุณสมบัติการครอบตัดของรูปภาพ
angle

number

มุมหมุนตามเข็มนาฬิกาของรูปภาพ เป็นเรเดียน

คุณสมบัติการครอบตัด

คุณสมบัติการครอบตัดของรูปภาพ

รูปสี่เหลี่ยมครอบตัดแสดงโดยใช้ออฟเซ็ตเป็นส่วนๆ จากขอบทั้ง 4 ของเนื้อหาต้นฉบับ

  • หากออฟเซ็ตอยู่ในช่วง (0, 1) ขอบที่สอดคล้องกันของรูปสี่เหลี่ยมสำหรับครอบตัดจะอยู่ในรูปสี่เหลี่ยมผืนผ้าที่มีขอบซึ่งเดิมของรูปภาพ
  • หากออฟเซ็ตเป็นค่าลบหรือมากกว่า 1 ขอบที่ตรงกันของรูปสี่เหลี่ยมสำหรับครอบตัดจะอยู่นอกกรอบสี่เหลี่ยมเดิมของรูปภาพ
  • หากค่าออฟเซ็ตและมุมการหมุนทั้งหมดเป็น 0 ระบบจะไม่ครอบตัดรูปภาพ
การแสดง JSON 
{
  "offsetLeft": number,
  "offsetRight": number,
  "offsetTop": number,
  "offsetBottom": number,
  "angle": number
}
ช่อง
offsetLeft

number

ออฟเซ็ตจะระบุว่าขอบด้านซ้ายของรูปสี่เหลี่ยมสำหรับครอบตัดอยู่ห่างจากขอบด้านซ้ายของเนื้อหาต้นฉบับเป็นเศษส่วนของความกว้างของเนื้อหาเดิม
offsetRight

number

ค่าออฟเซ็ตจะระบุว่าขอบด้านขวาของรูปสี่เหลี่ยมสำหรับครอบตัดอยู่ห่างจากขอบด้านขวาของเนื้อหาต้นฉบับเป็นเศษส่วนของความกว้างของเนื้อหาเดิมหรือไม่
offsetTop

number

ค่าออฟเซ็ตจะระบุว่าขอบด้านบนของรูปสี่เหลี่ยมสำหรับครอบตัดอยู่ห่างจากขอบด้านบนของเนื้อหาต้นฉบับเป็นเศษส่วนของความสูงของเนื้อหาดั้งเดิม
offsetBottom

number

ออฟเซ็ตจะระบุว่าขอบด้านล่างของรูปสี่เหลี่ยมสำหรับครอบตัดอยู่ห่างจากขอบล่างของเนื้อหาต้นฉบับเป็นเศษส่วนของความสูงของเนื้อหาเดิมมากเพียงใด
angle

number

มุมหมุนตามเข็มนาฬิกาของรูปสี่เหลี่ยมครอบตัดรอบศูนย์กลาง เป็นเรเดียน การหมุนจะมีผลหลังจากออฟเซ็ต

Border แบบฝัง

เส้นขอบรอบ EmbeddedObject

การแสดง JSON 
{
  "color": {
    object (OptionalColor)
  },
  "width": {
    object (Dimension)
  },
  "dashStyle": enum (DashStyle),
  "propertyState": enum (PropertyState)
}
ช่อง
color

object (OptionalColor)

สีของเส้นขอบ
width

object (Dimension)

ความกว้างของเส้นขอบ
dashStyle

enum (DashStyle)

รูปแบบเส้นประของเส้นขอบ
propertyState

enum (PropertyState)

สถานะคุณสมบัติของพร็อพเพอร์ตี้เส้นขอบ

สถานะพร็อพเพอร์ตี้

สถานะที่เป็นไปได้ของพร็อพเพอร์ตี้

Enum
RENDERED หากสถานะของพร็อพเพอร์ตี้คือ RENDERED องค์ประกอบจะมีพร็อพเพอร์ตี้ที่สอดคล้องกันเมื่อแสดงผลในเอกสาร นี่คือค่าเริ่มต้น
NOT_RENDERED หากสถานะของพร็อพเพอร์ตี้คือ NOT_RENDERED องค์ประกอบจะไม่มีคุณสมบัติที่สอดคล้องกันเมื่อแสดงผลในเอกสาร

LinkedContentReference

การอ้างอิงเนื้อหาแหล่งที่มาที่ลิงก์ไว้ภายนอก

การแสดง JSON 
{

  // Union field reference can be only one of the following:
  "sheetsChartReference": {
    object (SheetsChartReference)
  }
  // End of list of possible types for union field reference.
}
ช่อง
ฟิลด์การรวม reference ข้อมูลอ้างอิงสำหรับประเภทเนื้อหาที่ลิงก์โดยเฉพาะ reference ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
sheetsChartReference

object (SheetsChartReference)

ข้อมูลอ้างอิงไปยังแผนภูมิที่ลิงก์

การอ้างอิงแผนภูมิชีต

ข้อมูลอ้างอิงไปยังแผนภูมิที่ลิงก์ซึ่งฝังจาก Google ชีต

การแสดง JSON 
{
  "spreadsheetId": string,
  "chartId": integer
}
ช่อง
spreadsheetId

string

รหัสของสเปรดชีต Google ชีตที่มีแผนภูมิแหล่งที่มา
chartId

integer

รหัสของแผนภูมิที่เฉพาะเจาะจงในสเปรดชีต Google ชีตที่ฝังอยู่

inlineObjectProperties ที่แนะนำ

การเปลี่ยนแปลงที่แนะนำกับ InlineObjectProperties

การแสดง JSON 
{
  "inlineObjectProperties": {
    object (InlineObjectProperties)
  },
  "inlineObjectPropertiesSuggestionState": {
    object (InlineObjectPropertiesSuggestionState)
  }
}
ช่อง
inlineObjectProperties

object (InlineObjectProperties)

InlineObjectProperties ที่มีเฉพาะการเปลี่ยนแปลงที่ทำในคำแนะนำนี้ ซึ่งสามารถใช้ร่วมกับ inlineObjectPropertiesSuggestionState เพื่อดูว่าช่องใดมีการเปลี่ยนแปลงและค่าใหม่
inlineObjectPropertiesSuggestionState

object (InlineObjectPropertiesSuggestionState)

มาสก์ที่ระบุว่ามีการเปลี่ยนแปลงช่องใดบนฐาน InlineObjectProperties ในคำแนะนำนี้

inlineObjectProperties SuggestionState

มาสก์ที่ระบุว่ามีการเปลี่ยนแปลงช่องใดบนฐาน InlineObjectProperties ในคำแนะนำนี้ จะมีค่าที่แนะนำใหม่สำหรับทุกช่องที่ตั้งค่าเป็น "จริง"

การแสดง JSON 
{
  "embeddedObjectSuggestionState": {
    object (EmbeddedObjectSuggestionState)
  }
}
ช่อง
embeddedObjectSuggestionState

object (EmbeddedObjectSuggestionState)

มาสก์ที่ระบุว่าช่องใดใน embeddedObject ที่มีการเปลี่ยนแปลงในคำแนะนำนี้

สถานะคำแนะนำออบเจ็กต์แบบฝัง

มาสก์ที่ระบุว่ามีการเปลี่ยนแปลงช่องใดบนฐาน EmbeddedObject ในคำแนะนำนี้ จะมีค่าที่แนะนำใหม่สำหรับทุกช่องที่ตั้งค่าเป็น "จริง"

การแสดง 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)
  }
}
ช่อง
embeddedDrawingPropertiesSuggestionState

object (EmbeddedDrawingPropertiesSuggestionState)

มาสก์ที่ระบุว่าช่องใดใน embeddedDrawingProperties ที่มีการเปลี่ยนแปลงในคำแนะนำนี้
imagePropertiesSuggestionState

object (ImagePropertiesSuggestionState)

มาสก์ที่ระบุว่าช่องใดใน imageProperties ที่มีการเปลี่ยนแปลงในคำแนะนำนี้
titleSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ title หรือไม่
descriptionSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ description หรือไม่
embeddedObjectBorderSuggestionState

object (EmbeddedObjectBorderSuggestionState)

มาสก์ที่ระบุว่าช่องใดใน embeddedObjectBorder ที่มีการเปลี่ยนแปลงในคำแนะนำนี้
sizeSuggestionState

object (SizeSuggestionState)

มาสก์ที่ระบุว่าช่องใดใน size ที่มีการเปลี่ยนแปลงในคำแนะนำนี้
marginLeftSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ marginLeft หรือไม่
marginRightSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ marginRight หรือไม่
marginTopSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ marginTop หรือไม่
marginBottomSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ marginBottom หรือไม่
linkedContentReferenceSuggestionState

object (LinkedContentReferenceSuggestionState)

มาสก์ที่ระบุว่าช่องใดใน linkedContentReference ที่มีการเปลี่ยนแปลงในคำแนะนำนี้

สถานะคำแนะนำของ EmbeddedDrawingProperties

ประเภทนี้ไม่มีช่อง

มาสก์ที่ระบุว่ามีการเปลี่ยนแปลงช่องใดบนฐาน EmbeddedDrawingProperties ในคำแนะนำนี้ จะมีค่าที่แนะนำใหม่สำหรับทุกช่องที่ตั้งค่าเป็น "จริง"

สถานะคำแนะนำของคุณสมบัติรูปภาพ

มาสก์ที่ระบุว่ามีการเปลี่ยนแปลงช่องใดบนฐาน ImageProperties ในคำแนะนำนี้ จะมีค่าที่แนะนำใหม่สำหรับทุกช่องที่ตั้งค่าเป็น "จริง"

การแสดง JSON 
{
  "contentUriSuggested": boolean,
  "sourceUriSuggested": boolean,
  "brightnessSuggested": boolean,
  "contrastSuggested": boolean,
  "transparencySuggested": boolean,
  "cropPropertiesSuggestionState": {
    object (CropPropertiesSuggestionState)
  },
  "angleSuggested": boolean
}
ช่อง
contentUriSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ contentUri หรือไม่
sourceUriSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนําสําหรับ [sourceUri] [google.apps.docs.v1.embeddedObject.source_uri] หรือไม่
brightnessSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ [ความสว่าง] [google.apps.docs.v1.embeddedObject.brightness] หรือไม่
contrastSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ [คอนทราสต์] [google.apps.docs.v1.EmbedObject.contrast] หรือไม่
transparencySuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนําสําหรับ [transparency] [google.apps.docs.v1.embeddedObject.transparency] หรือไม่
cropPropertiesSuggestionState

object (CropPropertiesSuggestionState)

มาสก์ที่ระบุว่าช่องใดใน cropProperties ที่มีการเปลี่ยนแปลงในคำแนะนำนี้
angleSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนําสําหรับ [angle] [google.apps.docs.v1.embeddedObject.angle] หรือไม่

สถานะคำแนะนำ CropProperties

มาสก์ที่ระบุว่ามีการเปลี่ยนแปลงช่องใดบนฐาน CropProperties ในคำแนะนำนี้ จะมีค่าที่แนะนำใหม่สำหรับทุกช่องที่ตั้งค่าเป็น "จริง"

การแสดง JSON 
{
  "offsetLeftSuggested": boolean,
  "offsetRightSuggested": boolean,
  "offsetTopSuggested": boolean,
  "offsetBottomSuggested": boolean,
  "angleSuggested": boolean
}
ช่อง
offsetLeftSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ offsetLeft หรือไม่
offsetRightSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ offsetRight หรือไม่
offsetTopSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ offsetTop หรือไม่
offsetBottomSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ offsetBottom หรือไม่
angleSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ angle หรือไม่

สถานะคำแนะนำของออบเจ็กต์แบบฝัง

มาสก์ที่ระบุว่ามีการเปลี่ยนแปลงช่องใดบนฐาน EmbeddedObjectBorder ในคำแนะนำนี้ จะมีค่าที่แนะนำใหม่สำหรับทุกช่องที่ตั้งค่าเป็น "จริง"

การแสดง JSON 
{
  "colorSuggested": boolean,
  "widthSuggested": boolean,
  "dashStyleSuggested": boolean,
  "propertyStateSuggested": boolean
}
ช่อง
colorSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำเป็น [color] [google.apps.docs.v1.embeddedBorderObject.color] หรือไม่
widthSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำใน [width] [google.apps.docs.v1.EmbedBorderObject.width] หรือไม่
dashStyleSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนําสําหรับ [dashStyle] [google.apps.docs.v1.embeddedBorderObject.dash_style] หรือไม่
propertyStateSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนําสําหรับ [propertyState] [google.apps.docs.v1.EmbedBorderObject.property_state] หรือไม่

LinkedContentReferenceSuggestionState

มาสก์ที่ระบุว่ามีการเปลี่ยนแปลงช่องใดบนฐาน LinkedContentReference ในคำแนะนำนี้ จะมีค่าที่แนะนำใหม่สำหรับทุกช่องที่ตั้งค่าเป็น "จริง"

การแสดง JSON 
{
  "sheetsChartReferenceSuggestionState": {
    object (SheetsChartReferenceSuggestionState)
  }
}
ช่อง
sheetsChartReferenceSuggestionState

object (SheetsChartReferenceSuggestionState)

มาสก์ที่ระบุว่าช่องใดใน sheetsChartReference ที่มีการเปลี่ยนแปลงในคำแนะนำนี้

ชีตแผนภูมิการอ้างอิงคำแนะนำแนะนำ

มาสก์ที่ระบุว่ามีการเปลี่ยนแปลงช่องใดบนฐาน SheetsChartReference ในคำแนะนำนี้ จะมีค่าที่แนะนำใหม่สำหรับทุกช่องที่ตั้งค่าเป็น "จริง"

การแสดง JSON 
{
  "spreadsheetIdSuggested": boolean,
  "chartIdSuggested": boolean
}
ช่อง
spreadsheetIdSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ spreadsheetId หรือไม่
chartIdSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ chartId หรือไม่

วัตถุที่มีตำแหน่ง

ออบเจ็กต์ที่ปล่อยสัญญาณไปยัง Paragraph และอยู่ในตำแหน่งที่สัมพันธ์กับตอนต้นของย่อหน้า PositionedObject มี EmbeddedObject เช่น รูปภาพ

การแสดง JSON 
{
  "objectId": string,
  "positionedObjectProperties": {
    object (PositionedObjectProperties)
  },
  "suggestedPositionedObjectPropertiesChanges": {
    string: {
      object (SuggestedPositionedObjectProperties)
    },
    ...
  },
  "suggestedInsertionId": string,
  "suggestedDeletionIds": [
    string
  ]
}
ช่อง
objectId

string

รหัสของวัตถุที่กำหนดตำแหน่งนี้
positionedObjectProperties

object (PositionedObjectProperties)

คุณสมบัติของวัตถุที่วางตำแหน่งนี้
suggestedPositionedObjectPropertiesChanges

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

การเปลี่ยนแปลงที่แนะนำเกี่ยวกับพร็อพเพอร์ตี้ออบเจ็กต์ที่มีตำแหน่ง ซึ่งกำหนดโดยรหัสคำแนะนำ
suggestedInsertionId

string

รหัสการแทรกที่แนะนำ หากเว้นว่างไว้ ค่านี้ไม่ใช่การแทรกที่แนะนำ
suggestedDeletionIds[]

string

รหัสการลบที่แนะนำ หากว่างเปล่า หมายความว่าไม่มีการลบเนื้อหานี้ตามที่แนะนำ

พร็อพเพอร์ตี้ออบเจ็กต์ที่มีตำแหน่ง

คุณสมบัติของ PositionedObject

การแสดง JSON 
{
  "positioning": {
    object (PositionedObjectPositioning)
  },
  "embeddedObject": {
    object (EmbeddedObject)
  }
}
ช่อง
positioning

object (PositionedObjectPositioning)

การวางตำแหน่งของวัตถุที่กำหนดตำแหน่งนี้สัมพัทธ์กับบรรทัดใหม่ของ Paragraph ที่อ้างอิงวัตถุที่กำหนดตำแหน่งนี้
embeddedObject

object (EmbeddedObject)

วัตถุที่ฝังไว้ของวัตถุที่วางตำแหน่งนี้

การวางตำแหน่งวัตถุ

ตำแหน่งของ PositionedObject วัตถุที่กำหนดตำแหน่งจะอยู่ในตำแหน่งสัมพันธ์กับจุดเริ่มต้นของ Paragraph ที่ปล่อยสัญญาณไว้

การแสดง JSON 
{
  "layout": enum (PositionedObjectLayout),
  "leftOffset": {
    object (Dimension)
  },
  "topOffset": {
    object (Dimension)
  }
}
ช่อง
layout

enum (PositionedObjectLayout)

เลย์เอาต์ของออบเจ็กต์ที่มีตำแหน่งนี้
leftOffset

object (Dimension)

ค่าออฟเซ็ตของขอบด้านซ้ายของวัตถุที่กำหนดตำแหน่งซึ่งสัมพันธ์กับจุดเริ่มต้นของ Paragraph ที่ปล่อยสัญญาณมา ตําแหน่งที่แน่นอนของออบเจ็กต์อาจขึ้นอยู่กับเนื้อหาอื่นๆ ในเอกสารและการจัดรูปแบบของเอกสาร
topOffset

object (Dimension)

ค่าออฟเซ็ตของขอบด้านบนของวัตถุที่วางตำแหน่งซึ่งสัมพันธ์กับจุดเริ่มต้นของ Paragraph ที่ปล่อยสัญญาณไว้ ตําแหน่งที่แน่นอนของออบเจ็กต์อาจขึ้นอยู่กับเนื้อหาอื่นๆ ในเอกสารและการจัดรูปแบบของเอกสาร

การจัดวางวัตถุที่กำหนดตำแหน่ง

เลย์เอาต์ที่เป็นไปได้ของ [PositionedObject][google.aps.docs.v1.PositionedObject]

Enum
POSITIONED_OBJECT_LAYOUT_UNSPECIFIED ไม่ได้ระบุการออกแบบ
WRAP_TEXT ข้อความจะล้อมรอบวัตถุที่วางตำแหน่ง
BREAK_LEFT แบ่งข้อความให้วัตถุที่จัดวางอยู่ทางด้านซ้าย และข้อความอยู่ทางด้านขวา
BREAK_RIGHT แบ่งข้อความให้วัตถุที่จัดวางอยู่ทางขวา และข้อความอยู่ทางซ้าย
BREAK_LEFT_RIGHT แบ่งข้อความให้ไม่มีข้อความอยู่ทางซ้ายหรือขวาของวัตถุที่วางตำแหน่ง
IN_FRONT_OF_TEXT วัตถุที่จัดวางตำแหน่งจะอยู่ด้านหน้าข้อความ
BEHIND_TEXT วัตถุที่จัดวางตำแหน่งจะอยู่หลังข้อความ

คุณสมบัติของออบเจ็กต์ตำแหน่งที่แนะนำ

การเปลี่ยนแปลงที่แนะนำกับ PositionedObjectProperties

การแสดง JSON 
{
  "positionedObjectProperties": {
    object (PositionedObjectProperties)
  },
  "positionedObjectPropertiesSuggestionState": {
    object (PositionedObjectPropertiesSuggestionState)
  }
}
ช่อง
positionedObjectProperties

object (PositionedObjectProperties)

PositionedObjectProperties ที่มีเฉพาะการเปลี่ยนแปลงในคำแนะนำนี้ ซึ่งสามารถใช้ร่วมกับ positionedObjectPropertiesSuggestionState เพื่อดูว่าช่องใดมีการเปลี่ยนแปลงและค่าใหม่
positionedObjectPropertiesSuggestionState

object (PositionedObjectPropertiesSuggestionState)

มาสก์ที่ระบุว่ามีการเปลี่ยนแปลงช่องใดบนฐาน PositionedObjectProperties ในคำแนะนำนี้

สถานะคำแนะนำพร็อพเพอร์ตี้ออบเจ็กต์ที่มีตำแหน่ง

มาสก์ที่ระบุว่ามีการเปลี่ยนแปลงช่องใดบนฐาน PositionedObjectProperties ในคำแนะนำนี้ จะมีค่าที่แนะนำใหม่สำหรับทุกช่องที่ตั้งค่าเป็น "จริง"

การแสดง JSON 
{
  "positioningSuggestionState": {
    object (PositionedObjectPositioningSuggestionState)
  },
  "embeddedObjectSuggestionState": {
    object (EmbeddedObjectSuggestionState)
  }
}
ช่อง
positioningSuggestionState

object (PositionedObjectPositioningSuggestionState)

มาสก์ที่ระบุว่าช่องใดใน positioning ที่มีการเปลี่ยนแปลงในคำแนะนำนี้
embeddedObjectSuggestionState

object (EmbeddedObjectSuggestionState)

มาสก์ที่ระบุว่าช่องใดใน embeddedObject ที่มีการเปลี่ยนแปลงในคำแนะนำนี้

สถานะคำแนะนำการจัดตำแหน่งออบเจ็กต์ที่มีตำแหน่ง

มาสก์ที่ระบุว่ามีการเปลี่ยนแปลงช่องใดบนฐาน PositionedObjectPositioning ในคำแนะนำนี้ จะมีค่าที่แนะนำใหม่สำหรับทุกช่องที่ตั้งค่าเป็น "จริง"

การแสดง JSON 
{
  "layoutSuggested": boolean,
  "leftOffsetSuggested": boolean,
  "topOffsetSuggested": boolean
}
ช่อง
layoutSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ layout หรือไม่
leftOffsetSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ leftOffset หรือไม่
topOffsetSuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ topOffset หรือไม่

วิธีการ

batchUpdate

 ใช้การอัปเดตกับเอกสารอย่างน้อย 1 รายการ

create

 สร้างเอกสารเปล่าโดยใช้ชื่อที่ระบุในคำขอ

get

 รับเอกสารที่ระบุเวอร์ชันล่าสุด