Method: spreadsheets.batchUpdate

스프레드시트에 하나 이상의 업데이트를 적용합니다.

각 request는 적용되기 전에 검증됩니다. 요청이 유효하지 않으면 전체 요청이 실패하고 아무것도 적용되지 않습니다.

일부 요청에는 적용 방법에 관한 정보를 제공하는 replies가 있습니다. 답글은 요청을 미러링합니다. 예를 들어 업데이트를 4개 적용했는데 세 번째 업데이트에 답장이 있는 경우 응답에는 빈 답글 2개, 실제 답글, 빈 답글 1개가 순서대로 포함됩니다.

스프레드시트의 공동작업 특성상 이 작업이 완료된 후 스프레드시트에 변경사항이 정확하게 반영되지 않을 수 있지만 요청의 업데이트는 원자적으로 함께 적용됩니다. 공동작업자 변경사항에 따라 변경사항이 변경될 수 있습니다. 공동작업자가 없는 경우 스프레드시트에 변경사항이 반영됩니다.

HTTP 요청

POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}:batchUpdate

URL은 gRPC 트랜스코딩 문법을 사용합니다.

경로 매개변수

매개변수
spreadsheetId

string

업데이트를 적용할 스프레드시트입니다.

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "requests": [
    {
      object (Request)
    }
  ],
  "includeSpreadsheetInResponse": boolean,
  "responseRanges": [
    string
  ],
  "responseIncludeGridData": boolean
}
필드
requests[]

object (Request)

스프레드시트에 적용할 업데이트 목록입니다. 요청은 지정된 순서대로 적용됩니다. 요청이 유효하지 않으면 요청이 적용되지 않습니다.
includeSpreadsheetInResponse

boolean

업데이트 응답에 스프레드시트 리소스를 포함해야 하는지 결정합니다.
responseRanges[]

string

응답 스프레드시트에 포함된 범위를 제한합니다. includeSpreadsheetInResponse이 'true'인 경우에만 의미가 있습니다.
responseIncludeGridData

boolean

그리드 데이터를 반환해야 하는 경우 true입니다. includeSpreadsheetInResponse이 'true'인 경우에만 의미가 있습니다. 요청에 필드 마스크가 설정된 경우 이 매개변수는 무시됩니다.

응답 본문

스프레드시트 일괄 업데이트에 대한 답장입니다.

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현 
{
  "spreadsheetId": string,
  "replies": [
    {
      object (Response)
    }
  ],
  "updatedSpreadsheet": {
    object (Spreadsheet)
  }
}
필드
spreadsheetId

string

업데이트가 적용된 스프레드시트입니다.
replies[]

object (Response)

업데이트의 답장입니다. 일부 요청에 대한 답변은 비어 있을 수 있지만 업데이트와 1:1로 매핑됩니다.
updatedSpreadsheet

object (Spreadsheet)

업데이트가 적용된 후의 스프레드시트입니다. BatchUpdateSpreadsheetRequest.include_spreadsheet_in_response이 true인 경우에만 설정됩니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/spreadsheets

자세한 내용은 승인 가이드를 참고하세요.

요청

스프레드시트에 적용할 단일 업데이트 유형입니다.

JSON 표현 
{

  // Union field kind can be only one of the following:
  "updateSpreadsheetProperties": {
    object (UpdateSpreadsheetPropertiesRequest)
  },
  "updateSheetProperties": {
    object (UpdateSheetPropertiesRequest)
  },
  "updateDimensionProperties": {
    object (UpdateDimensionPropertiesRequest)
  },
  "updateNamedRange": {
    object (UpdateNamedRangeRequest)
  },
  "repeatCell": {
    object (RepeatCellRequest)
  },
  "addNamedRange": {
    object (AddNamedRangeRequest)
  },
  "deleteNamedRange": {
    object (DeleteNamedRangeRequest)
  },
  "addSheet": {
    object (AddSheetRequest)
  },
  "deleteSheet": {
    object (DeleteSheetRequest)
  },
  "autoFill": {
    object (AutoFillRequest)
  },
  "cutPaste": {
    object (CutPasteRequest)
  },
  "copyPaste": {
    object (CopyPasteRequest)
  },
  "mergeCells": {
    object (MergeCellsRequest)
  },
  "unmergeCells": {
    object (UnmergeCellsRequest)
  },
  "updateBorders": {
    object (UpdateBordersRequest)
  },
  "updateCells": {
    object (UpdateCellsRequest)
  },
  "addFilterView": {
    object (AddFilterViewRequest)
  },
  "appendCells": {
    object (AppendCellsRequest)
  },
  "clearBasicFilter": {
    object (ClearBasicFilterRequest)
  },
  "deleteDimension": {
    object (DeleteDimensionRequest)
  },
  "deleteEmbeddedObject": {
    object (DeleteEmbeddedObjectRequest)
  },
  "deleteFilterView": {
    object (DeleteFilterViewRequest)
  },
  "duplicateFilterView": {
    object (DuplicateFilterViewRequest)
  },
  "duplicateSheet": {
    object (DuplicateSheetRequest)
  },
  "findReplace": {
    object (FindReplaceRequest)
  },
  "insertDimension": {
    object (InsertDimensionRequest)
  },
  "insertRange": {
    object (InsertRangeRequest)
  },
  "moveDimension": {
    object (MoveDimensionRequest)
  },
  "updateEmbeddedObjectPosition": {
    object (UpdateEmbeddedObjectPositionRequest)
  },
  "pasteData": {
    object (PasteDataRequest)
  },
  "textToColumns": {
    object (TextToColumnsRequest)
  },
  "updateFilterView": {
    object (UpdateFilterViewRequest)
  },
  "deleteRange": {
    object (DeleteRangeRequest)
  },
  "appendDimension": {
    object (AppendDimensionRequest)
  },
  "addConditionalFormatRule": {
    object (AddConditionalFormatRuleRequest)
  },
  "updateConditionalFormatRule": {
    object (UpdateConditionalFormatRuleRequest)
  },
  "deleteConditionalFormatRule": {
    object (DeleteConditionalFormatRuleRequest)
  },
  "sortRange": {
    object (SortRangeRequest)
  },
  "setDataValidation": {
    object (SetDataValidationRequest)
  },
  "setBasicFilter": {
    object (SetBasicFilterRequest)
  },
  "addProtectedRange": {
    object (AddProtectedRangeRequest)
  },
  "updateProtectedRange": {
    object (UpdateProtectedRangeRequest)
  },
  "deleteProtectedRange": {
    object (DeleteProtectedRangeRequest)
  },
  "autoResizeDimensions": {
    object (AutoResizeDimensionsRequest)
  },
  "addChart": {
    object (AddChartRequest)
  },
  "updateChartSpec": {
    object (UpdateChartSpecRequest)
  },
  "updateBanding": {
    object (UpdateBandingRequest)
  },
  "addBanding": {
    object (AddBandingRequest)
  },
  "deleteBanding": {
    object (DeleteBandingRequest)
  },
  "createDeveloperMetadata": {
    object (CreateDeveloperMetadataRequest)
  },
  "updateDeveloperMetadata": {
    object (UpdateDeveloperMetadataRequest)
  },
  "deleteDeveloperMetadata": {
    object (DeleteDeveloperMetadataRequest)
  },
  "randomizeRange": {
    object (RandomizeRangeRequest)
  },
  "addDimensionGroup": {
    object (AddDimensionGroupRequest)
  },
  "deleteDimensionGroup": {
    object (DeleteDimensionGroupRequest)
  },
  "updateDimensionGroup": {
    object (UpdateDimensionGroupRequest)
  },
  "trimWhitespace": {
    object (TrimWhitespaceRequest)
  },
  "deleteDuplicates": {
    object (DeleteDuplicatesRequest)
  },
  "updateEmbeddedObjectBorder": {
    object (UpdateEmbeddedObjectBorderRequest)
  },
  "addSlicer": {
    object (AddSlicerRequest)
  },
  "updateSlicerSpec": {
    object (UpdateSlicerSpecRequest)
  },
  "addDataSource": {
    object (AddDataSourceRequest)
  },
  "updateDataSource": {
    object (UpdateDataSourceRequest)
  },
  "deleteDataSource": {
    object (DeleteDataSourceRequest)
  },
  "refreshDataSource": {
    object (RefreshDataSourceRequest)
  },
  "cancelDataSourceRefresh": {
    object (CancelDataSourceRefreshRequest)
  },
  "addTable": {
    object (AddTableRequest)
  },
  "updateTable": {
    object (UpdateTableRequest)
  },
  "deleteTable": {
    object (DeleteTableRequest)
  }
  // End of list of possible types for union field kind.
}
필드
통합 필드 kind. 업데이트 유형입니다. 필드는 정확히 하나만 필요합니다. kind은 다음 중 하나여야 합니다.
updateSpreadsheetProperties

object (UpdateSpreadsheetPropertiesRequest)

스프레드시트의 속성을 업데이트합니다.
updateSheetProperties

object (UpdateSheetPropertiesRequest)

시트의 속성을 업데이트합니다.
updateDimensionProperties

object (UpdateDimensionPropertiesRequest)

측정기준의 속성을 업데이트합니다.
updateNamedRange

object (UpdateNamedRangeRequest)

이름이 지정된 범위를 업데이트합니다.
repeatCell

object (RepeatCellRequest)

범위에서 단일 셀을 반복합니다.
addNamedRange

object (AddNamedRangeRequest)

이름이 지정된 범위를 추가합니다.
deleteNamedRange

object (DeleteNamedRangeRequest)

이름이 지정된 범위를 삭제합니다.
addSheet

object (AddSheetRequest)

시트를 추가합니다.
deleteSheet

object (DeleteSheetRequest)

시트를 삭제합니다.
autoFill

object (AutoFillRequest)

기존 데이터를 기반으로 더 많은 데이터를 자동으로 채웁니다.
cutPaste

object (CutPasteRequest)

한 영역에서 데이터를 잘라 다른 영역에 붙여넣습니다.
copyPaste

object (CopyPasteRequest)

한 영역의 데이터를 복사하여 다른 영역에 붙여넣습니다.
mergeCells

object (MergeCellsRequest)

셀을 병합합니다.
unmergeCells

object (UnmergeCellsRequest)

병합된 셀을 병합 취소합니다.
updateBorders

object (UpdateBordersRequest)

셀 범위의 테두리를 업데이트합니다.
updateCells

object (UpdateCellsRequest)

한 번에 여러 셀을 업데이트합니다.
addFilterView

object (AddFilterViewRequest)

필터 보기를 추가합니다.
appendCells

object (AppendCellsRequest)

시트에서 데이터가 포함된 마지막 행 뒤에 셀을 추가합니다.
clearBasicFilter

object (ClearBasicFilterRequest)

시트에서 기본 필터를 지웁니다.
deleteDimension

object (DeleteDimensionRequest)

시트에서 행 또는 열을 삭제합니다.
deleteEmbeddedObject

object (DeleteEmbeddedObjectRequest)

시트에서 삽입된 객체 (예: 차트, 이미지)를 삭제합니다.
deleteFilterView

object (DeleteFilterViewRequest)

시트에서 필터 보기를 삭제합니다.
duplicateFilterView

object (DuplicateFilterViewRequest)

필터 보기를 복제합니다.
duplicateSheet

object (DuplicateSheetRequest)

시트를 복제합니다.
findReplace

object (FindReplaceRequest)

특정 텍스트가 나오는 위치를 찾아 다른 텍스트로 바꿉니다.
insertDimension

object (InsertDimensionRequest)

시트에 새 행 또는 열을 삽입합니다.
insertRange

object (InsertRangeRequest)

시트에 새 셀을 삽입하여 기존 셀을 이동합니다.
moveDimension

object (MoveDimensionRequest)

시트의 다른 위치로 행 또는 열을 이동합니다.
updateEmbeddedObjectPosition

object (UpdateEmbeddedObjectPositionRequest)

삽입된 객체 (예: 차트, 이미지)의 위치를 업데이트합니다.
pasteData

object (PasteDataRequest)

시트에 데이터 (HTML 또는 구분된 데이터)를 붙여넣습니다.
textToColumns

object (TextToColumnsRequest)

텍스트 열을 여러 개의 텍스트 열로 변환합니다.
updateFilterView

object (UpdateFilterViewRequest)

필터 뷰의 속성을 업데이트합니다.
deleteRange

object (DeleteRangeRequest)

시트에서 셀 범위를 삭제하여 나머지 셀을 이동합니다.
appendDimension

object (AppendDimensionRequest)

시트 끝에 측정기준을 추가합니다.
addConditionalFormatRule

object (AddConditionalFormatRuleRequest)

새 조건부 서식 규칙을 추가합니다.
updateConditionalFormatRule

object (UpdateConditionalFormatRuleRequest)

기존 조건부 서식 규칙을 업데이트합니다.
deleteConditionalFormatRule

object (DeleteConditionalFormatRuleRequest)

기존 조건부 서식 규칙을 삭제합니다.
sortRange

object (SortRangeRequest)

범위 내 데이터를 정렬합니다.
setDataValidation

object (SetDataValidationRequest)

하나 이상의 셀에 데이터 유효성 검사를 설정합니다.
setBasicFilter

object (SetBasicFilterRequest)

시트에 기본 필터를 설정합니다.
addProtectedRange

object (AddProtectedRangeRequest)

보호된 범위를 추가합니다.
updateProtectedRange

object (UpdateProtectedRangeRequest)

보호된 범위를 업데이트합니다.
deleteProtectedRange

object (DeleteProtectedRangeRequest)

보호된 범위를 삭제합니다.
autoResizeDimensions

object (AutoResizeDimensionsRequest)

해당 측정기준의 셀 콘텐츠를 기반으로 하나 이상의 측정기준 크기를 자동으로 조절합니다.
addChart

object (AddChartRequest)

차트를 추가합니다.
updateChartSpec

object (UpdateChartSpecRequest)

차트 사양을 업데이트합니다.
updateBanding

object (UpdateBandingRequest)

범위가 지정된 범위 업데이트
addBanding

object (AddBandingRequest)

새 범위 표시
deleteBanding

object (DeleteBandingRequest)

밴딩된 범위를 삭제합니다.
createDeveloperMetadata

object (CreateDeveloperMetadataRequest)

새 개발자 메타데이터를 만듭니다.
updateDeveloperMetadata

object (UpdateDeveloperMetadataRequest)

기존 개발자 메타데이터 항목 업데이트
deleteDeveloperMetadata

object (DeleteDeveloperMetadataRequest)

개발자 메타데이터를 삭제합니다.
randomizeRange

object (RandomizeRangeRequest)

범위 내 행의 순서를 무작위로 지정합니다.
addDimensionGroup

object (AddDimensionGroupRequest)

지정된 범위 위에 그룹을 만듭니다.
deleteDimensionGroup

object (DeleteDimensionGroupRequest)

지정된 범위의 그룹을 삭제합니다.
updateDimensionGroup

object (UpdateDimensionGroupRequest)

지정된 그룹의 상태를 업데이트합니다.
trimWhitespace

object (TrimWhitespaceRequest)

공백 (예: 공백, 탭, 줄바꿈)의 셀을 자릅니다.
deleteDuplicates

object (DeleteDuplicatesRequest)

셀 범위의 지정된 열에 중복 값이 포함된 행을 삭제합니다.
updateEmbeddedObjectBorder

object (UpdateEmbeddedObjectBorderRequest)

삽입된 객체의 테두리를 업데이트합니다.
addSlicer

object (AddSlicerRequest)

슬라이서를 추가합니다.
updateSlicerSpec

object (UpdateSlicerSpecRequest)

슬라이서의 사양을 업데이트합니다.
addDataSource

object (AddDataSourceRequest)

데이터 소스를 추가합니다.
updateDataSource

object (UpdateDataSourceRequest)

데이터 소스를 업데이트합니다.
deleteDataSource

object (DeleteDataSourceRequest)

데이터 소스를 삭제합니다.
refreshDataSource

object (RefreshDataSourceRequest)

하나 이상의 데이터 소스 및 연결된 dbobject를 새로고침합니다.
cancelDataSourceRefresh

object (CancelDataSourceRefreshRequest)

하나 이상의 데이터 소스 및 연결된 dbobject의 새로고침을 취소합니다.
addTable

object (AddTableRequest)

표를 추가합니다.
updateTable

object (UpdateTableRequest)

테이블을 업데이트합니다.
deleteTable

object (DeleteTableRequest)

테이블 삭제 요청입니다.

UpdateSpreadsheetPropertiesRequest

스프레드시트의 속성을 업데이트합니다.

JSON 표현 
{
  "properties": {
    object (SpreadsheetProperties)
  },
  "fields": string
}
필드
properties

object (SpreadsheetProperties)

업데이트할 속성입니다.
fields

string (FieldMask format)

업데이트해야 하는 필드입니다. 하나 이상의 필드를 지정해야 합니다. 루트 'properties'는 암시되며 지정해서는 안 됩니다. 단일 "*"는 모든 필드를 나열하는 방법으로 사용할 수 있습니다.

UpdateSheetPropertiesRequest

지정된 sheetId로 시트의 속성을 업데이트합니다.

JSON 표현 
{
  "properties": {
    object (SheetProperties)
  },
  "fields": string
}
필드
properties

object (SheetProperties)

업데이트할 속성입니다.
fields

string (FieldMask format)

업데이트해야 하는 필드입니다. 하나 이상의 필드를 지정해야 합니다. 루트 properties는 암시되며 지정해서는 안 됩니다. 단일 "*"는 모든 필드를 나열하는 방법으로 사용할 수 있습니다.

UpdateDimensionPropertiesRequest

지정된 범위 내에서 측정기준의 속성을 업데이트합니다.

JSON 표현 
{
  "properties": {
    object (DimensionProperties)
  },
  "fields": string,

  // Union field dimension_range can be only one of the following:
  "range": {
    object (DimensionRange)
  },
  "dataSourceSheetRange": {
    object (DataSourceSheetDimensionRange)
  }
  // End of list of possible types for union field dimension_range.
}
필드
properties

object (DimensionProperties)

업데이트할 속성입니다.
fields

string (FieldMask format)

업데이트해야 하는 필드입니다. 하나 이상의 필드를 지정해야 합니다. 루트 properties는 암시되며 지정해서는 안 됩니다. 단일 "*"는 모든 필드를 나열하는 방법으로 사용할 수 있습니다.
통합 필드 dimension_range. 측정기준 범위입니다. dimension_range은 다음 중 하나여야 합니다.
range

object (DimensionRange)

업데이트할 행 또는 열입니다.
dataSourceSheetRange

object (DataSourceSheetDimensionRange)

업데이트할 데이터 소스 시트의 열입니다.

DataSourceSheetDimensionRange

DATA_SOURCE 시트의 단일 측정기준에 따른 범위입니다.

JSON 표현 
{
  "sheetId": integer,
  "columnReferences": [
    {
      object (DataSourceColumnReference)
    }
  ]
}
필드
sheetId

integer

범위가 있는 데이터 소스 시트의 ID입니다.
columnReferences[]

object (DataSourceColumnReference)

데이터 소스 시트의 열입니다.

UpdateNamedRangeRequest

지정된 namedRangeId로 이름이 지정된 범위의 속성을 업데이트합니다.

JSON 표현 
{
  "namedRange": {
    object (NamedRange)
  },
  "fields": string
}
필드
namedRange

object (NamedRange)

새 속성으로 업데이트할 이름이 지정된 범위입니다.
fields

string (FieldMask format)

업데이트해야 하는 필드입니다. 하나 이상의 필드를 지정해야 합니다. 루트 namedRange는 암시되며 지정해서는 안 됩니다. 단일 "*"는 모든 필드를 나열하는 방법으로 사용할 수 있습니다.

RepeatCellRequest

범위의 모든 셀을 지정된 Cell 객체의 값으로 업데이트합니다. fields 필드에 나열된 필드만 업데이트되고 나머지는 변경되지 않습니다.

수식으로 셀을 작성하면 범위의 각 필드에 대해 수식의 범위가 자동으로 증가합니다. 예를 들어 B2:C4 범위에 수식 =A1가 포함된 셀을 작성하면 B2는 =A1, B3는 =A2, B4는 =A3, C2는 =B1, C3는 =B2, C4는 =B3이 됩니다.

수식의 범위를 고정하려면 $ 표시기를 사용합니다. 예를 들어 =$A$1 수식을 사용하여 행과 열이 모두 증가하지 않도록 합니다.

JSON 표현 
{
  "range": {
    object (GridRange)
  },
  "cell": {
    object (CellData)
  },
  "fields": string
}
필드
range

object (GridRange)

셀을 반복할 범위입니다.
cell

object (CellData)

쓸 데이터입니다.
fields

string (FieldMask format)

업데이트해야 하는 필드입니다. 하나 이상의 필드를 지정해야 합니다. 루트 cell는 암시되며 지정해서는 안 됩니다. 단일 "*"는 모든 필드를 나열하는 방법으로 사용할 수 있습니다.

AddNamedRangeRequest

스프레드시트에 이름이 지정된 범위를 추가합니다.

JSON 표현 
{
  "namedRange": {
    object (NamedRange)
  }
}
필드
namedRange

object (NamedRange)

추가할 이름이 지정된 범위입니다. namedRangeId 필드는 선택사항입니다. 설정하지 않으면 ID가 무작위로 생성됩니다. 이미 존재하는 범위의 ID를 지정하면 오류가 발생합니다.

DeleteNamedRangeRequest

지정된 ID가 있는 이름이 지정된 범위를 스프레드시트에서 삭제합니다.

JSON 표현 
{
  "namedRangeId": string
}
필드
namedRangeId

string

삭제할 이름이 지정된 범위의 ID입니다.

AddSheetRequest

새 시트를 추가합니다. 시트가 지정된 색인에 추가되면 그 이후의 모든 시트 색인이 증가합니다. 객체 시트를 추가하려면 대신 AddChartRequest를 사용하고 EmbeddedObjectPosition.sheetId 또는 EmbeddedObjectPosition.newSheet를 지정합니다.

JSON 표현 
{
  "properties": {
    object (SheetProperties)
  }
}
필드
properties

object (SheetProperties)

새 시트에 있어야 하는 속성입니다. 모든 속성은 선택사항입니다. sheetId 필드는 선택사항입니다. 설정하지 않으면 ID가 무작위로 생성됩니다. 이미 존재하는 시트의 ID를 지정하면 오류가 발생합니다.

DeleteSheetRequest

요청된 시트를 삭제합니다.

JSON 표현 
{
  "sheetId": integer
}
필드
sheetId

integer

삭제할 시트의 ID입니다.

시트가 DATA_SOURCE 유형인 경우 연결된 DataSource도 삭제됩니다.

AutoFillRequest

기존 데이터를 기반으로 더 많은 데이터를 채웁니다.

JSON 표현 
{
  "useAlternateSeries": boolean,

  // Union field area can be only one of the following:
  "range": {
    object (GridRange)
  },
  "sourceAndDestination": {
    object (SourceAndDestination)
  }
  // End of list of possible types for union field area.
}
필드
useAlternateSeries

boolean

'대체' 시리즈로 데이터를 생성해야 하는 경우 true입니다. 이는 소스 데이터의 유형과 양에 따라 다릅니다.
통합 필드 area. 자동 완성할 영역입니다. area은 다음 중 하나여야 합니다.
range

object (GridRange)

자동 완성할 범위입니다. 이렇게 하면 범위를 검사하고 데이터가 있는 위치를 감지하여 나머지 범위에 해당 데이터를 자동으로 채웁니다.
sourceAndDestination

object (SourceAndDestination)

자동 완성할 소스 및 대상 영역입니다. 이렇게 하면 자동 완성의 소스와 해당 데이터를 확장할 위치가 명시적으로 표시됩니다.

SourceAndDestination

소스 범위와 소스를 확장하는 방법의 조합입니다.

JSON 표현 
{
  "source": {
    object (GridRange)
  },
  "dimension": enum (Dimension),
  "fillLength": integer
}
필드
source

object (GridRange)

자동 완성 소스로 사용할 데이터의 위치입니다.
dimension

enum (Dimension)

데이터를 채워야 하는 측정기준입니다.
fillLength

integer

데이터를 채워야 하는 행 또는 열의 수입니다. 양수는 소스의 마지막 행 또는 마지막 열을 넘어 확장됩니다. 음수는 소스의 첫 번째 행 또는 첫 번째 열 앞에 확장됩니다.

CutPasteRequest

소스에서 대상으로 데이터를 이동합니다.

JSON 표현 
{
  "source": {
    object (GridRange)
  },
  "destination": {
    object (GridCoordinate)
  },
  "pasteType": enum (PasteType)
}
필드
source

object (GridRange)

자르려는 소스 데이터입니다.
destination

object (GridCoordinate)

데이터를 붙여넣을 왼쪽 상단 좌표입니다.
pasteType

enum (PasteType)

붙여넣을 데이터의 유형 붙여넣은 내용과 관계없이 모든 소스 데이터가 잘립니다.

PasteType

어떤 종류의 데이터를 붙여넣어야 하나요?

열거형
PASTE_NORMAL 값, 수식, 형식, 병합을 붙여넣습니다.
PASTE_VALUES 서식, 수식, 병합 없이 값만 붙여넣습니다.
PASTE_FORMAT 형식 및 데이터 확인만 붙여넣습니다.
PASTE_NO_BORDERS PASTE_NORMAL와 같지만 테두리가 없습니다.
PASTE_FORMULA 수식만 붙여넣습니다.
PASTE_DATA_VALIDATION 데이터 확인만 붙여넣습니다.
PASTE_CONDITIONAL_FORMATTING 조건부 서식 규칙만 붙여넣습니다.

CopyPasteRequest

소스에서 대상에 데이터를 복사합니다.

JSON 표현 
{
  "source": {
    object (GridRange)
  },
  "destination": {
    object (GridRange)
  },
  "pasteType": enum (PasteType),
  "pasteOrientation": enum (PasteOrientation)
}
필드
source

object (GridRange)

복사할 소스 범위입니다.
destination

object (GridRange)

붙여넣을 위치입니다. 범위가 소스의 높이 또는 너비의 배수인 범위를 포함하는 경우 데이터가 반복되어 대상 범위를 채웁니다. 범위가 소스 범위보다 작은 경우에도 전체 소스 데이터가 대상 범위의 끝을 넘어 복사됩니다.
pasteType

enum (PasteType)

붙여넣을 데이터의 유형
pasteOrientation

enum (PasteOrientation)

붙여넣을 때 데이터의 방향

PasteOrientation

붙여넣기 작업을 실행하는 방법입니다.

열거형
NORMAL 평소와 같이 붙여넣습니다.
TRANSPOSE 전치된 붙여넣기: 모든 행이 열이 되고 열이 행이 됩니다.

MergeCellsRequest

범위의 모든 셀을 병합합니다.

JSON 표현 
{
  "range": {
    object (GridRange)
  },
  "mergeType": enum (MergeType)
}
필드
range

object (GridRange)

병합할 셀 범위입니다.
mergeType

enum (MergeType)

셀을 병합하는 방법입니다.

MergeType

만들 병합 유형입니다.

열거형
MERGE_ALL 범위에서 단일 병합 만들기
MERGE_COLUMNS 범위의 각 열에 대해 병합 만들기
MERGE_ROWS 범위의 각 행에 대해 병합 만들기

UnmergeCellsRequest

지정된 범위의 셀 병합을 해제합니다.

JSON 표현 
{
  "range": {
    object (GridRange)
  }
}
필드
range

object (GridRange)

모든 셀의 병합을 취소할 범위입니다. 범위가 여러 병합에 걸쳐 있는 경우 모두 병합 해제됩니다. 범위가 병합에 부분적으로 걸쳐서는 안 됩니다.

UpdateBordersRequest

범위의 테두리를 업데이트합니다. 요청에 필드가 설정되지 않으면 경계가 그대로 유지됩니다. 예를 들어 두 개의 후속 UpdateBordersRequest를 사용합니다.

  1. 범위: A1:A5 { top: RED, bottom: WHITE }
  2. 범위: A1:A5 { left: BLUE }

그러면 A1:A5에 { top: RED, bottom: WHITE, left: BLUE } 테두리가 적용됩니다. 테두리를 지우려면 스타일을 NONE로 명시적으로 설정합니다.

JSON 표현 
{
  "range": {
    object (GridRange)
  },
  "top": {
    object (Border)
  },
  "bottom": {
    object (Border)
  },
  "left": {
    object (Border)
  },
  "right": {
    object (Border)
  },
  "innerHorizontal": {
    object (Border)
  },
  "innerVertical": {
    object (Border)
  }
}
필드
range

object (GridRange)

테두리를 업데이트해야 하는 범위입니다.
top

object (Border)

범위 상단에 배치할 테두리입니다.
bottom

object (Border)

범위 하단에 배치할 테두리입니다.
left

object (Border)

범위의 왼쪽에 배치할 테두리입니다.
right

object (Border)

범위의 오른쪽에 배치할 테두리입니다.
innerHorizontal

object (Border)

범위 내에 배치할 가로 테두리입니다.
innerVertical

object (Border)

범위 내에 배치할 세로 테두리입니다.

UpdateCellsRequest

범위의 모든 셀을 새 데이터로 업데이트합니다.

JSON 표현 
{
  "rows": [
    {
      object (RowData)
    }
  ],
  "fields": string,

  // Union field area can be only one of the following:
  "start": {
    object (GridCoordinate)
  },
  "range": {
    object (GridRange)
  }
  // End of list of possible types for union field area.
}
필드
rows[]

object (RowData)

쓸 데이터입니다.
fields

string (FieldMask format)

업데이트해야 하는 CellData의 필드입니다. 하나 이상의 필드를 지정해야 합니다. 루트는 CellData입니다. 'row.values'는 지정해서는 안 됩니다. 단일 "*"는 모든 필드를 나열하는 방법으로 사용할 수 있습니다.
통합 필드 area. 위치 데이터를 작성해야 합니다. 정확히 하나의 값을 설정해야 합니다. area은 다음 중 하나여야 합니다.
start

object (GridCoordinate)

데이터 쓰기를 시작할 좌표입니다. 행당 열 수가 다른 경우를 포함하여 임의의 수의 행과 열을 쓸 수 있습니다.
range

object (GridRange)

데이터를 쓸 범위입니다.

행의 데이터가 요청된 전체 범위를 포함하지 않는 경우 fields에 설정된 필드와 일치하는 필드는 삭제됩니다.

AddFilterViewRequest

필터 보기를 추가합니다.

JSON 표현 
{
  "filter": {
    object (FilterView)
  }
}
필드
filter

object (FilterView)

추가할 필터입니다. filterViewId 필드는 선택사항입니다. 설정하지 않으면 ID가 무작위로 생성됩니다. 이미 존재하는 필터의 ID를 지정하면 오류가 발생합니다.

AppendCellsRequest

시트의 데이터가 있는 마지막 행 뒤에 새 셀을 추가하고 필요한 경우 시트에 새 행을 삽입합니다.

JSON 표현 
{
  "sheetId": integer,
  "rows": [
    {
      object (RowData)
    }
  ],
  "fields": string,

  // Union field area can be only one of the following:
  "tableId": string
  // End of list of possible types for union field area.
}
필드
sheetId

integer

데이터를 추가할 시트 ID입니다.
rows[]

object (RowData)

추가할 데이터입니다.
fields

string (FieldMask format)

업데이트해야 하는 CellData의 필드입니다. 하나 이상의 필드를 지정해야 합니다. 루트는 CellData입니다. 'row.values'는 지정해서는 안 됩니다. 단일 "*"는 모든 필드를 나열하는 방법으로 사용할 수 있습니다.
통합 필드 area. 위치 데이터를 작성해야 합니다. area은 다음 중 하나여야 합니다.
tableId

string

데이터를 추가할 테이블의 ID입니다. 데이터는 테이블 본문에만 추가됩니다.

이 필드는 sheetId 필드보다 우선 적용됩니다.

ClearBasicFilterRequest

시트에 기본 필터가 있는 경우 삭제합니다.

JSON 표현 
{
  "sheetId": integer
}
필드
sheetId

integer

기본 필터를 지울 시트 ID입니다.

DeleteDimensionRequest

시트에서 측정기준을 삭제합니다.

JSON 표현 
{
  "range": {
    object (DimensionRange)
  }
}
필드
range

object (DimensionRange)

시트에서 삭제할 측정기준입니다.

DeleteEmbeddedObjectRequest

지정된 ID가 있는 삽입된 객체를 삭제합니다.

JSON 표현 
{
  "objectId": integer
}
필드
objectId

integer

삭제할 삽입된 객체의 ID입니다.

DeleteFilterViewRequest

특정 필터 뷰를 삭제합니다.

JSON 표현 
{
  "filterId": integer
}
필드
filterId

integer

삭제할 필터의 ID입니다.

DuplicateFilterViewRequest

특정 필터 보기를 복제합니다.

JSON 표현 
{
  "filterId": integer
}
필드
filterId

integer

중복되는 필터의 ID입니다.

DuplicateSheetRequest

시트의 콘텐츠를 복제합니다.

JSON 표현 
{
  "sourceSheetId": integer,
  "insertSheetIndex": integer,
  "newSheetId": integer,
  "newSheetName": string
}
필드
sourceSheetId

integer

복제할 시트입니다.

소스 시트가 DATA_SOURCE 유형인 경우 백킹 DataSource도 복제되어 시트의 새 사본과 연결됩니다. 데이터 실행이 트리거되지 않으며 이 시트의 그리드 데이터도 복사되지만 일괄 요청이 완료된 후에만 사용할 수 있습니다.
insertSheetIndex

integer

새 시트를 삽입할 0부터 시작하는 색인입니다. 이후의 모든 시트 색인이 증가합니다.
newSheetId

integer

설정된 경우 새 시트의 ID입니다. 설정하지 않으면 ID가 선택됩니다. 설정된 경우 ID가 기존 시트 ID와 충돌해서는 안 됩니다. 설정된 경우 음수가 아니어야 합니다.
newSheetName

string

새 시트의 이름입니다. 이 필드를 비워두면 새 이름이 자동으로 선택됩니다.

FindReplaceRequest

범위, 시트 또는 모든 시트의 셀에서 데이터를 찾아 바꿉니다.

JSON 표현 
{
  "find": string,
  "replacement": string,
  "matchCase": boolean,
  "matchEntireCell": boolean,
  "searchByRegex": boolean,
  "includeFormulas": boolean,

  // Union field scope can be only one of the following:
  "range": {
    object (GridRange)
  },
  "sheetId": integer,
  "allSheets": boolean
  // End of list of possible types for union field scope.
}
필드
find

string

검색할 값입니다.
replacement

string

대체 값으로 사용할 값입니다.
matchCase

boolean

검색 시 대소문자를 구분하는 경우 true입니다.
matchEntireCell

boolean

찾을 값이 전체 셀과 일치해야 하는 경우 true입니다.
searchByRegex

boolean

찾을 값이 정규식이면 true입니다. 정규 표현식 및 대체는 https://docs.oracle.com/javase/8/docs/api/java/util/regex/Pattern.html의 Java 정규식 규칙을 따라야 합니다. 대체 문자열은 캡처 그룹을 참조할 수 있습니다. 예를 들어 한 셀에 "Google Sheets" 콘텐츠가 있고 다른 셀에 "Google Docs" 콘텐츠가 있는 경우 "$1 Rocks"로 대체하여 "o.* (.*)"를 검색하면 셀의 콘텐츠가 각각 "GSheets Rocks" 및 "GDocs Rocks"로 변경됩니다.
includeFormulas

boolean

수식이 포함된 셀을 검색에 포함해야 하는 경우 true입니다. 수식이 있는 셀을 건너뛰려면 False입니다.
통합 필드 scope. 찾기/바꾸기를 실행할 범위입니다. 하나만 설정해야 합니다. scope은 다음 중 하나여야 합니다.
range

object (GridRange)

찾기/바꾸기를 실행할 범위입니다.
sheetId

integer

찾기/바꾸기를 실행할 시트입니다.
allSheets

boolean

모든 시트에서 찾기/바꾸기를 실행하려면 true입니다.

InsertDimensionRequest

시트의 특정 색인에 행 또는 열을 삽입합니다.

JSON 표현 
{
  "range": {
    object (DimensionRange)
  },
  "inheritFromBefore": boolean
}
필드
range

object (DimensionRange)

삽입할 측정기준입니다. 시작 색인과 종료 색인은 모두 경계가 있어야 합니다.
inheritFromBefore

boolean

측정기준 속성을 새로 삽입된 측정기준 전 또는 후에 있는 측정기준에서 확장해야 하는지 여부입니다. 이전 측정기준에서 상속하려면 true를, 이후 측정기준에서 상속하려면 false를 지정합니다. 이 경우 시작 색인은 0보다 커야 합니다.

예를 들어 행 색인 0의 배경이 빨간색이고 행 색인 1의 배경이 녹색이면 색인 1에 행 2개를 삽입하면 녹색 또는 빨간색 배경을 상속받을 수 있습니다. inheritFromBefore가 true이면 두 개의 새 행이 빨간색이 되고 (삽입 지점 앞의 행이 빨간색이므로), inheritFromBefore가 false이면 두 개의 새 행이 녹색이 됩니다 (삽입 지점 뒤의 행이 녹색이므로).

InsertRangeRequest

범위에 셀을 삽입하여 기존 셀을 위 또는 아래로 이동합니다.

JSON 표현 
{
  "range": {
    object (GridRange)
  },
  "shiftDimension": enum (Dimension)
}
필드
range

object (GridRange)

새 셀을 삽입할 범위입니다. 범위는 현재 시트 경계로 제한됩니다.
shiftDimension

enum (Dimension)

셀을 삽입할 때 이동되는 크기입니다. ROWS인 경우 기존 셀이 아래로 이동합니다. COLUMNS인 경우 기존 셀이 오른쪽으로 이동합니다.

MoveDimensionRequest

하나 이상의 행 또는 열을 이동합니다.

JSON 표현 
{
  "source": {
    object (DimensionRange)
  },
  "destinationIndex": integer
}
필드
source

object (DimensionRange)

이동할 소스 측정기준입니다.
destinationIndex

integer

소스 데이터가 그리드에서 삭제되기 전의 좌표를 기준으로 소스 데이터를 이동할 위치의 0 기반 시작 색인입니다. 이동된 측정기준을 배치할 공간을 만들기 위해 기존 데이터가 측정기준에 따라 아래쪽 또는 오른쪽으로 이동합니다. 소스 측정기준은 그리드에서 삭제되므로 데이터가 지정된 것과 다른 색인에 표시될 수 있습니다.

예를 들어 0, 1, 2, 3, 4의 A1..A5가 주어지고 "1" 및 "2"를 "3"와 "4" 사이로 이동하려는 경우 소스는 ROWS [1..3)이고 대상 색인은 "4" (5번 행의 0 기반 색인)입니다. 최종 결과는 0, 3, 1, 2, 4의 A1..A5입니다.

UpdateEmbeddedObjectPositionRequest

삽입된 객체의 위치를 업데이트합니다 (예: 차트 또는 이미지 이동 또는 크기 조정).

JSON 표현 
{
  "objectId": integer,
  "newPosition": {
    object (EmbeddedObjectPosition)
  },
  "fields": string
}
필드
objectId

integer

이동할 객체의 ID입니다.
newPosition

object (EmbeddedObjectPosition)

삽입된 객체를 이동할 명시적 위치입니다. newPosition.sheetId가 설정되면 해당 ID로 새 시트가 생성됩니다. newPosition.newSheet가 true로 설정되면 자동으로 선택된 ID로 새 시트가 생성됩니다.
fields

string (FieldMask format)

새 위치를 설정할 때 업데이트해야 하는 OverlayPosition의 필드입니다. newPosition.overlayPosition가 설정된 경우에만 사용되며 이 경우 하나 이상의 필드를 지정해야 합니다. 루트 newPosition.overlayPosition는 암시되며 지정해서는 안 됩니다. 단일 "*"는 모든 필드를 나열하는 방법으로 사용할 수 있습니다.

PasteDataRequest

지정된 좌표에서 시작하여 스프레드시트에 데이터를 삽입합니다.

JSON 표현 
{
  "coordinate": {
    object (GridCoordinate)
  },
  "data": string,
  "type": enum (PasteType),

  // Union field kind can be only one of the following:
  "delimiter": string,
  "html": boolean
  // End of list of possible types for union field kind.
}
필드
coordinate

object (GridCoordinate)

데이터 삽입을 시작해야 하는 좌표입니다.
data

string

삽입할 데이터입니다.
type

enum (PasteType)

데이터를 붙여넣는 방법
통합 필드 kind. 데이터를 해석하는 방법입니다. 정확히 하나의 값을 설정해야 합니다. kind은 다음 중 하나여야 합니다.
delimiter

string

데이터의 구분자입니다.
html

boolean

데이터가 HTML인 경우 true입니다.

TextToColumnsRequest

각 셀의 구분 기호를 기준으로 텍스트 열을 여러 열로 분할합니다.

JSON 표현 
{
  "source": {
    object (GridRange)
  },
  "delimiter": string,
  "delimiterType": enum (DelimiterType)
}
필드
source

object (GridRange)

소스 데이터 범위입니다. 이 값은 정확히 하나의 열에 걸쳐야 합니다.
delimiter

string

사용할 구분자입니다. delimiterType이 CUSTOM인 경우에만 사용됩니다.
delimiterType

enum (DelimiterType)

사용할 구분자 유형입니다.

DelimiterType

분할할 구분 기호입니다.

열거형
DELIMITER_TYPE_UNSPECIFIED 기본값 이 값은 사용하면 안 됩니다.
COMMA ","
SEMICOLON ";"
PERIOD "."
SPACE " "
CUSTOM 구분 기호에 정의된 맞춤 값입니다.
AUTODETECT 열을 자동으로 감지합니다.

UpdateFilterViewRequest

필터 뷰의 속성을 업데이트합니다.

JSON 표현 
{
  "filter": {
    object (FilterView)
  },
  "fields": string
}
필드
filter

object (FilterView)

필터 보기의 새 속성입니다.
fields

string (FieldMask format)

업데이트해야 하는 필드입니다. 하나 이상의 필드를 지정해야 합니다. 루트 filter는 암시되며 지정해서는 안 됩니다. 단일 "*"는 모든 필드를 나열하는 방법으로 사용할 수 있습니다.

DeleteRangeRequest

셀 범위를 삭제하여 다른 셀을 삭제된 영역으로 이동합니다.

JSON 표현 
{
  "range": {
    object (GridRange)
  },
  "shiftDimension": enum (Dimension)
}
필드
range

object (GridRange)

삭제할 셀 범위입니다.
shiftDimension

enum (Dimension)

삭제된 셀을 대체할 측정기준입니다. ROWS인 경우 기존 셀이 위로 이동하여 삭제된 셀을 대체합니다. COLUMNS인 경우 기존 셀이 왼쪽으로 이동하여 삭제된 셀을 대체합니다.

AppendDimensionRequest

시트 끝에 행 또는 열을 추가합니다.

JSON 표현 
{
  "sheetId": integer,
  "dimension": enum (Dimension),
  "length": integer
}
필드
sheetId

integer

행 또는 열을 추가할 시트입니다.
dimension

enum (Dimension)

행 또는 열을 추가할지 여부입니다.
length

integer

추가할 행 또는 열의 수입니다.

AddConditionalFormatRuleRequest

지정된 색인에 새 조건부 서식 규칙을 추가합니다. 이후의 모든 규칙 색인이 증가합니다.

JSON 표현 
{
  "rule": {
    object (ConditionalFormatRule)
  },
  "index": integer
}
필드
rule

object (ConditionalFormatRule)

추가할 규칙입니다.
index

integer

규칙을 삽입해야 하는 색인으로, 0부터 시작합니다.

UpdateConditionalFormatRuleRequest

지정된 색인에서 조건부 서식 규칙을 업데이트하거나 조건부 서식 규칙을 다른 색인으로 이동합니다.

JSON 표현 
{
  "index": integer,
  "sheetId": integer,

  // Union field instruction can be only one of the following:
  "rule": {
    object (ConditionalFormatRule)
  },
  "newIndex": integer
  // End of list of possible types for union field instruction.
}
필드
index

integer

대체하거나 이동할 규칙의 0부터 시작하는 색인입니다.
sheetId

integer

이동할 규칙의 시트입니다. newIndex가 설정된 경우 필수이며, 그렇지 않으면 사용되지 않습니다.
통합 필드 instruction. 실행해야 하는 업데이트 유형입니다. instruction은 다음 중 하나여야 합니다.
rule

object (ConditionalFormatRule)

지정된 색인의 규칙을 대체할 규칙입니다.
newIndex

integer

규칙이 종료되는 0부터 시작하는 새 색인입니다.

DeleteConditionalFormatRuleRequest

지정된 색인에서 조건부 서식 규칙을 삭제합니다. 이후의 모든 규칙 색인이 감소합니다.

JSON 표현 
{
  "index": integer,
  "sheetId": integer
}
필드
index

integer

삭제할 규칙의 0부터 시작하는 색인입니다.
sheetId

integer

규칙이 삭제되는 시트입니다.

SortRangeRequest

열별 정렬 순서에 따라 행의 데이터를 정렬합니다.

JSON 표현 
{
  "range": {
    object (GridRange)
  },
  "sortSpecs": [
    {
      object (SortSpec)
    }
  ]
}
필드
range

object (GridRange)

정렬할 범위입니다.
sortSpecs[]

object (SortSpec)

열별 정렬 순서입니다. 이후 사양은 이전 사양에서 값이 동일한 경우에 사용됩니다.

SetDataValidationRequest

범위의 모든 셀에 데이터 유효성 검사 규칙을 설정합니다. 범위에서 유효성 검사를 지우려면 규칙을 지정하지 않고 이 메서드를 호출합니다.

JSON 표현 
{
  "range": {
    object (GridRange)
  },
  "rule": {
    object (DataValidationRule)
  },
  "filteredRowsIncluded": boolean
}
필드
range

object (GridRange)

데이터 확인 규칙이 적용될 범위입니다.
rule

object (DataValidationRule)

범위의 각 셀에 설정할 데이터 유효성 검사 규칙 또는 범위의 데이터 유효성 검사를 삭제하기 위해 비워 둡니다.
filteredRowsIncluded

boolean

선택사항입니다. 이 값이 true이면 데이터 유효성 검사 규칙이 필터링된 행에도 적용됩니다.

SetBasicFilterRequest

시트와 연결된 기본 필터를 설정합니다.

JSON 표현 
{
  "filter": {
    object (BasicFilter)
  }
}
필드
filter

object (BasicFilter)

설정할 필터입니다.

AddProtectedRangeRequest

새 보호 범위를 추가합니다.

JSON 표현 
{
  "protectedRange": {
    object (ProtectedRange)
  }
}
필드
protectedRange

object (ProtectedRange)

추가할 보호된 범위입니다. protectedRangeId 필드는 선택사항입니다. 설정하지 않으면 ID가 무작위로 생성됩니다. 이미 존재하는 범위의 ID를 지정하면 오류가 발생합니다.

UpdateProtectedRangeRequest

지정된 protectedRangeId로 기존 보호 범위를 업데이트합니다.

JSON 표현 
{
  "protectedRange": {
    object (ProtectedRange)
  },
  "fields": string
}
필드
protectedRange

object (ProtectedRange)

새 속성으로 업데이트할 보호된 범위입니다.
fields

string (FieldMask format)

업데이트해야 하는 필드입니다. 하나 이상의 필드를 지정해야 합니다. 루트 protectedRange는 암시되며 지정해서는 안 됩니다. 단일 "*"는 모든 필드를 나열하는 방법으로 사용할 수 있습니다.

DeleteProtectedRangeRequest

지정된 ID로 보호된 범위를 삭제합니다.

JSON 표현 
{
  "protectedRangeId": integer
}
필드
protectedRangeId

integer

삭제할 보호된 범위의 ID입니다.

AutoResizeDimensionsRequest

해당 측정기준의 셀 콘텐츠를 기반으로 하나 이상의 측정기준 크기를 자동으로 조절합니다.

JSON 표현 
{

  // Union field dimension_range can be only one of the following:
  "dimensions": {
    object (DimensionRange)
  },
  "dataSourceSheetDimensions": {
    object (DataSourceSheetDimensionRange)
  }
  // End of list of possible types for union field dimension_range.
}
필드
통합 필드 dimension_range. 측정기준 범위입니다. dimension_range은 다음 중 하나여야 합니다.
dimensions

object (DimensionRange)

자동으로 크기를 조정할 크기입니다.
dataSourceSheetDimensions

object (DataSourceSheetDimensionRange)

자동으로 크기를 조절할 데이터 소스 시트의 측정기준입니다.

AddChartRequest

스프레드시트의 시트에 차트를 추가합니다.

JSON 표현 
{
  "chart": {
    object (EmbeddedChart)
  }
}
필드
chart

object (EmbeddedChart)

스프레드시트에 추가해야 하는 차트(배치할 위치 포함) chartId 필드는 선택사항입니다. 설정하지 않으면 ID가 무작위로 생성됩니다. 이미 존재하는 삽입된 객체의 ID를 지정하면 오류가 발생합니다.

UpdateChartSpecRequest

차트 사양을 업데이트합니다. 이렇게 해도 차트가 이동하거나 크기가 조정되지는 않습니다. 차트를 이동하거나 크기를 조절하려면 UpdateEmbeddedObjectPositionRequest를 사용합니다.)

JSON 표현 
{
  "chartId": integer,
  "spec": {
    object (ChartSpec)
  }
}
필드
chartId

integer

업데이트할 차트의 ID입니다.
spec

object (ChartSpec)

차트에 적용할 사양입니다.

UpdateBandingRequest

제공된 번들 범위의 속성을 업데이트합니다.

JSON 표현 
{
  "bandedRange": {
    object (BandedRange)
  },
  "fields": string
}
필드
bandedRange

object (BandedRange)

새 속성으로 업데이트할 번들 범위입니다.
fields

string (FieldMask format)

업데이트해야 하는 필드입니다. 하나 이상의 필드를 지정해야 합니다. 루트 bandedRange는 암시되며 지정해서는 안 됩니다. 단일 "*"는 모든 필드를 나열하는 방법으로 사용할 수 있습니다.

AddBandingRequest

스프레드시트에 새 밴딩 범위를 추가합니다.

JSON 표현 
{
  "bandedRange": {
    object (BandedRange)
  }
}
필드
bandedRange

object (BandedRange)

추가할 범위입니다. bandedRangeId 필드는 선택사항입니다. 설정하지 않으면 ID가 무작위로 생성됩니다. 이미 존재하는 범위의 ID를 지정하면 오류가 발생합니다.

DeleteBandingRequest

스프레드시트에서 지정된 ID가 있는 번들 범위를 삭제합니다.

JSON 표현 
{
  "bandedRangeId": integer
}
필드
bandedRangeId

integer

삭제할 범위의 ID입니다.

CreateDeveloperMetadataRequest

개발자 메타데이터를 만들기 위한 요청입니다.

JSON 표현 
{
  "developerMetadata": {
    object (DeveloperMetadata)
  }
}
필드
developerMetadata

object (DeveloperMetadata)

생성할 개발자 메타데이터입니다.

UpdateDeveloperMetadataRequest

개발자 메타데이터의 속성을 업데이트하기 위한 요청입니다. 필터에 의해 선택된 개발자 메타데이터의 속성을 DeveloperMetadata 리소스에 제공된 값으로 업데이트합니다. 호출자는 fields 매개변수에서 업데이트할 속성을 지정하고 업데이트할 메타데이터와 일치하는 DataFilter를 하나 이상 지정해야 합니다.

JSON 표현 
{
  "dataFilters": [
    {
      object (DataFilter)
    }
  ],
  "developerMetadata": {
    object (DeveloperMetadata)
  },
  "fields": string
}
필드
dataFilters[]

object (DataFilter)

업데이트할 개발자 메타데이터 항목과 일치하는 필터입니다.
developerMetadata

object (DeveloperMetadata)

데이터 필터와 일치하는 모든 메타데이터가 업데이트되는 값입니다.
fields

string (FieldMask format)

업데이트해야 하는 필드입니다. 하나 이상의 필드를 지정해야 합니다. 루트 developerMetadata는 암시되며 지정해서는 안 됩니다. 단일 "*"는 모든 필드를 나열하는 방법으로 사용할 수 있습니다.

DeleteDeveloperMetadataRequest

개발자 메타데이터 삭제 요청입니다.

JSON 표현 
{
  "dataFilter": {
    object (DataFilter)
  }
}
필드
dataFilter

object (DataFilter)

삭제할 개발자 메타데이터 항목을 선택하는 데 사용되는 기준을 설명하는 데이터 필터입니다.

RandomizeRangeRequest

범위 내 행의 순서를 무작위로 지정합니다.

JSON 표현 
{
  "range": {
    object (GridRange)
  }
}
필드
range

object (GridRange)

무작위로 지정할 범위입니다.

AddDimensionGroupRequest

지정된 범위 위에 그룹을 만듭니다.

요청된 범위가 기존 그룹 G의 범위의 상위 집합인 경우 G의 깊이가 증가하고 이 새 그룹 G'에는 해당 그룹의 깊이가 있습니다. 예를 들어 그룹 [C:D, depth 1] + [B:E] 는 그룹 [B:E, depth 1] 및 [C:D, depth 2]가 됩니다. 요청된 범위가 기존 그룹 G의 범위의 하위 집합인 경우 새 그룹 G'의 깊이는 G의 깊이보다 1이 더 커집니다. 예를 들어 그룹 [B:E, 깊이 1] + [C:D] 는 그룹 [B:E, 깊이 1] 및 [C:D, 깊이 2]가 됩니다. 요청된 범위가 기존 그룹 G의 범위보다 먼저 시작되어 범위 내에 끝나거나 범위 내에 시작되어 범위보다 나중에 끝나는 경우 기존 그룹 G의 범위가 범위의 합집합이 되고 새 그룹 G'는 G의 깊이보다 1 더 큰 깊이를 가지며 범위가 범위의 교집합이 됩니다. 예를 들어 그룹 [B:D, 깊이 1] + [C:E] 는 그룹 [B:E, 깊이 1] 및 [C:D, 깊이 2]가 됩니다.

JSON 표현 
{
  "range": {
    object (DimensionRange)
  }
}
필드
range

object (DimensionRange)

그룹을 만들 범위입니다.

DeleteDimensionGroupRequest

지정된 범위의 측정기준 깊이를 감소시켜 지정된 범위의 그룹을 삭제합니다.

예를 들어 시트에 B:E에 깊이 1 그룹이 있고 C:D에 깊이 2 그룹이 있다고 가정해 보겠습니다. D:E의 그룹을 삭제하면 시트에 B:D의 깊이 1 그룹과 C:C의 깊이 2 그룹이 남게 됩니다.

JSON 표현 
{
  "range": {
    object (DimensionRange)
  }
}
필드
range

object (DimensionRange)

삭제할 그룹의 범위입니다.

UpdateDimensionGroupRequest

지정된 그룹의 상태를 업데이트합니다.

JSON 표현 
{
  "dimensionGroup": {
    object (DimensionGroup)
  },
  "fields": string
}
필드
dimensionGroup

object (DimensionGroup)

상태를 업데이트해야 하는 그룹입니다. 그룹의 범위와 깊이는 시트에서 유효한 그룹을 지정해야 하며 다른 모든 필드는 업데이트됩니다.
fields

string (FieldMask format)

업데이트해야 하는 필드입니다. 하나 이상의 필드를 지정해야 합니다. 루트 dimensionGroup는 암시되며 지정해서는 안 됩니다. 단일 "*"는 모든 필드를 나열하는 방법으로 사용할 수 있습니다.

TrimWhitespaceRequest

지정된 범위의 모든 셀에서 공백 (예: 공백, 탭, 줄바꿈)을 자릅니다. 이 요청은 각 셀의 텍스트 시작과 끝에서 모든 공백을 삭제하고 남은 공백 문자의 하위 시퀀스를 단일 공백으로 줄입니다. 잘린 텍스트가 '+' 또는 '=' 문자로 시작하는 경우 텍스트는 문자열 값으로 유지되며 수식으로 해석되지 않습니다.

JSON 표현 
{
  "range": {
    object (GridRange)
  }
}
필드
range

object (GridRange)

셀을 자르려는 범위입니다.

DeleteDuplicatesRequest

지정된 열에 이전 행의 값과 중복되는 값이 포함된 이 범위 내 행을 삭제합니다. 값은 동일하지만 대소문자, 형식, 수식이 다른 행도 중복으로 간주됩니다.

이 요청은 필터로 인해 뷰에서 숨겨진 중복 행도 삭제합니다. 중복을 삭제할 때는 위에서 아래로 스캔하는 각 중복 행의 첫 번째 인스턴스가 결과 범위에 유지됩니다. 지정된 범위 외부의 콘텐츠는 삭제되지 않으며 중복으로 간주되는 행은 범위 내에서 서로 인접하지 않아도 됩니다.

JSON 표현 
{
  "range": {
    object (GridRange)
  },
  "comparisonColumns": [
    {
      object (DimensionRange)
    }
  ]
}
필드
range

object (GridRange)

중복 행을 삭제할 범위입니다.
comparisonColumns[]

object (DimensionRange)

중복 값을 분석할 범위의 열입니다. 열을 선택하지 않으면 모든 열에서 중복을 분석합니다.

UpdateEmbeddedObjectBorderRequest

삽입된 객체의 테두리 속성을 업데이트합니다.

JSON 표현 
{
  "objectId": integer,
  "border": {
    object (EmbeddedObjectBorder)
  },
  "fields": string
}
필드
objectId

integer

업데이트할 삽입된 객체의 ID입니다.
border

object (EmbeddedObjectBorder)

삽입된 객체에 적용되는 테두리입니다.
fields

string (FieldMask format)

업데이트해야 하는 필드입니다. 하나 이상의 필드를 지정해야 합니다. 루트 border는 암시되며 지정해서는 안 됩니다. 단일 "*"는 모든 필드를 나열하는 방법으로 사용할 수 있습니다.

AddSlicerRequest

스프레드시트의 시트에 슬라이서를 추가합니다.

JSON 표현 
{
  "slicer": {
    object (Slicer)
  }
}
필드
slicer

object (Slicer)

스프레드시트에 추가해야 하는 슬라이서(위치 포함)입니다. slicerId 필드는 선택사항입니다. 설정하지 않으면 ID가 무작위로 생성됩니다. 이미 존재하는 슬라이서의 ID를 지정하면 오류가 발생합니다.

UpdateSlicerSpecRequest

슬라이서의 사양을 업데이트합니다. 슬라이서를 이동하거나 크기를 조정하지 않습니다. 슬라이서를 이동하거나 크기를 조절하려면 UpdateEmbeddedObjectPositionRequest를 사용합니다.

JSON 표현 
{
  "slicerId": integer,
  "spec": {
    object (SlicerSpec)
  },
  "fields": string
}
필드
slicerId

integer

업데이트할 슬라이서의 ID입니다.
spec

object (SlicerSpec)

슬라이서에 적용할 사양입니다.
fields

string (FieldMask format)

업데이트해야 하는 필드입니다. 하나 이상의 필드를 지정해야 합니다. 루트 SlicerSpec는 암시되며 지정해서는 안 됩니다. 단일 '*'는 모든 필드를 나열하는 방법으로 사용할 수 있습니다.

AddDataSourceRequest

데이터 소스를 추가합니다. 데이터 소스가 추가되면 연결된 DATA_SOURCE 시트가 생성되고 시트를 새로고침하여 데이터 소스에서 데이터를 읽도록 실행이 트리거됩니다.

BigQuery 데이터 소스를 추가하는 경우 요청에 bigquery.readonly OAuth 범위가 추가로 필요합니다.

JSON 표현 
{
  "dataSource": {
    object (DataSource)
  }
}
필드
dataSource

object (DataSource)

추가할 데이터 소스입니다.

UpdateDataSourceRequest

데이터 소스를 업데이트합니다. 데이터 소스가 업데이트되면 연결된 DATA_SOURCE 시트를 새로고침하여 업데이트된 데이터 소스에서 데이터를 읽도록 실행이 트리거됩니다.

BigQuery 데이터 소스를 업데이트하는 경우 요청에 bigquery.readonly OAuth 범위가 추가로 필요합니다.

JSON 표현 
{
  "dataSource": {
    object (DataSource)
  },
  "fields": string
}
필드
dataSource

object (DataSource)

업데이트할 데이터 소스입니다.
fields

string (FieldMask format)

업데이트해야 하는 필드입니다. 하나 이상의 필드를 지정해야 합니다. 루트 dataSource는 암시되며 지정해서는 안 됩니다. 단일 "*"는 모든 필드를 나열하는 방법으로 사용할 수 있습니다.

DeleteDataSourceRequest

데이터 소스를 삭제합니다. 또한 이 요청은 연결된 데이터 소스 시트를 삭제하고 연결된 모든 데이터 소스 객체의 연결을 해제합니다.

JSON 표현 
{
  "dataSourceId": string
}
필드
dataSourceId

string

삭제할 데이터 소스의 ID입니다.

RefreshDataSourceRequest

지정된 참조를 사용하여 스프레드시트에서 하나 이상의 데이터 소스 객체를 새로고침합니다.

BigQuery 데이터 소스를 새로고침하는 경우 요청에 bigquery.readonly OAuth 범위가 추가로 필요합니다.

한 번의 일괄 처리에서 동일한 데이터 소스 객체를 참조하는 여러 새로고침 요청이 있는 경우 마지막 새로고침 요청만 처리되며 이러한 모든 요청에 동일한 응답이 반환됩니다.

JSON 표현 
{
  "force": boolean,

  // Union field target can be only one of the following:
  "references": {
    object (DataSourceObjectReferences)
  },
  "dataSourceId": string,
  "isAll": boolean
  // End of list of possible types for union field target.
}
필드
force

boolean

현재 상태와 관계없이 데이터 소스 객체를 새로고침합니다. 설정되지 않았고 참조된 데이터 소스 객체가 오류 상태인 경우 새로고침이 즉시 실패합니다.
통합 필드 target. 새로고침할 항목을 지정합니다. target은 다음 중 하나여야 합니다.
references

object (DataSourceObjectReferences)

새로고침할 데이터 소스 객체 참조입니다.
dataSourceId

string

DataSource 참조 지정된 경우 데이터 소스의 연결된 모든 데이터 소스 객체를 새로고침합니다.
isAll

boolean

스프레드시트의 모든 기존 데이터 소스 객체를 새로고침합니다.

DataSourceObjectReferences

데이터 소스 객체에 대한 참조 목록입니다.

JSON 표현 
{
  "references": [
    {
      object (DataSourceObjectReference)
    }
  ]
}
필드
references[]

object (DataSourceObjectReference)

참조입니다.

DataSourceObjectReference

데이터 소스 객체 참조입니다.

JSON 표현 
{

  // Union field value can be only one of the following:
  "sheetId": string,
  "chartId": integer,
  "dataSourceTableAnchorCell": {
    object (GridCoordinate)
  },
  "dataSourcePivotTableAnchorCell": {
    object (GridCoordinate)
  },
  "dataSourceFormulaCell": {
    object (GridCoordinate)
  }
  // End of list of possible types for union field value.
}
필드
통합 필드 value. 참조 유형입니다. value은 다음 중 하나여야 합니다.
sheetId

string

DATA_SOURCE 시트 참조
chartId

integer

데이터 소스 차트에 대한 참조입니다.
dataSourceTableAnchorCell

object (GridCoordinate)

셀에 고정된 DataSourceTable에 대한 참조입니다.
dataSourcePivotTableAnchorCell

object (GridCoordinate)

셀에 고정된 데이터 소스 PivotTable 참조입니다.
dataSourceFormulaCell

object (GridCoordinate)

DataSourceFormula가 포함된 셀의 참조입니다.

CancelDataSourceRefreshRequest

지정된 참조에 따라 스프레드시트에서 데이터 소스 객체의 새로고침을 하나 이상 취소합니다.

BigQuery 데이터 소스의 새로고침을 취소하는 경우 요청에 bigquery.readonly OAuth 범위가 추가로 필요합니다.

JSON 표현 
{

  // Union field target can be only one of the following:
  "references": {
    object (DataSourceObjectReferences)
  },
  "dataSourceId": string,
  "isAll": boolean
  // End of list of possible types for union field target.
}
필드
통합 필드 target. 취소할 항목을 지정합니다. target은 다음 중 하나여야 합니다.
references

object (DataSourceObjectReferences)

새로고침이 취소될 데이터 소스 객체 참조입니다.
dataSourceId

string

DataSource 참조 지정된 경우 이 데이터 소스의 연결된 모든 데이터 소스 객체 새로고침을 취소합니다.
isAll

boolean

스프레드시트의 모든 데이터 소스에 대해 기존의 모든 데이터 소스 객체 새로고침을 취소합니다.

AddTableRequest

스프레드시트에 새 테이블을 추가합니다.

JSON 표현 
{
  "table": {
    object (Table)
  }
}
필드
table

object (Table)

필수 항목입니다. 추가할 테이블입니다.

UpdateTableRequest

스프레드시트의 테이블을 업데이트합니다.

JSON 표현 
{
  "table": {
    object (Table)
  },
  "fields": string
}
필드
table

object (Table)

필수 항목입니다. 업데이트할 테이블입니다.
fields

string (FieldMask format)

필수 항목입니다. 업데이트해야 하는 필드입니다. 하나 이상의 필드를 지정해야 합니다. 루트 table는 암시되며 지정해서는 안 됩니다. 단일 "*"는 모든 필드를 나열하는 방법으로 사용할 수 있습니다.

DeleteTableRequest

스프레드시트에서 지정된 ID의 테이블을 삭제합니다.

JSON 표현 
{
  "tableId": string
}
필드
tableId

string

삭제할 테이블의 ID입니다.

응답

업데이트의 단일 응답입니다.

JSON 표현 
{

  // Union field kind can be only one of the following:
  "addNamedRange": {
    object (AddNamedRangeResponse)
  },
  "addSheet": {
    object (AddSheetResponse)
  },
  "addFilterView": {
    object (AddFilterViewResponse)
  },
  "duplicateFilterView": {
    object (DuplicateFilterViewResponse)
  },
  "duplicateSheet": {
    object (DuplicateSheetResponse)
  },
  "findReplace": {
    object (FindReplaceResponse)
  },
  "updateEmbeddedObjectPosition": {
    object (UpdateEmbeddedObjectPositionResponse)
  },
  "updateConditionalFormatRule": {
    object (UpdateConditionalFormatRuleResponse)
  },
  "deleteConditionalFormatRule": {
    object (DeleteConditionalFormatRuleResponse)
  },
  "addProtectedRange": {
    object (AddProtectedRangeResponse)
  },
  "addChart": {
    object (AddChartResponse)
  },
  "addBanding": {
    object (AddBandingResponse)
  },
  "createDeveloperMetadata": {
    object (CreateDeveloperMetadataResponse)
  },
  "updateDeveloperMetadata": {
    object (UpdateDeveloperMetadataResponse)
  },
  "deleteDeveloperMetadata": {
    object (DeleteDeveloperMetadataResponse)
  },
  "addDimensionGroup": {
    object (AddDimensionGroupResponse)
  },
  "deleteDimensionGroup": {
    object (DeleteDimensionGroupResponse)
  },
  "trimWhitespace": {
    object (TrimWhitespaceResponse)
  },
  "deleteDuplicates": {
    object (DeleteDuplicatesResponse)
  },
  "addSlicer": {
    object (AddSlicerResponse)
  },
  "addDataSource": {
    object (AddDataSourceResponse)
  },
  "updateDataSource": {
    object (UpdateDataSourceResponse)
  },
  "refreshDataSource": {
    object (RefreshDataSourceResponse)
  },
  "cancelDataSourceRefresh": {
    object (CancelDataSourceRefreshResponse)
  }
  // End of list of possible types for union field kind.
}
필드
통합 필드 kind. 답장 유형입니다. 요청에 응답이 없으면 설정된 필드가 없을 수 있습니다. kind은 다음 중 하나여야 합니다.
addNamedRange

object (AddNamedRangeResponse)

이름이 지정된 범위를 추가한 후의 답장입니다.
addSheet

object (AddSheetResponse)

시트 추가에 대한 답장입니다.
addFilterView

object (AddFilterViewResponse)

필터 보기 추가에 대한 답글입니다.
duplicateFilterView

object (DuplicateFilterViewResponse)

필터 보기를 복제한 후의 답장입니다.
duplicateSheet

object (DuplicateSheetResponse)

시트 복제에 대한 답장입니다.
findReplace

object (FindReplaceResponse)

찾기/바꾸기 작업의 답장입니다.
updateEmbeddedObjectPosition

object (UpdateEmbeddedObjectPositionResponse)

삽입된 객체의 위치를 업데이트한 후의 응답입니다.
updateConditionalFormatRule

object (UpdateConditionalFormatRuleResponse)

조건부 서식 규칙 업데이트의 답장입니다.
deleteConditionalFormatRule

object (DeleteConditionalFormatRuleResponse)

조건부 서식 규칙 삭제에 대한 답장입니다.
addProtectedRange

object (AddProtectedRangeResponse)

보호된 범위를 추가한 후의 답장입니다.
addChart

object (AddChartResponse)

차트 추가에 대한 답장입니다.
addBanding

object (AddBandingResponse)

범위가 지정된 범위를 추가한 후의 답글입니다.
createDeveloperMetadata

object (CreateDeveloperMetadataResponse)

개발자 메타데이터 항목 생성의 답장입니다.
updateDeveloperMetadata

object (UpdateDeveloperMetadataResponse)

개발자 메타데이터 항목 업데이트의 답장입니다.
deleteDeveloperMetadata

object (DeleteDeveloperMetadataResponse)

개발자 메타데이터 항목 삭제에 대한 답장입니다.
addDimensionGroup

object (AddDimensionGroupResponse)

측정기준 그룹 추가에 대한 답장입니다.
deleteDimensionGroup

object (DeleteDimensionGroupResponse)

측정기준 그룹 삭제에 대한 답글
trimWhitespace

object (TrimWhitespaceResponse)

공백을 잘라낸 답장입니다.
deleteDuplicates

object (DeleteDuplicatesResponse)

중복 값이 포함된 행을 삭제한 후의 응답입니다.
addSlicer

object (AddSlicerResponse)

슬라이서 추가에 대한 답장입니다.
addDataSource

object (AddDataSourceResponse)

데이터 소스 추가에 대한 답장입니다.
updateDataSource

object (UpdateDataSourceResponse)

데이터 소스 업데이트의 답장입니다.
refreshDataSource

object (RefreshDataSourceResponse)

데이터 소스 객체 새로고침의 응답입니다.
cancelDataSourceRefresh

object (CancelDataSourceRefreshResponse)

데이터 소스 객체 새로고침을 취소하는 응답입니다.

AddNamedRangeResponse

이름이 지정된 범위를 추가한 결과입니다.

JSON 표현 
{
  "namedRange": {
    object (NamedRange)
  }
}
필드
namedRange

object (NamedRange)

추가할 이름이 지정된 범위입니다.

AddSheetResponse

시트를 추가한 결과입니다.

JSON 표현 
{
  "properties": {
    object (SheetProperties)
  }
}
필드
properties

object (SheetProperties)

새로 추가된 시트의 속성입니다.

AddFilterViewResponse

필터 보기를 추가한 결과

JSON 표현 
{
  "filter": {
    object (FilterView)
  }
}
필드
filter

object (FilterView)

새로 추가된 필터 보기

DuplicateFilterViewResponse

필터 보기가 중복된 결과입니다.

JSON 표현 
{
  "filter": {
    object (FilterView)
  }
}
필드
filter

object (FilterView)

새로 만든 필터입니다.

DuplicateSheetResponse

시트를 복제한 결과입니다.

JSON 표현 
{
  "properties": {
    object (SheetProperties)
  }
}
필드
properties

object (SheetProperties)

중복 시트의 속성입니다.

FindReplaceResponse

찾기/바꾸기 결과입니다.

JSON 표현 
{
  "valuesChanged": integer,
  "formulasChanged": integer,
  "rowsChanged": integer,
  "sheetsChanged": integer,
  "occurrencesChanged": integer
}
필드
valuesChanged

integer

수식이 아닌 셀의 수가 변경되었습니다.
formulasChanged

integer

수식 셀 수가 변경되었습니다.
rowsChanged

integer

변경된 행 수입니다.
sheetsChanged

integer

시트 수가 변경되었습니다.
occurrencesChanged

integer

발생 횟수 (셀 내에 여러 개 있을 수 있음)가 변경되었습니다. 예를 들어 "Google Sheets"에서 "e"를 "o"로 대체하면 "Google Sheets" -> "Googlo Shoots"이므로 "3"이 됩니다.

UpdateEmbeddedObjectPositionResponse

삽입된 객체의 위치를 업데이트한 결과입니다.

JSON 표현 
{
  "position": {
    object (EmbeddedObjectPosition)
  }
}
필드
position

object (EmbeddedObjectPosition)

삽입된 객체의 새 위치입니다.

UpdateConditionalFormatRuleResponse

조건부 서식 규칙을 업데이트한 결과입니다.

JSON 표현 
{
  "newRule": {
    object (ConditionalFormatRule)
  },
  "newIndex": integer,

  // Union field old_info can be only one of the following:
  "oldRule": {
    object (ConditionalFormatRule)
  },
  "oldIndex": integer
  // End of list of possible types for union field old_info.
}
필드
newRule

object (ConditionalFormatRule)

이전 규칙을 대체한 새 규칙 (대체된 경우) 또는 이동된 규칙 (이동된 경우)
newIndex

integer

새 규칙의 색인입니다.
통합 필드 old_info. 이전 규칙에 관한 정보입니다. old_info은 다음 중 하나여야 합니다.
oldRule

object (ConditionalFormatRule)

이전 (삭제된) 규칙 규칙이 이동된 경우에는 설정되지 않습니다 (newRule과 동일하므로).
oldIndex

integer

규칙의 이전 색인입니다. 규칙이 대체된 경우에는 설정되지 않습니다 (newIndex와 동일하므로).

DeleteConditionalFormatRuleResponse

조건부 서식 규칙을 삭제한 결과입니다.

JSON 표현 
{
  "rule": {
    object (ConditionalFormatRule)
  }
}
필드
rule

object (ConditionalFormatRule)

삭제된 규칙

AddProtectedRangeResponse

새 보호 범위를 추가한 결과

JSON 표현 
{
  "protectedRange": {
    object (ProtectedRange)
  }
}
필드
protectedRange

object (ProtectedRange)

새로 추가된 보호된 범위입니다.

AddChartResponse

스프레드시트에 차트를 추가한 결과입니다.

JSON 표현 
{
  "chart": {
    object (EmbeddedChart)
  }
}
필드
chart

object (EmbeddedChart)

새로 추가된 차트

AddBandingResponse

밴딩된 범위를 추가한 결과입니다.

JSON 표현 
{
  "bandedRange": {
    object (BandedRange)
  }
}
필드
bandedRange

object (BandedRange)

추가된 밴딩된 범위입니다.

CreateDeveloperMetadataResponse

개발자 메타데이터 생성의 응답입니다.

JSON 표현 
{
  "developerMetadata": {
    object (DeveloperMetadata)
  }
}
필드
developerMetadata

object (DeveloperMetadata)

생성된 개발자 메타데이터입니다.

UpdateDeveloperMetadataResponse

개발자 메타데이터 업데이트의 응답입니다.

JSON 표현 
{
  "developerMetadata": [
    {
      object (DeveloperMetadata)
    }
  ]
}
필드
developerMetadata[]

object (DeveloperMetadata)

업데이트된 개발자 메타데이터입니다.

DeleteDeveloperMetadataResponse

개발자 메타데이터 삭제에 대한 응답입니다.

JSON 표현 
{
  "deletedDeveloperMetadata": [
    {
      object (DeveloperMetadata)
    }
  ]
}
필드
deletedDeveloperMetadata[]

object (DeveloperMetadata)

삭제된 메타데이터입니다.

AddDimensionGroupResponse

그룹 추가의 결과입니다.

JSON 표현 
{
  "dimensionGroups": [
    {
      object (DimensionGroup)
    }
  ]
}
필드
dimensionGroups[]

object (DimensionGroup)

측정기준에 그룹을 추가한 후 측정기준의 모든 그룹

DeleteDimensionGroupResponse

그룹 삭제의 결과입니다.

JSON 표현 
{
  "dimensionGroups": [
    {
      object (DimensionGroup)
    }
  ]
}
필드
dimensionGroups[]

object (DimensionGroup)

측정기준에서 그룹을 삭제한 후 측정기준의 모든 그룹

TrimWhitespaceResponse

셀에서 공백을 제거한 결과입니다.

JSON 표현 
{
  "cellsChangedCount": integer
}
필드
cellsChangedCount

integer

공백이 잘린 셀 수입니다.

DeleteDuplicatesResponse

범위에서 중복을 삭제한 결과입니다.

JSON 표현 
{
  "duplicatesRemovedCount": integer
}
필드
duplicatesRemovedCount

integer

삭제된 중복 행 수입니다.

AddSlicerResponse

스프레드시트에 슬라이서를 추가한 결과입니다.

JSON 표현 
{
  "slicer": {
    object (Slicer)
  }
}
필드
slicer

object (Slicer)

새로 추가된 슬라이서

AddDataSourceResponse

데이터 소스를 추가한 결과입니다.

JSON 표현 
{
  "dataSource": {
    object (DataSource)
  },
  "dataExecutionStatus": {
    object (DataExecutionStatus)
  }
}
필드
dataSource

object (DataSource)

생성된 데이터 소스입니다.
dataExecutionStatus

object (DataExecutionStatus)

데이터 실행 상태입니다.

UpdateDataSourceResponse

데이터 소스 업데이트의 응답입니다.

JSON 표현 
{
  "dataSource": {
    object (DataSource)
  },
  "dataExecutionStatus": {
    object (DataExecutionStatus)
  }
}
필드
dataSource

object (DataSource)

업데이트된 데이터 소스
dataExecutionStatus

object (DataExecutionStatus)

데이터 실행 상태입니다.

RefreshDataSourceResponse

하나 이상의 데이터 소스 객체를 새로고침한 결과입니다.

JSON 표현 
{
  "statuses": [
    {
      object (RefreshDataSourceObjectExecutionStatus)
    }
  ]
}
필드
statuses[]

object (RefreshDataSourceObjectExecutionStatus)

요청에 지정된 데이터 소스 객체 참조의 모든 새로고침 상태입니다. isAll가 지정되면 필드에 실패 상태인 항목만 포함됩니다.

RefreshDataSourceObjectExecutionStatus

하나의 데이터 소스 객체 새로고침의 실행 상태입니다.

JSON 표현 
{
  "reference": {
    object (DataSourceObjectReference)
  },
  "dataExecutionStatus": {
    object (DataExecutionStatus)
  }
}
필드
reference

object (DataSourceObjectReference)

새로고침 중인 데이터 소스 객체 참조입니다.
dataExecutionStatus

object (DataExecutionStatus)

데이터 실행 상태입니다.

CancelDataSourceRefreshResponse

하나 이상의 데이터 소스 객체 새로고침을 취소할 때의 응답입니다.

JSON 표현 
{
  "statuses": [
    {
      object (CancelDataSourceRefreshStatus)
    }
  ]
}
필드
statuses[]

object (CancelDataSourceRefreshStatus)

요청에 지정된 모든 데이터 소스 객체 새로고침의 취소 상태입니다. isAll가 지정되면 필드에 실패 상태인 항목만 포함됩니다. 동일한 batchUpdate에서 동일한 데이터 소스 객체를 새로고침하고 새로고침을 취소하는 것도 허용되지 않습니다.

CancelDataSourceRefreshStatus

단일 데이터 소스 객체 새로고침을 취소하는 상태입니다.

JSON 표현 
{
  "reference": {
    object (DataSourceObjectReference)
  },
  "refreshCancellationStatus": {
    object (RefreshCancellationStatus)
  }
}
필드
reference

object (DataSourceObjectReference)

새로고침이 취소되는 데이터 소스 객체 참조입니다.
refreshCancellationStatus

object (RefreshCancellationStatus)

취소 상태입니다.

RefreshCancellationStatus

새로고침 취소 상태입니다.

cancel request를 전송하여 하나 이상의 데이터 소스 객체 새로고침을 명시적으로 취소할 수 있습니다.

JSON 표현 
{
  "state": enum (RefreshCancellationState),
  "errorCode": enum (RefreshCancellationErrorCode)
}
필드
state

enum (RefreshCancellationState)

Sheets에서 새로고침을 취소하는 호출의 상태입니다.
errorCode

enum (RefreshCancellationErrorCode)

오류 코드입니다.

RefreshCancellationState

새로고침 취소 상태의 열거형입니다.

열거형
REFRESH_CANCELLATION_STATE_UNSPECIFIED 기본값이며 사용할 수 없습니다.
CANCEL_SUCCEEDED 새로고침을 취소하기 위한 Sheets API 호출이 완료되었습니다. 이는 취소가 완료되었다는 의미가 아니라 호출이 완료되었다는 의미입니다.
CANCEL_FAILED 새로고침을 취소하기 위한 Sheets API 호출에 실패했습니다.

RefreshCancellationErrorCode

새로고침 취소 오류 코드의 열거형입니다.

열거형
REFRESH_CANCELLATION_ERROR_CODE_UNSPECIFIED 기본값이며 사용할 수 없습니다.
EXECUTION_NOT_FOUND 취소할 실행이 쿼리 엔진 또는 Sheets에서 찾을 수 없습니다.
CANCEL_PERMISSION_DENIED 사용자에게 쿼리를 취소할 권한이 없습니다.
QUERY_EXECUTION_COMPLETED 쿼리 실행이 이미 완료되어 취소할 수 없습니다.
CONCURRENT_CANCELLATION 이미 다른 취소가 진행 중입니다.
CANCEL_OTHER_ERROR 기타 모든 오류.