Requests

요청

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

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)
  }
  // End of list of possible types for union field kind.
}
필드
공용체 필드 kind입니다. 업데이트 유형입니다. 필드는 정확히 1개만 필요합니다. 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의 새로고침을 취소합니다.

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
}
필드
sheetId

integer

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

rows[]

object (RowData)

추가할 데이터입니다.

fields

string (FieldMask format)

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

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" 콘텐츠가 있는 경우 "o.* (.*)"를 검색하고 "$1 Rocks"로 바꾸면 셀의 콘텐츠가 각각 "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이 참이면 두 개의 새 행이 빨간색이 되고 (삽입 지점 앞의 행이 빨간색이므로), inheritFromBefore이 거짓이면 두 개의 새 행이 녹색이 됩니다 (삽입 지점 뒤의 행이 녹색이므로).

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)

참조입니다.

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

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