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