Эта страница переведена с помощью Cloud Translation API.

Class 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` из указанного большого двоичного объекта изображения по указанному индексу.
`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`	Устанавливает выравнивание текста.

Устаревшие методы

Метод	Тип возврата	Краткое описание
`getFootnotes()`	`Footnote[]`	Извлекает все `Footnotes` содержащиеся в разделе.
`getLinkUrl()`	`String`	Получает URL-адрес ссылки.
`getNextSibling()`	`Element`	Извлекает следующий родственный элемент элемента.
`getPreviousSibling()`	`Element`	Извлекает предыдущий родственный элемент элемента.
`isAtDocumentEnd()`	`Boolean`	Определяет, находится ли элемент в конце `Document` .
`setLinkUrl(url)`	`Body`	Устанавливает URL-адрес ссылки.

Подробная документация

`appendHorizontalRule()`

Создает и добавляет новый HorizontalRule .

HorizontalRule будет содержаться в новом Paragraph .

Возвращаться

HorizontalRule — Новое горизонтальное правило.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

`appendImage(image)`

Создает и добавляет новый InlineImage из указанного BLOB-объекта изображения.

Изображение будет содержаться в новом Paragraph .

Параметры

Имя	Тип	Описание
`image`	`BlobSource`	Данные изображения.

Возвращаться

InlineImage — добавленное изображение.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

`appendImage(image)`

Добавляет заданный InlineImage .

InlineImage будет содержаться в новом Paragraph .

Используйте эту версию appendImage при добавлении копии существующего InlineImage .

Параметры

Имя	Тип	Описание
`image`	`InlineImage`	Данные изображения.

Возвращаться

InlineImage — добавленное изображение.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

`appendListItem(listItem)`

Добавляет данный ListItem .

Используйте эту версию appendListItem при добавлении копии существующего ListItem .

Параметры

Имя	Тип	Описание
`listItem`	`ListItem`	Добавляемый элемент списка.

Возвращаться

ListItem — добавленный элемент списка.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

`appendListItem(text)`

Создает и добавляет новый ListItem содержащий указанное текстовое содержимое.

Последовательные элементы списка добавляются как часть одного и того же списка.

Параметры

Имя	Тип	Описание
`text`	`String`	Текстовое содержимое элемента списка.

Возвращаться

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 .

Параметры

Имя	Тип	Описание
`pageBreak`	`PageBreak`	Разрыв страницы для добавления.

Возвращаться

PageBreak — добавленный разрыв страницы.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

`appendParagraph(paragraph)`

Добавляет данный Paragraph .

Используйте эту версию appendParagraph при добавлении копии существующего Paragraph .

Параметры

Имя	Тип	Описание
`paragraph`	`Paragraph`	Абзац, который нужно добавить.

Возвращаться

Paragraph — добавленный абзац.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

`appendParagraph(text)`

Создает и добавляет новый Paragraph , содержащий указанное текстовое содержимое.

Параметры

Имя	Тип	Описание
`text`	`String`	Текстовое содержимое абзаца.

Возвращаться

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 для каждого указанного строкового значения.

Параметры

Имя	Тип	Описание
`cells`	`String[][]`	Текстовое содержимое ячеек таблицы, добавляемое в новую таблицу.

Возвращаться

Table — добавленная таблица.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

`appendTable(table)`

Добавляет данную Table .

Используйте эту версию appendTable при добавлении копии существующей Table . Этот метод также добавит пустой абзац после таблицы, поскольку документы Google Docs не могут заканчиваться таблицей.

Параметры

Имя	Тип	Описание
`table`	`Table`	Таблица для добавления.

Возвращаться

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)`

Ищет в содержимом элемента потомка указанного типа.

Параметры

Имя	Тип	Описание
`elementType`	`ElementType`	Тип элемента для поиска.

Возвращаться

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;
  }
}

Параметры

Имя	Тип	Описание
`elementType`	`ElementType`	Тип элемента для поиска.
`from`	`RangeElement`	Результат поиска, по которому осуществляется поиск.

Возвращаться

RangeElement — Результат поиска, указывающий следующую позицию искомого элемента.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

`findText(searchPattern)`

Ищет в содержимом элемента указанный текстовый шаблон с помощью регулярных выражений.

Некоторые функции регулярных выражений JavaScript, такие как группы захвата и модификаторы режима, поддерживаются не полностью.

Предоставленный шаблон регулярного выражения независимо сопоставляется с каждым текстовым блоком, содержащимся в текущем элементе.

Параметры

Имя	Тип	Описание
`searchPattern`	`String`	образец для поиска

Возвращаться

RangeElement — результат поиска, указывающий позицию искомого текста, или значение NULL, если совпадений нет.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

`findText(searchPattern, from)`

Ищет в содержимом элемента указанный текстовый шаблон, начиная с заданного результата поиска.

Параметры

Имя	Тип	Описание
`searchPattern`	`String`	образец для поиска
`from`	`RangeElement`	результат поиска для поиска

Возвращаться

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.");
}

Параметры

Имя	Тип	Описание
`childIndex`	`Integer`	Индекс дочернего элемента, который требуется получить.

Возвращаться

Element — Дочерний элемент по указанному индексу.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

`getChildIndex(child)`

Получает дочерний индекс для указанного дочернего элемента.

Параметры

Имя	Тип	Описание
`child`	`Element`	Дочерний элемент, для которого нужно получить индекс.

Возвращаться

Integer — Дочерний индекс.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

`getHeadingAttributes(paragraphHeading)`

Получает набор атрибутов для предоставленного ParagraphHeading .

Параметры

Имя	Тип	Описание
`paragraphHeading`	`ParagraphHeading`	Заголовок, атрибуты которого необходимо получить.

Возвращаться

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 .

Параметры

Имя	Тип	Описание
`childIndex`	`Integer`	Индекс, по которому вставляется элемент.

Возвращаться

HorizontalRule — Новое горизонтальное правило.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

`insertImage(childIndex, image)`

Создает и вставляет InlineImage из указанного большого двоичного объекта изображения по указанному индексу.

Параметры

Имя	Тип	Описание
`childIndex`	`Integer`	Индекс, по которому вставляется элемент.
`image`	`BlobSource`	Данные изображения.

Возвращаться

InlineImage — Вставленное встроенное изображение.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

`insertImage(childIndex, image)`

Вставляет заданный InlineImage по указанному индексу.

Изображение будет содержаться в новом Paragraph .

Параметры

Имя	Тип	Описание
`childIndex`	`Integer`	Индекс, по которому вставляется элемент.
`image`	`InlineImage`	Изображение для вставки.

Возвращаться

InlineImage — Вставленное встроенное изображение.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

`insertListItem(childIndex, listItem)`

Вставляет заданный ListItem по указанному индексу.

Параметры

Имя	Тип	Описание
`childIndex`	`Integer`	Индекс, по которому вставляется.
`listItem`	`ListItem`	Элемент списка для вставки.

Возвращаться

ListItem — Вставленный элемент списка.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

`insertListItem(childIndex, text)`

Создает и вставляет новый ListItem по указанному индексу, содержащий указанное текстовое содержимое.

Параметры

Имя	Тип	Описание
`childIndex`	`Integer`	Индекс, по которому вставляется.
`text`	`String`	Текстовое содержимое элемента списка.

Возвращаться

ListItem — Новый элемент списка.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

`insertPageBreak(childIndex)`

Создает и вставляет новый PageBreak по указанному индексу.

PageBreak будет содержаться в новом Paragraph .

Параметры

Имя	Тип	Описание
`childIndex`	`Integer`	Индекс, по которому вставляется элемент.

Возвращаться

PageBreak — новый разрыв страницы.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

`insertPageBreak(childIndex, pageBreak)`

Вставляет заданный PageBreak по указанному индексу.

PageBreak будет содержаться в новом Paragraph .

Параметры

Имя	Тип	Описание
`childIndex`	`Integer`	Индекс, по которому вставляется элемент.
`pageBreak`	`PageBreak`	Разрыв страницы для вставки.

Возвращаться

PageBreak — вставленный разрыв страницы.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

`insertParagraph(childIndex, paragraph)`

Вставляет данный Paragraph по указанному индексу.

Параметры

Имя	Тип	Описание
`childIndex`	`Integer`	Индекс, по которому вставляется.
`paragraph`	`Paragraph`	Абзац для вставки.

Возвращаться

Paragraph — вставленный абзац.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

`insertParagraph(childIndex, text)`

Создает и вставляет новый Paragraph по указанному индексу, содержащий указанное текстовое содержимое.

Параметры

Имя	Тип	Описание
`childIndex`	`Integer`	Индекс, по которому вставляется.
`text`	`String`	Текстовое содержимое абзаца.

Возвращаться

Paragraph — Новый параграф.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

`insertTable(childIndex)`

Создает и вставляет новую Table по указанному индексу.

Параметры

Имя	Тип	Описание
`childIndex`	`Integer`	Индекс, по которому вставляется.

Возвращаться

Table — Новая таблица.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

`insertTable(childIndex, cells)`

Создает и вставляет новую Table , содержащую указанные ячейки, по указанному индексу.

Параметры

Имя	Тип	Описание
`childIndex`	`Integer`	Индекс, по которому вставляется.
`cells`	`String[][]`	Текстовое содержимое ячеек таблицы, добавляемое в новую таблицу.

Возвращаться

Table — Новая таблица.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

`insertTable(childIndex, table)`

Вставляет данную Table по указанному индексу.

Параметры

Имя	Тип	Описание
`childIndex`	`Integer`	Индекс, по которому вставляется.
`table`	`Table`	Таблица для вставки.

Возвращаться

Table — вставленная таблица.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

`removeChild(child)`

Удаляет указанный дочерний элемент.

Параметры

Имя	Тип	Описание
`child`	`Element`	Дочерний элемент, который нужно удалить.

Возвращаться

Body — текущий элемент.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

`replaceText(searchPattern, replacement)`

Заменяет все вхождения данного текстового шаблона заданной строкой замены, используя регулярные выражения.

Шаблон поиска передается как строка, а не как объект регулярного выражения JavaScript. По этой причине вам необходимо избегать любых обратных косых черт в шаблоне.

В этом методе используется библиотека регулярных выражений Google RE2 , что ограничивает поддерживаемый синтаксис .

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

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

Параметры

Имя	Тип	Описание
`searchPattern`	`String`	шаблон регулярного выражения для поиска
`replacement`	`String`	текст, который будет использоваться в качестве замены

Возвращаться

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);

Параметры

Имя	Тип	Описание
`attributes`	`Object`	Атрибуты элемента.

Возвращаться

Body — текущий элемент.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

`setHeadingAttributes(paragraphHeading, attributes)`

Устанавливает атрибуты для предоставленного ParagraphHeading .

Параметры

Имя	Тип	Описание
`paragraphHeading`	`ParagraphHeading`	Заголовок, атрибуты которого необходимо задать.
`attributes`	`Object`	Карта атрибутов и значений для их установки.

Возвращаться

Body — текущий элемент.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

`setMarginBottom(marginBottom)`

Устанавливает нижнее поле в пунктах.

Параметры

Имя	Тип	Описание
`marginBottom`	`Number`	Нижнее поле, в пунктах.

Возвращаться

Body — текущий элемент.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

`setMarginLeft(marginLeft)`

Устанавливает левое поле в пунктах.

Параметры

Имя	Тип	Описание
`marginLeft`	`Number`	Левое поле, в пунктах.

Возвращаться

Body — текущий элемент.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

`setMarginRight(marginRight)`

Устанавливает правое поле в пунктах.

Параметры

Имя	Тип	Описание
`marginRight`	`Number`	Правильный запас.

Возвращаться

Body — текущий элемент.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

`setMarginTop(marginTop)`

Устанавливает верхнее поле.

Параметры

Имя	Тип	Описание
`marginTop`	`Number`	Верхнее поле в пунктах.

Возвращаться

Body — текущий элемент.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

`setPageHeight(pageHeight)`

Устанавливает высоту страницы в пунктах.

Параметры

Имя	Тип	Описание
`pageHeight`	`Number`	Высота страницы в пунктах.

Возвращаться

Body — текущий элемент.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

`setPageWidth(pageWidth)`

Устанавливает ширину страницы в пунктах.

Параметры

Имя	Тип	Описание
`pageWidth`	`Number`	Ширина страницы в пунктах.

Возвращаться

Body — текущий элемент.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

`setText(text)`

Устанавливает содержимое в виде обычного текста.

Примечание: существующее содержимое будет удалено.

Параметры

Имя	Тип	Описание
`text`	`String`	Новое текстовое содержание.

Возвращаться

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);

Параметры

Имя	Тип	Описание
`textAlignment`	`TextAlignment`	тип выравнивания текста, который необходимо применить

Возвращаться

Body — текущий элемент

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

Устаревшие методы

`getFootnotes()`

Устарело. Этот элемент не может содержать Footnote .

Извлекает все Footnotes содержащиеся в разделе.

Возвращаться

Footnote[] — Сноски раздела.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

`getLinkUrl()`

Устарело. Вместо применения ссылки ко всему разделу примените ссылку к элементу внутри раздела.

Получает URL-адрес ссылки.

Возвращаться

String — URL-адрес ссылки или значение NULL, если элемент содержит несколько значений для этого атрибута.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

`getNextSibling()`

Устарело. У этого элемента нет братьев и сестер.

Извлекает следующий родственный элемент элемента.

Следующий брат имеет того же родителя и следует за текущим элементом.

Возвращаться

Element — следующий родственный элемент.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

`getPreviousSibling()`

Устарело. У этого элемента нет братьев и сестер.

Извлекает предыдущий родственный элемент элемента.

Предыдущий одноуровневый элемент имеет того же родителя и предшествует текущему элементу.

Возвращаться

Element — предыдущий родственный элемент.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

`isAtDocumentEnd()`

Устарело. Этот метод ненадежен для HeaderSection .

Определяет, находится ли элемент в конце Document .

Возвращаться

Boolean — находится ли элемент в конце вкладки.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

`setLinkUrl(url)`

Устарело. Вместо применения ссылки ко всему разделу примените ссылку к элементу внутри раздела.

Устанавливает URL-адрес ссылки.

Параметры

Имя	Тип	Описание
`url`	`String`	URL-адрес ссылки

Возвращаться

Body — текущий элемент

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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