是否可以使用 Google Docs API 插入水平规则？

我一直在开发一个项目，需要使用 PHP 将文本和其他类型的元素插入 Google 文档文档中。我可以使用以下代码插入文本：

    $requests = [];
    ```
    $requests[] = new \Google_Service_Docs_Request(
        ['insertText' => ['text' => 'Text to insert',
                          'location' => ['index' => $insertionIndex],
                          ],
         ]);
    ```
    $batchUpdateRequest = new \Google_Service_Docs_BatchUpdateDocumentRequest(['requests' => $requests]);
    $docsService->documents->batchUpdate($documentID, $batchUpdateRequest);

我还可以使用类似的调用插入分页符：

    $requests = [];
    ```
    $requests[] = new \Google_Service_Docs_Request(
        ['insertPageBreak' => ['location' => ['index' => $insertionIndex],
                               ],
         ]);
    ```
    $batchUpdateRequest = new \Google_Service_Docs_BatchUpdateDocumentRequest(['requests' => $requests]);
    $docsService->documents->batchUpdate($documentID, $batchUpdateRequest);

上述两种方法都工作得很好（根据谷歌的建议，当我进行多次插入时，我正在向后工作）。我需要做的就是向文档添​​加水平线。我知道 Google Docs 允许手动插入它们，并且 Apps 脚本支持 insertHorizo​​ntalRule，但 Docs API 似乎没有等效的功能。我在这里、Google 和 API 文档中进行了搜索，但找不到任何参考资料。有人可以告诉我这是否可能吗？如果可能的话，正确的请求类型是什么？

似乎也很奇怪，没有记录的插入它们的方法，但您可以查询现有文档的内容，并且文档中的任何内容都会作为其结构的一部分报告给您。

为了清楚起见，我试图将一个 Google 文档的内容附加到另一个 Google 文档中。如果有人知道比逐个元素使用源文档并创建将这些元素添加到目标文档的请求更好的方法，那么这将绕过处理插入水平规则的需要。

• 您想要使用 Docs API 将水平线插入 Google 文档。
• 您想使用 php 来实现这一点。
• 您已经能够使用 Docs API 获取和放置 Google 文档的值。

我可以像上面那样理解。不幸的是，在现阶段，Google Docs API 中似乎还没有添加水平规则的方法，而“horizo​​ntalRule”可以通过以下方式检索：documents.get。 Docs API 现在正在增长。所以这可能会在未来的更新中添加。

所以现阶段需要采用workaround来解决这个问题。

模式一：

在此模式中，使用由 Google Apps 脚本创建的 Web Apps 作为 API 将水平线添加到 Google 文档中。

Usage:

请将以下脚本复制并粘贴到 Google Apps 脚本的脚本编辑器中。

function doGet(e) {
  DocumentApp.openById(e.parameter.id).getBody().insertHorizontalRule(Number(e.parameter.index) - 1);
  return ContentService.createTextOutput("Done");
}

2. 部署Web应用程序：

1. 在脚本编辑器上，通过“发布”->“部署为 Web 应用程序”打开一个对话框。
2. Select "Me" for “执行应用程序：”.
3. Select "Anyone, even anonymous" for "Who has access to the app:".
   • 此设置用于测试情况。
   • 您还可以通过设置“仅我自己”而不是“任何人，甚至匿名”来使用访问令牌进行访问。
4. 单击“部署”按钮作为新的“项目版本”。
5. Automatically open a dialog box of "Authorization required".
   1. 单击“查看权限”。
   2. 选择自己的帐户。
   3. 单击“此应用程序未经验证”处的“高级”。
   4. 点击“转到###项目名称###（不安全）”
   5. 单击“允许”按钮。
6. 单击“确定”。
7. Copy the URL of Web Apps. It's like https://script.google.com/macros/s/###/exec.
   • 当您修改 Google Apps 脚本时，请重新部署为新版本。这样，修改后的脚本就会反映到Web Apps中。请小心这一点。

3. 使用 Web 应用程序作为 API：

以下脚本适用于 PHP。请设置查询参数id and index. id是 Google 文档 ID。什么时候index=1设置后，水平线将插入到文档正文的顶部。在这种情况下，index表示 Google 文档中的每一行。

$url = 'https://script.google.com/macros/s/###/exec?id=###&index=1';
$curl = curl_init();
$option = [
  CURLOPT_URL => $url,
  CURLOPT_CUSTOMREQUEST => 'GET',
  CURLOPT_FOLLOWLOCATION => true,
];
curl_setopt_array($curl, $option);
$response = curl_exec($curl);
$result = json_decode($response, true);
curl_close($curl);

模式2：

我认为你的建议I'm also going to look at possible inserting a thin table with a top border line as a replacement for a horizontal rule.也可以用作解决方法。为了实现这一点，脚本如下。

运行此脚本时，将在文档顶部创建仅包含顶部行的新表。在运行脚本之前，请先设置$documentId。在这种情况下，请设置Google_Service_Docs::DOCUMENTS到范围。

示例脚本：

$documentId = '###';
$index = 1;
$style = [
    'width' => ['magnitude' => 0, 'unit' => 'PT'],
    'dashStyle' => 'SOLID',
    'color' => ['color' => ['rgbColor' => ['blue' => 1, 'green' => 1, 'red' => 1]]]
];
$requests = [
    new Google_Service_Docs_Request([
        'insertTable' => [
            'location' => ['index' => $index],
            'columns' => 1,
            'rows' => 1
        ]
    ]),
    new Google_Service_Docs_Request([
        'updateTableCellStyle' => [
            'tableCellStyle' => [
                'borderBottom' => $style,
                'borderLeft' => $style,
                'borderRight' => $style,
            ],
            'tableStartLocation' => ['index' => $index + 1],
            'fields' => 'borderBottom,borderLeft,borderRight'
        ]
    ])
];
$batchUpdateRequest = new Google_Service_Docs_BatchUpdateDocumentRequest([
  'requests' => $requests
]);
$result = $service->documents->batchUpdate($documentId, $batchUpdateRequest);

参考：

• Web Apps https://developers.google.com/apps-script/guides/web
• 插入水平规则() https://developers.google.com/apps-script/reference/document/paragraph#inserthorizontalrulechildindex
• 方法：documents.batchUpdate https://developers.google.com/docs/api/reference/rest/v1/documents/batchUpdate