Google Docs API를 사용하여 표 콘텐츠를 수정할 수 있습니다. 수행할 수 있는 작업은 수행할 작업에는 다음이 포함됩니다.
- 행, 열 또는 전체 표를 삽입하고 삭제합니다.
- 표 셀에 콘텐츠를 삽입합니다.
- 표 셀에서 콘텐츠를 읽습니다.
- 열 속성과 행 스타일을 수정합니다.
Google Docs의 표는 StructuralElement 유형으로 표현됨 합쳐집니다. 각 테이블 테이블 행 목록을 포함합니다. 여기서 각 행에는 표 셀입니다. Google의 테이블에는 시작 색인 및 종료 색인 는 문서에서 표의 위치를 나타냅니다. 자세한 내용은 구조를 참조하세요. 표 속성에는 여러 스타일 요소가 포함되어 있습니다. 예를 들어 열 너비 및 패딩과 같은 특성을 가질 수 있습니다
를 탭합니다. 다음 JSON 조각은 대부분의 세부정보가 포함된 간단한 2x2 테이블을 보여줍니다. 삭제됨:
"table": {
"columns": 2,
"rows": 2,
"tableRows": [
{ "tableCells": [
{
"content": [ { "paragraph": { ... }, } ],
},
{
"content": [ { "paragraph": { ... }, } ],
}
],
},
{
"tableCells": [
{
"content": [ { "paragraph": { ... }, } ],
},
{
"content": [ { "paragraph": { ... }, } ],
}
],
}
]
}
테이블 삽입 및 삭제
문서에 새 표를 추가하려면 InsertTableRequest. 테이블을 삽입할 때 다음을 지정해야 합니다.
- 행과 열의 표 크기입니다.
- 새 테이블을 삽입할 위치입니다. 테이블 내의 색인일 수 있습니다. 세그먼트 또는 세그먼트를 지정할 수 있습니다. 둘 중 하나에 지정된 탭의 ID를 포함해야 합니다.
테이블을 삭제하는 명시적인 메서드는 없습니다. 테이블에서 테이블을 삭제하려면 다른 콘텐츠와 마찬가지로 다뤄야 합니다. DeleteContentRangeRequest, 전체 테이블을 포함하는 범위 지정
다음 예에서는 빈 문서의 끝에 3x3 테이블을 삽입합니다.
자바
// Insert a table at the end of the body.
// (An empty or unspecified segmentId field indicates the document's body.)
List<Request> requests = new ArrayList<>();
requests.add(
new Request()
.setInsertTable(
new InsertTableRequest()
.setEndOfSegmentLocation(
new EndOfSegmentLocation().setTabId(TAB_ID))
.setRows(3)
.setColumns(3)));
BatchUpdateDocumentRequest body =
new BatchUpdateDocumentRequest().setRequests(requests);
BatchUpdateDocumentResponse response =
docsService.documents().batchUpdate(DOCUMENT_ID, body).execute();
Python
# Insert a table at the end of the body.
# (An empty or unspecified segmentId field indicates the document's body.)
requests = [{
'insertTable': {
'rows': 3,
'columns': 3,
'endOfSegmentLocation': {
'segmentId': '',
'tabId': TAB_ID
}
},
}
]
result = service.documents().batchUpdate(documentId=DOCUMENT_ID, body={'requests': requests}).execute()
상응하는 다음 예는 이전에 삽입한 테이블을 삭제하는 방법을 보여줍니다.
자바
// Delete a table that was inserted at the start of the body of the first tab.
// (The table is the second element in the body:
// documentTab.getBody().getContent().get(2).)
Document document = docsService.documents().get(DOCUMENT_ID).setIncludeTabsContent(true).execute();
String tabId = document.getTabs()[0].getTabProperties().getTabId();
DocumentTab documentTab = document.getTabs()[0].getDocumentTab();
StructuralElement table = documentTab.getBody().getContent().get(2);
List<Request> requests = new ArrayList<>();
requests.add(
new Request()
.setDeleteContentRange(
new DeleteContentRangeRequest()
.setRange(
new Range()
.setStartIndex(table.getStartIndex())
.setEndIndex(table.getEndIndex())
.setTabId(tabId))));
BatchUpdateDocumentRequest body =
new BatchUpdateDocumentRequest().setRequests(requests);
BatchUpdateDocumentResponse response =
docsService.documents().batchUpdate(DOCUMENT_ID, body).execute();
Python
# Delete a table that was inserted at the start of the body of the first tab.
# (The table is the second element in the body: ['body']['content'][2].)
document = service.documents().get(documentId=DOCUMENT_ID, includeTabsContent=True).execute()
tab_id = document['tabs'][0]['tabProperties']['tabId']
document_tab = document['tabs'][0]['documentTab']
table = document_tab['body']['content'][2]
requests = [{
'deleteContentRange': {
'range': {
'segmentId': '',
'startIndex': table['startIndex'],
'endIndex': table['endIndex'],
'tabId': tab_id
}
},
}
]
result = service.documents().batchUpdate(documentId=DOCUMENT_ID, body={'requests': requests}).execute()
시작과 끝을 지정하여 테이블을 일반 콘텐츠로 삭제하기 때문입니다. 어딘가에서 이러한 색인을 가져와야 합니다. 이 예시에서는 한 가지 방법으로 문서 콘텐츠에서 이러한 색인을 추출할 수 있습니다.
행 삽입 및 삭제
문서에 이미 표가 포함되어 있는 경우 Google Docs API를 사용하여 테이블 행을 삭제합니다 InsertTableRowRequest 사용 위 또는 아래에 행을 삽입하려면 지정된 테이블 셀 및 DeleteTableRowRequest 지정된 셀 위치에 걸쳐 있는 행을 삭제합니다.
다음 예는 표의 첫 번째 표 셀에 텍스트를 삽입하고 있습니다.
자바
List<Request> requests = new ArrayList<>();
requests.add(new Request().setInsertText(new InsertTextRequest()
.setText("Hello")
.setLocation(new Location().setIndex(5).setTabId(TAB_ID))));
requests.add(new Request().setInsertTableRow(new InsertTableRowRequest()
.setTableCellLocation(new TableCellLocation()
.setTableStartLocation(new Location()
.setIndex(2).setTabId(TAB_ID))
.setRowIndex(1)
.setColumnIndex(1))
.setInsertBelow(true)));
BatchUpdateDocumentRequest body =
new BatchUpdateDocumentRequest().setRequests(requests);
BatchUpdateDocumentResponse response = docsService.documents()
.batchUpdate(DOCUMENT_ID, body).execute();
Python
requests = [{
'insertText': {
'location': {
'index': 5,
'tabId': TAB_ID
},
'text': 'Hello'
}
},
{
'insertTableRow': {
'tableCellLocation': {
'tableStartLocation': {
'index': 2,
'tabId': TAB_ID
},
'rowIndex': 1,
'columnIndex': 1
},
'insertBelow': 'true'
}
}
]
result = service.documents().batchUpdate(documentId=DOCUMENT_ID, body={'requests': requests}).execute()
열 삽입 및 삭제
기존 테이블에 열을 삽입하려면 InsertTableColumnRequest. 다음을 지정해야 합니다.
- 새 열을 삽입하려는 옆의 셀입니다.
- 새 열을 삽입할 방향 (왼쪽 또는 오른쪽)입니다.
다음 예는 열을 2x2 열에 삽입하는 방법을 보여줍니다. 표를 참조하세요.
자바
List<Request> requests = new ArrayList<>();
requests.add(
new Request()
.setInsertTableColumn(
new InsertTableColumnRequest()
.setTableCellLocation(
new TableCellLocation()
.setTableStartLocation(
new Location().setIndex(2).setTabId(TAB_ID))
.setRowIndex(0)
.setColumnIndex(0))
.setInsertRight(true)));
BatchUpdateDocumentRequest body =
new BatchUpdateDocumentRequest().setRequests(requests);
BatchUpdateDocumentResponse response =
docsService.documents().batchUpdate(DOCUMENT_ID, body).execute();
Python
requests = [{
'insertTableColumn': {
'tableCellLocation': {
'tableStartLocation': {
'segmentId': '',
'index': 2,
'tabId': TAB_ID
},
'rowIndex': 0,
'columnIndex': 0
},
'insertRight': True
},
}
]
result = service.documents().batchUpdate(documentId=DOCUMENT_ID, body={'requests': requests}).execute()
열을 삭제하려면 DeleteTableColumnRequest. 이전에 설명한 것처럼 타겟 열 내에서 셀 위치를 지정합니다. 사용할 수 있습니다
표 셀에서 콘텐츠 읽기
테이블 셀에는 구조적 요소 목록이 포함됩니다. 이러한 각 구조적 요소는 텍스트가 있는 단락이거나 심지어 다른 테이블까지 할 수 있습니다. 표 콘텐츠를 읽으려면 다음을 수행합니다. 각 요소를 재귀적으로 검사합니다. 텍스트 추출.
표 셀에 콘텐츠 삽입
테이블 셀에 쓰려면 InsertTextRequest를 사용합니다. 업데이트하려는 셀 내의 색인으로 이동합니다. 테이블 색인은 업데이트된 텍스트를 사용합니다. 마찬가지로 DeleteContentRangeRequest.
열 속성 수정
이 UpdateTableColumnPropertiesRequest 를 사용하면 테이블에 있는 하나 이상의 열 속성을 수정할 수 있습니다.
테이블의 시작 색인과 함께 TableColumnProperties 객체를 지정합니다. 선택한 열만 수정하려면 열 번호 목록을 request; 테이블의 모든 열을 수정하려면 빈 목록을 제공합니다.
다음 예는 테이블의 열 너비를 업데이트하여 모든 열을 설정합니다. 너비가 100pts인 다음 첫 번째 열의 너비를 200pt로 설정합니다.
자바
List<Request> requests = new ArrayList<>();
requests.add(
new Request()
.setUpdateTableColumnProperties(
new UpdateTableColumnPropertiesRequest()
.setTableStartLocation(
new Location()
.setIndex(2)
.setTabId(TAB_ID))
.setColumnIndices(null)
.setTableColumnProperties(
new TableColumnProperties()
.setWidthType("FIXED_WIDTH")
.setWidth(
new Dimension().setMagnitude(100d).setUnit("PT")))
.setFields("*")));
List<Integer> columnIndices = new ArrayList<>();
columnIndices.add(0);
requests.add(
new Request()
.setUpdateTableColumnProperties(
new UpdateTableColumnPropertiesRequest()
.setTableStartLocation(
new Location()
.setIndex(2)
.setTabId(TAB_ID))
.setColumnIndices(columnIndices)
.setTableColumnProperties(
new TableColumnProperties()
.setWidthType("FIXED_WIDTH")
.setWidth(
new Dimension().setMagnitude(200d).setUnit("PT")))
.setFields("*")));
BatchUpdateDocumentRequest body =
new BatchUpdateDocumentRequest().setRequests(requests);
BatchUpdateDocumentResponse response =
docsService.documents().batchUpdate(DOCUMENT_ID, body).execute();
Python
requests = [{
'updateTableColumnProperties': {
'tableStartLocation': {'index': 2, 'tabId': TAB_ID},
'columnIndices': [],
'tableColumnProperties': {
'widthType': 'FIXED_WIDTH',
'width': {
'magnitude': 100,
'unit': 'PT'
}
},
'fields': '*'
},
'updateTableColumnProperties': {
'tableStartLocation': {'index': 2, 'tabId': TAB_ID},
'columnIndices': [0],
'tableColumnProperties': {
'widthType': 'FIXED_WIDTH',
'width': {
'magnitude': 200,
'unit': 'PT'
}
},
'fields': '*'
},
}
]
result = service.documents().batchUpdate(documentId=DOCUMENT_ID, body={'requests': requests}).execute()
행 스타일 수정
UpdateTableRowsStyleRequest 를 사용하면 표에 있는 하나 이상의 행의 스타일을 수정할 수 있습니다.
테이블의 시작 색인과 함께 TableRowStyle 객체를 지정합니다. 선택한 행만 수정하려면 행 번호 목록을 request; 테이블의 모든 행을 수정하려면 빈 목록을 제공하세요.
다음 예는 테이블 3행의 최소 높이를 설정합니다.
자바
List<Integer> rowIndices = new ArrayList<>();
rowIndices.add(3);
List<Request> requests = new ArrayList<>();
requests.add(
new Request()
.setUpdateTableRowStyle(
new UpdateTableRowStyleRequest()
.setTableStartLocation(
new Location()
.setIndex(2)
.setTabId(TAB_ID))
.setRowIndices(rowIndices)
.setTableRowStyle(
new TableRowStyle()
.setMinRowHeight(
new Dimension().setMagnitude(18d).setUnit("PT")))
.setFields("*")));
BatchUpdateDocumentRequest body =
new BatchUpdateDocumentRequest().setRequests(requests);
BatchUpdateDocumentResponse response =
docsService.documents().batchUpdate(DOCUMENT_ID, body).execute();
Python
requests = [{
'updateTableRowStyle': {
'tableStartLocation': {'index': 2, 'tabId': TAB_ID},
'rowIndices': [3],
'tableRowStyle': {
'minRowHeight': {
'magnitude': 18,
'unit': 'PT'
}
},
'fields': '*'
},
}
]
result = service.documents().batchUpdate(documentId=DOCUMENT_ID, body={'requests': requests}).execute()