Google Docs API는 일반 단락을 글머리기호 목록으로 변환하고 단락에서 글머리기호를 삭제할 수 있도록 지원합니다.
단락을 목록으로 변환
단락을 글머리기호 목록으로 변환하는 작업은 일반적인 단락 서식 지정 작업입니다.
목록을 만들려면 documents.batchUpdate
메서드를 사용하고 CreateParagraphBulletsRequest
를 제공합니다.
영향을 받는 셀을 지정하기 위해 Range
를 포함하고 글머리기호의 패턴을 설정하기 위해 BulletGlyphPreset
를 포함합니다.
지정된 범위와 겹치는 모든 단락에 글머리기호가 표시됩니다. 지정된 범위가 표와 겹치면 글머리 기호가 표 셀 내에 적용됩니다. 각 단락의 중첩 수준은 각 단락 앞에 있는 선행 탭을 세서 결정됩니다.
기존 글머리기호의 중첩 수준은 조정할 수 없습니다. 대신 글머리기호를 삭제하고 단락 앞에 들여쓰기 탭을 설정한 다음 글머리기호를 다시 만들어야 합니다. 자세한 내용은 목록에서 글머리기호 삭제를 참고하세요.
CreateParagraphBulletsRequest
를 사용하여 기존 목록의 글머리기호 스타일을 변경할 수도 있습니다.
다음 코드 샘플은 문서 시작 부분에 먼저 텍스트를 삽입한 후 처음 50자를 포함하는 단락에서 목록을 만드는 일괄 요청을 보여줍니다. BulletGlyphPreset
은 BULLET_ARROW_DIAMOND_DISC
를 사용합니다. 즉, 글머리기호 목록의 처음 세 개의 중첩 수준은 화살표, 다이아몬드, 원반으로 표시됩니다.
자바
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
를 포함합니다.
이 메서드는 중첩 수준과 관계없이 지정된 범위와 겹치는 모든 글머리기호를 삭제합니다. 중첩 수준을 시각적으로 유지하기 위해 상응하는 각 단락의 시작 부분에 들여쓰기가 추가됩니다.
다음 코드 샘플은 단락 목록에서 글머리기호를 삭제하는 일괄 요청을 보여줍니다.
자바
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()