插入、删除和移动文本

通过 Google 文档 API,您可以在文档中插入或删除文本。移动文本 涉及到这两项操作,前面带有内容的 get

您可以在任何文档中插入或删除文本 标签页的各个部分(正文、页眉、页脚或脚注)。

插入文本

要将文本插入文档,请使用 documents.batchUpdate 方法,并包含一个 InsertTextRequest 以文本和位置作为载荷。

以下代码示例展示了如何在 指定索引位置。该示例使用三个 目标偏移值(25、50 和 75),并在每个 位置。

Java

List<Request> requests = new ArrayList<>();
requests.add(new Request().setInsertText(new InsertTextRequest()
        .setText(text1)
        .setLocation(new Location().setIndex(25).setTabId(TAB_ID))));

requests.add(new Request().setInsertText(new InsertTextRequest()
        .setText(text2)
        .setLocation(new Location().setIndex(50).setTabId(TAB_ID))));

requests.add(new Request().setInsertText(new InsertTextRequest()
        .setText(text3)
        .setLocation(new Location().setIndex(75).setTabId(TAB_ID))));

BatchUpdateDocumentRequest body = new BatchUpdateDocumentRequest().setRequests(requests);
BatchUpdateDocumentResponse response = docsService.documents()
        .batchUpdate(DOCUMENT_ID, body).execute();

PHP

$requests = array();
$requests[] = new Google_Service_Docs_Request(array(
    'insertText' => array(
        'text' => $text1,
        'location' => array(
            'index' => 25,
            'tabId' => TAB_ID,
        ),
    ),
    'insertText' => array(
        'text' => $text2,
        'location' => array(
            'index' => 50,
            'tabId' => TAB_ID,
        ),
    ),
    'insertText' => array(
        'text' => $text3,
        'location' => array(
            'index' => 75,
            'tabId' => TAB_ID,
        ),
    ),
));

$batchUpdateRequest = new Google_Service_Docs_BatchUpdateDocumentRequest(array(
    'requests' => $requests
));

$response = $service->documents->batchUpdate($documentId, $batchUpdateRequest);

Python

requests = [
        {
        'insertText': {
            'location': {
                'index': 25,
                'tabId': TAB_ID
            },
            'text': text1
        }
    },
                {
        'insertText': {
            'location': {
                'index': 50,
                'tabId': TAB_ID
            },
            'text': text2
        }
    },
                {
        'insertText': {
            'location': {
                'index': 75,
                'tabId': TAB_ID
            },
            'text': text3
        }
    },
]

result = service.documents().batchUpdate(
    documentId=DOCUMENT_ID, body={'requests': requests}).execute()

每次插入都会按照 插入文字。该示例会预先计算这些索引变化的结果, 之后的插入操作将以新的已修正偏移量进行。因此,要插入 原始目标偏移值 25、50 和 75 时,实际插入索引 分别是:

  • 首次插入会在偏移值 25 处添加 10 个字符。
  • 第二次插入在偏移量 50+10=60 处添加 10 个字符。
  • 第三次插入可在偏移量 75+10+10=95 处添加 10 个字符。
。 <ph type="x-smartling-placeholder">

删除文字

要从文档中删除文本,请先构建一个 Range,用于定义 要删除的文本。然后,使用 documents.batchUpdate 方法并添加一个 DeleteContentRangeRequest

以下代码示例展示了如何删除索引 10 之间的文本 和索引 24。

Java

List<Request> requests = new ArrayList<>();
requests.add(new Request().setDeleteContentRange(
        new DeleteContentRangeRequest()
                .setRange(new Range()
                        .setStartIndex(10)
                        .setEndIndex(24)
                        .setTabId(TAB_ID))
    ));

BatchUpdateDocumentRequest body = new BatchUpdateDocumentRequest().setRequests(requests);
BatchUpdateDocumentResponse response = docsService.documents()
        .batchUpdate(DOCUMENT_ID, body).execute();

PHP

$requests = array();
$requests[] = new Google_Service_Docs_Request(array(
    'deleteContentRange' => array(
        'range' => array(
            'startIndex' => 10,
            'endIndex' => 24,
            'tabId' => TAB_ID
        ),
    ),
));

$batchUpdateRequest = new Google_Service_Docs_BatchUpdateDocumentRequest(array(
    'requests' => $requests
));

$response = $service->documents->batchUpdate($documentId, $batchUpdateRequest);

Python

requests = [
    {
        'deleteContentRange': {
            'range': {
                'startIndex': 10,
                'endIndex': 24,
                'tabId': TAB_ID
            }

        }

    },
]
result = service.documents().batchUpdate(
    documentId=DOCUMENT_ID, body={'requests': requests}).execute()

通过反向写作来简化诉讼或调查。与插入操作一样 text 更改“以下”所有文本的索引细分。再次强调, 反向可以简化对索引的处理。

移动文本

如要移动文本,请先将其删除,然后将其插入其他位置。 删除内容并不会获得内容的副本(目前还没有 剪贴板),因此您必须先提取该范围的内容,然后才能使用 。