כללים והתנהגות עריכה מבניים
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
בקטע הזה מתוארים התנהגויות ומגבלות שחשוב להכיר כשעורכים מסמכים באמצעות 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
בלי למחוק את הרכיב.
מחיקה של שורות או תאים ספציפיים בטבלה. מותר למחוק את התוכן בתא בטבלה.
מידע נוסף מופיע במאמר הוספה, מחיקה והעברה של טקסט.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-08-29 (שעון UTC).
[null,null,["עדכון אחרון: 2025-08-29 (שעון UTC)."],[],[],null,["# Structural edit rules and behavior\n\nThis section describes behaviors and limitations that you must understand when\nyou edit documents using the Google Docs API.\n\nIn general, you cannot execute edits that cause the invalid structure of\nelements within a document. Review each\n[`documents.batchUpdate`](/workspace/docs/api/reference/rest/v1/documents/batchUpdate)\nrequest method for constraints and rules that apply to those\n[requests](/workspace/docs/api/reference/rest/v1/documents/request).\n\nThe following sections summarize the key rules across these methods.\n\nInsert text\n-----------\n\n- Inserting a newline character implicitly creates a [`Paragraph`](/workspace/docs/api/reference/rest/v1/documents#paragraph) at that index. The paragraph style of the new paragraph is copied from the paragraph at the current insertion index, including lists and bullets.\n- Text must be inserted within the bounds of an existing `Paragraph`. For example, text cannot be inserted at a table's start index. The text must be inserted in the preceding paragraph.\n- The API may implicitly adjust the location to prevent insertions within Unicode grapheme clusters. When this happens, the text is inserted immediately after the grapheme cluster.\n- Text styles for inserted text are determined automatically, generally preserving the styling of neighboring text. Typically, the text style for the inserted text matches the text immediately before the insertion index.\n- Some control characters (`U+0000-U+0008, U+000C-U+001F`) and characters from the Unicode Basic Multilingual Plane Private Use Area (`U+E000-U+F8FF`) are stripped out of inserted text.\n- For more information, see [Insert, delete, and move\n text](/workspace/docs/api/how-tos/move-text).\n\nInsert inline images\n--------------------\n\n- Image must be less than 50 MB in size, cannot exceed 25 megapixels, and must be in one of PNG, JPEG, or GIF formats.\n- The provided URI must be publicly accessible and at most 2 KB in length.\n- Image must be inserted within the bounds of an existing `Paragraph`. For example, text cannot be inserted at a table's start index.\n- Images can't be inserted inside a footnote or equation.\n- For more information, see [Insert inline\n images](/workspace/docs/api/how-tos/images).\n\nFormat text\n-----------\n\n- When you apply paragraph-level formatting to a range, the formatting is applied to any paragraph that's partially or completely overlapped by that range.\n- The range might be extended to include adjacent newlines.\n- If the range fully contains a paragraph belonging to a list, the paragraph's bullet is also updated with the matching text style.\n- For more information, see [Format\n text](/workspace/docs/api/how-tos/format-text).\n\nCreate paragraph bullets\n------------------------\n\n- Creates bullets for all paragraphs that overlap with the given range.\n- The nesting level of each paragraph is determined by the number of leading tabs before each paragraph.\n- The leading tabs are removed when creating the bullets, which might change the indexes of parts of the text.\n- If you add paragraph bullets that match those of a list immediately before the target paragraph, the paragraph is joined to the list.\n- For more information, see [Work with lists](/workspace/docs/api/how-tos/lists).\n\nDelete text\n-----------\n\n- Deleting text that crosses a paragraph boundary might cause changes to\n paragraph styles, lists, positioned objects, and bookmarks as the two\n paragraphs are merged.\n\n- Deletions that cause an invalid document structure are not permitted. Some\n examples of invalid delete requests include:\n\n - Deleting one code unit of a surrogate pair.\n\n - Deleting the last newline character of a\n [`Body`](/workspace/docs/api/reference/rest/v1/documents#body),\n [`Header`](/workspace/docs/api/reference/rest/v1/documents#header),\n [`Footer`](/workspace/docs/api/reference/rest/v1/documents#footer),\n [`Footnote`](/workspace/docs/api/reference/rest/v1/documents#footnote),\n [`TableCell`](/workspace/docs/api/reference/rest/v1/documents#tablecell), or\n [`TableOfContents`](/workspace/docs/api/reference/rest/v1/documents#tableofcontents).\n\n - Deleting the start or end of a\n [`Table`](/workspace/docs/api/reference/rest/v1/documents#table),\n `TableOfContents`, or\n [`Equation`](/workspace/docs/api/reference/rest/v1/documents#equation)\n without deleting the entire element.\n\n - Deleting the newline character before a `Table`, `TableOfContents`, or\n [`SectionBreak`](/workspace/docs/api/reference/rest/v1/documents#sectionbreak)\n without deleting the element.\n\n - Deleting individual rows or cells of a table. Deleting the content in a\n table cell is allowed.\n\n- For more information, see [Insert, delete, and move\n text](/workspace/docs/api/how-tos/move-text).\n\nRelated topics\n--------------\n\n- [Structure of a Google Docs document](/workspace/docs/api/concepts/structure)\n- [Requests and responses](/workspace/docs/api/concepts/request-response)"]]
