Google Docs API 以编程方式添加目录

Question

我有一个 python 脚本，它进行一些分析并将结果作为文本（段落）输出到 Google Doc 上。我知道如何通过 batchUpdate 插入文本、更新段落和文本样式。

doc_service.documents().batchUpdate(documentId=<ID>,body={'requests': <my_request>}).execute()

例如，“my_request”采用以下形式：

request = [
        {
            "insertText": {
                "location": {
                    "index": <index_position>,
                    "segmentId": <id>
                },
                "text": <text>
            }
        },
        {
            "updateParagraphStyle": {
                "paragraphStyle": {
                    "namedStyleType": <paragraph_type>
                },
                "range": {
                    "segmentId": <id>,
                    "startIndex": <index_position>,
                    "endIndex": <index_position>
                },
                "fields": "namedStyleType"
            }
        },
    ]

但是，一旦脚本完成更新表格，如果可以在文档顶部添加目录，那就太棒了。

但是，我对 Google Docs API 很陌生，我不完全确定如何去做。我知道我应该使用“TableOfContents”作为 StructuralElement。我也知道这个选项目前不会在每次修改文档后自动更新（这就是为什么我想在文档完成更新后创建它并将其放在文档顶部）。

如何用 python 做到这一点？我不清楚在我的请求中在哪里调用“TableOfContents”。

非常感谢！

Answer 1

在你的评论之后，我能够更好地理解你想要做什么，但是我看到了这两个Issue Tracker的帖子：

• Add the ability to generate and update the TOC of a doc.

• Geting a link to heading paragraph.

这些是众所周知的功能请求，遗憾的是尚未实现。您可以点击此页面左上角问题编号旁边的 ☆，因为它可以让 Google 知道更多人遇到此问题，因此更有可能更快地被看到。

因此，无法以编程方式插入/更新目录。