행 및 열 작업

Google Sheets API를 사용하면 스프레드시트 내에서 행과 열을 추가, 삭제 및 조작할 수 할 수 있습니다. 이 페이지의 예는 몇 가지 일반적인 행과 열이 어떻게 Sheets API를 사용하여 수행할 수 있습니다.

이 예는 언어적 표현인 HTTP 요청의 형식으로 중립적입니다. 다음을 사용하여 다양한 언어로 일괄 업데이트를 구현하는 방법을 알아봅니다. 자세한 내용은 업데이트 스프레드시트를 사용합니다.

이 예에서 SPREADSHEET_IDSHEET_ID 자리표시자는 는 해당 ID를 제공할 위치를 나타냅니다. 스프레드시트 ID를 입력합니다. 얻을 수 있는 혜택 시트 IDspreadsheets.get 메서드를 사용하여 지도 가장자리에 패딩을 추가할 수 있습니다. 이 A1 표기법을 사용하여 범위를 지정합니다. 예시 범위는 Sheet1!A1:D5입니다.

열 너비 또는 행 높이 조정

다음 spreadsheets.batchUpdate 드림 코드 샘플을 사용하여 UpdateDimensionPropertiesRequest 를 눌러 A열의 너비 속성을 160픽셀로 업데이트합니다. 두 번째 요청은 첫 3행의 행 높이 속성을 40픽셀로 설정합니다. dimension 필드는 연산이 표의 열 또는 행에 적용되는지 여부를 결정합니다. 시트입니다.

요청 프로토콜은 아래와 같습니다.

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
  "requests": [
    {
      "updateDimensionProperties": {
        "range": {
          "sheetId": SHEET_ID,
          "dimension": "COLUMNS",
          "startIndex": 0,
          "endIndex": 1
        },
        "properties": {
          "pixelSize": 160
        },
        "fields": "pixelSize"
      }
    },
    {
      "updateDimensionProperties": {
        "range": {
          "sheetId": SHEET_ID,
          "dimension": "ROWS",
          "startIndex": 0,
          "endIndex": 3
        },
        "properties": {
          "pixelSize": 40
        },
        "fields": "pixelSize"
      }
    }
  ]
}

빈 행 또는 열 추가

다음 spreadsheets.batchUpdate 드림 코드 샘플을 사용하여 AppendDimensionRequest 행과 열을 추가합니다. 첫 번째 요청은 세 개의 빈 행을 두 번째는 빈 열 하나를 추가합니다. dimension 필드는 연산이 표의 열 또는 행에 적용되는지 여부를 결정합니다. 시트입니다.

요청 프로토콜은 아래와 같습니다.

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
  "requests": [
    {
      "appendDimension": {
        "sheetId": SHEET_ID,
        "dimension": "ROWS",
        "length": 3
      }
    },
    {
      "appendDimension": {
        "sheetId": SHEET_ID,
        "dimension": "COLUMNS",
        "length": 1
      }
    }
  ]
}

자동으로 열 크기 조정

다음 spreadsheets.batchUpdate 드림 코드 샘플을 사용하여 AutoResizeDimensionsRequest 열 콘텐츠의 크기에 따라 열 A:C의 크기를 조절합니다. dimension 필드는 작업이 시트의 열에 적용된다는 것을 나타냅니다.

요청 프로토콜은 아래와 같습니다.

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
  "requests": [
    {
      "autoResizeDimensions": {
        "dimensions": {
          "sheetId": SHEET_ID,
          "dimension": "COLUMNS",
          "startIndex": 0,
          "endIndex": 3
        }
      }
    }
  ]
}

자동으로 행 크기 조정

다음 spreadsheets.batchUpdate 드림 코드 샘플을 사용하여 AutoResizeDimensionsRequest 처음 세 행의 행 높이를 지웁니다. 그러면 행 높이가 각 행의 셀 내용에 따라 동적으로 생성됩니다. dimension 필드는 작업이 시트의 행에 적용된다는 것을 나타냅니다.

요청 프로토콜은 아래와 같습니다.

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
  "requests": [
    {
      "autoResizeDimensions": {
        "dimensions": {
          "sheetId": SHEET_ID,
          "dimension": "ROWS",
          "startIndex": 0,
          "endIndex": 3
        }
      }
    }
  ]
}

행 또는 열 삭제

다음 spreadsheets.batchUpdate 드림 코드 샘플을 사용하여 DeleteDimensionRequest 시트의 처음 세 행을 삭제합니다. 두 번째 요청은 B:D 열을 삭제합니다. dimension 필드는 작업을 열에 적용할지 아니면 다음 열에 적용할지를 결정합니다. 행입니다.

요청 프로토콜은 아래와 같습니다.

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
  "requests": [
    {
      "deleteDimension": {
        "range": {
          "sheetId": SHEET_ID,
          "dimension": "ROWS",
          "startIndex": 0,
          "endIndex": 3
        }
      }
    },
    {
      "deleteDimension": {
        "range": {
          "sheetId": SHEET_ID,
          "dimension": "COLUMNS",
          "startIndex": 1,
          "endIndex": 4
        }
      }
    },
  ],
}

빈 행 또는 열 삽입

다음 spreadsheets.batchUpdate 드림 코드 샘플을 사용하여 InsertDimensionRequest 특정 색인에 열이나 행을 삽입 (예: 빈 행 앞에 추가) 을 클릭합니다. 첫 번째 요청은 C열에 빈 열 두 개를 삽입합니다. 두 번째 요청은 1행부터 시작하여 세 개의 빈 행을 삽입합니다.

dimension 필드는 작업을 열에 적용할지 아니면 다음 열에 적용할지를 결정합니다. 행입니다.

true인 경우 inheritFromBefore 필드는 Sheets API에 다음을 제공하도록 지시합니다. 새 열이나 행에 이전 행 또는 열과 동일한 속성이 있으며 false로 설정하여 새 열 또는 행 다음의 측정기준에서 상속합니다. inheritFromBefore은 1행에 행을 삽입하거나 A열을 참조하세요.

요청 프로토콜은 아래와 같습니다.

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
  "requests": [
    {
      "insertDimension": {
        "range": {
          "sheetId": SHEET_ID,
          "dimension": "COLUMNS",
          "startIndex": 2,
          "endIndex": 4
        },
        "inheritFromBefore": true
      }
    },
    {
      "insertDimension": {
        "range": {
          "sheetId": SHEET_ID,
          "dimension": "ROWS",
          "startIndex": 0,
          "endIndex": 3
        },
        "inheritFromBefore": false
      }
    },
  ],
}

행 또는 열 이동

다음 spreadsheets.batchUpdate 드림 코드 샘플을 사용하여 MoveDimensionRequest A열을 D열 위치로 이동합니다. 두 번째 요청은 행을 이동함 행 20 위치까지 5~10개

dimension 필드는 작업을 열에 적용할지 아니면 다음 열에 적용할지를 결정합니다. 행입니다. destinationIndex 필드는 소스 데이터를 생성할 수 있습니다.

요청 프로토콜은 아래와 같습니다.

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
  "requests": [
    {
      "moveDimension": {
        "source": {
          "sheetId": SHEET_ID,
          "dimension": "COLUMNS",
          "startIndex": 0,
          "endIndex": 1
        },
        "destinationIndex": 3
      }
    },
    {
      "moveDimension": {
        "source": {
          "sheetId": SHEET_ID,
          "dimension": "ROWS",
          "startIndex": 4,
          "endIndex": 10
        },
        "destinationIndex": 19
      }
    },
  ],
}