กฎและลักษณะการทำงานของการแก้ไขโครงสร้าง

ส่วนนี้จะอธิบายลักษณะการทำงานและข้อจำกัดที่คุณต้องทำความเข้าใจเมื่อแก้ไขเอกสารโดยใช้ Google เอกสาร API

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

ส่วนต่อไปนี้จะสรุปกฎหลักของเมธอดเหล่านี้

แทรกข้อความ

  • การแทรกอักขระขึ้นบรรทัดใหม่จะสร้างa Paragraphที่ ดัชนีนั้นโดยนัย ระบบจะคัดลอกรูปแบบย่อหน้าของย่อหน้าใหม่จากย่อหน้าที่ดัชนีการแทรกปัจจุบัน ซึ่งรวมถึงรายการและสัญลักษณ์แสดงหัวข้อย่อย
  • ต้องแทรกข้อความภายในขอบเขตของ Paragraph ที่มีอยู่ เช่น ไม่สามารถแทรกข้อความที่ดัชนีเริ่มต้นของตาราง โดยต้องแทรกข้อความในย่อหน้าก่อนหน้า
  • API อาจปรับตำแหน่งโดยนัยเพื่อป้องกันการแทรกภายในคลัสเตอร์กราฟีม Unicode เมื่อเกิดกรณีนี้ ระบบจะแทรกข้อความทันทีหลังจากคลัสเตอร์กราฟีม
  • ระบบจะกำหนดรูปแบบข้อความสำหรับข้อความที่แทรกโดยอัตโนมัติ ซึ่งโดยทั่วไปจะคงการจัดรูปแบบของข้อความข้างเคียงไว้ โดยปกติแล้วรูปแบบข้อความสำหรับข้อความที่แทรกจะตรงกับข้อความที่อยู่ก่อนดัชนีการแทรก
  • ระบบจะนำอักขระควบคุมบางตัว (U+0000-U+0008, U+000C-U+001F) และอักขระจากพื้นที่ใช้งานส่วนตัวของระนาบหลายภาษาพื้นฐานของ Unicode (U+E000-U+F8FF) ออกจากข้อความที่แทรก
  • ดูข้อมูลเพิ่มเติมได้ที่หัวข้อ แทรก ลบ และย้าย ข้อความ

แทรกรูปภาพในบรรทัด

  • รูปภาพต้องมีขนาดไม่เกิน 50 MB มีความละเอียดไม่เกิน 25 เมกะพิกเซล และต้องอยู่ในรูปแบบ PNG, JPEG หรือ GIF
  • URI ที่ระบุต้องเข้าถึงได้แบบสาธารณะและมีความยาวไม่เกิน 2 KB
  • ต้องแทรกรูปภาพภายในขอบเขตของ Paragraph ที่มีอยู่ เช่น ไม่สามารถแทรกข้อความที่ดัชนีเริ่มต้นของตาราง
  • ไม่สามารถแทรกรูปภาพภายในเชิงอรรถหรือสมการ
  • ดูข้อมูลเพิ่มเติมได้ที่หัวข้อ แทรกรูปภาพในบรรทัด images

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

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

สร้างสัญลักษณ์แสดงหัวข้อย่อยของย่อหน้า

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

ลบข้อความ

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

  • ระบบไม่อนุญาตให้ลบที่ทำให้โครงสร้างเอกสารไม่ถูกต้อง ตัวอย่างคำขอการลบที่ไม่ถูกต้องมีดังนี้

    • การลบหน่วยโค้ด 1 หน่วยของคู่ตัวแทน

    • การลบอักขระขึ้นบรรทัดใหม่สุดท้ายของ Body, Header, Footer, Footnote, TableCell หรือ TableOfContents

    • การลบจุดเริ่มต้นหรือจุดสิ้นสุดของ Table, TableOfContents, หรือ Equation โดยไม่ลบองค์ประกอบทั้งหมด

    • การลบอักขระขึ้นบรรทัดใหม่ก่อน Table, TableOfContents, หรือ SectionBreak โดยไม่ลบองค์ประกอบ

    • การลบแถวหรือเซลล์แต่ละรายการของตาราง แต่สามารถลบเนื้อหาในเซลล์ตารางได้

  • ดูข้อมูลเพิ่มเติมได้ที่หัวข้อ แทรก ลบ และย้าย ข้อความ