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