ส่วนนี้จะอธิบายถึงการทำงานและข้อจำกัดที่คุณต้องเข้าใจเมื่อแก้ไขเอกสารโดยใช้ Google เอกสาร API
โดยทั่วไปแล้ว คุณจะไม่สามารถดำเนินการแก้ไขที่ทำให้โครงสร้างขององค์ประกอบภายในเอกสารไม่ถูกต้อง ตรวจสอบเมธอดคำขอของ documents.batchUpdate
แต่ละวิธีสำหรับข้อจำกัดและกฎที่ใช้กับคำขอเหล่านั้น
ส่วนต่อไปนี้จะสรุปกฎสำคัญสำหรับวิธีการเหล่านี้
แทรกข้อความ
- การแทรกอักขระขึ้นบรรทัดใหม่จะเป็นการสร้าง
Paragraph
ที่ดัชนีดังกล่าวโดยปริยาย รูปแบบย่อหน้าของย่อหน้าใหม่จะคัดลอกจากย่อหน้าที่ดัชนีการแทรกปัจจุบัน ซึ่งรวมถึงรายการและหัวข้อย่อย - ต้องแทรกข้อความภายในขอบเขตของ
Paragraph
ที่มีอยู่ ตัวอย่างเช่น คุณจะแทรกข้อความที่ดัชนีเริ่มต้นของตารางไม่ได้ ต้องแทรกข้อความไว้ในย่อหน้าก่อนหน้านี้ - API อาจปรับตำแหน่งโดยปริยายเพื่อป้องกันการแทรกภายในคลัสเตอร์ Graeme ของ Unicode เมื่อเกิดกรณีนี้ขึ้น ระบบจะแทรกข้อความทันทีหลังจากคลัสเตอร์ Graeme
- รูปแบบข้อความสำหรับข้อความที่แทรกจะได้รับการกำหนดโดยอัตโนมัติ โดยทั่วไปจะรักษาการจัดรูปแบบของข้อความที่อยู่ใกล้เคียง โดยปกติแล้ว รูปแบบข้อความของข้อความที่แทรกจะตรงกับข้อความที่อยู่ก่อนดัชนีการแทรก
- อักขระควบคุมบางตัว (
U+0000-U+0008, U+000C-U+001F
) และอักขระจาก Unicode Basic Multilingual Plane Private Use Area (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
โดยไม่ลบองค์ประกอบการลบแต่ละแถวหรือเซลล์ของตาราง การลบเนื้อหาในเซลล์ตารางนั้นสามารถทำได้
ดูข้อมูลเพิ่มเติมได้ที่แทรก ลบ และย้ายข้อความ