데이터 작업

Google Sheets API를 사용하면 스프레드시트 내의 데이터를 다양한 형식으로 조작할 수 있습니다. 있습니다. Sheets UI는 또한 Sheets API를 사용합니다. 이 페이지의 예시를 통해 일반적인 스프레드시트 작업을 수행했습니다.

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

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

범위에 데이터 확인 적용

다음 spreadsheets.batchUpdate 코드 샘플을 사용하여 SetDataValidationRequest 데이터 확인 규칙을 적용할 수 있습니다. 여기서 '값 > 5"를 A1:D10 범위의 모든 셀에 추가합니다.

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

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
  "requests": [
    {
      "setDataValidation": {
        "range": {
          "sheetId": SHEET_ID,
          "startRowIndex": 0,
          "endRowIndex": 10,
          "startColumnIndex": 0,
          "endColumnIndex": 4
        },
        "rule": {
          "condition": {
            "type": "NUMBER_GREATER",
            "values": [
              {
                "userEnteredValue": "5"
              }
            ]
          },
          "inputMessage": "Value must be > 5",
          "strict": true
        }
      }
    }
  ]
}

복사 및 셀 서식 붙여넣기

다음 spreadsheets.batchUpdate 코드 샘플을 사용하여 CopyPasteRequest A1:D10 범위에서만 서식을 복사하고 F1:I10 범위에 붙여넣습니다. 할 수 있습니다. 이 메서드는 PasteType enum PASTE_FORMAT를 사용하여 서식 및 데이터 확인만 붙여넣습니다. 이 A1:D10의 원래 값은 변경되지 않습니다.

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

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
  "requests": [
    {
      "copyPaste": {
        "source": {
          "sheetId": SHEET_ID,
          "startRowIndex": 0,
          "endRowIndex": 10,
          "startColumnIndex": 0,
          "endColumnIndex": 4
        },
        "destination": {
          "sheetId": SHEET_ID,
          "startRowIndex": 0,
          "endRowIndex": 10,
          "startColumnIndex": 5,
          "endColumnIndex": 9
        },
        "pasteType": "PASTE_FORMAT",
        "pasteOrientation": "NORMAL"
      }
    }
  ]
}

자르기 및 셀 붙여넣기

다음 spreadsheets.batchUpdate 코드 샘플을 사용하여 CutPasteRequest A1:D10 범위를 줄이고 PasteType enum PASTE_NORMAL를 사용하여 해당 값, 수식, 서식을 지정하고 동일한 시트의 F1:I10 범위입니다. 원본 소스 범위의 셀 내용은 삭제되었습니다.

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

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
  "requests": [
    {
      "cutPaste": {
        "source": {
          "sheetId": SHEET_ID,
          "startRowIndex": 0,
          "endRowIndex": 10,
          "startColumnIndex": 0,
          "endColumnIndex": 4
        },
        "destination": {
          "sheetId": SHEET_ID,
          "rowIndex": 0,
          "columnIndex": 5
        },
        "pasteType": "PASTE_NORMAL"
      }
    }
  ]
}

범위에 대해 수식 반복

다음 spreadsheets.batchUpdate 코드 샘플을 사용하여 RepeatCellRequest =FLOOR(A1*PI()) 수식을 B1:D10 범위에 복사합니다. 수식의 범위 범위의 각 행과 열에 대해 자동으로 증가하며 왼쪽 위 셀 예를 들어 B1 셀은 =FLOOR(A1*PI()) 수식을 가지고 있고, D6 셀은 =FLOOR(C6*PI()) 공식을 가지고 있습니다.

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

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
  "requests": [
    {
      "repeatCell": {
        "range": {
          "sheetId": SHEET_ID,
          "startRowIndex": 0,
          "endRowIndex": 10,
          "startColumnIndex": 1,
          "endColumnIndex": 4
        },
        "cell": {
          "userEnteredValue": {
              "formulaValue": "=FLOOR(A1*PI())"
          }
        },
        "fields": "userEnteredValue"
      }
    }
  ]
}

여러 정렬 사양으로 범위 정렬

다음 spreadsheets.batchUpdate 코드 샘플을 사용하여 SortRangeRequest 를 눌러 A1:D10 범위를 정렬합니다. 먼저 B열을 오름차순으로 정렬한 다음 C열을 기준으로 정렬합니다. 내림차순으로 정렬한 다음 D열을 내림차순으로 정렬합니다.

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

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
  "requests": [
    {
      "sortRange": {
        "range": {
          "sheetId": SHEET_ID,
          "startRowIndex": 0,
          "endRowIndex": 10,
          "startColumnIndex": 0,
          "endColumnIndex": 4
        },
        "sortSpecs": [
          {
            "dimensionIndex": 1,
            "sortOrder": "ASCENDING"
          },
          {
            "dimensionIndex": 2,
            "sortOrder": "DESCENDING"
          },
          {
            "dimensionIndex": 3,
            "sortOrder": "DESCENDING"
          }
        ]
      }
    }
  ]
}