בקטע הזה מתוארים התנהגויות ומגבלות שחשוב להכיר כשעורכים מסמכים באמצעות 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קיים. לדוגמה, אי אפשר להוסיף טקסט לאינדקס ההתחלתי של טבלה. - אי אפשר להוסיף תמונות בתוך הערת שוליים או משוואה.
- מידע נוסף זמין במאמר בנושא הוספת תמונות בתוך הטקסט.
עיצוב הטקסט
- כשמחילים עיצוב ברמת הפסקה על טווח, העיצוב חל על כל פסקה שחופפת חלקית או מלאה לטווח הזה.
- יכול להיות שהטווח יורחב כך שיכלול שורות חדשות סמוכות.
- אם הטווח מכיל פסקה ששייכת לרשימה, גם התבליט של הפסקה יעודכן בסגנון הטקסט התואם.
- מידע נוסף זמין במאמר בנושא עיצוב טקסט.
יצירת תבליטים בפסקאות
- יוצרת תבליטים לכל הפסקאות שחופפות לטווח הנתון.
- רמת הקינון של כל פסקה נקבעת לפי מספר הטאבים שמופיעים לפני כל פסקה.
- כשיוצרים את התבליטים, הכרטיסיות המובילות מוסרות, ולכן יכול להיות שהאינדקסים של חלקי הטקסט ישתנו.
- אם מוסיפים תבליטים לפסקה שזהים לתבליטים של רשימה שנמצאת מיד לפני פסקה היעד, הפסקה תצורף לרשימה.
- מידע נוסף זמין במאמר עבודה עם רשימות.
מחיקת הטקסט
מחיקת טקסט שחוצה גבול של פסקה עלולה לגרום לשינויים בסגנונות של פסקאות, ברשימות, באובייקטים ממוקמים ובסימניות, כי שתי הפסקאות ימוזגו.
אסור לבצע מחיקות שגורמות למבנה מסמך לא תקין. דוגמאות לבקשות מחיקה לא חוקיות:
מחיקה של יחידת קוד אחת מתוך זוג סרוגייט.
מחיקת התו האחרון של שורה חדשה ב-
Body,Header,Footer,Footnote,TableCellאוTableOfContents.מחיקת ההתחלה או הסוף של
Table,TableOfContentsאוEquationבלי למחוק את כל הרכיב.מחיקת התו של השורה החדשה לפני
Table,TableOfContentsאוSectionBreakבלי למחוק את הרכיב.מחיקה של שורות או תאים ספציפיים בטבלה. מותר למחוק את התוכן בתא בטבלה.
מידע נוסף מופיע במאמר הוספה, מחיקה והעברה של טקסט.