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)

하나 이상의 데이터 소스 및 연결된 dbobjects를 새로 고칩니다.

cancelDataSourceRefresh

object (CancelDataSourceRefreshRequest)

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

UpdateSpreadsheetPropertiesRequest

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

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)

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

UpdateNamedRangeRequest

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

JSON 표현
{
  "namedRange": {
    object (NamedRange)
  },
  "fields": string
}
입력란
namedRange

object (NamedRange)

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

fields

string (FieldMask format)

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

RepeatCellRequest

범위의 모든 셀을 지정된 셀 객체의 값으로 업데이트합니다. 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를 지정하면 오류가 발생합니다.

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의 자바 정규식 규칙을 따라야 합니다. 대체 문자열은 캡처 그룹을 참조할 수 있습니다. 예를 들어 한 셀의 내용은 "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이고 (이 경우 시작 색인이 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부터 시작하는 시작 색인입니다. 기존 데이터는 측정기준에 따라 아래 또는 오른쪽으로 이동하여 이동한 측정기준을 위한 공간을 확보합니다. 소스 측정기준이 그리드에서 삭제되므로 데이터가 지정된 것과 다른 색인으로 지정될 수 있습니다.

예를 들어 A1..A50, 1, 2, 3, 4이고 "1""2""3""4" 사이에서 이동하려면 소스는 ROWS [1..3)가 되고 대상 색인은 "4"(5행의 0부터 시작하는 색인)이 됩니다. 최종 결과는 0, 3, 1, 2, 4A1..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)

소스 데이터 범위입니다. 정확히 1개의 열을 포함해야 합니다.

delimiter

string

사용할 구분 기호입니다. 구분자 유형이 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)
  }
}
입력란
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입니다.

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 리소스에 제공된 값으로 업데이트합니다. 호출자는 필드 매개변수에서 업데이트할 속성을 지정하고 업데이트할 메타데이터와 일치하는 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, 깊이 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의 깊이보다 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.readonly OAuth 범위가 필요합니다.

JSON 표현
{
  "dataSource": {
    object (DataSource)
  }
}
입력란
dataSource

object (DataSource)

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

UpdateDataSourceRequest

데이터 소스를 업데이트합니다. 데이터 소스가 성공적으로 업데이트되면 업데이트된 데이터 소스에서 데이터를 읽기 위해 연결된 DATA_SOURCE 시트를 새로고침하도록 실행이 트리거됩니다. 요청에는 추가 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.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

스프레드시트에서 지정된 참조를 기준으로 데이터 소스 객체의 새로고침을 한 번 이상 취소합니다.

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

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