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

revisionId

string

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

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

suggestionsViewMode

enum (SuggestionsViewMode)

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

หมายเหตุ: เมื่อแก้ไขเอกสาร การเปลี่ยนแปลงจะขึ้นอยู่กับเอกสารที่มี SUGGESTIONS_INLINE

body

object (Body)

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

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

headers

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

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

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

footers

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

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

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

footnotes

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

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

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

documentStyle

object (DocumentStyle)

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

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

suggestedDocumentStyleChanges

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

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

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

namedStyles

object (NamedStyles)

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

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

suggestedNamedStylesChanges

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

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

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

lists

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

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

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

namedRanges

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

เอาต์พุตเท่านั้น ช่วงที่ตั้งชื่อแล้วในเอกสาร ผูกกับชื่อ

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

inlineObjects

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

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

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

positionedObjects

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

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

ช่องเดิม: ให้ใช้ Document.tabs.document_tab.positioned_objects แทน ซึ่งจะแสดงเนื้อหาเอกสารจริงจากทุกแท็บเมื่อตั้งค่าพารามิเตอร์ 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)

แท็บย่อยที่ฝังอยู่ภายในแท็บนี้

ช่องการรวม 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

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

endIndex

integer

ดัชนีสิ้นสุดฐาน 0 ขององค์ประกอบโครงสร้างนี้ (พิเศษ) ในหน่วยโค้ด UTF-16

ช่องการรวม content เนื้อหาขององค์ประกอบโครงสร้าง content ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
paragraph

object (Paragraph)

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

sectionBreak

object (SectionBreak)

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

table

object (Table)

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

tableOfContents

object (TableOfContents)

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

ย่อหน้า

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

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

object (ParagraphElement)

เนื้อหาของย่อหน้าจะแบ่งออกเป็นส่วนต่างๆ

paragraphStyle

object (ParagraphStyle)

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

suggestedParagraphStyleChanges

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

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

bullet

object (Bullet)

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

suggestedBulletChanges

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

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

positionedObjectIds[]

string

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

suggestedPositionedObjectIds

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

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

ParagraphElement

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

การแสดง JSON
{
  "startIndex": integer,
  "endIndex": integer,

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

integer

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

endIndex

integer

ดัชนีสิ้นสุดฐาน 0 ขององค์ประกอบย่อหน้านี้ (พิเศษ) ในหน่วยโค้ด UTF-16

ช่องการรวม content เนื้อหาขององค์ประกอบย่อหน้า content ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
textRun

object (TextRun)

องค์ประกอบย่อหน้าที่เรียกใช้ข้อความ

autoText

object (AutoText)

องค์ประกอบของย่อหน้าข้อความอัตโนมัติ

pageBreak

object (PageBreak)

องค์ประกอบย่อหน้าสำหรับแบ่งหน้า

columnBreak

object (ColumnBreak)

องค์ประกอบย่อหน้าสำหรับตัวแบ่งคอลัมน์

footnoteReference

object (FootnoteReference)

องค์ประกอบย่อหน้าอ้างอิงเชิงอรรถ

horizontalRule

object (HorizontalRule)

องค์ประกอบย่อหน้าของกฎแนวนอน

equation

object (Equation)

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

inlineObjectElement

object (InlineObjectElement)

องค์ประกอบย่อหน้าของออบเจ็กต์ในบรรทัด

person

object (Person)

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

TextRun

ParagraphElement ที่แสดงอักขระทั้งหมดโดยมีการจัดรูปแบบเหมือนกัน

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

string

ข้อความของการวิ่งครั้งนี้

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

suggestedInsertionIds[]

string

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

suggestedDeletionIds[]

string

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

textStyle

object (TextStyle)

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

suggestedTextStyleChanges

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

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

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

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

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

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

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

การแสดง JSON
{
  "bold": boolean,
  "italic": boolean,
  "underline": boolean,
  "strikethrough": boolean,
  "smallCaps": boolean,
  "backgroundColor": {
    object (OptionalColor)
  },
  "foregroundColor": {
    object (OptionalColor)
  },
  "fontSize": {
    object (Dimension)
  },
  "weightedFontFamily": {
    object (WeightedFontFamily)
  },
  "baselineOffset": enum (BaselineOffset),
  "link": {
    object (Link)
  }
}
ช่อง
bold

boolean

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

italic

boolean

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

underline

boolean

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

strikethrough

boolean

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

smallCaps

boolean

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

backgroundColor

object (OptionalColor)

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

foregroundColor

object (OptionalColor)

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

fontSize

object (Dimension)

ขนาดตัวอักษรของข้อความ

weightedFontFamily

object (WeightedFontFamily)

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

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

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

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

baselineOffset

enum (BaselineOffset)

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

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

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)

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

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 อาจมีรหัสการลบหลายรหัส ตัวอย่างเช่น หากมีผู้ใช้หลายคนแนะนำให้ลบรหัสนั้น หากเว้นว่างไว้ ระบบจะไม่แนะนําให้ลบลิงก์บุคคลนี้

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 ซึ่งพร้อมใช้งานเสมอ

mimeType

string

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

แบบย่อหน้า

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

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

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

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

การแสดง JSON
{
  "headingId": string,
  "namedStyleType": enum (NamedStyleType),
  "alignment": enum (Alignment),
  "lineSpacing": number,
  "direction": enum (ContentDirection),
  "spacingMode": enum (SpacingMode),
  "spaceAbove": {
    object (Dimension)
  },
  "spaceBelow": {
    object (Dimension)
  },
  "borderBetween": {
    object (ParagraphBorder)
  },
  "borderTop": {
    object (ParagraphBorder)
  },
  "borderBottom": {
    object (ParagraphBorder)
  },
  "borderLeft": {
    object (ParagraphBorder)
  },
  "borderRight": {
    object (ParagraphBorder)
  },
  "indentFirstLine": {
    object (Dimension)
  },
  "indentStart": {
    object (Dimension)
  },
  "indentEnd": {
    object (Dimension)
  },
  "tabStops": [
    {
      object (TabStop)
    }
  ],
  "keepLinesTogether": boolean,
  "keepWithNext": boolean,
  "avoidWidowAndOrphan": boolean,
  "shading": {
    object (Shading)
  },
  "pageBreakBefore": boolean
}
ช่อง
headingId

string

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

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

namedStyleType

enum (NamedStyleType)

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

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

alignment

enum (Alignment)

การจัดแนวข้อความของย่อหน้านี้

lineSpacing

number

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

direction

enum (ContentDirection)

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

spacingMode

enum (SpacingMode)

โหมดระยะห่างของย่อหน้า

spaceAbove

object (Dimension)

ระยะห่างเหนือย่อหน้า หากไม่ได้ตั้งค่า ระบบจะรับค่าจากระดับบน

spaceBelow

object (Dimension)

ขนาดพื้นที่เกินด้านล่างของย่อหน้า หากไม่ได้ตั้งค่า ระบบจะรับค่าจากระดับบน

borderBetween

object (ParagraphBorder)

เส้นขอบระหว่างย่อหน้านี้กับย่อหน้าถัดไปและย่อหน้าก่อนหน้า หากไม่ได้ตั้งค่า ระบบจะรับค่าจากระดับบน

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

อัปเดตเส้นขอบของย่อหน้าบางส่วนไม่ได้ เมื่อเปลี่ยนเส้นขอบของย่อหน้า คุณต้องระบุเส้นขอบใหม่ให้ครบถ้วน

borderTop

object (ParagraphBorder)

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

เส้นขอบด้านบนจะแสดงผลเมื่อย่อหน้าด้านบนมีคุณสมบัติของเส้นขอบและการเยื้องที่แตกต่างกัน

อัปเดตเส้นขอบของย่อหน้าบางส่วนไม่ได้ เมื่อเปลี่ยนเส้นขอบของย่อหน้า คุณต้องระบุเส้นขอบใหม่ให้ครบถ้วน

borderBottom

object (ParagraphBorder)

เส้นขอบที่ด้านล่างของย่อหน้านี้ หากไม่ได้ตั้งค่า ระบบจะรับค่าจากระดับบน

เส้นขอบด้านล่างจะแสดงผลเมื่อย่อหน้าด้านล่างมีคุณสมบัติของเส้นขอบและการเยื้องที่แตกต่างกัน

อัปเดตเส้นขอบของย่อหน้าบางส่วนไม่ได้ เมื่อเปลี่ยนเส้นขอบของย่อหน้า คุณต้องระบุเส้นขอบใหม่ให้ครบถ้วน

borderLeft

object (ParagraphBorder)

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

อัปเดตเส้นขอบของย่อหน้าบางส่วนไม่ได้ เมื่อเปลี่ยนเส้นขอบของย่อหน้า คุณต้องระบุเส้นขอบใหม่ให้ครบถ้วน

borderRight

object (ParagraphBorder)

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

อัปเดตเส้นขอบของย่อหน้าบางส่วนไม่ได้ เมื่อเปลี่ยนเส้นขอบของย่อหน้า คุณต้องระบุเส้นขอบใหม่ให้ครบถ้วน

indentFirstLine

object (Dimension)

จำนวนการเยื้องบรรทัดแรกของย่อหน้า หากไม่ได้ตั้งค่า ระบบจะรับค่าจากระดับบน

indentStart

object (Dimension)

จำนวนการเยื้องของย่อหน้าด้านข้างที่ตรงกับจุดเริ่มต้นของข้อความ โดยขึ้นอยู่กับทิศทางของย่อหน้าในปัจจุบัน หากไม่ได้ตั้งค่า ระบบจะรับค่าจากระดับบน

indentEnd

object (Dimension)

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

tabStops[]

object (TabStop)

รายการแท็บหยุดสำหรับย่อหน้านี้ โดยจะไม่รับค่ารายการตัวกั้นแท็บ

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

keepLinesTogether

boolean

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

keepWithNext

boolean

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

avoidWidowAndOrphan

boolean

จะหลีกเลี่ยงคนหม้ายและเด็กกำพร้าสําหรับย่อหน้านั้นหรือไม่ หากไม่ได้ตั้งค่า ระบบจะรับค่าจากระดับบน

shading

object (Shading)

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

pageBreakBefore

boolean

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

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

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.48 ของ "Office Open XML File Formats - Fundamentals and Markup Language Reference" ส่วนที่ 1 ของ ECMA-376 รุ่นที่ 4

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

TabStop

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

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

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

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

marginBottom

object (Dimension)

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

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

marginRight

object (Dimension)

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

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

marginLeft

object (Dimension)

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

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

marginHeader

object (Dimension)

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

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

sectionType

enum (SectionType)

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

defaultHeaderId

string

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

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

firstPageHeaderId

string

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

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

evenPageHeaderId

string

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

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

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

ดัชนีเริ่มต้นที่อิงตามศูนย์ของแถวนี้ ในหน่วยโค้ด 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

ดัชนีเริ่มต้นที่อิงตามศูนย์ของเซลล์นี้ในหน่วยโค้ด 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.59 ของ "Office Open XML File Formats - Fundamentals and Markup Language Reference" ส่วนที่ 1 ของ ECMA-376 รุ่นที่ 4

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 หรือค่านี้สำหรับส่วนหัวในหน้าเลขคู่ หากไม่ได้ตั้งค่าไว้ จะไม่มีส่วนหัวหน้าเลขคู่

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

firstPageHeaderId

string

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

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

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 หรือไม่

firstPageHeaderIdSuggested

boolean

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

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)

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

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

textStyleSuggestionState

object (TextStyleSuggestionState)

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

paragraphStyleSuggestionState

object (ParagraphStyleSuggestionState)

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

รายการ

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

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

object (ListProperties)

พร็อพเพอร์ตี้ของรายการ

suggestedListPropertiesChanges

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

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

suggestedInsertionId

string

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

suggestedDeletionIds[]

string

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

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 ตามลำดับ

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

ช่องการรวม 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 ตัวเลขที่มีเลขหลักเดียวนำหน้าด้วยศูนย์ เช่น 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

ดัชนีเริ่มต้นที่อิงตามศูนย์ของช่วงนี้ ในหน่วยโค้ด 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 ชีตต้นฉบับเมื่อวัตถุที่ฝังเป็นแผนภูมิที่ลิงก์

หากไม่ได้ตั้งค่า ระบบจะไม่ลิงก์ออบเจ็กต์ที่ฝัง

ช่องการรวม 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.
}
ช่อง
ช่องการรวม 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

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

transparencySuggested

boolean

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ [ความโปร่งใส] หรือไม่ [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

ระบุว่ามีการเปลี่ยนแปลงที่แนะนำกับ [ความกว้าง] หรือไม่ [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 SelectsViewMode ที่ใช้กับเอกสารที่แสดงผลจะขึ้นอยู่กับระดับการเข้าถึงปัจจุบันของผู้ใช้ หากผู้ใช้มีเพียงสิทธิ์ดู ระบบจะใช้ PREVIEW_WITHOUT_SUGGESTIONS มิเช่นนั้นระบบจะใช้ SUGGESTIONS_INLINE นี่คือโหมดมุมมองคำแนะนำเริ่มต้น
SUGGESTIONS_INLINE

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

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

PREVIEW_SUGGESTIONS_ACCEPTED

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

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

PREVIEW_WITHOUT_SUGGESTIONS เอกสารที่ส่งกลับมาเป็นหน้าตัวอย่างโดยปฏิเสธการเปลี่ยนแปลงที่แนะนำทั้งหมดหากมีคำแนะนำในเอกสาร

เมธอด

batchUpdate

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

create

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

get

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