목록 사용

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

단락을 목록으로 변환

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

목록을 만들려면 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))));

      requests.add(new Request().setCreateParagraphBullets(
              new CreateParagraphBulletsRequest()
                      .setRange(new Range()
                              .setStartIndex(1)
                              .setEndIndex(50))
                      .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
                },
                'text': 'Item One\n',
            }}, {
            'createParagraphBullets': {
                'range': {
                    'startIndex': 1,
                    'endIndex':  50
                },
                '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))));

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

Python

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

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