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