API 如何在 Google 文档中添加样式段落

Question

我有一个功能性 PHP 脚本可以将纯文本添加到 Google 文档中，但我很难插入带有样式的段落。我想要达到的是

1. 用文本附加标题段落
2. 附加带有超链接的段落

有 insertText 个请求，但无法直接在请求中设置此文本的样式。而且没有 insertParagraph，所以每次我插入文本时，我什至无法换行。 https://developers.google.com/docs/api/reference/rest/v1/documents/request

令人沮丧的是，使用 Google 文档 API 是多么困难，完成这些基本任务应该容易得多，请帮助。

Answer 1

我相信你的目标如下。

• 您想放置段落样式和文本样式的文本。
• 您想使用 Google 文档 API 实现此目的。

在这种情况下，下面的示例请求正文怎么样？

流量：

为了达到你的目的，当使用batchUpdate方法时，作为示例流程，使用了以下流程。

1. 插入文本。
   • 在此示例中，插入了 Sample1\n 和 Sample2\n 的文本。
2. 设置段落样式。
   • 在这种情况下，“HEADING_1”和“NORMAL_TEXT”分别反映在Sample1\n和Sample2\n的文本中。
3. 设置文字样式。
   • 在这种情况下，https://www.google.com 的 hyperlink 设置为 Sample2\n 的文本。

当这个流程反映在请求体中时，它变成如下。当然，比如你可以把这个流程改成“1.插入Sample1\n。2.设置段落样式。3.插入Sample2\n。4.设置段落样式。5.设置文字样式。” .

示例请求正文：

{
  "requests": [
    {
      "insertText": {
        "text": "Sample1\n",
        "location": {
          "index": 1
        }
      }
    },
    {
      "insertText": {
        "text": "sample2\n",
        "location": {
          "index": 9
        }
      }
    },
    {
      "updateParagraphStyle": {
        "range": {
          "startIndex": 1,
          "endIndex": 8
        },
        "paragraphStyle": {
          "namedStyleType": "HEADING_1"
        },
        "fields": "namedStyleType"
      }
    },
    {
      "updateParagraphStyle": {
        "range": {
          "startIndex": 9,
          "endIndex": 17
        },
        "paragraphStyle": {
          "namedStyleType": "NORMAL_TEXT"
        },
        "fields": "namedStyleType"
      }
    },
    {
      "updateTextStyle": {
        "range": {
          "startIndex": 9,
          "endIndex": 16
        },
        "textStyle": {
          "link": {
            "url": "https://www.google.com"
          }
        },
        "fields": "link"
      }
    }
  ]
}

测试：

当您使用 Docs API 的 batchUpdate 方法的“试试这个 API”测试此请求正文时，您可以在 this link 处进行。在这个link中，已经设置了request body。请准备一份示例 Google 文档并设置您的 Google 文档 ID。

结果：

当此请求正文用于 Google 文档时，将获得以下结果。

参考文献：

• InsertTextRequest
• UpdateParagraphStyleRequest
• UpdateTextStyleRequest