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 Private Use Area (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)

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

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

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

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 เป็นคำโดยนัยและไม่ควรระบุ คำขอ "*" สามารถใช้เป็นช่องสั้นๆ สำหรับแสดงรายการทุกช่อง

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

string

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

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

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

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

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

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

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

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

object (TableRange)

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

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

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

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

object (TableRange)

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

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

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

{
  "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 หมายความว่าแถวทั้งหมดไม่มีการปักหมุด