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