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()
移除清單中的項目符號
如要從段落清單移除項目符號,請使用
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()