使用清單

Google Docs API 支援將純段落轉換成項目符號清單，以及 移除段落中的項目符號

將段落轉換為清單

段落中的常見格式設定作業，就是將段落轉換為項目符號 請參考閱讀清單，進一步瞭解 如何選擇 Kubeflow Pipelines SDK 或 TFX

如要建立清單，請使用 documents.batchUpdate 方法，並提供 CreateParagraphBulletsRequest。 加入 Range 以指定 受影響的儲存格 BulletGlyphPreset 設定項目符號的模式

與指定範圍重疊的所有段落都會加上項目符號。如果指定 範圍與表格重疊，表格儲存格會套用項目符號。 每個段落的巢狀結構層級，取決於 。

您無法調整現有項目符號的巢狀層級。 如要改為刪除項目符號，你必須改為刪除 ，然後再次建立項目符號。詳情請參閱移除 項目符號清單。

您也可以使用 CreateParagraphBulletsRequest 變更下列項目的項目符號樣式： 建立現有名單

下列程式碼範例顯示先在 然後將橫跨的段落建立為清單 在輸出的前 50 個字元中BulletGlyphPreset會使用 BULLET_ARROW_DIAMOND_DISC，也就是 項目符號清單以箭頭、菱形和光碟表示。

Java

List<Request> requests = new ArrayList<>();
requests.add(new Request().setInsertText(new InsertTextRequest()
        .setText("Item One\n")
        .setLocation(new Location().setIndex(1).setTabId(TAB_ID))));

requests.add(new Request().setCreateParagraphBullets(
        new CreateParagraphBulletsRequest()
                .setRange(new Range()
                        .setStartIndex(1)
                        .setEndIndex(50)
                        .setTabId(TAB_ID))
                .setBulletPreset("BULLET_ARROW_DIAMOND_DISC")));

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

Python

requests = [
        {
        'insertText': {
            'location': {
                'index': 1,
                'tabId': TAB_ID
            },
            'text': 'Item One\n',
        }}, {
        'createParagraphBullets': {
            'range': {
                'startIndex': 1,
                'endIndex':  50,
                'tabId': TAB_ID
            },
            'bulletPreset': 'BULLET_ARROW_DIAMOND_DISC',
        }
    }
]

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

圖 1. 將段落轉換為清單。

移除清單中的項目符號

如要從段落清單移除項目符號，請使用 documents.batchUpdate 方法，並提供 DeleteParagraphBulletsRequest。 加入 Range 以指定 受影響的儲存格。

這個方法會刪除與指定範圍重疊的所有項目符號，無論項目為何 巢狀結構層級為了視覺化保留巢狀層級，系統會 在每個對應段落的開頭。

下列程式碼範例說明批次要求，該要求從變數中刪除項目符號 段落清單。

Java

List<Request> requests = new ArrayList<>();
requests.add(new Request().setDeleteParagraphBullets(
        new DeleteParagraphBulletsRequest()
                .setRange(new Range()
                        .setStartIndex(1)
                        .setEndIndex(50)
                        .setTabId(TAB_ID))));

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

Python

requests = [
        {
        'deleteParagraphBullets': {
            'range': {
                'startIndex': 1,
                'endIndex':  50,
                'tabId': TAB_ID
            },
        }
    }
]

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