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

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

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

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

แทรกข้อความ

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

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

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

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

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

ลบข้อความ

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

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

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

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

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

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

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

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