Правила и поведение структурного редактирования

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

Как правило, вы не можете выполнять изменения, которые приводят к недопустимой структуре элементов в документе. Ознакомьтесь с каждым методом запроса documents.batchUpdate на предмет ограничений и правил, применяемых к этим запросам .

В следующих разделах обобщены основные правила этих методов.

Вставить текст

  • Вставка символа новой строки неявно создаёт Paragraph с этой позицией. Стиль нового абзаца копируется из абзаца с текущей позицией вставки, включая списки и маркеры.
  • Текст должен быть вставлен в пределах существующего Paragraph . Например, текст не может быть вставлен в начальный индекс таблицы. Текст должен быть вставлен в предшествующий абзац.
  • API может неявно корректировать местоположение, чтобы предотвратить вставки внутри кластеров графем Unicode. В этом случае текст вставляется сразу после кластера графем.
  • Стили текста для вставленного текста определяются автоматически, как правило, сохраняя стиль соседнего текста. Как правило, стиль вставленного текста соответствует стилю текста, расположенного непосредственно перед индексом вставки.
  • Некоторые управляющие символы ( U+0000-U+0008, U+000C-U+001F ) и символы из области частного использования Unicode Basic Multilingual Plane ( U+E000-U+F8FF ) удаляются из вставленного текста.
  • Дополнительные сведения см. в разделе Вставка, удаление и перемещение текста .

Вставьте встроенные изображения

  • Изображение должно быть размером менее 50 МБ, не более 25 мегапикселей и должно быть в одном из форматов PNG, JPEG или GIF.
  • Предоставленный URI должен быть общедоступным и иметь длину не более 2 КБ.
  • Изображение должно быть вставлено в пределах существующего Paragraph . Например, текст не может быть вставлен в начальную позицию таблицы.
  • Изображения нельзя вставлять внутрь сноски или уравнения.
  • Для получения дополнительной информации см. раздел Вставка встроенных изображений .

Форматировать текст

  • При применении форматирования на уровне абзаца к диапазону форматирование применяется к любому абзацу, который частично или полностью перекрывается этим диапазоном.
  • Диапазон может быть расширен за счет включения смежных символов переноса строк.
  • Если диапазон полностью содержит абзац, принадлежащий списку, маркер абзаца также обновляется с использованием соответствующего стиля текста.
  • Более подробную информацию см. в разделе Форматирование текста .

Создать маркеры абзацев

  • Создает маркеры для всех абзацев, которые перекрывают указанный диапазон.
  • Уровень вложенности каждого абзаца определяется количеством начальных символов табуляции перед каждым абзацем.
  • При создании маркеров удаляются начальные символы табуляции, что может изменить индексы частей текста.
  • Если вы добавляете маркеры абзаца, соответствующие маркерам списка, непосредственно предшествующего целевому абзацу, абзац присоединяется к списку.
  • Более подробную информацию см. в разделе Работа со списками .

Удалить текст

  • Удаление текста, выходящего за границу абзаца, может привести к изменению стилей абзацев, списков, позиционированных объектов и закладок при объединении двух абзацев.

  • Удаления, приводящие к нарушению структуры документа, не допускаются. Вот некоторые примеры недействительных запросов на удаление:

    • Удаление одной кодовой единицы суррогатной пары.

    • Удаление последнего символа новой строки в Body , Header , Footer , Footnote , TableCell или TableOfContents .

    • Удаление начала или конца Table , TableOfContents или Equation без удаления всего элемента.

    • Удаление символа новой строки перед Table , TableOfContents или SectionBreak без удаления элемента.

    • Удаление отдельных строк или ячеек таблицы. Разрешено удаление содержимого ячейки таблицы.

  • Дополнительные сведения см. в разделе Вставка, удаление и перемещение текста .