google-docs - 如何使用 Google Docs API 添加页眉/页脚

Question

我想使用 Google Docs API 将页眉和页脚添加到现有的 Google 文档文件中.

看着documents.batchUpdate ( link ) 我们可以插入文本、替换文本、添加图像和表格等，方法是在 JSON 负载中使用 replaceAllText 之类的对象提及它们。 , insertText等等，但我找不到任何插入页眉和页脚的方法。

问题 1:如何添加页眉和页脚？

问题 2:如何为文档的第一页添加不同的页眉/页脚？

如果不可能，建议使用任何其他 API 或方法(如使用 MS Word)将不胜感激。先感谢您。

Answer 1

这个答案怎么样？

问题 1:

您想将页眉和页脚添加到 Google 文档。

关于这个问题，下面的流程怎么样？

流动:

首先，需要使用浏览器手动打开 Google 文档中的页眉和页脚。这样，似乎可以创建页眉 ID 和页脚 ID。

Even if the Document has only one page, when "Different first page"is checked, 2 ID s of 1st page and other pages are automatically created for the header and footer.

我认为这可能是当前的规范。

当第一页和第二页的页眉和页脚设置不同的示例文本时，您可以轻松找到 ID。

下一步，它使用Docs API 的documents.get 方法检索页眉ID 和页脚ID。终点如下。

GET https://docs.googleapis.com/v1/documents/{documentId}?fields=footers%2Cheaders

从这个结果中，可以检索页眉 ID 和页脚 ID。

您可以看到页眉和页脚的 2 个 ID。

手动设置页眉和页脚的文本时，如果选中“不同的第一页”，则每个 ID 都可以用于第一页和除第一页之外的其他页面。 (这是您的问题 2 的答案。)

它使用Docs API 的documents.batchUpdate 方法更新页眉和页脚。端点和请求正文如下。

POST https://docs.googleapis.com/v1/documents/{documentId}:batchUpdate

{
 "requests": [
  {
   "insertText": {
    "location": {
     "segmentId": "kix.#####",
     "index": 1
    },
    "text": "sample text"
   }
  }
 ]
}

kix.#####的 "segmentId": "kix.#####"是页眉 ID 和页脚 ID。这样就可以设置文本了。

index是插入文本的位置。

问题2:

您想知道设置第一页和其他页面之间不同值的方法。

关于这个问题，下面的流程怎么样？

流动:

首先，需要使用浏览器手动打开 Google 文档中的页眉和页脚。这样，似乎可以创建页眉 ID 和页脚 ID。

Even if the Document has only one page, when "Different first page"is checked, 2 ID s of 1st page and other pages are automatically created for the header and footer.

当第一页和第二页的页眉和页脚设置不同的示例文本时，您可以轻松找到 ID。

此后，流程与问题 1 的答案相同。

笔记:

当您请求上述端点时，请使用 OAuth2 和服务帐户检索到的访问 token 。并且请使用 https://www.googleapis.com/auth/documents作为范围。

关于创建页眉和页脚的 ID，我尝试仅使用 API 对新文档执行此操作。但在现阶段，我还无法实现。我道歉。

目前的结果如下。使用带有 Google Apps 脚本的文档服务添加页眉和页脚时，不会创建 ID。只有当手动打开页眉和页脚时，才会创建 ID。

从这个结果来看，在现阶段，我认为这可能是规范。

引用:

documents.get

documents.batchUpdate

InsertTextRequest

如果我误解了您的问题并且这不是您想要的方向，我深表歉意。