목록 사용

Google Docs API는 일반 단락을 글머리 기호 목록으로 변환하고 단락에서 글머리 기호를 삭제하는 작업을 지원합니다.

단락을 목록으로 변환

단락을 글머리기호로 변환하는 것은 일반적인 단락 서식 지정 작업입니다. 목록.

목록을 만들려면 documents.batchUpdate 메서드를 사용하고 CreateParagraphBulletsRequest를 제공합니다. Range를 포함하여 영향을 받은 세포와 BulletGlyphPreset 글머리기호의 패턴을 설정합니다

지정된 범위와 겹치는 모든 단락은 글머리 기호로 표시됩니다. 지정된 범위가 표와 겹치면 표 셀 내에 글머리기호가 적용됩니다. 이 각 단락의 중첩 수준은 앞에 있는 탭을 계산하여 결정됩니다. 살펴보겠습니다

기존 글머리기호의 중첩 수준은 조정할 수 없습니다. 대신 글머리기호를 삭제하고 단락 앞에 들여쓰기 탭을 설정한 다음 글머리기호를 다시 만들어야 합니다. 자세한 내용은 삭제 글머리기호 목록으로 표시할 수 있습니다.

CreateParagraphBulletsRequest를 사용하여 글머리기호 스타일을 변경할 수도 있습니다. 생성할 수 있습니다.

다음 코드 샘플은 그 문장부터 시작하여 문단 범위까지 이어지는 입력되어야 합니다. 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()