Class Body

Body

התוכן של כרטיסייה במסמך Google Docs. השדה Body עשוי להכיל את הערך ListItem, רכיבים Paragraph, Table ו-TableOfContents. מידע נוסף על למבנה המסמך, ניתן לעיין במדריך הרחבה של Google Docs.

השדה Body מכיל בדרך כלל את כל התוכן של הכרטיסייה, מלבד הרכיבים HeaderSection, FooterSection וכל רכיבי FootnoteSection אחרים.

var body = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody();

// Append a paragraph and a page break to the tab's body section directly.
body.appendParagraph("A paragraph.");
body.appendPageBreak();

שיטות

שיטהסוג הערך המוחזרתיאור קצר
appendHorizontalRule()HorizontalRuleיצירה והוספה של HorizontalRule חדש.
appendImage(image)InlineImageיצירה והוספה של InlineImage חדש מ-blob של התמונה שצוין.
appendImage(image)InlineImageהפונקציה מצרפת את הערך של InlineImage הנתון.
appendListItem(listItem)ListItemהפונקציה מצרפת את הערך של ListItem הנתון.
appendListItem(text)ListItemיצירה והוספה של ListItem חדש שמכיל את תוכן הטקסט שצוין.
appendPageBreak()PageBreakיצירה והוספה של PageBreak חדש.
appendPageBreak(pageBreak)PageBreakהפונקציה מצרפת את הערך של PageBreak הנתון.
appendParagraph(paragraph)Paragraphהפונקציה מצרפת את הערך של Paragraph הנתון.
appendParagraph(text)Paragraphיצירה והוספה של Paragraph חדש שמכיל את תוכן הטקסט שצוין.
appendTable()Tableיצירה והוספה של Table חדש.
appendTable(cells)Tableהפונקציה מצרפת Table חדש שמכיל TableCell לכל ערך מחרוזת שצוין.
appendTable(table)Tableהפונקציה מצרפת את הערך של Table הנתון.
clear()Bodyניקוי התוכן של הרכיב.
copy()Bodyהפונקציה מחזירה עותק עמוק בנפרד עבור הרכיב הנוכחי.
editAsText()Textמתקבלת גרסת Text של הרכיב הנוכחי, לעריכה.
findElement(elementType)RangeElementחיפוש תוכן הרכיב כדי למצוא צאצא מהסוג שצוין.
findElement(elementType, from)RangeElementמחפש את תוכן הרכיב כדי למצוא צאצא מהסוג שצוין, החל מ- ציינת RangeElement.
findText(searchPattern)RangeElementחיפוש תוכן הרכיב לפי דפוס הטקסט שצוין באמצעות ביטויים רגולריים.
findText(searchPattern, from)RangeElementחיפוש תוכן הרכיב לפי תבנית הטקסט שצוינה, החל ממאפיין נתון בתוצאות החיפוש.
getAttributes()Objectאחזור המאפיינים של הרכיב.
getChild(childIndex)Elementאחזור הרכיב הצאצא באינדקס הצאצא שצוין.
getChildIndex(child)Integerאחזור של אינדקס הצאצא לרכיב הצאצא שצוין.
getHeadingAttributes(paragraphHeading)Objectאחזור של קבוצת המאפיינים ל-ParagraphHeading שצוינו.
getImages()InlineImage[]אחזור כל InlineImages הכלולים בקטע.
getListItems()ListItem[]אחזור כל ListItems הכלולים בקטע.
getMarginBottom()Numberאחזור השוליים התחתוניים בנקודות.
getMarginLeft()Numberמאחזר את השוליים השמאליים בנקודות.
getMarginRight()Numberאחזור השוליים הימניים.
getMarginTop()Numberאחזור השוליים העליונים.
getNumChildren()Integerאחזור של מספר הילדים.
getPageHeight()Numberאחזור גובה הדף בנקודות.
getPageWidth()Numberאחזור של רוחב הדף בנקודות.
getParagraphs()Paragraph[]אחזור כל Paragraphs הכלולים בקטע (כולל ListItems).
getParent()ContainerElementאחזור הרכיב ההורה של הרכיב.
getTables()Table[]אחזור כל Tables הכלולים בקטע.
getText()Stringאחזור תוכן הרכיב כמחרוזת טקסט.
getTextAlignment()TextAlignmentמקבל את היישור של הטקסט.
getType()ElementTypeמאחזר את ElementType של הרכיב.
insertHorizontalRule(childIndex)HorizontalRuleיצירה והוספה של HorizontalRule חדש באינדקס שצוין.
insertImage(childIndex, image)InlineImageיצירה והוספה של InlineImage מה-blob של התמונה שצוין, בתרחיש שצוין להוסיף לאינדקס.
insertImage(childIndex, image)InlineImageמוסיפה את InlineImage הנתון באינדקס שצוין.
insertListItem(childIndex, listItem)ListItemמוסיפה את ListItem הנתון באינדקס שצוין.
insertListItem(childIndex, text)ListItemיצירה והוספה של ListItem חדש באינדקס שצוין, שמכיל את הערך שצוין את תוכן הטקסט.
insertPageBreak(childIndex)PageBreakיצירה והוספה של PageBreak חדש באינדקס שצוין.
insertPageBreak(childIndex, pageBreak)PageBreakמוסיפה את PageBreak הנתון באינדקס שצוין.
insertParagraph(childIndex, paragraph)Paragraphמוסיפה את Paragraph הנתון באינדקס שצוין.
insertParagraph(childIndex, text)Paragraphיצירה והוספה של Paragraph חדש באינדקס שצוין, שמכיל את הערך שצוין את תוכן הטקסט.
insertTable(childIndex)Tableיצירה והוספה של Table חדש באינדקס שצוין.
insertTable(childIndex, cells)Tableיצירה והוספה של Table חדש שמכיל את התאים שצוינו, באינדקס שצוין.
insertTable(childIndex, table)Tableמוסיפה את Table הנתון באינדקס שצוין.
removeChild(child)Bodyהסרת רכיב הצאצא שצוין.
replaceText(searchPattern, replacement)Elementמחליפה את כל המופעים של תבנית טקסט נתונה במחרוזת החלפה נתונה, באמצעות הפונקציה הרגילה הבעות פנים.
setAttributes(attributes)Bodyמגדיר את המאפיינים של הרכיב.
setHeadingAttributes(paragraphHeading, attributes)Bodyמגדיר את המאפיינים של ParagraphHeading שצוין.
setMarginBottom(marginBottom)Bodyהגדרת השוליים התחתוניים בנקודות.
setMarginLeft(marginLeft)Bodyמגדיר את השוליים השמאליים בנקודות.
setMarginRight(marginRight)Bodyמגדיר את השוליים הימניים בנקודות.
setMarginTop(marginTop)Bodyהגדרת השוליים העליונים.
setPageHeight(pageHeight)Bodyמגדיר את גובה הדף בנקודות.
setPageWidth(pageWidth)Bodyמגדיר את רוחב הדף בנקודות.
setText(text)Bodyמגדיר את התוכן כטקסט פשוט.
setTextAlignment(textAlignment)Bodyמגדיר את יישור הטקסט.

מסמכי תיעוד מפורטים

appendHorizontalRule()

יצירה והוספה של HorizontalRule חדש.

השדה HorizontalRule ייכלל בקובץ Paragraph חדש.

חזרה

HorizontalRule – הכלל האופקי החדש.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

appendImage(image)

יצירה והוספה של InlineImage חדש מ-blob של התמונה שצוין.

התמונה תיכלל בקובץ Paragraph חדש.

פרמטרים

שםסוגתיאור
imageBlobSourceנתוני התמונה.

חזרה

InlineImage – התמונה שמצורפת.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

appendImage(image)

הפונקציה מצרפת את הערך של InlineImage הנתון.

השדה InlineImage ייכלל בקובץ Paragraph חדש.

צריך להשתמש בגרסה הזו של appendImage כשמצרפים עותק של InlineImage קיים.

פרמטרים

שםסוגתיאור
imageInlineImageנתוני התמונה.

חזרה

InlineImage – התמונה שמצורפת.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

appendListItem(listItem)

הפונקציה מצרפת את הערך של ListItem הנתון.

צריך להשתמש בגרסה הזו של appendListItem כשמצרפים עותק של ListItem קיים.

פרמטרים

שםסוגתיאור
listItemListItemהפריט ברשימה שיש לצרף.

חזרה

ListItem – הפריט שצורף ברשימה.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

appendListItem(text)

יצירה והוספה של ListItem חדש שמכיל את תוכן הטקסט שצוין.

פריטים רצופים ברשימה יתווספו כחלק מאותה רשימה.

פרמטרים

שםסוגתיאור
textStringתוכן הטקסט של הפריט ברשימה.

חזרה

ListItem – הפריט החדש ברשימה.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

appendPageBreak()

יצירה והוספה של PageBreak חדש.

השדה PageBreak ייכלל בקובץ Paragraph חדש.

חזרה

PageBreak — מעבר הדף החדש.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

appendPageBreak(pageBreak)

הפונקציה מצרפת את הערך של PageBreak הנתון.

השדה PageBreak ייכלל בקובץ Paragraph חדש.

צריך להשתמש בגרסה הזו של appendPageBreak כשמצרפים עותק של PageBreak קיים.

פרמטרים

שםסוגתיאור
pageBreakPageBreakמעבר הדף שצריך לצרף.

חזרה

PageBreak — מעבר הדף שצורף.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

appendParagraph(paragraph)

הפונקציה מצרפת את הערך של Paragraph הנתון.

צריך להשתמש בגרסה הזו של appendParagraph כשמצרפים עותק של Paragraph קיים.

פרמטרים

שםסוגתיאור
paragraphParagraphהפסקה שצריך לצרף.

חזרה

Paragraph – הפסקה שצורפה.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

appendParagraph(text)

יצירה והוספה של Paragraph חדש שמכיל את תוכן הטקסט שצוין.

פרמטרים

שםסוגתיאור
textStringתוכן הטקסט של הפסקה.

חזרה

Paragraph – הפסקה החדשה.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

appendTable()

יצירה והוספה של Table חדש.

השיטה הזו גם תוסיף פסקה ריקה אחרי הטבלה, מפני שמסמכי Google Docs לא יכול להסתיים בטבלה.

חזרה

Table – הטבלה החדשה.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

appendTable(cells)

הפונקציה מצרפת Table חדש שמכיל TableCell לכל ערך מחרוזת שצוין.

השיטה הזו גם תוסיף פסקה ריקה אחרי הטבלה, מפני שמסמכי Google Docs לא יכול להסתיים בטבלה.

פרמטרים

שםסוגתיאור
cellsString[][]תוכן הטקסט של תאי הטבלה, שאותו רוצים להוסיף לטבלה החדשה.

חזרה

Table – הטבלה המצורפת.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

appendTable(table)

הפונקציה מצרפת את הערך של Table הנתון.

צריך להשתמש בגרסה הזו של appendTable כשמצרפים עותק של Table קיים. השיטה הזו גם תוסיף פסקה ריקה אחרי הטבלה, מפני שמסמכי Google Docs לא יכול להסתיים בטבלה.

פרמטרים

שםסוגתיאור
tableTableהטבלה שצריך לצרף.

חזרה

Table – הטבלה המצורפת.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

clear()

ניקוי התוכן של הרכיב.

חזרה

Body – הרכיב הנוכחי.


copy()

הפונקציה מחזירה עותק עמוק בנפרד עבור הרכיב הנוכחי.

כל רכיבי הצאצא שקיימים ברכיב מועתקים גם כן. ברכיב החדש אין הורה.

חזרה

Body – העותק החדש.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

editAsText()

מתקבלת גרסת Text של הרכיב הנוכחי, לעריכה.

אפשר להשתמש ב-editAsText כדי לבצע מניפולציות על התוכן של הרכיבים כטקסט עשיר. מצב editAsText מתעלם מאלמנטים שאינם טקסט (כמו InlineImage ו-HorizontalRule).

רכיבי צאצא הכלולים בטווח טקסט שנמחק יוסרו מהרכיב.

var body = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody();

// Insert two paragraphs separated by a paragraph containing an
// horizontal rule.
body.insertParagraph(0, "An editAsText sample.");
body.insertHorizontalRule(0);
body.insertParagraph(0, "An example.");

// Delete " sample.\n\n An" removing the horizontal rule in the process.
body.editAsText().deleteText(14, 25);

חזרה

Text – גרסת טקסט של הרכיב הנוכחי


findElement(elementType)

חיפוש תוכן הרכיב כדי למצוא צאצא מהסוג שצוין.

פרמטרים

שםסוגתיאור
elementTypeElementTypeסוג הרכיב שצריך לחפש.

חזרה

RangeElement - תוצאת חיפוש שמציינת את המיקום של רכיב החיפוש.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

findElement(elementType, from)

מחפש את תוכן הרכיב כדי למצוא צאצא מהסוג שצוין, החל מ- ציינת RangeElement.

var body = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody();

// Define the search parameters.
var searchType = DocumentApp.ElementType.PARAGRAPH;
var searchHeading = DocumentApp.ParagraphHeading.HEADING1;
var searchResult = null;

// Search until the paragraph is found.
while (searchResult = body.findElement(searchType, searchResult)) {
  var par = searchResult.getElement().asParagraph();
  if (par.getHeading() == searchHeading) {
    // Found one, update and stop.
    par.setText('This is the first header.');
    return;
  }
}

פרמטרים

שםסוגתיאור
elementTypeElementTypeסוג הרכיב שצריך לחפש.
fromRangeElementתוצאת החיפוש שממנה יש לחפש.

חזרה

RangeElement - תוצאת חיפוש שמציינת את המיקום הבא של רכיב החיפוש.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

findText(searchPattern)

חיפוש תוכן הרכיב לפי דפוס הטקסט שצוין באמצעות ביטויים רגולריים.

אין תמיכה מלאה בקבוצת משנה של תכונות הביטויים הרגולריים של JavaScript, כגון לתעד קבוצות ותנאים.

תבנית הביטויים הרגולריים שסופקה מותאמת בנפרד לכל בלוק טקסט שכלול ברכיב הנוכחי.

פרמטרים

שםסוגתיאור
searchPatternStringהדפוס שצריך לחפש

חזרה

RangeElement - תוצאת חיפוש שמציינת את המיקום של טקסט החיפוש, או ערך null אם אין להתאים

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

findText(searchPattern, from)

חיפוש תוכן הרכיב לפי תבנית הטקסט שצוינה, החל ממאפיין נתון בתוצאות החיפוש.

אין תמיכה מלאה בקבוצת משנה של תכונות הביטויים הרגולריים של JavaScript, כגון לתעד קבוצות ותנאים.

תבנית הביטויים הרגולריים שסופקה מותאמת בנפרד לכל בלוק טקסט שכלול ברכיב הנוכחי.

פרמטרים

שםסוגתיאור
searchPatternStringהדפוס שצריך לחפש
fromRangeElementתוצאת החיפוש שממנה יש לחפש

חזרה

RangeElement - תוצאת חיפוש שמציינת את המיקום הבא של טקסט החיפוש, או ערך null אם אין להתאים

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getAttributes()

אחזור המאפיינים של הרכיב.

התוצאה היא אובייקט שמכיל מאפיין לכל מאפיין חוקי של רכיב שבו כל אחד שם המאפיין תואם לפריט בספירה DocumentApp.Attribute.

var doc = DocumentApp.getActiveDocument();
var documentTab = doc.getActiveTab().asDocumentTab();
var body = documentTab.getBody();

// Append a styled paragraph.
var par = body.appendParagraph('A bold, italicized paragraph.');
par.setBold(true);
par.setItalic(true);

// Retrieve the paragraph's attributes.
var atts = par.getAttributes();

// Log the paragraph attributes.
for (var att in atts) {
  Logger.log(att + ":" + atts[att]);
}

חזרה

Object – המאפיינים של הרכיב.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getChild(childIndex)

אחזור הרכיב הצאצא באינדקס הצאצא שצוין.

var body = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody();

// Obtain the first element in the tab.
var firstChild = body.getChild(0);

// If it's a paragraph, set its contents.
if (firstChild.getType() == DocumentApp.ElementType.PARAGRAPH) {
  firstChild.asParagraph().setText("This is the first paragraph.");
}

פרמטרים

שםסוגתיאור
childIndexIntegerהאינדקס של רכיב הצאצא לאחזור.

חזרה

Element – רכיב הצאצא באינדקס שצוין.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getChildIndex(child)

אחזור של אינדקס הצאצא לרכיב הצאצא שצוין.

פרמטרים

שםסוגתיאור
childElementרכיב הצאצא שעבורו יש לאחזר את האינדקס.

חזרה

Integer – אינדקס הצאצא.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getHeadingAttributes(paragraphHeading)

אחזור של קבוצת המאפיינים ל-ParagraphHeading שצוינו.

פרמטרים

שםסוגתיאור
paragraphHeadingParagraphHeadingהכותרת שצריך לאחזר את המאפיינים שלה.

חזרה

Object – מפה של המאפיינים והערכים הנוכחיים שלהם.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getImages()

אחזור כל InlineImages הכלולים בקטע.

חזרה

InlineImage[] – תמונות הקטע.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getListItems()

אחזור כל ListItems הכלולים בקטע.

חזרה

ListItem[] – הפריטים ברשימת הקטעים.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getMarginBottom()

אחזור השוליים התחתוניים בנקודות.

חזרה

Number – השוליים התחתוניים בנקודות.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getMarginLeft()

מאחזר את השוליים השמאליים בנקודות.

חזרה

Number – השוליים השמאליים, בנקודות.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getMarginRight()

אחזור השוליים הימניים.

חזרה

Number – השוליים הימניים, בנקודות.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getMarginTop()

אחזור השוליים העליונים.

חזרה

Number – השוליים העליונים בנקודות.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getNumChildren()

אחזור של מספר הילדים.

var body = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody();

// Log the number of elements in the tab.
Logger.log("There are " + body.getNumChildren() +
    " elements in the tab's body.");

חזרה

Integer – מספר הילדים.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getPageHeight()

אחזור גובה הדף בנקודות.

חזרה

Number – גובה הדף בנקודות.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getPageWidth()

אחזור של רוחב הדף בנקודות.

חזרה

Number – רוחב הדף בנקודות.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getParagraphs()

אחזור כל Paragraphs הכלולים בקטע (כולל ListItems).

חזרה

Paragraph[] – הפסקאות בקטע.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getParent()

אחזור הרכיב ההורה של הרכיב.

רכיב ההורה מכיל את הרכיב הנוכחי.

חזרה

ContainerElement – רכיב ההורה.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getTables()

אחזור כל Tables הכלולים בקטע.

חזרה

Table[] – טבלאות הקטעים.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getText()

אחזור תוכן הרכיב כמחרוזת טקסט.

חזרה

String – תוכן הרכיב כמחרוזת טקסט

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getTextAlignment()

מקבל את היישור של הטקסט. סוגי ההתאמה הזמינים הם DocumentApp.TextAlignment.NORMAL, DocumentApp.TextAlignment.SUBSCRIPT ו-DocumentApp.TextAlignment.SUPERSCRIPT.

חזרה

TextAlignment - סוג היישור של הטקסט, או null אם הטקסט מכיל כמה סוגים של טקסט יישור או אם יישור הטקסט מעולם לא הוגדר

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getType()

מאחזר את ElementType של הרכיב.

משתמשים בפונקציה getType() כדי לקבוע את הסוג המדויק של רכיב נתון.

var doc = DocumentApp.getActiveDocument();
var documentTab = doc.getActiveTab().asDocumentTab();
var body = documentTab.getBody();

// Obtain the first element in the active tab's body.

var firstChild = body.getChild(0);

// Use getType() to determine the element's type.
if (firstChild.getType() == DocumentApp.ElementType.PARAGRAPH) {
  Logger.log('The first element is a paragraph.');
} else {
  Logger.log('The first element is not a paragraph.');
}

חזרה

ElementType – סוג הרכיב.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

insertHorizontalRule(childIndex)

יצירה והוספה של HorizontalRule חדש באינדקס שצוין.

השדה HorizontalRule ייכלל בקובץ Paragraph חדש.

פרמטרים

שםסוגתיאור
childIndexIntegerהאינדקס שבו יש להוסיף את הרכיב.

חזרה

HorizontalRule – הכלל האופקי החדש.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

insertImage(childIndex, image)

יצירה והוספה של InlineImage מה-blob של התמונה שצוין, בתרחיש שצוין להוסיף לאינדקס.

פרמטרים

שםסוגתיאור
childIndexIntegerהאינדקס שבו יש להוסיף את הרכיב.
imageBlobSourceנתוני התמונה.

חזרה

InlineImage – התמונה בתוך השורה שהוכנסה.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

insertImage(childIndex, image)

מוסיפה את InlineImage הנתון באינדקס שצוין.

התמונה תיכלל בקובץ Paragraph חדש.

פרמטרים

שםסוגתיאור
childIndexIntegerהאינדקס שבו יש להוסיף את הרכיב.
imageInlineImageהתמונה להוספה.

חזרה

InlineImage – התמונה בתוך השורה שהוכנסה.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

insertListItem(childIndex, listItem)

מוסיפה את ListItem הנתון באינדקס שצוין.

פרמטרים

שםסוגתיאור
childIndexIntegerהאינדקס שבו יש להוסיף.
listItemListItemהפריט שרוצים להוסיף ברשימה.

חזרה

ListItem – הפריט שנוסף ברשימה.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

insertListItem(childIndex, text)

יצירה והוספה של ListItem חדש באינדקס שצוין, שמכיל את הערך שצוין את תוכן הטקסט.

פרמטרים

שםסוגתיאור
childIndexIntegerהאינדקס שבו יש להוסיף.
textStringתוכן הטקסט של הפריט ברשימה.

חזרה

ListItem – הפריט החדש ברשימה.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

insertPageBreak(childIndex)

יצירה והוספה של PageBreak חדש באינדקס שצוין.

השדה PageBreak ייכלל בקובץ Paragraph חדש.

פרמטרים

שםסוגתיאור
childIndexIntegerהאינדקס שבו יש להוסיף את הרכיב.

חזרה

PageBreak — מעבר הדף החדש.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

insertPageBreak(childIndex, pageBreak)

מוסיפה את PageBreak הנתון באינדקס שצוין.

השדה PageBreak ייכלל בקובץ Paragraph חדש.

פרמטרים

שםסוגתיאור
childIndexIntegerהאינדקס שבו יש להוסיף את הרכיב.
pageBreakPageBreakמעבר הדף שיש להוסיף.

חזרה

PageBreak – מעבר הדף שנוסף.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

insertParagraph(childIndex, paragraph)

מוסיפה את Paragraph הנתון באינדקס שצוין.

פרמטרים

שםסוגתיאור
childIndexIntegerהאינדקס שבו יש להוסיף.
paragraphParagraphהפסקה להוספה.

חזרה

Paragraph – הפסקה שהוכנסה.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

insertParagraph(childIndex, text)

יצירה והוספה של Paragraph חדש באינדקס שצוין, שמכיל את הערך שצוין את תוכן הטקסט.

פרמטרים

שםסוגתיאור
childIndexIntegerהאינדקס שבו יש להוסיף.
textStringתוכן הטקסט של הפסקה.

חזרה

Paragraph – הפסקה החדשה.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

insertTable(childIndex)

יצירה והוספה של Table חדש באינדקס שצוין.

פרמטרים

שםסוגתיאור
childIndexIntegerהאינדקס שבו יש להוסיף.

חזרה

Table – הטבלה החדשה.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

insertTable(childIndex, cells)

יצירה והוספה של Table חדש שמכיל את התאים שצוינו, באינדקס שצוין.

פרמטרים

שםסוגתיאור
childIndexIntegerהאינדקס שבו יש להוסיף.
cellsString[][]תוכן הטקסט של תאי הטבלה, שאותו רוצים להוסיף לטבלה החדשה.

חזרה

Table – הטבלה החדשה.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

insertTable(childIndex, table)

מוסיפה את Table הנתון באינדקס שצוין.

פרמטרים

שםסוגתיאור
childIndexIntegerהאינדקס שבו יש להוסיף.
tableTableהטבלה להוספה.

חזרה

Table – הטבלה שהוכנסה.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

removeChild(child)

הסרת רכיב הצאצא שצוין.

פרמטרים

שםסוגתיאור
childElementרכיב הצאצא להסרה.

חזרה

Body – הרכיב הנוכחי.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

replaceText(searchPattern, replacement)

מחליפה את כל המופעים של תבנית טקסט נתונה במחרוזת החלפה נתונה, באמצעות הפונקציה הרגילה הבעות פנים.

דפוס החיפוש מועבר כמחרוזת, ולא כאובייקט של ביטוי רגולרי של JavaScript. לכן, צריך לסמן בתו בריחה (escape) את כל לוכסן הפוך בתבנית.

בשיטה הזאת נעשה שימוש במודל RE2 הרגיל של Google של ביטויים, שמגבילה את התחביר הנתמך.

תבנית הביטויים הרגולריים שסופקה מותאמת בנפרד לכל בלוק טקסט שכלול ברכיב הנוכחי.

var body = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody();

// Clear the text surrounding "Apps Script", with or without text.
body.replaceText("^.*Apps ?Script.*$", "Apps Script");

פרמטרים

שםסוגתיאור
searchPatternStringדפוס הביטוי הרגולרי שצריך לחפש
replacementStringהטקסט שישמש כתחליף

חזרה

Element – הרכיב הנוכחי

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

setAttributes(attributes)

מגדיר את המאפיינים של הרכיב.

פרמטר המאפיינים שצוין חייב להיות אובייקט שבו כל שם מאפיין הוא פריט ב- הספירה של DocumentApp.Attribute וכל ערך מאפיין הוא הערך החדש שצריך הוחלו.

var doc = DocumentApp.getActiveDocument();
var documentTab = doc.getActiveTab().asDocumentTab();
var body = documentTab.getBody();

// Define a custom paragraph style.
var style = {};
style[DocumentApp.Attribute.HORIZONTAL_ALIGNMENT] =
    DocumentApp.HorizontalAlignment.RIGHT;
style[DocumentApp.Attribute.FONT_FAMILY] = 'Calibri';
style[DocumentApp.Attribute.FONT_SIZE] = 18;
style[DocumentApp.Attribute.BOLD] = true;

// Append a plain paragraph.
var par = body.appendParagraph('A paragraph with custom style.');

// Apply the custom style.
par.setAttributes(style);

פרמטרים

שםסוגתיאור
attributesObjectהמאפיינים של הרכיב.

חזרה

Body – הרכיב הנוכחי.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

setHeadingAttributes(paragraphHeading, attributes)

מגדיר את המאפיינים של ParagraphHeading שצוין.

פרמטרים

שםסוגתיאור
paragraphHeadingParagraphHeadingהכותרת שאת המאפיינים שלה צריך להגדיר.
attributesObjectמפה של המאפיינים והערכים שיוגדרו בהם.

חזרה

Body – הרכיב הנוכחי.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

setMarginBottom(marginBottom)

הגדרת השוליים התחתוניים בנקודות.

פרמטרים

שםסוגתיאור
marginBottomNumberהשוליים התחתוניים בנקודות.

חזרה

Body – הרכיב הנוכחי.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

setMarginLeft(marginLeft)

מגדיר את השוליים השמאליים בנקודות.

פרמטרים

שםסוגתיאור
marginLeftNumberהשוליים השמאליים, בנקודות.

חזרה

Body – הרכיב הנוכחי.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

setMarginRight(marginRight)

מגדיר את השוליים הימניים בנקודות.

פרמטרים

שםסוגתיאור
marginRightNumberהשוליים הימניים.

חזרה

Body – הרכיב הנוכחי.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

setMarginTop(marginTop)

הגדרת השוליים העליונים.

פרמטרים

שםסוגתיאור
marginTopNumberהשוליים העליונים בנקודות.

חזרה

Body – הרכיב הנוכחי.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

setPageHeight(pageHeight)

מגדיר את גובה הדף בנקודות.

פרמטרים

שםסוגתיאור
pageHeightNumberגובה הדף, בנקודות.

חזרה

Body – הרכיב הנוכחי.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

setPageWidth(pageWidth)

מגדיר את רוחב הדף בנקודות.

פרמטרים

שםסוגתיאור
pageWidthNumberרוחב הדף, בנקודות.

חזרה

Body – הרכיב הנוכחי.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

setText(text)

מגדיר את התוכן כטקסט פשוט.

הערה: התוכן הקיים נמחק.

פרמטרים

שםסוגתיאור
textStringתוכן הטקסט החדש.

חזרה

Body – הרכיב הנוכחי.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

setTextAlignment(textAlignment)

מגדיר את יישור הטקסט. סוגי ההתאמה הזמינים הם DocumentApp.TextAlignment.NORMAL, DocumentApp.TextAlignment.SUBSCRIPT ו-DocumentApp.TextAlignment.SUPERSCRIPT.

// Make the entire first paragraph in the active tab be superscript.
var documentTab = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab();
var text = documentTab.getBody().getParagraphs()[0].editAsText();
text.setTextAlignment(DocumentApp.TextAlignment.SUPERSCRIPT);

פרמטרים

שםסוגתיאור
textAlignmentTextAlignmentסוג היישור של הטקסט שרוצים להחיל

חזרה

Body – הרכיב הנוכחי

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

שיטות שהוצאו משימוש