표

이 가이드에서는 Google Sheets API를 사용하여 스프레드시트에서 표를 만드는 방법과 이유를 설명합니다.

테이블이란 무엇인가요?

표를 사용하면 데이터 생성을 간소화할 수 있으며 데이터 범위에 형식과 구조를 자동으로 적용하여 데이터 서식 지정, 입력, 업데이트를 반복할 필요가 줄어듭니다.

테이블에는 헤더, 바닥글, 열 유형, 필터, 뷰, 테이블 참조, 테이블 이름과 같은 여러 기능이 있습니다. 기능 공지사항에서 자세히 알아보고 Sheets에서 표를 사용하는 방법을 알아보세요.

프로젝트 추적, 이벤트 계획, 인벤토리 관리와 같은 작업에 표를 사용할 수 있습니다.

표 추가

테이블을 추가하려면 addTable 요청을 제공하는 batchUpdate 메서드를 사용합니다. 이 요청을 사용하여 스프레드시트에 표를 추가합니다.

다음 예에서는 지정된 range에 2개의 열이 설정된 'Project Tracker'라는 테이블을 만듭니다. 첫 번째 열에 비율 열이 있고 두 번째 열에 드롭다운 열 유형이 있습니다.

{
  "addTable": {
    "table": {
      "name": "Project Tracker",
      "tableId": "123",
      "range": {
        "sheetId": 0,
        "startColumnIndex": 0,
        "endColumnIndex": 5,
        "startRowIndex": 0,
        "endRowIndex": 5,
      },
      "columnProperties": [
        {
          "columnIndex": 0,
          "columnName": "Column 1",
          "columnType": "PERCENT"
        },
        {
          "columnIndex": 1,
          "columnName": "Column 2",
          "columnType": "DROPDOWN",
          "dataValidationRule": {
            "condition": {
              "type": "ONE_OF_LIST",
              "values": [
                {
                  "userEnteredValue": "Not Started"
                },
                {
                  "userEnteredValue": "In Progress"
                },
                {
                  "userEnteredValue": "Complete"
                }
              ]
            }
          }
        }
      ],
    }
  }
}

열 유형

테이블에는 숫자, 날짜, 드롭다운, 스마트 칩, 체크박스와 같은 열 유형이 있습니다. 평점 및 체크박스 열 유형은 각각 0 및 FALSE의 기본값으로 채워집니다.

드롭다운 열 유형은 칩 드롭다운을 만듭니다. 열 유형이 드롭다운으로 설정된 경우 열의 dataValidationRule는 ONE_OF_LIST 조건으로 설정해야 합니다. 다른 열 유형은 `dataValidationRule 필드를 설정하면 안 됩니다.

테이블 업데이트

spreadsheets.batchUpdate 메서드를 사용하고 UpdateTableRequest를 제공합니다.

표 크기 수정

UpdateTableRequest 메서드를 사용하여 테이블에 새 행/열을 추가해야 하는 range를 수정합니다.

테이블 내에 새 행 또는 열을 추가해야 하는 경우 InsertRangeRequest 또는 InsertDimensionRequest를 사용하세요.

테이블 행을 삭제해야 하는 경우 DeleteRangeRequest를 사용하고, 그렇지 않은 경우 DeleteDimensionRequest를 사용하여 스프레드시트에서 전체 행을 삭제할 수 있습니다.

바닥글을 추가하기 위해 바닥글이 없는 기존 테이블을 업데이트하는 경우 range가 1행 확장됩니다. 바닥글이 있는 기존 테이블을 업데이트하고 바닥글을 삭제하면 range가 1행씩 줄어듭니다.

테이블에 값 추가

tableId와 함께 AppendCellsRequest를 사용하여 테이블 끝에 행을 추가합니다. 이렇게 하면 값이 첫 번째 비어 있는 행에 추가되고 전체 행과 바닥글을 인식합니다. 빈 행이 없으면 테이블 끝과 바닥글 앞에 행이 삽입됩니다(해당하는 경우).

표 삭제

spreadsheets.batchUpdate 메서드를 사용하고 DeleteTableRequest를 제공합니다. DeleteTableRequest를 사용하여 전체 테이블과 테이블의 콘텐츠를 삭제합니다.

DeleteBandingRequest를 사용하여 테이블 형식을 삭제하지만 데이터는 유지합니다.

다른 Sheets 기능과 함께 표 사용하기

테이블을 지원하는 다른 API 기능에는 필터, 필터 보기, 보호된 범위가 있습니다.