이 페이지에서는 Google Docs API를 사용하여 텍스트의 서식을 지정하는 방법을 설명합니다.
서식 지정 정보
문서의 텍스트 콘텐츠에 적용할 수 있는 두 가지 유형의 서식이 있습니다.
- 글꼴, 색상, 밑줄 등 문자 서식을 변경할 수 있습니다.
- 들여쓰기 또는 줄 간격과 같은 단락 서식을 변경할 수 있습니다.
문자 서식 변경
문자 서식은 문서의 텍스트 문자의 렌더링을 결정합니다.
적용하는 모든 서식은 기본 단락의 TextStyle에서 상속된 기본 서식을 재정의합니다. 반대로 서식을 설정하지 않은 문자는 계속해서 단락의 스타일에서 상속됩니다.
텍스트의 문자 형식을 변경하려면 batchUpdate
를 UpdateTextStyleRequest와 함께 사용합니다.
다음 정보가 포함된 Range 객체를 제공해야 합니다.
- 텍스트가 포함된 머리글, 바닥글, 각주 또는 지정되지 않은 경우 본문에 포함된
segmentId
를 식별합니다. - 형식을 지정할 세그먼트 내의 텍스트 범위를 정의하는
startIndex
및endIndex
다음 예에서는 헤더에 포함된 텍스트에서 여러 텍스트 스타일 지정 작업을 실행합니다.
- 문자 1~5의 글꼴을 굵은 기울임꼴로 설정합니다.
- 6~10자의 문자 색상을
blue
14포인트 곱셈 뉴 로마어 글꼴로 설정합니다. - 문자 11~15를
www.example.com
로 하이퍼링크합니다.
요청 목록을 작성한 후 batchUpdate 호출을 한 번만 사용하면 됩니다.
Java
List<Request> requests = new ArrayList<>(); requests.add(new Request().setUpdateTextStyle(new UpdateTextStyleRequest() .setTextStyle(new TextStyle() .setBold(true) .setItalic(true)) .setRange(new Range() .setStartIndex(1) .setEndIndex(5)) .setFields("bold"))); requests.add(new Request() .setUpdateTextStyle(new UpdateTextStyleRequest() .setRange(new Range() .setStartIndex(6) .setEndIndex(10)) .setTextStyle(new TextStyle() .setWeightedFontFamily(new WeightedFontFamily() .setFontFamily("Times New Roman")) .setFontSize(new Dimension() .setMagnitude(14.0) .setUnit("PT")) .setForegroundColor(new OptionalColor() .setColor(new Color().setRgbColor(new RgbColor() .setBlue(1.0F) .setGreen(0.0F) .setRed(0.0F))))) .setFields("foregroundColor,weightedFontFamily,fontSize"))); requests.add(new Request() .setUpdateTextStyle(new UpdateTextStyleRequest() .setRange(new Range() .setStartIndex(11) .setEndIndex(15)) .setTextStyle(new TextStyle() .setLink(new Link() .setUrl("www.example.com"))) .setFields("link"))); BatchUpdateDocumentRequest body = new BatchUpdateDocumentRequest().setRequests(requests); BatchUpdateDocumentResponse response = docsService.documents() .batchUpdate(DOCUMENT_ID, body).execute();
Python
requests = [ { 'updateTextStyle': { 'range': { 'startIndex': 1, 'endIndex': 5 }, 'textStyle': { 'bold': True, 'italic': True }, 'fields': 'bold,italic' } }, { 'updateTextStyle': { 'range': { 'startIndex': 6, 'endIndex': 10 }, 'textStyle': { 'weightedFontFamily': { 'fontFamily': 'Times New Roman' }, 'fontSize': { 'magnitude': 14, 'unit': 'PT' }, 'foregroundColor': { 'color': { 'rgbColor': { 'blue': 1.0, 'green': 0.0, 'red': 0.0 } } } }, 'fields': 'foregroundColor,weightedFontFamily,fontSize' } }, { 'updateTextStyle': { 'range': { 'startIndex': 11, 'endIndex': 15 }, 'textStyle': { 'link': { 'url': 'www.example.com' } }, 'fields': 'link' } } ] result = service.documents().batchUpdate( documentId=DOCUMENT_ID, body={'requests': requests}).execute()
단락 서식 변경
Google Docs API를 사용하면 정렬 및 들여쓰기와 같은 기능을 포함하여 문서에서 텍스트 블록이 렌더링되는 방식을 결정하는 단락 서식을 업데이트할 수 있습니다.
적용하는 모든 서식은 기본 단락 스타일에서 상속된 기본 서식을 재정의합니다. 반대로 설정하지 않은 모든 서식 지정 기능은 단락 스타일에서 상속됩니다. 단락 스타일 및 상속에 관한 자세한 내용은 ParagraphStyle을 참고하세요.
아래 예에서는 단락에 다음과 같은 서식을 지정합니다.
- 이름이 지정된 스타일인 제목
- 위 맞춤 간격
- 하단 맞춤 간격
- 맞춤 왼쪽 테두리
단락의 나머지 모든 서식 지정 기능은 계속해서 이름이 지정된 기본 스타일에서 상속됩니다.
Java
List<Request> requests = new ArrayList<>(); requests.add(new Request().setUpdateParagraphStyle(new UpdateParagraphStyleRequest() .setRange(new Range() .setStartIndex(1) .setEndIndex(10)) .setParagraphStyle(new ParagraphStyle() .setNamedStyleType("HEADING_1") .setSpaceAbove(new Dimension() .setMagnitude(10.0) .setUnit("PT")) .setSpaceBelow(new Dimension() .setMagnitude(10.0) .setUnit("PT"))) .setFields("namedStyleType,spaceAbove,spaceBelow") )); requests.add(new Request().setUpdateParagraphStyle(new UpdateParagraphStyleRequest() .setRange(new Range() .setStartIndex(10) .setEndIndex(20)) .setParagraphStyle(new ParagraphStyle() .setBorderLeft(new ParagraphBorder() .setColor(new OptionalColor() .setColor(new Color() .setRgbColor(new RgbColor() .setBlue(1.0F) .setGreen(0.0F) .setRed(0.0F) ) ) ) .setDashStyle("DASH") .setPadding(new Dimension() .setMagnitude(20.0) .setUnit("PT")) .setWidth(new Dimension() .setMagnitude(15.0) .setUnit("PT") ) ) ) .setFields("borderLeft") )); BatchUpdateDocumentRequest body = new BatchUpdateDocumentRequest().setRequests(requests); BatchUpdateDocumentResponse response = docsService.documents() .batchUpdate(DOCUMENT_ID, body).execute();
Python
requests = [ { 'updateParagraphStyle': { 'range': { 'startIndex': 1, 'endIndex': 10 }, 'paragraphStyle': { 'namedStyleType': 'HEADING_1', 'spaceAbove': { 'magnitude': 10.0, 'unit': 'PT' }, 'spaceBelow': { 'magnitude': 10.0, 'unit': 'PT' } }, 'fields': 'namedStyleType,spaceAbove,spaceBelow' } }, { 'updateParagraphStyle': { 'range': { 'startIndex': 10, 'endIndex': 20 }, 'paragraphStyle': { 'borderLeft': { 'color': { 'color': { 'rgbColor': { 'blue': 1.0, 'green': 0.0, 'red': 0.0 } } }, 'dashStyle': 'DASH', 'padding': { 'magnitude': 20.0, 'unit': 'PT' }, 'width': { 'magnitude': 15.0, 'unit': 'PT' }, } }, 'fields': 'borderLeft' } } ] result = service.documents().batchUpdate( documentId=DOCUMENT_ID, body={'requests': requests}).execute()