Requests

{

  // Union field request can be only one of the following:
  "replaceAllText": {
    object (ReplaceAllTextRequest)
  },
  "insertText": {
    object (InsertTextRequest)
  },
  "updateTextStyle": {
    object (UpdateTextStyleRequest)
  },
  "createParagraphBullets": {
    object (CreateParagraphBulletsRequest)
  },
  "deleteParagraphBullets": {
    object (DeleteParagraphBulletsRequest)
  },
  "createNamedRange": {
    object (CreateNamedRangeRequest)
  },
  "deleteNamedRange": {
    object (DeleteNamedRangeRequest)
  },
  "updateParagraphStyle": {
    object (UpdateParagraphStyleRequest)
  },
  "deleteContentRange": {
    object (DeleteContentRangeRequest)
  },
  "insertInlineImage": {
    object (InsertInlineImageRequest)
  },
  "insertTable": {
    object (InsertTableRequest)
  },
  "insertTableRow": {
    object (InsertTableRowRequest)
  },
  "insertTableColumn": {
    object (InsertTableColumnRequest)
  },
  "deleteTableRow": {
    object (DeleteTableRowRequest)
  },
  "deleteTableColumn": {
    object (DeleteTableColumnRequest)
  },
  "insertPageBreak": {
    object (InsertPageBreakRequest)
  },
  "deletePositionedObject": {
    object (DeletePositionedObjectRequest)
  },
  "updateTableColumnProperties": {
    object (UpdateTableColumnPropertiesRequest)
  },
  "updateTableCellStyle": {
    object (UpdateTableCellStyleRequest)
  },
  "updateTableRowStyle": {
    object (UpdateTableRowStyleRequest)
  },
  "replaceImage": {
    object (ReplaceImageRequest)
  },
  "updateDocumentStyle": {
    object (UpdateDocumentStyleRequest)
  },
  "mergeTableCells": {
    object (MergeTableCellsRequest)
  },
  "unmergeTableCells": {
    object (UnmergeTableCellsRequest)
  },
  "createHeader": {
    object (CreateHeaderRequest)
  },
  "createFooter": {
    object (CreateFooterRequest)
  },
  "createFootnote": {
    object (CreateFootnoteRequest)
  },
  "replaceNamedRangeContent": {
    object (ReplaceNamedRangeContentRequest)
  },
  "updateSectionStyle": {
    object (UpdateSectionStyleRequest)
  },
  "insertSectionBreak": {
    object (InsertSectionBreakRequest)
  },
  "deleteHeader": {
    object (DeleteHeaderRequest)
  },
  "deleteFooter": {
    object (DeleteFooterRequest)
  },
  "pinTableHeaderRows": {
    object (PinTableHeaderRowsRequest)
  }
  // End of list of possible types for union field request.
}

object (ReplaceAllTextRequest)

แทนที่อินสแตนซ์ทั้งหมดของข้อความที่ระบุ

object (InsertTextRequest)

แทรกข้อความในตำแหน่งที่ระบุ

object (UpdateTextStyleRequest)

อัปเดตรูปแบบข้อความในช่วงที่ระบุ

object (CreateParagraphBulletsRequest)

สร้างหัวข้อย่อยสำหรับย่อหน้า

object (DeleteParagraphBulletsRequest)

ลบหัวข้อย่อยออกจากย่อหน้า

object (CreateNamedRangeRequest)

สร้างช่วงที่มีชื่อ

object (DeleteNamedRangeRequest)

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

object (UpdateParagraphStyleRequest)

อัปเดตรูปแบบย่อหน้าในช่วงที่ระบุ

object (DeleteContentRangeRequest)

ลบเนื้อหาออกจากเอกสาร

object (InsertInlineImageRequest)

แทรกรูปภาพในบรรทัดในตำแหน่งที่ระบุ

object (InsertTableRequest)

แทรกตารางที่ตำแหน่งที่ระบุ

object (InsertTableRowRequest)

แทรกแถวว่างลงในตาราง

object (InsertTableColumnRequest)

แทรกคอลัมน์ว่างลงในตาราง

object (DeleteTableRowRequest)

ลบแถวออกจากตาราง

object (DeleteTableColumnRequest)

ลบคอลัมน์ออกจากตาราง

object (InsertPageBreakRequest)

แทรกการแบ่งหน้าในตำแหน่งที่ระบุ

object (DeletePositionedObjectRequest)

ลบออบเจ็กต์ที่จัดตำแหน่งแล้วออกจากเอกสาร

object (UpdateTableColumnPropertiesRequest)

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

object (UpdateTableCellStyleRequest)

อัปเดตรูปแบบของเซลล์ตาราง

object (UpdateTableRowStyleRequest)

อัปเดตรูปแบบแถวในตาราง

object (ReplaceImageRequest)

แทนที่รูปภาพในเอกสาร

object (UpdateDocumentStyleRequest)

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

object (MergeTableCellsRequest)

ผสานเซลล์ในตาราง

object (UnmergeTableCellsRequest)

ยกเลิกการผสานเซลล์ในตาราง

object (CreateHeaderRequest)

สร้างส่วนหัว

object (CreateFooterRequest)

สร้างส่วนท้าย

object (CreateFootnoteRequest)

สร้างเชิงอรรถ

object (ReplaceNamedRangeContentRequest)

แทนที่เนื้อหาในช่วงที่ชื่อ

object (UpdateSectionStyleRequest)

อัปเดตรูปแบบส่วนของช่วงที่ระบุ

object (InsertSectionBreakRequest)

แทรกตัวแบ่งส่วนในตำแหน่งที่ระบุ

object (DeleteHeaderRequest)

ลบส่วนหัวออกจากเอกสาร

object (DeleteFooterRequest)

ลบส่วนท้ายออกจากเอกสาร

object (PinTableHeaderRowsRequest)

อัปเดตจำนวนแถวส่วนหัวที่ปักหมุดไว้ในตาราง

{
  "replaceText": string,
  "tabsCriteria": {
    object (TabsCriteria)
  },

  // Union field criteria can be only one of the following:
  "containsText": {
    object (SubstringMatchCriteria)
  }
  // End of list of possible types for union field criteria.
}

string

ข้อความที่จะแทนที่ข้อความที่ตรงกัน

object (TabsCriteria)

ไม่บังคับ เกณฑ์ที่ใช้ระบุแท็บที่จะแทนที่

หากไม่ระบุ การเปลี่ยนทดแทนจะมีผลกับทุกแท็บ

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

• หากมี ต้องตรงกับรหัสของแท็บเอกพจน์

• หากไม่ระบุ การเปลี่ยนทดแทนจะมีผลกับแท็บเดี่ยว

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

• หากระบุไว้ การเปลี่ยนทดแทนจะมีผลกับแท็บที่ระบุ

• หากละไว้ การแทนที่จะมีผลกับทุกแท็บ

object (SubstringMatchCriteria)

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

{
  "text": string,
  "matchCase": boolean
}

string

ข้อความที่จะค้นหาในเอกสาร

boolean

ระบุว่าการค้นหาควรคำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่หรือไม่

• True : การค้นหาจะคำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่
• False : การค้นหาจะไม่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่

{
  "tabIds": [
    string
  ]
}

string

รายการรหัสแท็บที่คำขอจะดำเนินการ

{
  "text": string,

  // Union field insertion_location can be only one of the following:
  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
  // End of list of possible types for union field insertion_location.
}

string

ข้อความที่จะแทรก

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

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

ระบบจะนำอักขระควบคุมบางตัว (U+0000-U+0008, U+000C-U+001F) และอักขระจากพื้นที่ใช้งานส่วนตัวของ Unicode Basic Multilingual Plane (U+E000-U+F8FF) ออกจากข้อความที่แทรก

object (Location)

แทรกข้อความที่ดัชนีที่เจาะจงในเอกสาร

ข้อความต้องแทรกภายในขอบเขตของ Paragraph ที่มีอยู่ ตัวอย่างเช่น ไม่สามารถแทรกข้อความที่ดัชนีเริ่มต้นของตาราง (เช่น ระหว่างตารางกับย่อหน้าก่อนหน้า) ต้องแทรกข้อความในย่อหน้าก่อนหน้านี้

object (EndOfSegmentLocation)

แทรกข้อความที่ท้ายส่วนหัว ส่วนท้าย เชิงอรรถ หรือเนื้อหาเอกสาร

{
  "segmentId": string,
  "index": integer,
  "tabId": string
}

string

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

integer

ดัชนีฐาน 0 ในหน่วยโค้ด UTF-16

ดัชนีจะสัมพันธ์กับจุดเริ่มต้นของกลุ่มที่ระบุโดย segmentId

string

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

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

• หากมี ต้องตรงกับรหัสของแท็บเอกพจน์

• หากละไว้ คำขอจะใช้กับแท็บนั้น

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

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

• หากละเว้น ระบบจะใช้คำขอกับแท็บแรกในเอกสาร

{
  "segmentId": string,
  "tabId": string
}

string

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

string

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

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

• หากมี ต้องตรงกับรหัสของแท็บเอกพจน์

• หากละไว้ คำขอจะใช้กับแท็บนั้น

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

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

• หากละเว้น ระบบจะใช้คำขอกับแท็บแรกในเอกสาร

{
  "textStyle": {
    object (TextStyle)
  },
  "fields": string,

  // Union field insertion_location can be only one of the following:
  "range": {
    object (Range)
  }
  // End of list of possible types for union field insertion_location.
}

object (TextStyle)

รูปแบบที่จะตั้งค่าในข้อความ

หากค่าของสไตล์หนึ่งๆ ตรงกับค่าของสไตล์หลัก ระบบจะตั้งค่าสไตล์นั้นให้รับค่า

การเปลี่ยนแปลงรูปแบบข้อความบางอย่างอาจส่งผลให้เกิดการเปลี่ยนแปลงอื่นๆ เพื่อจำลองการทำงานของเครื่องมือแก้ไขเอกสาร ดูเอกสารของ TextStyle เพื่อดูข้อมูลเพิ่มเติม

string (FieldMask format)

ฟิลด์ที่ควรอัปเดต

ต้องระบุฟิลด์อย่างน้อย 1 ช่อง รูท textStyle เป็นคำโดยนัยและไม่ควรระบุ คำขอ "*" สามารถใช้เป็นช่องสัญญาณสั้นๆ สำหรับแสดงรายการทุกช่อง

เช่น หากต้องการอัปเดตรูปแบบข้อความเป็นแบบตัวหนา ให้ตั้งค่า fields เป็น "bold"

หากต้องการรีเซ็ตพร็อพเพอร์ตี้เป็นค่าเริ่มต้น ให้ใส่ชื่อช่องในมาสก์ช่อง แต่ไม่ต้องตั้งค่าช่อง

object (Range)

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

ระบบอาจขยายช่วงให้รวมบรรทัดใหม่ที่อยู่ติดกันด้วย

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

ไม่สามารถแทรกช่วงภายใน UpdateTextStyleRequest แบบสัมพัทธ์

{
  "range": {
    object (Range)
  },
  "bulletPreset": enum (BulletGlyphPreset)
}

object (Range)

ช่วงที่จะใช้รูปแบบหัวข้อที่กำหนดไว้ล่วงหน้า

enum (BulletGlyphPreset)

ประเภทของสัญลักษณ์หัวข้อย่อยที่จะใช้

{
  "range": {
    object (Range)
  }
}

object (Range)

ช่วงที่จะลบหัวข้อ

{
  "name": string,
  "range": {
    object (Range)
  }
}

string

ชื่อของ NamedRange ชื่อไม่จำเป็นต้องไม่ซ้ำกัน

ชื่อต้องมีอักขระอย่างน้อย 1 ตัวและไม่เกิน 256 ตัว โดยวัดเป็นหน่วยโค้ด UTF-16

object (Range)

ช่วงที่จะใช้ชื่อ

{
  "tabsCriteria": {
    object (TabsCriteria)
  },

  // Union field named_range_reference can be only one of the following:
  "namedRangeId": string,
  "name": string
  // End of list of possible types for union field named_range_reference.
}

object (TabsCriteria)

ไม่บังคับ เกณฑ์ที่ใช้ระบุแท็บที่ควรทำการลบช่วง หากไม่ระบุ การลบช่วงจะมีผลกับแท็บทั้งหมด

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

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

• หากไม่ระบุ ระบบจะลบช่วงในแท็บเดียว

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

• หากระบุ การลบช่วงจะมีผลกับแท็บที่ระบุ

• หากไม่ระบุ การลบช่วงจะมีผลกับแท็บทั้งหมด

string

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

string

ชื่อของช่วงที่จะลบ ระบบจะลบช่วงที่มีชื่อตามที่ระบุทั้งหมด

{
  "paragraphStyle": {
    object (ParagraphStyle)
  },
  "fields": string,

  // Union field insertion_location can be only one of the following:
  "range": {
    object (Range)
  }
  // End of list of possible types for union field insertion_location.
}

object (ParagraphStyle)

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

การเปลี่ยนแปลงรูปแบบย่อหน้าบางอย่างอาจทำให้เกิดการเปลี่ยนแปลงอื่นๆ เพื่อจำลองการทำงานของเครื่องมือแก้ไขเอกสาร ดูเอกสารของ ParagraphStyle เพื่อดูข้อมูลเพิ่มเติม

string (FieldMask format)

ช่องที่ควรอัปเดต

ต้องระบุอย่างน้อย 1 ช่อง ระบบจะนําราก paragraphStyle มาใช้โดยปริยายและไม่ควรระบุ คำขอ "*" สามารถใช้เป็นช่องสัญญาณสั้นๆ สำหรับแสดงรายการทุกช่อง

ตัวอย่างเช่น หากต้องการอัปเดตคุณสมบัติการปรับแนวของรูปแบบย่อหน้า ให้ตั้งค่า fields ถึง "alignment"

หากต้องการรีเซ็ตพร็อพเพอร์ตี้เป็นค่าเริ่มต้น ให้ใส่ชื่อช่องในมาสก์ของช่อง แต่ไม่ได้ตั้งค่าช่องดังกล่าว

object (Range)

ช่วงที่อยู่ซ้อนทับกับย่อหน้าที่จะจัดรูปแบบ

{
  "range": {
    object (Range)
  }
}

object (Range)

ช่วงของเนื้อหาที่จะลบ

การลบข้อความที่ข้ามขอบเขตของย่อหน้าอาจทำให้เกิดการเปลี่ยนแปลงลักษณะของย่อหน้า รายการ ออบเจ็กต์ที่มีตำแหน่ง และบุ๊กมาร์กเมื่อทั้ง 2 ย่อหน้ารวมเข้าด้วยกัน

การพยายามลบบางช่วงอาจส่งผลให้โครงสร้างเอกสารไม่ถูกต้อง ซึ่งจะทำให้ระบบส่งกลับข้อผิดพลาดเกี่ยวกับคำขอที่ไม่ถูกต้อง 400

ตัวอย่างของคำขอลบที่ไม่ถูกต้องมีดังนี้

• การลบหน่วยโค้ด 1 หน่วยของคู่ตัวแทน
• การลบอักขระขึ้นบรรทัดใหม่สุดท้ายของ Body, Header, Footer, Footnote, TableCell หรือ TableOfContents
• การลบจุดเริ่มต้นหรือจุดสิ้นสุดของ Table, TableOfContents หรือ Equation โดยไม่ต้องลบองค์ประกอบทั้งหมด
• การลบอักขระขึ้นบรรทัดใหม่ก่อน Table, TableOfContents หรือ SectionBreak โดยไม่ลบองค์ประกอบ
• ลบแต่ละแถวหรือเซลล์ของตาราง อนุญาตให้ลบเนื้อหาภายในเซลล์ตารางได้

{
  "uri": string,
  "objectSize": {
    object (Size)
  },

  // Union field insertion_location can be only one of the following:
  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
  // End of list of possible types for union field insertion_location.
}

string

URI ของรูปภาพ

ระบบจะดึงข้อมูลรูปภาพเพียงครั้งเดียว ณ เวลาแทรก และจัดเก็บสำเนาไว้เพื่อแสดงในเอกสาร รูปภาพต้องมีขนาดไม่เกิน 50 MB, ไม่เกิน 25 เมกะพิกเซล และต้องอยู่ในรูปแบบ PNG, JPEG หรือ GIF

URI ที่ระบุต้องเข้าถึงได้แบบสาธารณะและมีความยาวไม่เกิน 2 KB ระบบจะบันทึก URI ไว้กับรูปภาพและแสดงผ่านช่อง ImageProperties.content_uri

object (Size)

ขนาดที่รูปภาพควรปรากฏในเอกสาร คุณสมบัตินี้เป็นแบบไม่บังคับ และขนาดสุดท้ายของรูปภาพในเอกสารจะกำหนดโดยกฎต่อไปนี้ * หากไม่ได้ระบุความกว้างและความสูง ขนาดเริ่มต้นของรูปภาพจะคำนวณตามความละเอียด * หากระบุมิติข้อมูลเพียง 1 รายการ ระบบจะคำนวณมิติข้อมูลอีกรายการหนึ่งเพื่อรักษาสัดส่วนภาพของรูปภาพ * หากระบุทั้งความกว้างและความสูง ระบบจะปรับขนาดรูปภาพให้พอดีกับขนาดที่ระบุโดยคงสัดส่วนภาพเดิมไว้

object (Location)

แทรกรูปภาพในดัชนีที่เฉพาะเจาะจงในเอกสาร

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

คุณไม่สามารถแทรกภาพในบรรทัดภายในเชิงอรรถหรือสมการได้

object (EndOfSegmentLocation)

แทรกข้อความที่ส่วนท้ายของส่วนหัว ส่วนท้าย หรือเนื้อความเอกสาร

คุณไม่สามารถแทรกภาพในบรรทัดภายในเชิงอรรถ

{
  "rows": integer,
  "columns": integer,

  // Union field insertion_location can be only one of the following:
  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
  // End of list of possible types for union field insertion_location.
}

integer

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

integer

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

object (Location)

แทรกตารางที่ดัชนีโมเดลที่ระบุ

ระบบจะแทรกอักขระบรรทัดใหม่ก่อนตารางที่แทรก ดังนั้นดัชนีเริ่มต้นของตารางจะอยู่ที่ดัชนีตำแหน่งที่ระบุ + 1

ตารางต้องแทรกภายในขอบเขตของ Paragraph ที่มีอยู่ เช่น ไม่สามารถแทรกที่ดัชนีเริ่มต้นของตาราง (เช่น ระหว่างตารางที่มีอยู่กับย่อหน้าก่อนหน้า)

แทรกตารางภายในเชิงอรรถหรือสมการไม่ได้

object (EndOfSegmentLocation)

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

แทรกตารางภายในเชิงอรรถไม่ได้

{
  "tableCellLocation": {
    object (TableCellLocation)
  },
  "insertBelow": boolean
}

object (TableCellLocation)

ตำแหน่งเซลล์ในตารางอ้างอิงที่จะแทรกแถว

ระบบจะแทรกแถวใหม่เหนือ (หรือใต้) แถวที่มีเซลล์อ้างอิง หากเซลล์อ้างอิงเป็นเซลล์ที่ผสาน ระบบจะแทรกแถวใหม่เหนือ (หรือใต้) เซลล์ที่ผสาน

boolean

เลือกว่าจะแทรกแถวใหม่ด้านล่างตำแหน่งเซลล์อ้างอิงหรือไม่

• True : แทรกใต้เซลล์
• False : แทรกเหนือเซลล์

{
  "tableStartLocation": {
    object (Location)
  },
  "rowIndex": integer,
  "columnIndex": integer
}

object (Location)

ตำแหน่งที่ตารางเริ่มต้นในเอกสาร

integer

ดัชนีแถวที่อิงตาม 0 ตัวอย่างเช่น แถวที่ 2 ในตารางมีดัชนีแถวเป็น 1

integer

ดัชนีคอลัมน์ฐาน 0 เช่น คอลัมน์ที่ 2 ในตารางมีดัชนีคอลัมน์เป็น 1

{
  "tableCellLocation": {
    object (TableCellLocation)
  },
  "insertRight": boolean
}

object (TableCellLocation)

ตำแหน่งเซลล์ของตารางอ้างอิงที่จะแทรกคอลัมน์

ระบบจะแทรกคอลัมน์ใหม่ทางซ้าย (หรือขวา) ของคอลัมน์ที่มีเซลล์อ้างอิง หากเซลล์อ้างอิงเป็นเซลล์ที่ผสาน ระบบจะแทรกคอลัมน์ใหม่ไปทางซ้าย (หรือขวา) ของเซลล์ที่ผสาน

boolean

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

• True : แทรกไปทางขวา
• False : แทรกทางด้านซ้าย

{
  "tableCellLocation": {
    object (TableCellLocation)
  }
}

object (TableCellLocation)

ตำแหน่งของเซลล์ในตารางอ้างอิงซึ่งแถวที่จะถูกลบ

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

{
  "tableCellLocation": {
    object (TableCellLocation)
  }
}

object (TableCellLocation)

ตำแหน่งของเซลล์ตารางอ้างอิงที่คอลัมน์จะถูกลบ

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

{

  // Union field insertion_location can be only one of the following:
  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
  // End of list of possible types for union field insertion_location.
}

object (Location)

แทรกตัวแบ่งหน้าที่ดัชนีเฉพาะลงในเอกสาร

ต้องแทรกตัวแบ่งหน้าภายในขอบเขตของ Paragraph เช่น แทรกที่ดัชนีเริ่มต้นของตารางไม่ได้ (เช่น ระหว่างตารางกับย่อหน้าก่อนหน้า)

ไม่สามารถแทรกตัวแบ่งหน้าภายในตาราง สมการ เชิงอรรถ ส่วนหัว หรือส่วนท้าย เนื่องจากตัวแบ่งหน้าสามารถแทรกไว้ภายในส่วนเนื้อหาเท่านั้น segment ID ต้องว่างเปล่า

object (EndOfSegmentLocation)

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

คุณจะแทรกตัวแบ่งหน้าในเชิงอรรถ ส่วนหัว หรือส่วนท้ายไม่ได้ เนื่องจากสามารถแทรกการแบ่งหน้าได้ภายในเนื้อหาเท่านั้น ช่อง segment ID จึงต้องว่างเปล่า

{
  "objectId": string,
  "tabId": string
}

string

รหัสของออบเจ็กต์ที่มีตำแหน่งที่จะลบ

string

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

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

• หากมี ต้องตรงกับรหัสของแท็บเอกพจน์

• หากละไว้ คำขอจะใช้กับแท็บนั้น

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

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

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

{
  "tableStartLocation": {
    object (Location)
  },
  "columnIndices": [
    integer
  ],
  "tableColumnProperties": {
    object (TableColumnProperties)
  },
  "fields": string
}

object (Location)

ตำแหน่งที่ตารางเริ่มต้นในเอกสาร

integer

รายการดัชนีคอลัมน์แบบนับจาก 0 ที่ควรอัปเดตพร็อพเพอร์ตี้ หากไม่ระบุดัชนี ระบบจะอัปเดตทุกคอลัมน์

object (TableColumnProperties)

พร็อพเพอร์ตี้ของคอลัมน์ในตารางที่จะอัปเดต

หากค่าของ tableColumnProperties#width น้อยกว่า 5 จุด (5/72 นิ้ว) ระบบจะแสดงข้อผิดพลาด 400 Bad Request

string (FieldMask format)

ช่องที่ควรอัปเดต

ต้องระบุอย่างน้อย 1 ช่อง ระบบจะนําราก tableColumnProperties มาใช้โดยปริยายและไม่ควรระบุ คำขอ "*" สามารถใช้เป็นช่องสัญญาณสั้นๆ สำหรับแสดงรายการทุกช่อง

ตัวอย่างเช่น หากต้องการอัปเดตความกว้างของคอลัมน์ ให้ตั้งค่า fields ถึง "width"

{
  "tableCellStyle": {
    object (TableCellStyle)
  },
  "fields": string,

  // Union field cells can be only one of the following:
  "tableRange": {
    object (TableRange)
  },
  "tableStartLocation": {
    object (Location)
  }
  // End of list of possible types for union field cells.
}

object (TableCellStyle)

รูปแบบที่จะตั้งค่าในเซลล์ของตาราง

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

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

• borderRight
• borderLeft
• borderBottom
• borderTop

string (FieldMask format)

ฟิลด์ที่ควรอัปเดต

ต้องระบุฟิลด์อย่างน้อย 1 ช่อง ระบบจะนําราก tableCellStyle มาใช้โดยปริยายและไม่ควรระบุ คำขอ "*" สามารถใช้เป็นช่องสัญญาณสั้นๆ สำหรับแสดงรายการทุกช่อง

เช่น หากต้องการอัปเดตสีพื้นหลังของเซลล์ในตาราง ให้ตั้งค่า fields ถึง "backgroundColor"

หากต้องการรีเซ็ตพร็อพเพอร์ตี้เป็นค่าเริ่มต้น ให้ใส่ชื่อช่องในมาสก์ของช่อง แต่ไม่ได้ตั้งค่าช่องดังกล่าว

object (TableRange)

ช่วงตารางซึ่งแสดงชุดย่อยของตารางที่ใช้การอัปเดต

object (Location)

ตำแหน่งที่ตารางเริ่มต้นในเอกสาร เมื่อระบุ การอัปเดตจะมีผลกับเซลล์ทั้งหมดในตาราง

{
  "tableCellLocation": {
    object (TableCellLocation)
  },
  "rowSpan": integer,
  "columnSpan": integer
}

object (TableCellLocation)

ตำแหน่งของเซลล์ที่ช่วงตารางเริ่มต้น

integer

ช่วงแถวของช่วงตาราง

integer

ช่วงคอลัมน์ของช่วงตาราง

{
  "tableStartLocation": {
    object (Location)
  },
  "rowIndices": [
    integer
  ],
  "tableRowStyle": {
    object (TableRowStyle)
  },
  "fields": string
}

object (Location)

ตำแหน่งที่ตารางเริ่มต้นในเอกสาร

integer

รายการดัชนีแถวที่ไม่อิงตาม 0 ซึ่งควรอัปเดตสไตล์ หากไม่ระบุดัชนี ระบบจะอัปเดตทุกแถว

object (TableRowStyle)

รูปแบบที่จะตั้งค่าในแถว

string (FieldMask format)

ฟิลด์ที่ควรอัปเดต

ต้องระบุฟิลด์อย่างน้อย 1 ช่อง ระบบจะนําราก tableRowStyle มาใช้โดยปริยายและไม่ควรระบุ คุณสามารถใช้ "*" เพียงตัวเดียวเป็นทางลัดสำหรับแสดงรายการทุกช่อง

ตัวอย่างเช่น หากต้องการอัปเดตความสูงขั้นต่ำของแถว ให้ตั้งค่า fields ถึง "minRowHeight"

{
  "imageObjectId": string,
  "uri": string,
  "imageReplaceMethod": enum (ImageReplaceMethod),
  "tabId": string
}

string

รหัสของรูปภาพที่มีอยู่ซึ่งจะถูกแทนที่ คุณสามารถดึงรหัสได้จากคำตอบของคำขอ GET

string

URI ของรูปภาพใหม่

ระบบจะดึงข้อมูลรูปภาพครั้งเดียวเมื่อมีการแทรกและจัดเก็บสำเนาไว้เพื่อแสดงภายในเอกสาร รูปภาพต้องมีขนาดไม่เกิน 50 MB และมีขนาดไม่เกิน 25 เมกะพิกเซลและต้องอยู่ในรูปแบบ PNG, JPEG หรือ GIF

URI ที่ระบุมีความยาวได้ไม่เกิน 2 KB จะบันทึก URI พร้อมกับรูปภาพ และเปิดเผยผ่าน ImageProperties.source_uri ด้วย

enum (ImageReplaceMethod)

วิธีการเปลี่ยนทดแทน

string

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

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

• หากมี ต้องตรงกับรหัสของแท็บเอกพจน์

• หากละไว้ คำขอจะใช้กับแท็บนั้น

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

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

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

{
  "documentStyle": {
    object (DocumentStyle)
  },
  "fields": string,
  "tabId": string
}

object (DocumentStyle)

รูปแบบที่จะตั้งค่าในเอกสาร

การเปลี่ยนแปลงรูปแบบเอกสารบางอย่างอาจทำให้เกิดการเปลี่ยนแปลงอื่นๆ เพื่อจำลองการทำงานของเครื่องมือแก้ไขเอกสาร ดูเอกสารของ DocumentStyle เพื่อดูข้อมูลเพิ่มเติม

string (FieldMask format)

ฟิลด์ที่ควรอัปเดต

ต้องระบุฟิลด์อย่างน้อย 1 ช่อง รูท documentStyle เป็นคำโดยนัยและไม่ควรระบุ "*" 1 ตัวสามารถใช้เป็นอักษรย่อสำหรับแสดงรายการทุกช่อง

เช่น หากต้องการอัปเดตพื้นหลัง ให้ตั้งค่า fields ถึง "background"

string

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

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

• หากมี ต้องตรงกับรหัสของแท็บเอกพจน์

• หากละไว้ คำขอจะใช้กับแท็บนั้น

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

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

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

{
  "tableRange": {
    object (TableRange)
  }
}

object (TableRange)

ช่วงตารางที่ระบุเซลล์ของตารางที่จะผสาน

ข้อความในเซลล์ที่ผสานจะต่อกันและเก็บไว้ใน "head" เซลล์ของช่วง นี่คือเซลล์ด้านบนซ้ายของช่วงเมื่อทิศทางของเนื้อหาเป็นจากซ้ายไปขวา และเซลล์ด้านบนขวาของช่วง

หากช่วงไม่ใช่สี่เหลี่ยมผืนผ้า (ซึ่งอาจเกิดขึ้นในบางกรณีที่ช่วงครอบคลุมเซลล์ที่ผสานไว้แล้วหรือตารางไม่ใช่สี่เหลี่ยมผืนผ้า) ระบบจะแสดงข้อผิดพลาด 400 Bad Request

{
  "tableRange": {
    object (TableRange)
  }
}

object (TableRange)

ช่วงตารางที่ระบุเซลล์ของตารางที่จะยกเลิกการผสาน

ระบบจะยกเลิกการผสานเซลล์ที่ผสานทั้งหมดในช่วงนี้ และเซลล์ที่ยกเลิกการผสานแล้วจะไม่ได้รับผลกระทบ หากช่วงไม่มีเซลล์ที่ผสาน คำขอจะไม่ดำเนินการใดๆ

หากมีข้อความในเซลล์ที่ผสาน ข้อความจะยังคงอยู่ในเซลล์ "ส่วนหัว" ของบล็อกเซลล์ที่ไม่ได้ผสานซึ่งเกิดขึ้น เซลล์ "head" คือเซลล์ซ้ายบนเมื่อทิศทางของเนื้อหาเป็นแบบซ้ายไปขวา และจะเป็นเซลล์ขวาบนหากเป็นอย่างอื่น

{
  "type": enum (HeaderFooterType),
  "sectionBreakLocation": {
    object (Location)
  }
}

enum (HeaderFooterType)

ประเภทส่วนหัวที่จะสร้าง

object (Location)

ตำแหน่งของ SectionBreak ซึ่งเป็นจุดเริ่มต้นของส่วนที่ควรมีส่วนหัวนี้ หากเป็น "sectionBreakLocation" ไม่ได้ตั้งค่าไว้ หรือถ้าอ้างถึงตัวแบ่งส่วนแรกในส่วนเนื้อหาของเอกสาร ส่วนหัวจะมีผลกับฟิลด์ DocumentStyle

{
  "type": enum (HeaderFooterType),
  "sectionBreakLocation": {
    object (Location)
  }
}

enum (HeaderFooterType)

ประเภทส่วนท้ายที่จะสร้าง

object (Location)

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

{

  // Union field footnote_reference_location can be only one of the following:
  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
  // End of list of possible types for union field footnote_reference_location.
}

object (Location)

แทรกการอ้างอิงเชิงอรรถที่ดัชนีที่ระบุในเอกสาร

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

คุณไม่สามารถแทรกการอ้างอิงในเชิงอรรถภายในสมการ ส่วนหัว ส่วนท้าย หรือเชิงอรรถ เนื่องจากการอ้างอิงเชิงอรรถสามารถทำได้เฉพาะที่ส่วนเนื้อหาเท่านั้น segment ID ต้องว่างเปล่า

object (EndOfSegmentLocation)

แทรกการอ้างอิงเชิงอรรถที่ท้ายเนื้อหาเอกสาร

คุณไม่สามารถแทรกการอ้างอิงในเชิงอรรถภายในส่วนหัว ส่วนท้าย หรือเชิงอรรถ เนื่องจากการอ้างอิงเชิงอรรถสามารถทำได้เฉพาะที่ส่วนเนื้อหาเท่านั้น segment ID ต้องว่างเปล่า

{
  "tabsCriteria": {
    object (TabsCriteria)
  },

  // Union field replacement_content can be only one of the following:
  "text": string
  // End of list of possible types for union field replacement_content.

  // Union field named_range_reference can be only one of the following:
  "namedRangeId": string,
  "namedRangeName": string
  // End of list of possible types for union field named_range_reference.
}

object (TabsCriteria)

ไม่บังคับ เกณฑ์ที่ใช้ระบุว่าการแทนที่จะเกิดขึ้นในแท็บใด หากเว้นไว้ การแทนที่จะมีผลกับทุกแท็บ

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

• หากมี ต้องตรงกับรหัสของแท็บเอกพจน์

• หากไม่ระบุ การเปลี่ยนทดแทนจะมีผลกับแท็บเดี่ยว

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

• หากระบุไว้ การเปลี่ยนทดแทนจะมีผลกับแท็บที่ระบุ

• หากละไว้ การแทนที่จะมีผลกับทุกแท็บ

string

แทนที่เนื้อหาของช่วงที่มีชื่อที่ระบุด้วยข้อความที่ระบุ

string

รหัสของช่วงที่ตั้งชื่อแล้ว ซึ่งเนื้อหาจะถูกแทนที่

หากไม่มีช่วงที่ตั้งชื่อพร้อมรหัสที่ระบุ ระบบจะแสดงข้อผิดพลาด 400 คำขอผิดพลาด

string

ชื่อของ NamedRanges ที่จะมีการแทนที่เนื้อหา

หากมีไฟล์ named ranges หลายรายการที่มีชื่อเดียวกัน ระบบจะแทนที่เนื้อหาของไฟล์แต่ละรายการ หากไม่มีช่วงที่มีชื่อซึ่งมีชื่อที่ระบุไว้ คำขอจะดำเนินการไม่ได้

{
  "range": {
    object (Range)
  },
  "sectionStyle": {
    object (SectionStyle)
  },
  "fields": string
}

object (Range)

ช่วงจะทับซ้อนกับส่วนเพื่อจัดรูปแบบ

เนื่องจากตัวแบ่งส่วนจะต้องแทรก ในเนื้อความเท่านั้น segment ID ต้องว่างเปล่า

object (SectionStyle)

สไตล์ที่จะตั้งค่าในส่วน

การเปลี่ยนแปลงรูปแบบของส่วนบางส่วนอาจทำให้เกิดการเปลี่ยนแปลงอื่นๆ เพื่อจำลองการทำงานของเครื่องมือแก้ไขเอกสาร ดูเอกสารของ SectionStyle เพื่อดูข้อมูลเพิ่มเติม

string (FieldMask format)

ฟิลด์ที่ควรอัปเดต

ต้องระบุฟิลด์อย่างน้อย 1 ช่อง รูท sectionStyle เป็นคำโดยนัยและต้องไม่ระบุไว้ คำขอ "*" สามารถใช้เป็นช่องสัญญาณสั้นๆ สำหรับแสดงรายการทุกช่อง

เช่น หากต้องการอัปเดตระยะขอบด้านซ้าย ให้ตั้งค่า fields ถึง "marginLeft"

{
  "sectionType": enum (SectionType),

  // Union field insertion_location can be only one of the following:
  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
  // End of list of possible types for union field insertion_location.
}

enum (SectionType)

ประเภทของส่วนที่จะแทรก

object (Location)

แทรกบรรทัดใหม่และส่วนแบ่งที่ดัชนีที่เฉพาะเจาะจงในเอกสาร

ต้องแทรกตัวแบ่งส่วนภายในขอบเขตของ Paragraph ตัวอย่างเช่น ไม่สามารถแทรกดัชนีที่ดัชนีเริ่มต้นของตาราง (กล่าวคือ ระหว่างตารางกับย่อหน้าก่อนหน้า)

คุณไม่สามารถแทรกตัวแบ่งส่วนภายในตาราง สมการ เชิงอรรถ ส่วนหัว หรือส่วนท้ายได้ เนื่องจากตัวแบ่งส่วนจะต้องแทรกภายในเนื้อหาเท่านั้น segment ID ต้องว่างเปล่า

object (EndOfSegmentLocation)

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

คุณไม่สามารถแทรกตัวแบ่งส่วนในเชิงอรรถ ส่วนหัว หรือส่วนท้ายได้ เนื่องจากสามารถแทรกการแบ่งส่วนได้ภายในเนื้อหาเท่านั้น ช่อง segment ID จึงต้องว่างเปล่า

{
  "headerId": string,
  "tabId": string
}

string

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

string

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

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

• หากมี ต้องตรงกับรหัสของแท็บเอกพจน์

• หากละไว้ คำขอจะใช้กับแท็บนั้น

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

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

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

{
  "footerId": string,
  "tabId": string
}

string

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

string

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

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

• หากมี ต้องตรงกับรหัสของแท็บเอกพจน์

• หากละไว้ คำขอจะใช้กับแท็บนั้น

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

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

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

{
  "tableStartLocation": {
    object (Location)
  },
  "pinnedHeaderRowsCount": integer
}

object (Location)

ตำแหน่งที่ตารางเริ่มต้นในเอกสาร

integer

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