בקטע הזה מתוארים התנהגויות ומגבלות שחשוב להבין כשעורכים מסמכים באמצעות Google Docs API.
באופן כללי, אי אפשר לבצע פעולות עריכה שגורמות למבנה לא תקין של רכיבים במסמך. בודקים את כל שיטות הבקשה של documents.batchUpdate כדי לבדוק אילו אילוצים וכללים חלים על הבקשות האלה.
בקטעים הבאים מופיע סיכום של כללי המפתח בשיטות האלה.
הוספת טקסט
- הוספת תו של שורה חדשה יוצרת באופן משתמע את הערך
Paragraphבאותו אינדקס. סגנון הפסקה של הפסקה החדשה מועתק מפסקה באינדקס ההוספה הנוכחי, כולל רשימות ותבליטים. - צריך להוסיף טקסט בתוך גבולות של
Paragraphקיים. לדוגמה, אי אפשר להוסיף טקסט באינדקס ההתחלה של טבלה. צריך להוסיף את הטקסט בפסקה הקודמת. - ה-API עשוי לשנות את המיקום באופן משתמע כדי למנוע הוספה של תוכן בתוך אשכולות של גרפימות ב-Unicode. במקרה כזה, הטקסט מוכנס מיד אחרי אשכול הגרפמות.
- סגנונות הטקסט של הטקסט שהוכנס נקבעים באופן אוטומטי, בדרך כלל תוך שמירה על סגנון הטקסט הסמוך. בדרך כלל, סגנון הטקסט של הטקסט שהוזן תואם את הטקסט שממש לפני אינדקס ההוספה.
- חלק מתווי הבקרה (
U+0000-U+0008, U+000C-U+001F) והתווים מהאזור לשימוש הפרטי של המישור הבסיסי Unicode (U+E000-U+F8FF) נמחקים מהטקסט שמוכנס. - מידע נוסף זמין במאמר הוספה, מחיקה והעברה של טקסט.
הוספת תמונות מוטבעות
- התמונה צריכה להיות בגודל של עד 50MB, לא יכולה לחרוג מ-25 מגה-פיקסל וצריך להיות לה אחד מהפורמטים הבאים: PNG, JPEG או GIF.
- ה-URI שצוין צריך להיות נגיש לציבור ובאורך של 2KB לכל היותר.
- צריך להוסיף את התמונה בתוך גבולות של
Paragraphקיים. לדוגמה, אי אפשר להוסיף טקסט באינדקס ההתחלה של טבלה. - אי אפשר להוסיף תמונות בתוך הערה שוליים או בתוך משוואה.
- מידע נוסף זמין במאמר הוספת תמונות בתוך הטקסט.
עיצוב הטקסט
- כשמחילים עיצוב ברמת הפסקה על טווח, העיצוב מוחל על כל פסקה שהטווח חופף לה באופן חלקי או מלא.
- יכול להיות שהטווח יורחב כך שיכלול שורות חדשות סמוכות.
- אם הטווח מכיל פסקה שלמה ששייכת לרשימה, גם הנקודה של הפסקה תתעדכן בסגנון הטקסט התואם.
- מידע נוסף מופיע במאמר עיצוב טקסט.
יצירת תבליטים של פסקאות
- הוספת סימני כוכב לכל הקטעים שמצטופפים עם הטווח שצוין.
- רמת ההטמעה של כל הפסקה נקבעת לפי מספר התווים הקודמים של Tab לפני כל הפסקה.
- הכרטיסיות המובילות מוסרות במהלך יצירת התבליטים, דבר שעלול לשנות את האינדקסים של חלקי הטקסט.
- אם מוסיפים תבליטים של פסקאות שתואמים לתבליטים של רשימה מיד לפני פסקאת היעד, הפסקאה תצורף לרשימה.
- מידע נוסף זמין במאמר עבודה עם רשימות.
מחיקת הטקסט
מחיקת טקסט שמעבר לגבול של פסקה עלולה לגרום לשינויים בסגנונות של פסקאות, ברשימות, באובייקטים במיקום ספציפי ובסימניות, כי שתי הפסקאות ימוזגו.
אסור לבצע מחיקה שגורמת למבנה מסמך לא תקין. דוגמאות לבקשות מחיקה לא חוקיות:
מחיקה של יחידת קוד אחת מצמד חלופי.
מחיקת התו האחרון של שורת ההתחלה של
Body,Header,Footer,Footnote,TableCellאוTableOfContents.מחיקת ההתחלה או הסוף של
Table,TableOfContentsאוEquationבלי למחוק את הרכיב כולו.מחיקת התו של שורת חדשה לפני
Table,TableOfContentsאוSectionBreakבלי למחוק את הרכיב.מחיקה של שורות או תאים ספציפיים בטבלה. מותר למחוק את התוכן בתא בטבלה.
מידע נוסף מופיע במאמר הוספה, מחיקה והעברה של טקסט.