comment_renderingenum
Как отображать комментарии в выводе read_file. Используйте "paragraph_notes" (по умолчанию) для комментариев, привязанных к абзацам, "inline_markers" для добавления маркеров [cm-start:N]/[cm-end:N] в выводе TOON (в сочетании с блоками обсуждений), "endnotes" для сбора комментариев в отдельный блок #COMMENTS в конце вывода TOON, или "none" для прежнего формата вывода без отображения комментариев.
file_pathstring
Путь к файлу DOCX или ODT.
formatenum
google_doc_idstring
Google Doc ID или URL (альтернатива file_path). Извлекается из URL: docs.google.com/document/d/{ID}/edit
include_fingerprintboolean
Когда значение true и format="json", включайте переносимый content_fingerprint ("sha256:nfkc:<32hex>") для каждого абзаца. Это метаданные только для чтения, полученные из нормализованного видимого текста абзаца; это НЕ якорь редактирования. Инструменты редактирования принимают идентификатор _bk_* или (только для DOCX) любое другое имя закладки, чей диапазон, связанный с w:id, охватывает ровно этот абзац. На вывод TOON это не влияет. Для Google Docs и ODT игнорируется.
include_fingerprint_ordinalboolean
Когда значение true вместе с include_fingerprint и format="json", добавляет метаданные для устранения неоднозначности дубликатов к каждому параграфу: content_fingerprint_ordinal (позиция в порядке документа, начиная с 1, среди параграфов с одинаковым content_fingerprint), content_fingerprint_count_in_document (общее количество таких параграфов во всём документе, даже при разбиении на страницы), и portable_paragraph_ref ("<content_fingerprint>#<ordinal>"). Доступен только для чтения различитель, а не якорь редактирования; изменение порядка дубликатов может изменить порядковые номера. Не действует без include_fingerprint и не влияет на вывод TOON/простой. Игнорируется для Google Docs и ODT. По умолчанию: false.
include_footnotesboolean
Одноразовый вызов + извлечение сносок. Если значение true и format="json", ответ получает массив footnotes верхнего уровня на весь документ — каждая запись содержит {id, display_number, ref_paragraph_ids (массив id абзацев, которые ссылаются на эту сноску), paragraphs[] ({text, tagged_text с тегами форматирования на уровне прогонов, style})} — сохраняется многоабзацность и форматирование внутри сносок (жирный/курсив/цитаты). Этот массив верхнего уровня НЕ встраивается в content[], поэтому инвариант индексации content[] 1:1 сохраняется. Для обратной совместимости к каждому абзацу-якорю также прикрепляется облегчённый массив footnotes ({id, display_number, text}), ограниченный возвращаемым срезом. Если значение true и format="toon", в конец добавляется вспомогательный блок #FOOTNOTES (симметрично #COMMENTS). Сноски с пустым телом или display_number 0 исключаются. На обычный вывод не влияет. Для Google Docs и ODT игнорируется. По умолчанию: false.
limitnumber
Максимальное количество возвращаемых абзацев. Если параметр не задан, вывод ограничивается примерно 14 000 токенов с разбивкой на страницы.
node_idsstring[]
Селекторы абзацев. Каждый принимает безопасный docx-идентификатор _bk_* или (только для DOCX) любое другое имя закладки - например, собственную стабильную закладку абзаца хост-приложения - чей диапазон, связанный с w:id, охватывает ровно один абзац. Требуется точное совпадение имени; точечная закладка или многоабзацный диапазон отклоняются. Возвращаемые строки всегда сообщают канонический идентификатор _bk_* абзаца, даже когда выбор сделан по другому имени закладки; результаты дедуплицируются и возвращаются в порядке документа.
offsetnumber
Смещение абзаца с отсчетом от 1 для постраничной разбивки. Отрицательные значения отсчитываются от конца.
show_formattingboolean
Когда значение равно true (по умолчанию), отображаются строчные теги форматирования (<b>, <i>, <u>, <highlighting>, <a>). Когда значение равно false, выводится обычный текст без строчных тегов.
