요청
스프레드시트에 적용할 단일 업데이트 종류입니다.
| JSON 표현 |
|---|
{ // Union field |
| 필드 | |
|---|---|
통합 필드
kind. 업데이트 종류입니다. 필드는 정확히 하나만 필요합니다.
kind은 다음 중 하나여야 합니다.
|
|
updateSpreadsheetProperties
|
스프레드시트의 속성을 업데이트합니다. |
updateSheetProperties
|
시트의 속성을 업데이트합니다. |
updateDimensionProperties
|
측정기준의 속성을 업데이트합니다. |
updateNamedRange
|
이름이 지정된 범위를 업데이트합니다. |
repeatCell
|
범위에서 단일 셀을 반복합니다. |
addNamedRange
|
이름이 지정된 범위를 추가합니다. |
deleteNamedRange
|
이름이 지정된 범위를 삭제합니다. |
addSheet
|
시트를 추가합니다. |
deleteSheet
|
시트를 삭제합니다. |
autoFill
|
기존 데이터를 기반으로 더 많은 데이터를 자동으로 입력합니다. |
cutPaste
|
한 영역의 데이터를 잘라 다른 영역에 붙여넣습니다. |
copyPaste
|
한 영역에서 데이터를 복사하여 다른 영역에 붙여넣습니다. |
mergeCells
|
셀을 병합합니다. |
unmergeCells
|
병합된 셀을 병합 해제합니다. |
updateBorders
|
셀 범위의 테두리를 업데이트합니다. |
updateCells
|
한 번에 여러 셀을 업데이트합니다. |
addFilterView
|
필터 보기를 추가합니다. |
appendCells
|
시트에서 데이터가 있는 마지막 행 뒤에 셀을 추가합니다. |
clearBasicFilter
|
시트의 기본 필터를 지웁니다. |
deleteDimension
|
시트에서 행 또는 열을 삭제합니다. |
deleteEmbeddedObject
|
시트에서 삽입된 객체 (예: 차트, 이미지)를 삭제합니다. |
deleteFilterView
|
시트에서 필터 보기를 삭제합니다. |
duplicateFilterView
|
필터 보기를 복제합니다. |
duplicateSheet
|
시트를 복제합니다. |
findReplace
|
일부 텍스트를 찾아 다른 텍스트로 바꿉니다. |
insertDimension
|
시트에 새 행 또는 열을 삽입합니다. |
insertRange
|
시트에 새 셀을 삽입하여 기존 셀을 이동합니다. |
moveDimension
|
행 또는 열을 시트의 다른 위치로 이동합니다. |
updateEmbeddedObjectPosition
|
삽입된 객체 (예: 차트, 이미지)의 위치를 업데이트합니다. |
pasteData
|
데이터 (HTML 또는 구분)를 시트에 붙여넣습니다. |
textToColumns
|
텍스트 열을 여러 텍스트 열로 변환합니다. |
updateFilterView
|
필터 뷰의 속성을 업데이트합니다. |
deleteRange
|
시트에서 셀 범위를 삭제하고 나머지 셀을 이동합니다. |
appendDimension
|
시트 끝에 측정기준을 추가합니다. |
addConditionalFormatRule
|
새 조건부 서식 규칙을 추가합니다. |
updateConditionalFormatRule
|
기존 조건부 서식 규칙을 업데이트합니다. |
deleteConditionalFormatRule
|
기존 조건부 서식 규칙을 삭제합니다. |
sortRange
|
범위의 데이터를 정렬합니다. |
setDataValidation
|
하나 이상의 셀에 데이터 확인을 설정합니다. |
setBasicFilter
|
시트에 기본 필터를 설정합니다. |
addProtectedRange
|
보호된 범위를 추가합니다. |
updateProtectedRange
|
보호된 범위를 업데이트합니다. |
deleteProtectedRange
|
보호된 범위를 삭제합니다. |
autoResizeDimensions
|
해당 측정기준의 셀 콘텐츠를 기반으로 하나 이상의 측정기준 크기를 자동으로 조절합니다. |
addChart
|
차트를 추가합니다. |
updateChartSpec
|
차트의 사양을 업데이트합니다. |
updateBanding
|
밴드 범위를 업데이트합니다. |
addBanding
|
새로운 밴드 범위를 추가합니다. |
deleteBanding
|
밴드 처리된 범위를 삭제합니다. |
createDeveloperMetadata
|
새 개발자 메타데이터를 만듭니다. |
updateDeveloperMetadata
|
기존 개발자 메타데이터 항목을 업데이트합니다. |
deleteDeveloperMetadata
|
개발자 메타데이터를 삭제합니다. |
randomizeRange
|
범위의 행 순서를 무작위로 지정합니다. |
addDimensionGroup
|
지정된 범위에 그룹을 만듭니다. |
deleteDimensionGroup
|
지정된 범위의 그룹을 삭제합니다. |
updateDimensionGroup
|
지정된 그룹의 상태를 업데이트합니다. |
trimWhitespace
|
공백, 탭, 줄바꿈과 같은 공백을 셀에서 잘라냅니다. |
deleteDuplicates
|
셀 범위의 지정된 열에 중복 값이 포함된 행을 삭제합니다. |
updateEmbeddedObjectBorder
|
삽입된 객체의 테두리를 업데이트합니다. |
addSlicer
|
슬라이서를 추가합니다. |
updateSlicerSpec
|
슬라이서의 사양을 업데이트합니다. |
addDataSource
|
데이터 소스를 추가합니다. |
updateDataSource
|
데이터 소스를 업데이트합니다. |
deleteDataSource
|
데이터 소스를 삭제합니다. |
refreshDataSource
|
하나 이상의 데이터 소스와 연결된 dbobject를 새로고침합니다. |
cancelDataSourceRefresh
|
하나 이상의 데이터 소스 및 연결된 dbobject의 새로고침을 취소합니다. |
addTable
|
표를 추가합니다. |
updateTable
|
표를 업데이트합니다. |
deleteTable
|
표 삭제 요청입니다. |
UpdateSpreadsheetPropertiesRequest
스프레드시트의 속성을 업데이트합니다.
| JSON 표현 |
|---|
{
"properties": {
object ( |
| 필드 | |
|---|---|
properties
|
업데이트할 속성입니다. |
fields
|
업데이트해야 하는 필드입니다. 하나 이상의 필드를 지정해야 합니다. 루트 'properties'는 암시되어 있으므로 지정해서는 안 됩니다. 단일 |
UpdateSheetPropertiesRequest
지정된 sheetId로 시트의 속성을 업데이트합니다.
| JSON 표현 |
|---|
{
"properties": {
object ( |
| 필드 | |
|---|---|
properties
|
업데이트할 속성입니다. |
fields
|
업데이트해야 하는 필드입니다. 하나 이상의 필드를 지정해야 합니다. 루트 |
UpdateDimensionPropertiesRequest
지정된 범위 내에서 측정기준의 속성을 업데이트합니다.
| JSON 표현 |
|---|
{ "properties": { object ( |
| 필드 | |
|---|---|
properties
|
업데이트할 속성입니다. |
fields
|
업데이트해야 하는 필드입니다. 하나 이상의 필드를 지정해야 합니다. 루트 |
통합 필드
dimension_range. 측정기준 범위입니다.
dimension_range은 다음 중 하나여야 합니다.
|
|
range
|
업데이트할 행 또는 열입니다. |
dataSourceSheetRange
|
업데이트할 데이터 소스 시트의 열입니다. |
DataSourceSheetDimensionRange
DATA_SOURCE 시트의 단일 측정기준을 따라 있는 범위입니다.
| JSON 표현 |
|---|
{
"sheetId": integer,
"columnReferences": [
{
object ( |
| 필드 | |
|---|---|
sheetId
|
범위가 있는 데이터 소스 시트의 ID입니다. |
columnReferences[]
|
데이터 소스 시트의 열입니다. |
UpdateNamedRangeRequest
지정된 namedRangeId로 이름이 지정된 범위의 속성을 업데이트합니다.
| JSON 표현 |
|---|
{
"namedRange": {
object ( |
| 필드 | |
|---|---|
namedRange
|
새 속성으로 업데이트할 이름이 지정된 범위입니다. |
fields
|
업데이트해야 하는 필드입니다. 하나 이상의 필드를 지정해야 합니다. 루트 |
RepeatCellRequest
범위의 모든 셀을 지정된 Cell 객체의 값으로 업데이트합니다. fields 필드에 나열된 필드만 업데이트되고 다른 필드는 변경되지 않습니다.
수식이 있는 셀을 작성하는 경우 수식의 범위는 범위의 각 필드에 대해 자동으로 증가합니다. 예를 들어 수식 =A1이 있는 셀을 범위 B2:C4에 쓰는 경우 B2는 =A1, B3는 =A2, B4는 =A3, C2는 =B1, C3는 =B2, C4는 =B3이 됩니다.
수식의 범위를 정적으로 유지하려면 $ 표시기를 사용합니다. 예를 들어 행과 열이 모두 증가하지 않도록 하려면 =$A$1 수식을 사용합니다.
| JSON 표현 |
|---|
{ "range": { object ( |
| 필드 | |
|---|---|
range
|
셀을 반복할 범위입니다. |
cell
|
쓸 데이터입니다. |
fields
|
업데이트해야 하는 필드입니다. 하나 이상의 필드를 지정해야 합니다. 루트 |
AddNamedRangeRequest
스프레드시트에 이름이 지정된 범위를 추가합니다.
| JSON 표현 |
|---|
{
"namedRange": {
object ( |
| 필드 | |
|---|---|
namedRange
|
추가할 이름이 지정된 범위입니다. |
DeleteNamedRangeRequest
지정된 ID가 있는 이름이 지정된 범위를 스프레드시트에서 삭제합니다.
| JSON 표현 |
|---|
{ "namedRangeId": string } |
| 필드 | |
|---|---|
namedRangeId
|
삭제할 이름이 지정된 범위의 ID입니다. |
AddSheetRequest
새 시트를 추가합니다. 특정 색인에 시트가 추가되면 이후 모든 시트의 색인이 증가합니다. 객체 시트를 추가하려면 AddChartRequest를 대신 사용하고 EmbeddedObjectPosition.sheetId 또는 EmbeddedObjectPosition.newSheet를 지정합니다.
| JSON 표현 |
|---|
{
"properties": {
object ( |
| 필드 | |
|---|---|
properties
|
새 시트가 가져야 하는 속성입니다. 모든 속성은 선택사항입니다. |
DeleteSheetRequest
요청된 시트를 삭제합니다.
| JSON 표현 |
|---|
{ "sheetId": integer } |
| 필드 | |
|---|---|
sheetId
|
삭제할 시트의 ID입니다.
시트가 |
AutoFillRequest
기존 데이터를 기반으로 더 많은 데이터를 채웁니다.
| JSON 표현 |
|---|
{ "useAlternateSeries": boolean, // Union field |
| 필드 | |
|---|---|
useAlternateSeries
|
'대체' 계열로 데이터를 생성해야 하는 경우 true입니다. 이는 소스 데이터의 유형과 양에 따라 다릅니다. |
통합 필드
area. 자동 완성할 영역입니다.
area은 다음 중 하나여야 합니다.
|
|
range
|
자동 완성할 범위입니다. 이렇게 하면 범위가 검사되고 데이터가 있는 위치가 감지되어 나머지 범위에 해당 데이터가 자동으로 채워집니다. |
sourceAndDestination
|
자동 완성할 소스 및 대상 영역입니다. 여기에는 자동 완성의 소스와 해당 데이터를 확장할 위치가 명시적으로 나열됩니다. |
SourceAndDestination
소스 범위와 소스를 확장하는 방법의 조합입니다.
| JSON 표현 |
|---|
{ "source": { object ( |
| 필드 | |
|---|---|
source
|
자동 완성의 소스로 사용할 데이터의 위치입니다. |
dimension
|
데이터가 채워질 측정기준입니다. |
fillLength
|
데이터를 채워야 하는 행 또는 열의 수입니다. 양수는 소스의 마지막 행 또는 마지막 열을 넘어 확장됩니다. 음수는 소스의 첫 번째 행 또는 첫 번째 열 앞에 확장됩니다. |
CutPasteRequest
소스에서 대상으로 데이터를 이동합니다.
| JSON 표현 |
|---|
{ "source": { object ( |
| 필드 | |
|---|---|
source
|
잘라낼 소스 데이터입니다. |
destination
|
데이터를 붙여넣어야 하는 왼쪽 상단 좌표입니다. |
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 ( |
| 필드 | |
|---|---|
source
|
복사할 소스 범위입니다. |
destination
|
붙여넣을 위치입니다. 범위가 소스의 높이 또는 너비의 배수인 범위를 포함하는 경우 대상 범위를 채우기 위해 데이터가 반복됩니다. 범위가 소스 범위보다 작더라도 전체 소스 데이터가 복사됩니다 (대상 범위의 끝을 넘어). |
pasteType
|
어떤 종류의 데이터를 붙여넣을지 지정합니다. |
pasteOrientation
|
붙여넣을 때 데이터가 어떻게 방향을 지정해야 하는지입니다. |
PasteOrientation
붙여넣기 작업을 실행하는 방법입니다.
| 열거형 | |
|---|---|
NORMAL
|
일반적으로 붙여넣습니다. |
TRANSPOSE
|
전치된 상태로 붙여넣으면 모든 행이 열이 되고 그 반대도 마찬가지입니다. |
MergeCellsRequest
범위의 모든 셀을 병합합니다.
| JSON 표현 |
|---|
{ "range": { object ( |
| 필드 | |
|---|---|
range
|
병합할 셀 범위입니다. |
mergeType
|
셀을 병합하는 방법입니다. |
MergeType
만들 병합의 유형입니다.
| 열거형 | |
|---|---|
MERGE_ALL
|
범위에서 단일 병합 만들기 |
MERGE_COLUMNS
|
범위의 각 열에 병합 만들기 |
MERGE_ROWS
|
범위의 각 행에 병합 만들기 |
UnmergeCellsRequest
지정된 범위의 셀을 병합 해제합니다.
| JSON 표현 |
|---|
{
"range": {
object ( |
| 필드 | |
|---|---|
range
|
모든 셀의 병합을 취소해야 하는 범위입니다. 범위가 여러 병합에 걸쳐 있는 경우 모두 병합 해제됩니다. 범위가 병합을 부분적으로 포함해서는 안 됩니다. |
UpdateBordersRequest
범위의 테두리를 업데이트합니다. 요청에 필드가 설정되지 않으면 테두리가 그대로 유지됩니다. 예를 들어 두 개의 연속된 UpdateBordersRequest를 사용하면 다음과 같습니다.
-
범위: A1:A5
{ top: RED, bottom: WHITE } -
범위: A1:A5
{ left: BLUE }
그러면 A1:A5에 { top: RED, bottom: WHITE, left: BLUE } 테두리가 적용됩니다. 테두리를 지우려면 스타일을 NONE로 명시적으로 설정하세요.
| JSON 표현 |
|---|
{ "range": { object ( |
| 필드 | |
|---|---|
range
|
테두리를 업데이트해야 하는 범위입니다. |
top
|
범위의 상단에 배치할 테두리입니다. |
bottom
|
범위 하단에 배치할 테두리입니다. |
left
|
범위의 왼쪽에 배치할 테두리입니다. |
right
|
범위 오른쪽에 배치할 테두리입니다. |
innerHorizontal
|
범위 내에 배치할 가로 테두리입니다. |
innerVertical
|
범위 내에 배치할 세로 테두리입니다. |
UpdateCellsRequest
범위의 모든 셀을 새 데이터로 업데이트합니다.
| JSON 표현 |
|---|
{ "rows": [ { object ( |
| 필드 | |
|---|---|
rows[]
|
쓸 데이터입니다. |
fields
|
업데이트해야 하는 CellData 필드입니다. 하나 이상의 필드를 지정해야 합니다. 루트는 CellData이며 'row.values'는 지정하면 안 됩니다. 단일 |
통합 필드
area. 위치 데이터를 작성해야 합니다. 정확히 하나의 값을 설정해야 합니다.
area은 다음 중 하나여야 합니다.
|
|
start
|
데이터 쓰기를 시작할 좌표입니다. 행과 열의 수를 원하는 대로 작성할 수 있습니다 (행당 열 수가 다를 수 있음). |
range
|
데이터를 쓸 범위입니다.
행의 데이터가 요청된 전체 범위를 포함하지 않으면 |
AddFilterViewRequest
필터 보기를 추가합니다.
| JSON 표현 |
|---|
{
"filter": {
object ( |
| 필드 | |
|---|---|
filter
|
추가할 필터입니다. |
AppendCellsRequest
시트에서 데이터가 있는 마지막 행 뒤에 새 셀을 추가하고 필요한 경우 시트에 새 행을 삽입합니다.
| JSON 표현 |
|---|
{ "sheetId": integer, "rows": [ { object ( |
| 필드 | |
|---|---|
sheetId
|
데이터를 추가할 시트 ID입니다. |
rows[]
|
추가할 데이터입니다. |
fields
|
업데이트해야 하는 CellData 필드입니다. 하나 이상의 필드를 지정해야 합니다. 루트는 CellData이며 'row.values'는 지정하면 안 됩니다. 단일 |
통합 필드
area. 위치 데이터를 작성해야 합니다.
area은 다음 중 하나여야 합니다.
|
|
tableId
|
데이터를 추가할 테이블의 ID입니다. 데이터는 테이블 본문에만 추가됩니다.
이 필드는 |
ClearBasicFilterRequest
시트에 기본 필터가 있는 경우 이를 지웁니다.
| JSON 표현 |
|---|
{ "sheetId": integer } |
| 필드 | |
|---|---|
sheetId
|
기본 필터를 지워야 하는 시트 ID입니다. |
DeleteDimensionRequest
시트에서 측정기준을 삭제합니다.
| JSON 표현 |
|---|
{
"range": {
object ( |
| 필드 | |
|---|---|
range
|
시트에서 삭제할 측정기준입니다. |
DeleteEmbeddedObjectRequest
지정된 ID가 있는 삽입된 객체를 삭제합니다.
| JSON 표현 |
|---|
{ "objectId": integer } |
| 필드 | |
|---|---|
objectId
|
삭제할 삽입된 객체의 ID입니다. |
DeleteFilterViewRequest
특정 필터 뷰를 삭제합니다.
| JSON 표현 |
|---|
{ "filterId": integer } |
| 필드 | |
|---|---|
filterId
|
삭제할 필터의 ID입니다. |
DuplicateFilterViewRequest
특정 필터 보기를 복제합니다.
| JSON 표현 |
|---|
{ "filterId": integer } |
| 필드 | |
|---|---|
filterId
|
중복되는 필터의 ID입니다. |
DuplicateSheetRequest
시트의 콘텐츠를 복제합니다.
| JSON 표현 |
|---|
{ "sourceSheetId": integer, "insertSheetIndex": integer, "newSheetId": integer, "newSheetName": string } |
| 필드 | |
|---|---|
sourceSheetId
|
복제할 시트입니다.
소스 시트가 |
insertSheetIndex
|
새 시트를 삽입해야 하는 0부터 시작하는 색인입니다. 이후의 모든 시트의 색인이 증가합니다. |
newSheetId
|
설정된 경우 새 시트의 ID입니다. 설정하지 않으면 ID가 선택됩니다. 설정된 경우 ID가 기존 시트 ID와 충돌해서는 안 됩니다. 설정된 경우 음수가 아니어야 합니다. |
newSheetName
|
새 시트의 이름입니다. 비어 있으면 새 이름이 선택됩니다. |
FindReplaceRequest
범위, 시트 또는 모든 시트의 셀에서 데이터를 찾아 바꿉니다.
| JSON 표현 |
|---|
{ "find": string, "replacement": string, "matchCase": boolean, "matchEntireCell": boolean, "searchByRegex": boolean, "includeFormulas": boolean, // Union field |
| 필드 | |
|---|---|
find
|
검색할 값입니다. |
replacement
|
대체로 사용할 값입니다. |
matchCase
|
검색 시 대소문자를 구분하는 경우 true입니다. |
matchEntireCell
|
찾기 값이 전체 셀과 일치해야 하는 경우 true입니다. |
searchByRegex
|
찾는 값이 정규식인 경우 true입니다. 정규 표현식과 대체는 https://docs.oracle.com/javase/8/docs/api/java/util/regex/Pattern.html의 Java 정규식 규칙을 따라야 합니다. 대체 문자열은 캡처 그룹을 참조할 수 있습니다. 예를 들어 한 셀에 |
includeFormulas
|
검색에 수식이 있는 셀을 포함해야 하는 경우 true입니다. 수식이 있는 셀을 건너뛰려면 False입니다. |
통합 필드
scope. 찾기/바꾸기를 실행할 범위입니다. 하나만 설정해야 합니다.
scope은 다음 중 하나여야 합니다.
|
|
range
|
찾기/바꾸기를 실행할 범위입니다. |
sheetId
|
찾기/바꾸기를 실행할 시트입니다. |
allSheets
|
모든 시트에서 찾기/바꾸기를 실행하려면 true입니다. |
InsertDimensionRequest
시트의 특정 색인에 행 또는 열을 삽입합니다.
| JSON 표현 |
|---|
{
"range": {
object ( |
| 필드 | |
|---|---|
range
|
삽입할 차원입니다. 시작 및 종료 색인이 모두 제한되어야 합니다. |
inheritFromBefore
|
새로 삽입된 측정기준 전후의 측정기준에서 측정기준 속성을 확장해야 하는지 여부입니다. 이전의 측정기준에서 상속받으려면 true (이 경우 시작 색인이 0보다 커야 함), 이후의 측정기준에서 상속받으려면 false입니다.
예를 들어 행 색인 0의 배경이 빨간색이고 행 색인 1의 배경이 녹색인 경우 색인 1에 행 2개를 삽입하면 녹색 또는 빨간색 배경이 상속될 수 있습니다. |
InsertRangeRequest
범위에 셀을 삽입하여 기존 셀을 오른쪽이나 아래로 이동합니다.
| JSON 표현 |
|---|
{ "range": { object ( |
| 필드 | |
|---|---|
range
|
새 셀을 삽입할 범위입니다. 범위는 현재 시트 경계로 제한됩니다. |
shiftDimension
|
셀을 삽입할 때 이동되는 차원입니다. |
MoveDimensionRequest
하나 이상의 행 또는 열을 이동합니다.
| JSON 표현 |
|---|
{
"source": {
object ( |
| 필드 | |
|---|---|
source
|
이동할 소스 측정기준입니다. |
destinationIndex
|
소스 데이터를 이동할 위치의 0부터 시작하는 시작 색인입니다. 이는 소스 데이터가 그리드에서 삭제되기 전의 좌표를 기반으로 합니다. 이동된 측정기준을 위한 공간을 확보하기 위해 기존 데이터가 아래쪽이나 오른쪽으로 이동합니다 (측정기준에 따라 다름). 소스 측정기준이 그리드에서 삭제되므로 데이터가 지정된 인덱스와 다른 인덱스에 표시될 수 있습니다.
예를 들어 |
UpdateEmbeddedObjectPositionRequest
삽입된 객체의 위치를 업데이트합니다 (예: 차트 또는 이미지 이동 또는 크기 조절).
| JSON 표현 |
|---|
{
"objectId": integer,
"newPosition": {
object ( |
| 필드 | |
|---|---|
objectId
|
이동할 객체의 ID입니다. |
newPosition
|
삽입된 객체를 이동할 명시적 위치입니다. |
fields
|
새 위치를 설정할 때 업데이트해야 하는 |
PasteDataRequest
지정된 좌표부터 시작하여 데이터를 스프레드시트에 삽입합니다.
| JSON 표현 |
|---|
{ "coordinate": { object ( |
| 필드 | |
|---|---|
coordinate
|
데이터 삽입이 시작되어야 하는 좌표입니다. |
data
|
삽입할 데이터입니다. |
type
|
데이터를 붙여넣는 방법 |
통합 필드
kind. 데이터를 해석하는 방법입니다. 정확히 하나의 값을 설정해야 합니다.
kind은 다음 중 하나여야 합니다.
|
|
delimiter
|
데이터의 구분자입니다. |
html
|
데이터가 HTML인 경우 true입니다. |
TextToColumnsRequest
각 셀의 구분 기호를 기반으로 텍스트 열을 여러 열로 분할합니다.
| JSON 표현 |
|---|
{ "source": { object ( |
| 필드 | |
|---|---|
source
|
소스 데이터 범위입니다. 정확히 하나의 열에 걸쳐야 합니다. |
delimiter
|
사용할 구분 기호입니다. delimiterType이 |
delimiterType
|
사용할 구분자 유형입니다. |
DelimiterType
분할할 구분 기호입니다.
| 열거형 | |
|---|---|
DELIMITER_TYPE_UNSPECIFIED
|
기본값 이 값은 사용하면 안 됩니다. |
COMMA
|
"," |
SEMICOLON
|
";" |
PERIOD
|
'.' |
SPACE
|
" " |
CUSTOM
|
구분 기호에 정의된 맞춤 값입니다. |
AUTODETECT
|
열을 자동으로 감지합니다. |
UpdateFilterViewRequest
필터 뷰의 속성을 업데이트합니다.
| JSON 표현 |
|---|
{
"filter": {
object ( |
| 필드 | |
|---|---|
filter
|
필터 보기의 새 속성입니다. |
fields
|
업데이트해야 하는 필드입니다. 하나 이상의 필드를 지정해야 합니다. 루트 |
DeleteRangeRequest
셀 범위를 삭제하고 다른 셀을 삭제된 영역으로 이동합니다.
| JSON 표현 |
|---|
{ "range": { object ( |
| 필드 | |
|---|---|
range
|
삭제할 셀 범위입니다. |
shiftDimension
|
삭제된 셀을 대체할 측정기준입니다. |
AppendDimensionRequest
시트 끝에 행 또는 열을 추가합니다.
| JSON 표현 |
|---|
{
"sheetId": integer,
"dimension": enum ( |
| 필드 | |
|---|---|
sheetId
|
행 또는 열을 추가할 시트입니다. |
dimension
|
행 또는 열을 추가할지 여부입니다. |
length
|
추가할 행 또는 열의 수입니다. |
AddConditionalFormatRuleRequest
지정된 색인에 새 조건부 서식 규칙을 추가합니다. 이후의 모든 규칙의 색인이 증가합니다.
| JSON 표현 |
|---|
{
"rule": {
object ( |
| 필드 | |
|---|---|
rule
|
추가할 규칙입니다. |
index
|
규칙을 삽입해야 하는 0부터 시작하는 색인입니다. |
UpdateConditionalFormatRuleRequest
지정된 색인에서 조건부 서식 규칙을 업데이트하거나 조건부 서식 규칙을 다른 색인으로 이동합니다.
| JSON 표현 |
|---|
{ "index": integer, "sheetId": integer, // Union field |
| 필드 | |
|---|---|
index
|
바꾸거나 이동할 규칙의 0부터 시작하는 색인입니다. |
sheetId
|
이동할 규칙의 시트입니다. |
통합 필드
instruction. 발생해야 하는 업데이트의 종류입니다.
instruction은 다음 중 하나여야 합니다.
|
|
rule
|
지정된 색인의 규칙을 대체해야 하는 규칙입니다. |
newIndex
|
규칙이 끝나야 하는 0 기반 새 색인입니다. |
DeleteConditionalFormatRuleRequest
지정된 색인의 조건부 서식 규칙을 삭제합니다. 이후의 모든 규칙의 색인이 감소합니다.
| JSON 표현 |
|---|
{ "index": integer, "sheetId": integer } |
| 필드 | |
|---|---|
index
|
삭제할 규칙의 0부터 시작하는 색인입니다. |
sheetId
|
규칙이 삭제되는 시트입니다. |
SortRangeRequest
열별 정렬 순서에 따라 행의 데이터를 정렬합니다.
| JSON 표현 |
|---|
{ "range": { object ( |
| 필드 | |
|---|---|
range
|
정렬할 범위입니다. |
sortSpecs[]
|
열별 정렬 순서입니다. 이전 사양의 값이 동일한 경우 이후 사양이 사용됩니다. |
SetDataValidationRequest
범위의 모든 셀에 데이터 확인 규칙을 설정합니다. 범위의 유효성 검사를 지우려면 규칙을 지정하지 않고 이 함수를 호출하세요.
| JSON 표현 |
|---|
{ "range": { object ( |
| 필드 | |
|---|---|
range
|
데이터 확인 규칙이 적용될 범위입니다. |
rule
|
범위의 각 셀에 설정할 데이터 확인 규칙입니다. 범위를 비워 범위의 데이터 확인을 지울 수도 있습니다. |
filteredRowsIncluded
|
선택사항입니다. true인 경우 데이터 확인 규칙이 필터링된 행에도 적용됩니다. |
SetBasicFilterRequest
시트와 연결된 기본 필터를 설정합니다.
| JSON 표현 |
|---|
{
"filter": {
object ( |
| 필드 | |
|---|---|
filter
|
설정할 필터입니다. |
AddProtectedRangeRequest
새 보호된 범위를 추가합니다.
| JSON 표현 |
|---|
{
"protectedRange": {
object ( |
| 필드 | |
|---|---|
protectedRange
|
추가할 보호된 범위입니다. |
UpdateProtectedRangeRequest
지정된 protectedRangeId로 기존 보호된 범위를 업데이트합니다.
| JSON 표현 |
|---|
{
"protectedRange": {
object ( |
| 필드 | |
|---|---|
protectedRange
|
새 속성으로 업데이트할 보호된 범위입니다. |
fields
|
업데이트해야 하는 필드입니다. 하나 이상의 필드를 지정해야 합니다. 루트 |
DeleteProtectedRangeRequest
지정된 ID가 있는 보호된 범위를 삭제합니다.
| JSON 표현 |
|---|
{ "protectedRangeId": integer } |
| 필드 | |
|---|---|
protectedRangeId
|
삭제할 보호된 범위의 ID입니다. |
AutoResizeDimensionsRequest
해당 측정기준의 셀 콘텐츠를 기반으로 하나 이상의 측정기준 크기를 자동으로 조절합니다.
| JSON 표현 |
|---|
{ // Union field |
| 필드 | |
|---|---|
통합 필드
dimension_range. 측정기준 범위입니다.
dimension_range은 다음 중 하나여야 합니다.
|
|
dimensions
|
자동으로 크기를 조정할 측정기준입니다. |
dataSourceSheetDimensions
|
자동으로 크기를 조절할 데이터 소스 시트의 측정기준입니다. |
AddChartRequest
스프레드시트의 시트에 차트를 추가합니다.
| JSON 표현 |
|---|
{
"chart": {
object ( |
| 필드 | |
|---|---|
chart
|
스프레드시트에 추가할 차트입니다. 배치할 위치도 포함됩니다. |
UpdateChartSpecRequest
차트의 사양을 업데이트합니다. (차트가 이동되거나 크기가 조정되지는 않습니다. 차트를 이동하거나 크기를 조절하려면 UpdateEmbeddedObjectPositionRequest를 사용합니다.)
| JSON 표현 |
|---|
{
"chartId": integer,
"spec": {
object ( |
| 필드 | |
|---|---|
chartId
|
업데이트할 차트의 ID입니다. |
spec
|
차트에 적용할 사양입니다. |
UpdateBandingRequest
제공된 범위의 속성을 업데이트합니다.
| JSON 표현 |
|---|
{
"bandedRange": {
object ( |
| 필드 | |
|---|---|
bandedRange
|
새 속성으로 업데이트할 범위입니다. |
fields
|
업데이트해야 하는 필드입니다. 하나 이상의 필드를 지정해야 합니다. 루트 |
AddBandingRequest
스프레드시트에 새로운 밴드 범위를 추가합니다.
| JSON 표현 |
|---|
{
"bandedRange": {
object ( |
| 필드 | |
|---|---|
bandedRange
|
추가할 밴드 범위입니다. |
DeleteBandingRequest
지정된 ID가 있는 밴드 범위를 스프레드시트에서 삭제합니다.
| JSON 표현 |
|---|
{ "bandedRangeId": integer } |
| 필드 | |
|---|---|
bandedRangeId
|
삭제할 밴드 범위의 ID입니다. |
CreateDeveloperMetadataRequest
개발자 메타데이터를 만들기 위한 요청입니다.
| JSON 표현 |
|---|
{
"developerMetadata": {
object ( |
| 필드 | |
|---|---|
developerMetadata
|
생성할 개발자 메타데이터입니다. |
UpdateDeveloperMetadataRequest
개발자 메타데이터의 속성을 업데이트하기 위한 요청입니다. 필터로 선택된 개발자 메타데이터의 속성을 DeveloperMetadata 리소스에 제공된 값으로 업데이트합니다. 호출자는 업데이트할 속성을 fields 매개변수에 지정해야 하며 업데이트할 메타데이터와 일치하는 DataFilter를 하나 이상 지정해야 합니다.
| JSON 표현 |
|---|
{ "dataFilters": [ { object ( |
| 필드 | |
|---|---|
dataFilters[]
|
업데이트할 개발자 메타데이터 항목과 일치하는 필터입니다. |
developerMetadata
|
데이터 필터로 일치하는 모든 메타데이터가 업데이트될 값입니다. |
fields
|
업데이트해야 하는 필드입니다. 하나 이상의 필드를 지정해야 합니다. 루트 |
DeleteDeveloperMetadataRequest
개발자 메타데이터 삭제 요청입니다.
| JSON 표현 |
|---|
{
"dataFilter": {
object ( |
| 필드 | |
|---|---|
dataFilter
|
삭제할 개발자 메타데이터 항목을 선택하는 데 사용되는 기준을 설명하는 데이터 필터입니다. |
RandomizeRangeRequest
범위의 행 순서를 무작위로 지정합니다.
| JSON 표현 |
|---|
{
"range": {
object ( |
| 필드 | |
|---|---|
range
|
무작위로 지정할 범위입니다. |
AddDimensionGroupRequest
지정된 범위에 그룹을 만듭니다.
요청된 범위가 기존 그룹 G의 상위 집합인 경우 G의 깊이가 증가하고 이 새 그룹 G'의 깊이는 해당 그룹의 깊이와 같습니다. 예를 들어 [C:D, depth 1] + [B:E] 는 [B:E, depth 1] 및 [C:D, depth 2] 그룹을 생성합니다. 요청된 범위가 기존 그룹 G의 범위의 하위 집합인 경우 새 그룹 G'의 깊이는 G의 깊이보다 1 커집니다. 예를 들어 [B:E, depth 1] + [C:D] 는 [B:E, depth 1] 및 [C:D, depth 2] 그룹을 생성합니다. 요청된 범위가 기존 그룹 G의 범위보다 먼저 시작하고 범위 내에서 끝나거나 범위 내에서 시작하고 범위 이후에 끝나면 기존 그룹 G의 범위가 범위의 합집합이 되고 새 그룹 G'의 깊이는 G의 깊이보다 1 크고 범위는 범위의 교집합이 됩니다. 예를 들어 [B:D, 깊이 1] + [C:E] 는 [B:E, 깊이 1] 및 [C:D, 깊이 2] 그룹이 됩니다.
| JSON 표현 |
|---|
{
"range": {
object ( |
| 필드 | |
|---|---|
range
|
그룹을 만들 범위입니다. |
DeleteDimensionGroupRequest
범위의 측정기준 깊이를 감소시켜 지정된 범위의 그룹을 삭제합니다.
예를 들어 시트에 B:E에 깊이 1 그룹이 있고 C:D에 깊이 2 그룹이 있다고 가정해 보겠습니다. D:E에 있는 그룹을 삭제하면 B:D에 깊이 1 그룹이 있고 C:C에 깊이 2 그룹이 있는 시트가 남습니다.
| JSON 표현 |
|---|
{
"range": {
object ( |
| 필드 | |
|---|---|
range
|
삭제할 그룹의 범위입니다. |
UpdateDimensionGroupRequest
지정된 그룹의 상태를 업데이트합니다.
| JSON 표현 |
|---|
{
"dimensionGroup": {
object ( |
| 필드 | |
|---|---|
dimensionGroup
|
상태를 업데이트해야 하는 그룹입니다. 그룹의 범위와 깊이는 시트의 유효한 그룹을 지정해야 하며 다른 모든 필드는 업데이트됩니다. |
fields
|
업데이트해야 하는 필드입니다. 하나 이상의 필드를 지정해야 합니다. 루트 |
TrimWhitespaceRequest
지정된 범위의 모든 셀에서 공백, 탭, 줄바꿈과 같은 공백을 자릅니다. 이 요청은 각 셀 텍스트의 시작과 끝에 있는 모든 공백을 삭제하고, 남아 있는 공백 문자의 모든 후속 항목을 단일 공백으로 줄입니다. 결과적으로 잘린 텍스트가 '+' 또는 '=' 문자로 시작하면 텍스트는 문자열 값으로 유지되며 수식으로 해석되지 않습니다.
| JSON 표현 |
|---|
{
"range": {
object ( |
| 필드 | |
|---|---|
range
|
셀을 자를 범위입니다. |
DeleteDuplicatesRequest
이 범위 내에서 지정된 열의 값이 이전 행의 값과 중복되는 행을 삭제합니다. 값은 동일하지만 대소문자, 형식, 수식이 다른 행도 중복으로 간주됩니다.
이 요청은 뷰에서 숨겨진 중복 행도 삭제합니다 (예: 필터로 인해). 중복 항목을 삭제할 때 위에서 아래로 스캔되는 각 중복 행의 첫 번째 인스턴스가 결과 범위에 유지됩니다. 지정된 범위 밖의 콘텐츠는 삭제되지 않으며 중복으로 간주되는 행이 범위 내에서 서로 인접할 필요는 없습니다.
| JSON 표현 |
|---|
{ "range": { object ( |
| 필드 | |
|---|---|
range
|
중복 행을 삭제할 범위입니다. |
comparisonColumns[]
|
중복 값을 분석할 범위의 열입니다. 열을 선택하지 않으면 모든 열에서 중복이 분석됩니다. |
UpdateEmbeddedObjectBorderRequest
삽입된 객체의 테두리 속성을 업데이트합니다.
| JSON 표현 |
|---|
{
"objectId": integer,
"border": {
object ( |
| 필드 | |
|---|---|
objectId
|
업데이트할 삽입된 객체의 ID입니다. |
border
|
삽입된 객체에 적용되는 테두리입니다. |
fields
|
업데이트해야 하는 필드입니다. 하나 이상의 필드를 지정해야 합니다. 루트 |
AddSlicerRequest
스프레드시트의 시트에 슬라이서를 추가합니다.
| JSON 표현 |
|---|
{
"slicer": {
object ( |
| 필드 | |
|---|---|
slicer
|
스프레드시트에 추가해야 하는 슬라이서입니다. 배치해야 하는 위치도 포함됩니다. |
UpdateSlicerSpecRequest
슬라이서의 사양을 업데이트합니다. (슬라이서가 이동되거나 크기가 조정되지는 않습니다. 슬라이서를 이동하거나 크기를 조절하려면 UpdateEmbeddedObjectPositionRequest를 사용합니다.
| JSON 표현 |
|---|
{
"slicerId": integer,
"spec": {
object ( |
| 필드 | |
|---|---|
slicerId
|
업데이트할 슬라이서의 ID입니다. |
spec
|
슬라이서에 적용할 사양입니다. |
fields
|
업데이트해야 하는 필드입니다. 하나 이상의 필드를 지정해야 합니다. 루트 |
AddDataSourceRequest
데이터 소스를 추가합니다. 데이터 소스가 추가되면 연결된 DATA_SOURCE 시트가 생성되고 데이터 소스에서 데이터를 읽도록 시트를 새로고침하는 실행이 트리거됩니다.
BigQuery 데이터 소스를 추가하는 경우 요청에 추가 bigquery.readonly OAuth 범위가 필요합니다.
| JSON 표현 |
|---|
{
"dataSource": {
object ( |
| 필드 | |
|---|---|
dataSource
|
추가할 데이터 소스입니다. |
UpdateDataSourceRequest
데이터 소스를 업데이트합니다. 데이터 소스가 업데이트되면 연결된 DATA_SOURCE 시트를 새로고침하여 업데이트된 데이터 소스에서 데이터를 읽어오는 실행이 트리거됩니다.
BigQuery 데이터 소스를 업데이트하는 경우 요청에 추가 bigquery.readonly OAuth 범위가 필요합니다.
| JSON 표현 |
|---|
{
"dataSource": {
object ( |
| 필드 | |
|---|---|
dataSource
|
업데이트할 데이터 소스입니다. |
fields
|
업데이트해야 하는 필드입니다. 하나 이상의 필드를 지정해야 합니다. 루트 |
DeleteDataSourceRequest
데이터 소스를 삭제합니다. 또한 요청 시 연결된 데이터 소스 시트가 삭제되고 연결된 모든 데이터 소스 객체의 연결이 해제됩니다.
| JSON 표현 |
|---|
{ "dataSourceId": string } |
| 필드 | |
|---|---|
dataSourceId
|
삭제할 데이터 소스의 ID입니다. |
RefreshDataSourceRequest
지정된 참조를 기준으로 스프레드시트의 하나 이상의 데이터 소스 객체를 새로고침합니다.
BigQuery 데이터 소스를 새로고침하는 경우 요청에 추가 bigquery.readonly OAuth 범위가 필요합니다.
한 배치에서 동일한 데이터 소스 객체를 참조하는 새로고침 요청이 여러 개 있는 경우 마지막 새로고침 요청만 처리되며 모든 요청의 응답은 동일합니다.
| JSON 표현 |
|---|
{ "force": boolean, // Union field |
| 필드 | |
|---|---|
force
|
현재 상태와 관계없이 데이터 소스 객체를 새로고침합니다. 설정되지 않았고 참조된 데이터 소스 객체가 오류 상태인 경우 새로고침이 즉시 실패합니다. |
통합 필드
target. 새로고침할 항목을 지정합니다.
target은 다음 중 하나여야 합니다.
|
|
references
|
새로고침할 데이터 소스 객체에 대한 참조입니다. |
dataSourceId
|
|
isAll
|
스프레드시트의 모든 기존 데이터 소스 객체를 새로고침합니다. |
DataSourceObjectReferences
데이터 소스 객체에 대한 참조 목록입니다.
| JSON 표현 |
|---|
{
"references": [
{
object ( |
| 필드 | |
|---|---|
references[]
|
참조입니다. |
DataSourceObjectReference
데이터 소스 객체에 대한 참조입니다.
| JSON 표현 |
|---|
{ // Union field |
| 필드 | |
|---|---|
통합 필드
value. 참조 유형입니다.
value은 다음 중 하나여야 합니다.
|
|
sheetId
|
|
chartId
|
데이터 소스 차트에 대한 참조입니다. |
dataSourceTableAnchorCell
|
셀에 고정된 |
dataSourcePivotTableAnchorCell
|
셀에 고정된 데이터 소스를 참조합니다.
|
dataSourceFormulaCell
|
|
CancelDataSourceRefreshRequest
지정된 참조에 따라 스프레드시트에서 데이터 소스 객체의 새로고침을 하나 이상 취소합니다.
BigQuery 데이터 소스의 새로고침을 취소하는 경우 요청에 추가 bigquery.readonly OAuth 범위가 필요합니다.
| JSON 표현 |
|---|
{ // Union field |
| 필드 | |
|---|---|
통합 필드
target. 취소할 항목을 지정합니다.
target은 다음 중 하나여야 합니다.
|
|
references
|
새로고침을 취소할 데이터 소스 객체에 대한 참조입니다. |
dataSourceId
|
|
isAll
|
스프레드시트의 모든 데이터 소스에 대해 기존 데이터 소스 객체 새로고침을 모두 취소합니다. |
AddTableRequest
스프레드시트에 새 표를 추가합니다.
| JSON 표현 |
|---|
{
"table": {
object ( |
| 필드 | |
|---|---|
table
|
필수 항목입니다. 추가할 테이블입니다. |
UpdateTableRequest
스프레드시트의 테이블을 업데이트합니다.
| JSON 표현 |
|---|
{
"table": {
object ( |
| 필드 | |
|---|---|
table
|
필수 항목입니다. 업데이트할 테이블입니다. |
fields
|
필수 항목입니다. 업데이트해야 하는 필드입니다. 하나 이상의 필드를 지정해야 합니다. 루트 |
DeleteTableRequest
지정된 ID의 표를 스프레드시트에서 삭제합니다.
| JSON 표현 |
|---|
{ "tableId": string } |
| 필드 | |
|---|---|
tableId
|
삭제할 테이블의 ID입니다. |