이 페이지는 Cloud Translation API를 통해 번역되었습니다.

시트 작업

Google Sheets API를 사용하면 시트를 만들고, 삭제하고, 복사하고, 삭제할 뿐만 아니라 속성을 제어할 수 있습니다. 이 페이지의 예제는 일반적인 Sheets 작업을 Sheets API를 사용합니다.

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

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

시트 추가

다음 spreadsheets.batchUpdate 코드 샘플을 사용하여 AddSheetRequest 시트를 스프레드시트에 추가하고 제목, 그리드 크기 및 탭 색상

응답은 AddSheetResponse님, 여기에는 생성된 시트의 속성 (예: SHEET_ID).

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

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate

{
  "requests": [
    {
      "addSheet": {
        "properties": {
          "title": "Deposits",
          "gridProperties": {
            "rowCount": 20,
            "columnCount": 12
          },
          "tabColor": {
            "red": 1.0,
            "green": 0.3,
            "blue": 0.4
          }
        }
      }
    }
  ]
}

형식을 유지하면서 시트의 모든 값 지우기

다음 spreadsheets.batchUpdate 코드 샘플을 사용하여 UpdateCellsRequest 서식은 그대로 두고 시트에서 모든 값을 삭제합니다.

이 userEnteredValue 필드 해당 값이 없으면 값을 지우는 명령으로 해석됩니다. 있습니다. 이 설정은 다른 필드에도 사용할 수 있습니다. 예를 들어 fields 값을 다음으로 변경 userEnteredFormat 삭제 Sheets API에서 지원하는 모든 서식 지정 하지만 셀 값은 변경되지 않은 상태로 둡니다.

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

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate

{
  "requests": [
    {
      "updateCells": {
        "range": {
          "sheetId": SHEET_ID
        },
        "fields": "userEnteredValue"
      }
    }
  ]
}

한 스프레드시트에서 다른 스프레드시트로 시트 복사

다음 spreadsheet.sheets.copyTo SHEET_ID로 지정된 단일 시트를 복사하는 방법을 보여주는 코드 샘플 다른 스프레드시트로 변환할 수 있습니다.

요청 본문의 TARGET_SPREADSHEET_ID 변수는 할 수 있습니다. 사본에는 모든 값, 서식, 수식 및 영향을 주지 않습니다. 복사된 시트의 제목이 '복사'로 설정되어 있습니다. [원본 시트 제목]'

응답은 SheetProperties 생성된 시트의 속성을 설명하는 객체입니다.

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID/sheets/SHEET_ID:copyTo

{
  "destinationSpreadsheetId": "TARGET_SPREADSHEET_ID"
}

시트 삭제

다음 spreadsheets.batchUpdate 코드 샘플을 사용하여 DeleteSheetRequest SHEET_ID로 지정된 시트를 삭제합니다.

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

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate

{
  "requests": [
    {
      "deleteSheet": {
        "sheetId": SHEET_ID
      }
    }
  ]
}

시트 데이터 읽기

다음 spreadsheets.get 코드 샘플 시트 속성 정보를 가져오는 방법 설명 SHEET_ID에서 지정한 스프레드시트에서 및 SPREADSHEET_ID 이 방법은 시트의 메타데이터를 생성하여 추가 작업으로 선택합니다. fields 쿼리 매개변수는 시트 속성만 지정 데이터가 반환되어야 함 (셀 값 데이터 또는 전체 스프레드시트)

GET https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID?&fields=sheets.properties

응답은 Spreadsheet 이 리소스에는 Sheet 객체를 SheetProperties 요소 지정된 응답 필드가 기본값으로 설정된 경우 생략됩니다. 삭제합니다.

{
  "sheets": [
    {
      "properties": {
        "sheetId": SHEET_ID,
        "title": "Sheet1",
        "index": 0,
        "sheetType": "GRID",
        "gridProperties": {
          "rowCount": 100,
          "columnCount": 20,
          "frozenRowCount": 1
        }
        "tabColor": {
          "blue": 1.0
        }
      },
      ...
  ],
}