REST Resource: documents

แหล่งข้อมูล: เอกสาร

เอกสาร Google เอกสาร

การแสดง JSON 
{
  "documentId": string,
  "title": string,
  "tabs": [
    {
      object (Tab)
    }
  ],
  "revisionId": string,
  "suggestionsViewMode": enum (SuggestionsViewMode),
  "body": {
    object (Body)
  },
  "headers": {
    string: {
      object (Header)
    },
    ...
  },
  "footers": {
    string: {
      object (Footer)
    },
    ...
  },
  "footnotes": {
    string: {
      object (Footnote)
    },
    ...
  },
  "documentStyle": {
    object (DocumentStyle)
  },
  "suggestedDocumentStyleChanges": {
    string: {
      object (SuggestedDocumentStyle)
    },
    ...
  },
  "namedStyles": {
    object (NamedStyles)
  },
  "suggestedNamedStylesChanges": {
    string: {
      object (SuggestedNamedStyles)
    },
    ...
  },
  "lists": {
    string: {
      object (List)
    },
    ...
  },
  "namedRanges": {
    string: {
      object (NamedRanges)
    },
    ...
  },
  "inlineObjects": {
    string: {
      object (InlineObject)
    },
    ...
  },
  "positionedObjects": {
    string: {
      object (PositionedObject)
    },
    ...
  }
}
ช่อง
documentId

string

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

string

ชื่อเอกสาร
tabs[]

object (Tab)

แท็บที่เป็นส่วนหนึ่งของเอกสาร

แท็บสามารถมีแท็บย่อย ซึ่งเป็นแท็บที่ซ้อนอยู่ภายในแท็บอื่น แท็บย่อยจะแสดงด้วยฟิลด์ Tab.childTabs
revisionId

string

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

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

enum (SuggestionsViewMode)

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

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

object (Body)

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

ฟิลด์เดิม: ให้ใช้ Document.tabs.documentTab.body แทน ซึ่งจะแสดงเนื้อหาเอกสารจริงจากแท็บทั้งหมดเมื่อตั้งค่าพารามิเตอร์ includeTabsContent เป็น true หากเป็น false หรือไม่ได้ตั้งค่า ช่องนี้จะมีข้อมูลเกี่ยวกับแท็บแรกในเอกสาร
headers

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

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

ฟิลด์เดิม: ให้ใช้ Document.tabs.documentTab.headers แทน ซึ่งจะแสดงเนื้อหาเอกสารจริงจากแท็บทั้งหมดเมื่อตั้งค่าพารามิเตอร์ includeTabsContent เป็น true หากเป็น false หรือไม่ได้ตั้งค่า ช่องนี้จะมีข้อมูลเกี่ยวกับแท็บแรกในเอกสาร
footers

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

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

ฟิลด์เดิม: ให้ใช้ Document.tabs.documentTab.footers แทน ซึ่งจะแสดงเนื้อหาเอกสารจริงจากแท็บทั้งหมดเมื่อตั้งค่าพารามิเตอร์ includeTabsContent เป็น true หากเป็น false หรือไม่ได้ตั้งค่า ช่องนี้จะมีข้อมูลเกี่ยวกับแท็บแรกในเอกสาร
footnotes

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

เอาต์พุตเท่านั้น เชิงอรรถในเอกสารซึ่งมีคีย์เป็นรหัสเชิงอรรถ

ฟิลด์เดิม: ให้ใช้ Document.tabs.documentTab.footnotes แทน ซึ่งจะแสดงเนื้อหาเอกสารจริงจากแท็บทั้งหมดเมื่อตั้งค่าพารามิเตอร์ includeTabsContent เป็น true หากเป็น false หรือไม่ได้ตั้งค่า ช่องนี้จะมีข้อมูลเกี่ยวกับแท็บแรกในเอกสาร
documentStyle

object (DocumentStyle)

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

ฟิลด์เดิม: ให้ใช้ Document.tabs.documentTab.documentStyle แทน ซึ่งจะแสดงเนื้อหาเอกสารจริงจากแท็บทั้งหมดเมื่อตั้งค่าพารามิเตอร์ includeTabsContent เป็น true หากเป็น false หรือไม่ได้ตั้งค่า ช่องนี้จะมีข้อมูลเกี่ยวกับแท็บแรกในเอกสาร
suggestedDocumentStyleChanges

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

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

ฟิลด์เดิม: ให้ใช้ Document.tabs.documentTab.suggestedDocumentStyleChanges แทน ซึ่งจะแสดงเนื้อหาเอกสารจริงจากแท็บทั้งหมดเมื่อตั้งค่าพารามิเตอร์ includeTabsContent เป็น true หากเป็น false หรือไม่ได้ตั้งค่า ช่องนี้จะมีข้อมูลเกี่ยวกับแท็บแรกในเอกสาร
namedStyles

object (NamedStyles)

เอาต์พุตเท่านั้น สไตล์ที่มีชื่อของเอกสาร

ฟิลด์เดิม: ให้ใช้ Document.tabs.documentTab.namedStyles แทน ซึ่งจะแสดงเนื้อหาเอกสารจริงจากแท็บทั้งหมดเมื่อตั้งค่าพารามิเตอร์ includeTabsContent เป็น true หากเป็น false หรือไม่ได้ตั้งค่า ช่องนี้จะมีข้อมูลเกี่ยวกับแท็บแรกในเอกสาร
suggestedNamedStylesChanges

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

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

ฟิลด์เดิม: ให้ใช้ Document.tabs.documentTab.suggestedNamedStylesChanges แทน ซึ่งจะแสดงเนื้อหาเอกสารจริงจากแท็บทั้งหมดเมื่อตั้งค่าพารามิเตอร์ includeTabsContent เป็น true หากเป็น false หรือไม่ได้ตั้งค่า ช่องนี้จะมีข้อมูลเกี่ยวกับแท็บแรกในเอกสาร
lists

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

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

ฟิลด์เดิม: ให้ใช้ Document.tabs.documentTab.lists แทน ซึ่งจะแสดงเนื้อหาเอกสารจริงจากแท็บทั้งหมดเมื่อตั้งค่าพารามิเตอร์ includeTabsContent เป็น true หากเป็น false หรือไม่ได้ตั้งค่า ช่องนี้จะมีข้อมูลเกี่ยวกับแท็บแรกในเอกสาร
namedRanges

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

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

ฟิลด์เดิม: ให้ใช้ Document.tabs.documentTab.namedRanges แทน ซึ่งจะแสดงเนื้อหาเอกสารจริงจากแท็บทั้งหมดเมื่อตั้งค่าพารามิเตอร์ includeTabsContent เป็น true หากเป็น false หรือไม่ได้ตั้งค่า ช่องนี้จะมีข้อมูลเกี่ยวกับแท็บแรกในเอกสาร
inlineObjects

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

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

ฟิลด์เดิม: ให้ใช้ Document.tabs.documentTab.inlineObjects แทน ซึ่งจะแสดงเนื้อหาเอกสารจริงจากแท็บทั้งหมดเมื่อตั้งค่าพารามิเตอร์ includeTabsContent เป็น true หากเป็น false หรือไม่ได้ตั้งค่า ช่องนี้จะมีข้อมูลเกี่ยวกับแท็บแรกในเอกสาร
positionedObjects

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

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

ฟิลด์เดิม: ให้ใช้ Document.tabs.documentTab.positionedObjects แทน ซึ่งจะแสดงเนื้อหาเอกสารจริงจากแท็บทั้งหมดเมื่อตั้งค่าพารามิเตอร์ includeTabsContent เป็น true หากเป็น false หรือไม่ได้ตั้งค่า ช่องนี้จะมีข้อมูลเกี่ยวกับแท็บแรกในเอกสาร

แท็บ

แท็บในเอกสาร

การแสดง JSON 
{
  "tabProperties": {
    object (TabProperties)
  },
  "childTabs": [
    {
      object (Tab)
    }
  ],

  // Union field content can be only one of the following:
  "documentTab": {
    object (DocumentTab)
  }
  // End of list of possible types for union field content.
}
ช่อง
tabProperties

object (TabProperties)

พร็อพเพอร์ตี้ของแท็บ เช่น รหัสและชื่อ
childTabs[]

object (Tab)

แท็บย่อยที่ซ้อนอยู่ภายในแท็บนี้
ฟิลด์ Union content เนื้อหาของแท็บ content ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
documentTab

object (DocumentTab)

แท็บที่มีเนื้อหาของเอกสาร เช่น ข้อความและรูปภาพ

TabProperties

คุณสมบัติของแท็บ

การแสดง JSON 
{
  "tabId": string,
  "title": string,
  "parentTabId": string,
  "index": integer,
  "nestingLevel": integer
}
ช่อง
tabId

string

เอาต์พุตเท่านั้น รหัสของแท็บ ซึ่งคุณจะเปลี่ยนช่องนี้ไม่ได้
title

string

ชื่อของแท็บที่ผู้ใช้มองเห็นได้
parentTabId

string

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

integer

ดัชนีฐาน 0 ของแท็บภายในแท็บหลัก
nestingLevel

integer

เอาต์พุตเท่านั้น ความลึกของแท็บภายในเอกสาร แท็บระดับรูทจะเริ่มต้นที่ 0

DocumentTab

แท็บที่มีเนื้อหาของเอกสาร

การแสดง JSON 
{
  "body": {
    object (Body)
  },
  "headers": {
    string: {
      object (Header)
    },
    ...
  },
  "footers": {
    string: {
      object (Footer)
    },
    ...
  },
  "footnotes": {
    string: {
      object (Footnote)
    },
    ...
  },
  "documentStyle": {
    object (DocumentStyle)
  },
  "suggestedDocumentStyleChanges": {
    string: {
      object (SuggestedDocumentStyle)
    },
    ...
  },
  "namedStyles": {
    object (NamedStyles)
  },
  "suggestedNamedStylesChanges": {
    string: {
      object (SuggestedNamedStyles)
    },
    ...
  },
  "lists": {
    string: {
      object (List)
    },
    ...
  },
  "namedRanges": {
    string: {
      object (NamedRanges)
    },
    ...
  },
  "inlineObjects": {
    string: {
      object (InlineObject)
    },
    ...
  },
  "positionedObjects": {
    string: {
      object (PositionedObject)
    },
    ...
  }
}
ช่อง
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))

ช่วงที่ตั้งชื่อแล้วในแท็บเอกสาร โดยมีชื่อเป็นคีย์
inlineObjects

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

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

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

ออบเจ็กต์ที่วางตำแหน่งในแท็บเอกสาร โดยมีรหัสออบเจ็กต์เป็นคีย์

เนื้อความ

เนื้อความของเอกสาร

โดยปกติแล้ว เนื้อหาจะประกอบด้วยเนื้อหาของเอกสารทั้งหมด ยกเว้น headers, footers และ footnotes

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

object (StructuralElement)

เนื้อหาของเนื้อหา

ดัชนีสำหรับเนื้อหาของเนื้อหาเริ่มต้นที่ 0

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

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

integer

ดัชนีสิ้นสุดแบบอิงตาม 0 ขององค์ประกอบโครงสร้างนี้ ซึ่งไม่รวมในหน่วยโค้ด UTF-16
ฟิลด์ Union 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

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

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

integer

ดัชนีสิ้นสุดแบบอิงตาม 0 ขององค์ประกอบย่อหน้านี้ ซึ่งไม่รวมในหน่วยโค้ด UTF-16
ฟิลด์ Union 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)

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

TextRun

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

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

string

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

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

string

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

string

รหัสการลบที่แนะนำ หากไม่มีข้อมูล แสดงว่าไม่มีการแนะนำให้ลบเนื้อหานี้
textStyle

object (TextStyle)

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

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

รูปแบบข้อความที่แนะนำจะเปลี่ยนเป็นรูปแบบนี้ โดยมีรหัสคำแนะนำเป็นคีย์

TextStyle

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

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

  • 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 Bad Request
baselineOffset

enum (BaselineOffset)

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

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

OptionalColor

สีที่อาจทึบแสงสนิทหรือโปร่งแสงสนิท

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

object (Color)

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

สี

สีทึบ

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

object (RgbColor)

ค่าสี RGB

RgbColor

สี 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 นิ้ว

WeightedFontFamily

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

การแสดง 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 น้ำหนักที่แสดงจะเท่ากับน้ำหนัก
  • หากข้อความไม่ได้เป็นตัวหนา น้ำหนักที่แสดงจะเท่ากับน้ำหนัก

BaselineOffset

วิธีที่ข้อความสามารถชดเชยในแนวตั้งจากตำแหน่งปกติ

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

SuggestedTextStyle

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

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

object (TextStyle)

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

object (TextStyleSuggestionState)

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

TextStyleSuggestionState

มาสก์ที่ระบุว่ามีการเปลี่ยนแปลงฟิลด์ใดในฐาน 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 หรือไม่

AutoText

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)

รูปแบบข้อความของข้อความอัตโนมัตินี้
suggestedTextStyleChanges

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

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

ประเภท

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

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

PageBreak

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

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

string

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

string

รหัสการลบที่แนะนำ หากไม่มีข้อมูล แสดงว่าไม่มีการแนะนำให้ลบเนื้อหานี้
textStyle

object (TextStyle)

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

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

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

รูปแบบข้อความที่แนะนำจะเปลี่ยนเป็น PageBreak นี้ โดยมีรหัสคำแนะนำเป็นคีย์

ColumnBreak

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 นี้ โดยมีรหัสคำแนะนำเป็นคีย์

FootnoteReference

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 นี้ โดยมีรหัสคำแนะนำเป็นคีย์

HorizontalRule

ParagraphElement แสดงเส้นแนวนอน

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

string

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

string

รหัสการลบที่แนะนำ หากไม่มีข้อมูล แสดงว่าไม่มีการแนะนำให้ลบเนื้อหานี้
textStyle

object (TextStyle)

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

รูปแบบข้อความของเส้นแนวนอนอาจส่งผลต่อเลย์เอาต์เนื้อหา รวมถึงการจัดรูปแบบข้อความที่แทรกไว้ข้างๆ เช่นเดียวกับเนื้อหาข้อความ เช่น การเรียกใช้ข้อความและการอ้างอิงเชิงอรรถ
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 อาจมีรหัสการลบหลายรายการ หากมีผู้ใช้หลายคนแนะนำให้ลบ Person เป็นต้น หากเว้นว่างไว้ ระบบจะไม่แนะนำให้ลบลิงก์บุคคลนี้
textStyle

object (TextStyle)

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

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

รูปแบบข้อความที่แนะนำจะเปลี่ยนเป็น Person โดยมีรหัสคำแนะนำเป็นคีย์
personProperties

object (PersonProperties)

เอาต์พุตเท่านั้น พร็อพเพอร์ตี้ของ Person นี้ ฟิลด์นี้จะแสดงเสมอ

PersonProperties

พร็อพเพอร์ตี้เฉพาะของ 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 This is always present.
mimeType

string

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

ParagraphStyle

รูปแบบที่มีผลกับทั้งย่อหน้า

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

  • Paragraph ใน named style type จะรับค่ามาจาก Paragraph ที่สอดคล้องกันของย่อหน้า
  • 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 Bad Request

NamedStyleType

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

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 ย่อหน้ามีการจัดแนว

ContentDirection

ทิศทางที่เนื้อหาจะไหลเวียน

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

SpacingMode

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

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

ParagraphBorder

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

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

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

DashStyle

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

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

TabStop

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

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

object (Dimension)

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

enum (TabStopAlignment)

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

TabStopAlignment

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

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

การแรเงา

การแรเงาย่อหน้า

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

object (OptionalColor)

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

SuggestedParagraphStyle

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

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

object (ParagraphStyle)

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

object (ParagraphStyleSuggestionState)

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

ParagraphStyleSuggestionState

มาสก์ที่ระบุว่ามีการเปลี่ยนแปลงฟิลด์ใดในฐาน 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 หรือไม่

ShadingSuggestionState

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

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

boolean

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

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

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

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

string

รหัสของรายการที่ย่อหน้านี้เป็นของ
nestingLevel

integer

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

object (TextStyle)

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

SuggestedBullet

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

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

object (Bullet)

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

object (BulletSuggestionState)

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

BulletSuggestionState

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

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

boolean

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

boolean

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

object (TextStyleSuggestionState)

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

ObjectReferences

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

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

string

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

SectionBreak

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

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

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

string

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

string

รหัสการลบที่แนะนำ หากไม่มีข้อมูล แสดงว่าไม่มีการแนะนำให้ลบเนื้อหานี้
sectionStyle

object (SectionStyle)

ลักษณะของส่วนหลังจากตัวแบ่งส่วนนี้

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)

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

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

object (Dimension)

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

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

object (Dimension)

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

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

object (Dimension)

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

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

object (Dimension)

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

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

enum (SectionType)

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

string

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

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

string

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

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

string

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

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

string

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

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

string

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

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

boolean

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

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

integer

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

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

boolean

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

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

SectionColumnProperties

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

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

object (Dimension)

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

object (Dimension)

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

ColumnSeparatorStyle

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

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

SectionType

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

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)

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

TableRow

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

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

integer

ดัชนีเริ่มต้นของแถวนี้ซึ่งอิงตาม 0 ในหน่วยรหัส UTF-16
endIndex

integer

ดัชนีสิ้นสุดของแถวนี้โดยอิงตาม 0 ซึ่งไม่รวมในหน่วยรหัส UTF-16
tableCells[]

object (TableCell)

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

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

string

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

string

รหัสการลบที่แนะนำ หากไม่มีข้อมูล แสดงว่าไม่มีการแนะนำให้ลบเนื้อหานี้
tableRowStyle

object (TableRowStyle)

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

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

การเปลี่ยนแปลงรูปแบบที่แนะนำสำหรับแถวนี้ โดยมีรหัสคำแนะนำเป็นคีย์

TableCell

เนื้อหาและสไตล์ของเซลล์ใน Table

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

integer

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

integer

ดัชนีสิ้นสุดแบบอิงตาม 0 ของเซลล์นี้ ซึ่งไม่รวมอยู่ในหน่วยรหัส UTF-16
content[]

object (StructuralElement)

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

object (TableCellStyle)

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

string

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

string

รหัสการลบที่แนะนำ หากไม่มีข้อมูล แสดงว่าไม่มีการแนะนำให้ลบเนื้อหานี้
suggestedTableCellStyleChanges

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

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

TableCellStyle

สไตล์ของ 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)

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

TableCellBorder

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

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

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

object (OptionalColor)

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

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

object (Dimension)

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

enum (DashStyle)

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

ContentAlignment

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

ได้มาจากค่าส่วนย่อยของประเภทอย่างง่าย "ST_TextAnchoringType" ในส่วนที่ 20.1.10.60 ของ "Office Open XML File Formats - Fundamentals and Markup Language Reference" ส่วนที่ 1 ของ ECMA-376 ฉบับที่ 5

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'

SuggestedTableCellStyle

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

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

object (TableCellStyle)

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

object (TableCellStyleSuggestionState)

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

TableCellStyleSuggestionState

มาสก์ที่ระบุว่ามีการเปลี่ยนแปลงฟิลด์ใดในฐาน 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 หรือไม่

TableRowStyle

รูปแบบที่มีผลกับแถวในตาราง

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

object (Dimension)

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

boolean

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

boolean

ระบุว่าแถวจะแสดงต่อในหน้าหรือขอบเขตคอลัมน์ไม่ได้หรือไม่

SuggestedTableRowStyle

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

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

object (TableRowStyle)

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

object (TableRowStyleSuggestionState)

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

TableRowStyleSuggestionState

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

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

boolean

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

TableStyle

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

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

object (TableColumnProperties)

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

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

TableColumnProperties

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

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

enum (WidthType)

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

object (Dimension)

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

WidthType

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

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

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

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

TableOfContents

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)

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

ดัชนีสำหรับเนื้อหาของเชิงอรรถจะเริ่มต้นที่ 0

DocumentStyle

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

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

ความกว้างของออบเจ็กต์

SuggestedDocumentStyle

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

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

object (DocumentStyle)

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

object (DocumentStyleSuggestionState)

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

DocumentStyleSuggestionState

มาสก์ที่ระบุว่ามีการเปลี่ยนแปลงฟิลด์ใดในฐาน 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 หรือไม่

BackgroundSuggestionState

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

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

boolean

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

SizeSuggestionState

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

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

boolean

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

boolean

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

NamedStyles

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

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

object (NamedStyle)

สไตล์ที่มีชื่อ

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

NamedStyle

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

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

enum (NamedStyleType)

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

object (TextStyle)

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

object (ParagraphStyle)

ลักษณะของย่อหน้าของลักษณะที่มีชื่อนี้

SuggestedNamedStyles

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

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

object (NamedStyles)

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

object (NamedStylesSuggestionState)

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

NamedStylesSuggestionState

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

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

object (NamedStyleSuggestionState)

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

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

NamedStyleSuggestionState

สถานะคำแนะนำของข้อความ 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 มีการเปลี่ยนแปลงในคำแนะนำนี้

รายการ

List แสดงแอตทริบิวต์รายการสำหรับกลุ่มย่อหน้าที่อยู่ในรายการเดียวกัน ย่อหน้าที่เป็นส่วนหนึ่งของรายการจะมีข้อมูลอ้างอิงถึงรหัสของรายการใน 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

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

ListProperties

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

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

object (NestingLevel)

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

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

NestingLevel

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

การแสดง 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 ตามลำดับ

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

enum (GlyphType)

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

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

string

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

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

BulletAlignment

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

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

GlyphType

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

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

SuggestedListProperties

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

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

object (ListProperties)

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

object (ListPropertiesSuggestionState)

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

ListPropertiesSuggestionState

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

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

object (NestingLevelSuggestionState)

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

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

NestingLevelSuggestionState

มาสก์ที่ระบุว่ามีการเปลี่ยนแปลงฟิลด์ใดในฐาน 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 หรือไม่

NamedRanges

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

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

string

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

object (NamedRange)

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,
  "tabId": string
}
ช่อง
segmentId

string

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

integer

ดัชนีเริ่มต้นแบบอิงตาม 0 ของช่วงนี้ในหน่วยรหัส UTF-16

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

integer

ดัชนีสิ้นสุดของช่วงนี้โดยเริ่มจาก 0 และไม่รวมดัชนีนี้ในหน่วยรหัส UTF-16

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

string

แท็บที่มีช่วงนี้ หากไม่ระบุ ระบบจะใช้คำขอกับแท็บแรก

ในเอกสารที่มีแท็บเดียว ให้ทำดังนี้

  • หากระบุไว้ ต้องตรงกับรหัสของแท็บรายการเดียว

  • หากไม่ระบุ คำขอจะมีผลกับแท็บเดียว

ในเอกสารที่มีหลายแท็บ ให้ทำดังนี้

  • หากระบุไว้ คำขอจะใช้กับแท็บที่ระบุ

  • หากไม่ระบุ ระบบจะใช้คำขอกับแท็บแรกในเอกสาร

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 ชีตต้นฉบับเมื่อออบเจ็กต์ที่ฝังเป็นแผนภูมิที่ลิงก์

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

object (EmbeddedDrawingProperties)

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

object (ImageProperties)

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

EmbeddedDrawingProperties

ประเภทนี้ไม่มีฟิลด์

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

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

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

CropProperties

พร็อพเพอร์ตี้การครอบตัดของรูปภาพ

สี่เหลี่ยมผืนผ้าครอบตัดแสดงโดยใช้การชดเชยเศษส่วนจากขอบทั้ง 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

มุมการหมุนตามเข็มนาฬิกาของสี่เหลี่ยมผืนผ้าสำหรับการครอบตัดรอบจุดกึ่งกลางเป็นเรเดียน ระบบจะใช้การหมุนหลังจากออฟเซ็ต

EmbeddedObjectBorder

เส้นขอบรอบ 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)

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

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.
}
ช่อง
ฟิลด์ Union reference การอ้างอิงที่เฉพาะเจาะจงกับประเภทของเนื้อหาที่ลิงก์ reference ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
sheetsChartReference

object (SheetsChartReference)

การอ้างอิงถึงแผนภูมิที่ลิงก์

SheetsChartReference

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

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

string

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

integer

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

SuggestedInlineObjectProperties

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

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

object (InlineObjectProperties)

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

object (InlineObjectPropertiesSuggestionState)

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

InlineObjectPropertiesSuggestionState

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

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

object (EmbeddedObjectSuggestionState)

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

EmbeddedObjectSuggestionState

มาสก์ที่ระบุว่ามีการเปลี่ยนแปลงฟิลด์ใดในฐาน 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 มีการเปลี่ยนแปลงในคำแนะนำนี้

EmbeddedDrawingPropertiesSuggestionState

ประเภทนี้ไม่มีฟิลด์

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

ImagePropertiesSuggestionState

มาสก์ที่ระบุว่ามีการเปลี่ยนแปลงฟิลด์ใดในฐาน 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

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

boolean

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

object (CropPropertiesSuggestionState)

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

boolean

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

CropPropertiesSuggestionState

มาสก์ที่ระบุว่ามีการเปลี่ยนแปลงฟิลด์ใดในฐาน 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 หรือไม่

EmbeddedObjectBorderSuggestionState

มาสก์ที่ระบุว่ามีการเปลี่ยนแปลงฟิลด์ใดในฐาน 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.EmbeddedBorderObject.width] หรือไม่
dashStyleSuggested

boolean

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

boolean

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

LinkedContentReferenceSuggestionState

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

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

object (SheetsChartReferenceSuggestionState)

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

SheetsChartReferenceSuggestionState

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

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

boolean

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

boolean

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

PositionedObject

ออบเจ็กต์ที่เชื่อมโยงกับ 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

รหัสการลบที่แนะนำ หากไม่มีข้อมูล แสดงว่าไม่มีการแนะนำให้ลบเนื้อหานี้

PositionedObjectProperties

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

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

object (PositionedObjectPositioning)

การวางตำแหน่งของออบเจ็กต์ที่วางตำแหน่งนี้เทียบกับบรรทัดใหม่ของ Paragraph ที่อ้างอิงออบเจ็กต์ที่วางตำแหน่งนี้
embeddedObject

object (EmbeddedObject)

ออบเจ็กต์ที่ฝังของออบเจ็กต์ที่วางตำแหน่งนี้

PositionedObjectPositioning

การวางตำแหน่งของ PositionedObject ออบเจ็กต์ที่วางตำแหน่งจะวางตำแหน่งโดยสัมพันธ์กับจุดเริ่มต้นของParagraphที่เชื่อมโยงอยู่

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

enum (PositionedObjectLayout)

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

object (Dimension)

ออฟเซ็ตของขอบด้านซ้ายของออบเจ็กต์ที่วางตำแหน่งเทียบกับจุดเริ่มต้นของParagraphที่เชื่อมโยงอยู่ ตำแหน่งที่แน่นอนของออบเจ็กต์อาจขึ้นอยู่กับเนื้อหาอื่นๆ ในเอกสารและสไตล์ของเอกสาร
topOffset

object (Dimension)

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

PositionedObjectLayout

เลย์เอาต์ที่เป็นไปได้ของ [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 ออบเจ็กต์ที่วางตำแหน่งอยู่ด้านหลังข้อความ

SuggestedPositionedObjectProperties

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

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

object (PositionedObjectProperties)

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

object (PositionedObjectPropertiesSuggestionState)

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

PositionedObjectPropertiesSuggestionState

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

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

object (PositionedObjectPositioningSuggestionState)

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

object (EmbeddedObjectSuggestionState)

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

PositionedObjectPositioningSuggestionState

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

การแสดง JSON 
{
  "layoutSuggested": boolean,
  "leftOffsetSuggested": boolean,
  "topOffsetSuggested": boolean
}
ช่อง
layoutSuggested

boolean

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

boolean

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

boolean

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

SuggestionsViewMode

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

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

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

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

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

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

เมธอด

batchUpdate

 ใช้การอัปเดตอย่างน้อย 1 รายการกับเอกสาร

create

 สร้างเอกสารเปล่าโดยใช้ชื่อที่ระบุในคำขอ

get

 รับเอกสารเวอร์ชันล่าสุดที่ระบุ