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)
  }
  // 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를 새로고침합니다.

UpdateSheetsPropertiesRequest 클래스의 생성자

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

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

object (SpreadsheetProperties)

업데이트할 속성입니다.

fields

string (FieldMask format)

업데이트해야 하는 필드입니다. 하나 이상의 필드를 지정해야 합니다. 루트 '속성'은 묵시적이며 지정되어서는 안 됩니다. 단일 "*"를 모든 필드를 나열하는 약식으로 사용할 수 있습니다.

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)

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

업데이트 이름 요청 범위

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

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

object (NamedRange)

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

fields

string (FieldMask format)

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

반복 셀 요청

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

수식이 있는 셀을 작성할 경우, 수식의 범위가 범위 내 각 필드에 자동으로 증가합니다. 예를 들어 =A1 수식이 포함된 셀을 B2:C4 범위에 포함하는 경우 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를 지정하면 오류가 발생합니다.

삭제 요청 이름 범위

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

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

string

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

AddSheetRequest

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

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

object (SheetProperties)

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

시트 삭제 요청

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

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

integer

삭제할 시트의 ID입니다.

시트가 DATA_SOURCE 유형이면 연결된 DataSource도 삭제됩니다.

자동 완성 요청

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

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

'대체' 시리즈로 데이터를 생성해야 하는 경우 참입니다. 소스 데이터의 유형과 양에 따라 다릅니다.

공용체 필드 area는 자동 완성할 영역 area는 다음 중 하나여야 합니다.
range

object (GridRange)

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

sourceAndDestination

object (SourceAndDestination)

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

소스 및 대상

소스 범위와 해당 소스를 확장하는 방법의 조합.

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

object (GridRange)

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

dimension

enum (Dimension)

데이터를 입력해야 하는 측정기준입니다.

fillLength

integer

데이터를 입력해야 하는 행 또는 열의 개수입니다. 양수는 소스의 마지막 행 또는 마지막 열 이상으로 확장됩니다. 음수는 소스의 첫 번째 행 또는 첫 번째 열 앞에 펼쳐집니다.

CutPaste 요청

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

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

object (GridRange)

잘라낼 소스 데이터입니다.

destination

object (GridCoordinate)

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

pasteType

enum (PasteType)

붙여넣을 데이터의 종류. 붙여넣은 항목에 관계없이 모든 소스 데이터가 잘립니다.

붙여넣기 유형

붙여넣을 데이터의 종류

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

요청 붙여넣기

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

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)

붙여넣을 때 데이터의 방향을 지정하는 방법입니다.

방향 붙여넣기

붙여넣기 작업을 수행하는 방법

열거형
NORMAL 정상적으로 붙여넣습니다.
TRANSPOSE 행과 열을 바꿔 붙여넣습니다. 모든 행이 열이 되며 반대의 경우도 마찬가지입니다.

MergeCellsRequest 클래스의 생성자

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

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

object (GridRange)

병합할 셀의 범위입니다.

mergeType

enum (MergeType)

셀을 병합하는 방법

병합 유형

생성할 병합 유형입니다.

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

병합되지 않은 셀 요청

지정된 범위의 셀 병합을 취소합니다.

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는 위치 데이터를 작성해야 합니다. 정확히 1개의 값을 설정해야 합니다. 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)

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

삽입된 개체 요청

지정된 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

새 시트의 이름입니다. 비어 있으면 새 이름이 선택됩니다.

찾기 바꾸기 요청

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

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)을 따라야 합니다. 대체 문자열은 캡처 그룹을 나타낼 수 있습니다. 예를 들어 한 셀에 "Google Sheets" 콘텐츠가 있고 다른 셀에 "Google Docs"가 있는 경우 "o.* (.*)"을 "$1 Rocks"로 바꾸면 셀의 콘텐츠가 각각 "GSheets Rocks" 및 "GDocs Rocks"로 변경됩니다.

includeFormulas

boolean

검색에 수식이 있는 셀을 포함해야 하는 경우 참입니다. 수식이 있는 셀을 건너뛰려면 False로 설정합니다.

공용체 필드 scope는 찾거나 바꿀 범위입니다. 하나만 설정해야 합니다. scope는 다음 중 하나여야 합니다.
range

object (GridRange)

찾거나 바꿀 범위입니다.

sheetId

integer

찾아서 대체할 시트입니다.

allSheets

boolean

모든 시트를 찾아서 바꾸려면 참입니다.

InsertDimensionRequest

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

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

object (DimensionRange)

삽입할 크기입니다. 시작 색인과 끝 색인은 모두 결합되어야 합니다.

inheritFromBefore

boolean

측정기준 속성을 새로 삽입된 측정기준 앞이나 뒤에 있는 크기에서 확장해야 하는지 여부입니다. 이전 측정기준에서 상속하려면 (이 경우 시작 색인이 0보다 커야 함) 이후 측정기준에서 상속받으려면 false입니다.

예를 들어 행 색인 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는 암시적이므로 지정해서는 안 됩니다. 단일 "*"를 모든 필드를 나열하는 약식으로 사용할 수 있습니다.

데이터 요청 붙여넣기

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

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)

사용할 구분 기호 유형입니다.

구분 기호 유형

분할할 구분 기호입니다.

열거형
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

규칙을 삭제할 시트입니다.

정렬 범위 요청

열별 정렬 순서를 기준으로 행의 데이터를 정렬합니다.

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

object (GridRange)

정렬할 범위입니다.

sortSpecs[]

object (SortSpec)

열별 정렬 순서입니다. 이후 사양은 값이 이전 사양과 같을 때 사용됩니다.

SetDataValidationRequest

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

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

object (GridRange)

데이터 확인 규칙이 적용되는 범위입니다.

rule

object (DataValidationRule)

범위의 각 셀에 설정할 데이터 확인 규칙 또는 범위의 데이터 확인을 지우려면 비어 있습니다.

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입니다.

자동 크기 조절 크기 요청

해당 측정기준에 있는 셀의 내용에 따라 하나 이상의 측정기준을 자동으로 조정합니다.

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)

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

업데이트 차단 요청

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

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를 지정하면 오류가 발생합니다.

삭제 차단 요청

주어진 ID가 있는 밴딩 범위를 스프레드시트에서 삭제합니다.

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

integer

삭제할 범위 범위의 ID입니다.

CreateDeveloperMetadataRequest 클래스의 생성자

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

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

object (DeveloperMetadata)

만들 개발자 메타데이터입니다.

업데이트 개발자 메타데이터 요청

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

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

object (DataFilter)

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

developerMetadata

object (DeveloperMetadata)

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

fields

string (FieldMask format)

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

개발자 메타데이터 요청 삭제

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

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

object (DataFilter)

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

RandomizeRangeRequest로

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

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

object (GridRange)

임의 범위를 지정합니다.

AddDimensionGroupRequest

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

요청된 범위가 기존 그룹 G의 범위 중 상위 집합인 경우 G의 깊이가 증가하고 이 새로운 그룹 G'의 깊이는 해당 그룹의 깊이가 됩니다. 예를 들어 그룹 [C:D, 깊이 1] + [B:E] 는 그룹 [B:E, 깊이 1] 과 [C:D, 깊이 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는 암시적이므로 지정해서는 안 됩니다. 단일 "*"를 모든 필드를 나열하는 약식으로 사용할 수 있습니다.

자르기 화이트스페이스 요청

지정된 범위의 모든 셀에서 공백 (예: 공백, 탭 또는 새 줄)을 자릅니다. 이 요청은 각 셀 텍스트의 시작과 끝에서 모든 공백을 제거하고 나머지 공백 문자의 하위 시퀀스는 한 개로 줄입니다. 텍스트에서 잘린 텍스트가 '+' 또는 '=' 문자로 시작하면 해당 문자열은 문자열 값으로 유지되며 수식으로 해석되지 않습니다.

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

object (GridRange)

다듬을 셀 범위입니다.

중복 삭제 요청

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

또한 이 요청은 필터로 인해 보기에서 숨겨진 중복 행을 삭제합니다. 중복을 제거하면 위에서 아래로 중복된 각 행 스캔의 첫 번째 인스턴스가 결과 범위에 유지됩니다. 지정된 범위를 벗어난 콘텐츠는 삭제되지 않으며, 중복으로 간주되는 행은 범위 내에서 서로 인접하지 않아도 됩니다.

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

object (GridRange)

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

comparisonColumns[]

object (DimensionRange)

분석할 값을 중복 값으로 분석합니다. 열을 선택하지 않으면 모든 열이 중복으로 분석됩니다.

UpdateEmbeddedObjectBorderRequest

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

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는 암시적이므로 지정해서는 안 됩니다. 하나의 '*'를 모든 필드를 나열하는 약식으로 사용할 수 있습니다.

데이터 소스 요청 추가

데이터 소스를 추가합니다. 데이터 소스가 추가되면 연결된 DATA_SOURCE 시트가 생성되고, 데이터 소스에서 데이터를 읽기 위해 시트를 새로고침하도록 실행이 트리거됩니다. 이 요청에는 추가 bigquery.readonly OAuth 범위가 필요합니다.

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

object (DataSource)

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

업데이트 데이터 소스 요청

데이터 소스를 업데이트합니다. 데이터 소스가 성공적으로 업데이트되면 연결된 DATA_SOURCE 시트를 새로고침하여 업데이트된 데이터 소스에서 데이터를 읽는 실행이 트리거됩니다. 이 요청에는 추가 bigquery.readonly OAuth 범위가 필요합니다.

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

object (DataSource)

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

fields

string (FieldMask format)

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

데이터 소스 요청 삭제

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

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

string

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

데이터 소스 요청 새로고침

지정된 참조로 스프레드시트의 하나 이상의 데이터 소스 객체를 새로고침합니다. 이 요청에는 추가 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)

참조

데이터 소스 객체 참조

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

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를 포함하는 셀에 대한 참조입니다.