В этом разделе описаны особенности поведения и ограничения, которые необходимо понимать при редактировании документов с помощью API Google Docs.
В целом, вы не можете выполнять изменения, которые приводят к некорректной структуре элементов в документе. Ознакомьтесь с ограничениями и правилами, применяемыми к каждому методу запроса documents.batchUpdate .
В следующих разделах кратко изложены основные правила, применяемые в этих методах.
Вставить текст
- Вставка символа новой строки автоматически создает
Paragraphпо указанному индексу. Стиль нового абзаца копируется из абзаца по текущему индексу вставки, включая списки и маркированные списки. - Текст должен быть вставлен в пределах существующего
Paragraph. Например, текст нельзя вставить в начало таблицы. Текст должен быть вставлен в предыдущий абзац. - API может неявно корректировать местоположение, чтобы предотвратить вставку текста внутри кластеров графем Unicode. В этом случае текст вставляется сразу после кластера графем.
- Стили вставляемого текста определяются автоматически, как правило, с сохранением стиля соседнего текста. Обычно стиль вставляемого текста соответствует стилю текста, расположенного непосредственно перед индексом вставки.
- Некоторые управляющие символы (
U+0000-U+0008, U+000C-U+001F) и символы из области частного использования базовой многоязычной плоскости Unicode (U+E000-U+F8FF) удаляются из вставленного текста. - Для получения дополнительной информации см. раздел «Вставка, удаление и перемещение текста» .
Вставка встроенных изображений
- Размер изображения не должен превышать 50 МБ, количество пикселей не должно превышать 25, и оно должно быть в одном из форматов PNG, JPEG или GIF.
- Указанный URI должен быть общедоступным и иметь длину не более 2 КБ.
- Изображение должно быть вставлено в пределах существующего
Paragraph. Например, текст нельзя вставить в начало таблицы. - Изображения нельзя вставлять внутрь сноски или уравнения.
- Для получения дополнительной информации см. раздел «Вставка встроенных изображений» .
Форматировать текст
- При применении форматирования на уровне абзаца к диапазону, форматирование применяется ко всем абзацам, которые частично или полностью перекрываются этим диапазоном.
- Диапазон может быть расширен за счет включения смежных новых строк.
- Если диапазон полностью содержит абзац, принадлежащий списку, то маркер абзаца также обновляется с использованием соответствующего стиля текста.
- Для получения более подробной информации см. раздел «Формат текста» .
Создание маркированных списков абзацев
- Создает маркированные списки для всех абзацев, которые перекрываются с заданным диапазоном.
- Уровень вложенности каждого абзаба определяется количеством символов табуляции перед каждым абзацем.
- При создании маркированных списков удаляются начальные отступы, что может изменить индексы частей текста.
- Если добавить маркеры абзаца, соответствующие маркерам списка, расположенного непосредственно перед целевым абзацем, то абзац будет объединен со списком.
- Для получения более подробной информации см. раздел «Работа со списками» .
Удалить текст
Удаление текста, выходящего за пределы абзаца, может привести к изменению стилей абзацев, списков, позиционирования объектов и закладок при объединении двух абзацев.
Удаление документов, приводящее к некорректной структуре, не допускается. Примеры некорректных запросов на удаление включают:
Удаление одного кодового блока из суррогатной пары.
Удаление последнего символа новой строки в элементах
Body,Header,Footer,Footnote,TableCellилиTableOfContents.Удаление начала или конца
Table,TableOfContentsилиEquationбез удаления всего элемента.Удаление символа новой строки перед
Table,TableOfContentsилиSectionBreakбез удаления самого элемента.Удаление отдельных строк или ячеек таблицы. Допускается удаление содержимого ячейки таблицы.
Для получения дополнительной информации см. раздел «Вставка, удаление и перемещение текста» .