목록 사용

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()
단락을 목록으로 변환합니다.
그림 1. 단락을 목록으로 변환합니다.

목록에서 글머리기호 삭제

단락 목록에서 글머리기호를 삭제하려면 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()