Cells

CellData

특정 셀에 관한 데이터입니다.

JSON 표현 
{
  "userEnteredValue": {
    object (ExtendedValue)
  },
  "effectiveValue": {
    object (ExtendedValue)
  },
  "formattedValue": string,
  "userEnteredFormat": {
    object (CellFormat)
  },
  "effectiveFormat": {
    object (CellFormat)
  },
  "hyperlink": string,
  "note": string,
  "textFormatRuns": [
    {
      object (TextFormatRun)
    }
  ],
  "dataValidation": {
    object (DataValidationRule)
  },
  "pivotTable": {
    object (PivotTable)
  },
  "dataSourceTable": {
    object (DataSourceTable)
  },
  "dataSourceFormula": {
    object (DataSourceFormula)
  },
  "chipRuns": [
    {
      object (ChipRun)
    }
  ]
}
필드
userEnteredValue

object (ExtendedValue)

사용자가 셀에 입력한 값입니다. 예: 1234, 'Hello' 또는 =NOW(). 참고: 날짜, 시간, 날짜-시간은 serial number 형식의 이중으로 표시됩니다.

effectiveValue

object (ExtendedValue)

셀의 유효 값입니다. 수식이 있는 셀의 경우 계산된 값입니다. 리터럴이 있는 셀의 경우 userEnteredValue와 동일합니다. 이 필드는 읽기 전용입니다.

formattedValue

string

셀의 형식이 지정된 값입니다. 사용자에게 표시되는 값입니다. 이 필드는 읽기 전용입니다.

userEnteredFormat

object (CellFormat)

사용자가 셀에 입력한 형식입니다.

작성 시 새 형식이 기존 형식과 병합됩니다.

effectiveFormat

object (CellFormat)

셀에서 사용 중인 유효 형식입니다. 여기에는 조건부 서식을 적용한 결과와 셀에 수식이 포함된 경우 계산된 숫자 형식이 포함됩니다. 유효한 형식이 기본 형식인 경우 유효한 형식이 작성되지 않습니다. 이 필드는 읽기 전용입니다.

note

string

셀에 관한 메모입니다.

textFormatRuns[]

object (TextFormatRun)

셀의 하위 섹션에 적용된 서식 있는 텍스트 실행입니다. 실행은 수식, 불리언, 숫자가 아닌 사용자가 입력한 문자열에만 유효합니다. 실행의 속성은 텍스트의 특정 색인에서 시작하여 다음 실행까지 계속됩니다. 실행은 명시적으로 변경되지 않는 한 셀의 속성을 상속합니다.

작성 시 새 실행이 이전 실행을 덮어씁니다. 새 userEnteredValue를 작성하면 이전 실행이 삭제됩니다.

dataValidation

object (DataValidationRule)

셀의 데이터 확인 규칙(있는 경우)

작성 시 새 데이터 유효성 검사 규칙이 이전 규칙을 덮어씁니다.

pivotTable

object (PivotTable)

이 셀에 고정된 피벗 테이블입니다. 피벗 테이블 자체의 크기는 데이터, 그룹화, 필터, 값 등을 기반으로 동적으로 계산됩니다. 피벗 테이블의 왼쪽 상단 셀에만 피벗 테이블 정의가 포함됩니다. 다른 셀에는 effectiveValue 필드에 피벗 결과의 계산된 값이 포함됩니다.

dataSourceTable

object (DataSourceTable)

이 셀에 고정된 데이터 소스 표입니다. 데이터 소스 테이블 자체의 크기는 구성에 따라 동적으로 계산됩니다. 데이터 소스 테이블의 첫 번째 셀에만 데이터 소스 테이블 정의가 포함됩니다. 다른 셀에는 데이터 소스 표 결과의 표시 값이 effectiveValue 필드에 포함됩니다.

dataSourceFormula

object (DataSourceFormula)

출력 전용입니다. 셀의 데이터 소스 수식에 관한 정보입니다. userEnteredValue가 일부 DATA_SOURCE 시트(예: =SUM(DataSheet!Column))를 참조하는 수식인 경우 필드가 설정됩니다.

chipRuns[]

object (ChipRun)

선택사항입니다. 셀의 하위 섹션에 적용된 칩 실행입니다. 실행의 속성은 텍스트의 특정 색인에서 시작하여 다음 실행까지 계속됩니다.

읽을 때는 칩이 있는 런과 칩이 없는 런이 모두 포함됩니다. 칩이 없는 런에는 빈 Chip가 있습니다.

작성 시에는 칩이 있는 실행만 포함됩니다. 칩이 포함된 실행은 길이가 1이며 사용자 입력 텍스트에서 '@' 자리표시자 기호로 표시됩니다. 새 실행은 이전 실행을 덮어씁니다. 새 userEnteredValue를 쓰면 이전 실행이 삭제됩니다.

CellFormat

셀의 형식입니다.

JSON 표현 
{
  "numberFormat": {
    object (NumberFormat)
  },
  "backgroundColor": {
    object (Color)
  },
  "backgroundColorStyle": {
    object (ColorStyle)
  },
  "borders": {
    object (Borders)
  },
  "padding": {
    object (Padding)
  },
  "horizontalAlignment": enum (HorizontalAlign),
  "verticalAlignment": enum (VerticalAlign),
  "wrapStrategy": enum (WrapStrategy),
  "textDirection": enum (TextDirection),
  "textFormat": {
    object (TextFormat)
  },
  "hyperlinkDisplayType": enum (HyperlinkDisplayType),
  "textRotation": {
    object (TextRotation)
  }
}
필드
numberFormat

object (NumberFormat)

숫자 값을 사용자에게 표시하는 방법을 설명하는 형식입니다.

backgroundColor
(deprecated)

object (Color)

셀의 배경 색상입니다. 지원 중단됨: backgroundColorStyle를 사용하세요.

backgroundColorStyle

object (ColorStyle)

셀의 배경 색상입니다. backgroundColor도 설정된 경우 이 필드가 우선 적용됩니다.

borders

object (Borders)

셀의 테두리입니다.

padding

object (Padding)

셀의 패딩입니다.

horizontalAlignment

enum (HorizontalAlign)

셀의 값의 가로 정렬입니다.

verticalAlignment

enum (VerticalAlign)

셀의 값의 세로 정렬입니다.

wrapStrategy

enum (WrapStrategy)

셀의 값에 대한 줄바꿈 전략입니다.

textDirection

enum (TextDirection)

셀의 텍스트 방향입니다.

textFormat

object (TextFormat)

셀의 텍스트 형식입니다 (서식 실행으로 재정의하지 않는 한). 여기에서 셀 수준 링크를 설정하면 셀의 기존 링크가 삭제됩니다. TextFormatRun에서 링크 필드를 설정하면 셀 수준 링크보다 우선 적용됩니다.

textRotation

object (TextRotation)

셀의 텍스트에 적용된 회전입니다.

NumberFormat

셀의 숫자 형식입니다.

JSON 표현 
{
  "type": enum (NumberFormatType),
  "pattern": string
}
필드
type

enum (NumberFormatType)

숫자 형식의 유형입니다. 쓰기 시 이 필드를 설정해야 합니다.

pattern

string

형식 지정에 사용되는 패턴 문자열입니다. 설정하지 않으면 지정된 유형에 필요한 경우 사용자의 언어를 기반으로 하는 기본 패턴이 사용됩니다. 지원되는 패턴에 관한 자세한 내용은 날짜 및 숫자 형식 가이드를 참고하세요.

NumberFormatType

셀의 숫자 형식입니다. 이 문서에서는 언어를 en_US로 가정하지만 실제 형식은 스프레드시트의 언어에 따라 다릅니다.

열거형
NUMBER_FORMAT_TYPE_UNSPECIFIED 숫자 형식은 지정되지 않으며 셀의 콘텐츠를 기반으로 합니다. 명시적으로 사용하지 마세요.
TEXT 텍스트 서식(예: 1000.12)
NUMBER 숫자 형식(예: 1,000.12)
PERCENT 퍼센트 형식(예: 10.12%)
CURRENCY 통화 형식(예: $1,000.12)
DATE 날짜 형식(예: 9/26/2008)
TIME 시간 형식(예: 3:59:00 PM)
DATE_TIME 날짜+시간 형식(예: 9/26/08 15:59:00)
SCIENTIFIC 과학적 숫자 형식(예: 1.01E+03)

테두리

셀의 테두리입니다.

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

object (Border)

셀의 상단 테두리입니다.

bottom

object (Border)

셀의 하단 테두리입니다.

left

object (Border)

셀의 왼쪽 테두리입니다.

right

object (Border)

셀의 오른쪽 테두리입니다.

테두리

셀의 테두리

JSON 표현 
{
  "style": enum (Style),
  "width": integer,
  "color": {
    object (Color)
  },
  "colorStyle": {
    object (ColorStyle)
  }
}
필드
style

enum (Style)

테두리 스타일입니다.

width
(deprecated)

integer

테두리 너비(픽셀)입니다. 지원 중단됨. 너비는 'style' 필드에 따라 결정됩니다.

color
(deprecated)

object (Color)

테두리의 색상입니다. 지원 중단됨: colorStyle를 사용하세요.

colorStyle

object (ColorStyle)

테두리의 색상입니다. color도 설정된 경우 이 필드가 우선 적용됩니다.

스타일

테두리 스타일입니다.

열거형
STYLE_UNSPECIFIED 스타일이 지정되지 않았습니다. 사용하지 마세요.
DOTTED 테두리가 점선으로 표시됩니다.
DASHED 테두리가 점선으로 표시됩니다.
SOLID 테두리는 얇은 실선입니다.
SOLID_MEDIUM 테두리는 중간 굵기의 실선입니다.
SOLID_THICK 테두리는 굵은 실선입니다.
NONE 테두리가 없습니다. 테두리를 지우기 위해 테두리를 업데이트할 때만 사용됩니다.
DOUBLE 테두리는 두 개의 실선입니다.

패딩

셀 주변의 패딩 크기(단위: 픽셀)입니다. 패딩을 업데이트할 때는 모든 필드를 지정해야 합니다.

JSON 표현 
{
  "top": integer,
  "right": integer,
  "bottom": integer,
  "left": integer
}
필드
top

integer

셀의 상단 여백입니다.

right

integer

셀의 오른쪽 여백입니다.

bottom

integer

셀의 하단 패딩입니다.

left

integer

셀의 왼쪽 패딩입니다.

VerticalAlign

셀의 텍스트 세로 정렬입니다.

열거형
VERTICAL_ALIGN_UNSPECIFIED 세로 정렬이 지정되지 않았습니다. 사용하지 마세요.
TOP 텍스트가 셀 상단에 명시적으로 정렬됩니다.
MIDDLE 텍스트가 셀 중앙에 명시적으로 정렬됩니다.
BOTTOM 텍스트가 셀 하단에 명시적으로 정렬됩니다.

WrapStrategy

셀에서 텍스트를 줄바꿈하는 방법

열거형
WRAP_STRATEGY_UNSPECIFIED 기본값이며 사용할 수 없습니다.
OVERFLOW_CELL

셀 너비보다 긴 선은 다음 셀이 비어 있는 경우 다음 셀에 작성됩니다. 다음 셀이 비어 있지 않으면 CLIP와 동일하게 작동합니다. 사용자가 새 줄을 수동으로 삽입하지 않는 한 텍스트가 다음 줄로 넘어가지 않습니다. 예: 

| First sentence. |
| Manual newline that is very long. <- Text continues into next cell
| Next newline.   |
LEGACY_WRAP

이 줄바꿈 전략은 한 줄보다 긴 단어가 줄바꿈되는 대신 잘리는 이전 Google Sheets 줄바꿈 전략을 나타냅니다. 이 전략은 일부 플랫폼에서만 지원되며 점진적으로 지원 중단됩니다. 예: 

| Cell has a |
| loooooooooo| <- Word is clipped.
| word.      |
CLIP

셀 너비보다 긴 선은 잘립니다. 사용자가 새 줄을 수동으로 삽입하지 않는 한 텍스트가 다음 줄로 넘어가지 않습니다. 예: 

| First sentence. |
| Manual newline t| <- Text is clipped
| Next newline.   |
WRAP

한 줄보다 긴 단어는 잘리는 대신 문자 수준에서 줄바꿈됩니다. 예: 

| Cell has a |
| loooooooooo| <- Word is broken.
| ong word.  |

TextDirection

셀의 텍스트 방향입니다.

열거형
TEXT_DIRECTION_UNSPECIFIED 텍스트 방향이 지정되지 않았습니다. 사용하지 마세요.
LEFT_TO_RIGHT 사용자가 텍스트 방향을 왼쪽에서 오른쪽으로 설정했습니다.
RIGHT_TO_LEFT 사용자가 텍스트 방향을 오른쪽에서 왼쪽으로 설정했습니다.

HyperlinkDisplayType

하이퍼링크를 명시적으로 렌더링할지 여부입니다. 지정하지 않으면 하이퍼링크가 연결됩니다.

열거형
LINKED 하이퍼링크는 명시적으로 렌더링되어야 합니다.
PLAIN_TEXT 하이퍼링크는 렌더링되어서는 안 됩니다.

TextRotation

셀의 텍스트에 적용된 회전입니다.

JSON 표현 
{

  // Union field type can be only one of the following:
  "angle": integer,
  "vertical": boolean
  // End of list of possible types for union field type.
}
필드
공용체 필드 type입니다. 회전 유형(세로 또는 각도)입니다. type는 다음 중 하나여야 합니다.
angle

integer

표준 방향과 원하는 방향 간의 각도입니다. 도 단위로 측정됩니다. 유효한 값은 -90과 90 사이입니다. 양수 각도는 위쪽을 향하고 음수 각도는 아래쪽을 향합니다.

참고: LTR 텍스트 방향의 경우 양수 각도는 시계 반대 방향이지만 RTL의 경우 시계 방향입니다.

vertical

boolean

true인 경우 텍스트가 위에서 아래로 읽히지만 개별 문자의 방향은 변경되지 않습니다. 예를 들면 다음과 같습니다. 

| V |
| e |
| r |
| t |
| i |
| c |
| a |
| l |

TextFormatRun

텍스트 형식 실행 이 실행의 형식은 다음 실행의 시작 인덱스까지 계속됩니다. 업데이트할 때는 모든 필드를 설정해야 합니다.

JSON 표현 
{
  "startIndex": integer,
  "format": {
    object (TextFormat)
  }
}
필드
startIndex

integer

이 실행이 시작되는 0 기반 문자 인덱스(UTF-16 코드 단위)입니다.

format

object (TextFormat)

실행의 형식입니다. 값이 없는 경우 셀의 형식이 상속됩니다.

DataValidationRule

데이터 확인 규칙

JSON 표현 
{
  "condition": {
    object (BooleanCondition)
  },
  "inputMessage": string,
  "strict": boolean,
  "showCustomUi": boolean
}
필드
condition

object (BooleanCondition)

셀의 데이터가 일치해야 하는 조건입니다.

inputMessage

string

셀에 데이터를 추가할 때 사용자에게 표시할 메시지입니다.

strict

boolean

잘못된 데이터를 거부해야 하는 경우 true입니다.

showCustomUi

boolean

조건의 종류에 따라 UI를 맞춤설정해야 하는 경우 true입니다. true인 경우 '목록' 조건에 드롭다운이 표시됩니다.

DataSourceTable

사용자가 DataSource에서 Sheets로 정적 데이터 테이블을 가져올 수 있는 데이터 소스 테이블입니다. Sheets 편집기에서는 이를 '추출'이라고도 합니다.

JSON 표현 
{
  "dataSourceId": string,
  "columnSelectionType": enum (DataSourceTableColumnSelectionType),
  "columns": [
    {
      object (DataSourceColumnReference)
    }
  ],
  "filterSpecs": [
    {
      object (FilterSpec)
    }
  ],
  "sortSpecs": [
    {
      object (SortSpec)
    }
  ],
  "rowLimit": integer,
  "dataExecutionStatus": {
    object (DataExecutionStatus)
  }
}
필드
dataSourceId

string

데이터 소스 테이블이 연결된 데이터 소스의 ID입니다.

columnSelectionType

enum (DataSourceTableColumnSelectionType)

데이터 소스 표의 열을 선택하는 유형입니다. 기본값은 SELECTED입니다.

columns[]

object (DataSourceColumnReference)

데이터 소스 표에 선택된 열입니다. columnSelectionType는 SELECTED여야 합니다.

filterSpecs[]

object (FilterSpec)

데이터 소스 표에서 사양을 필터링합니다.

sortSpecs[]

object (SortSpec)

데이터 소스 표에서 사양을 정렬합니다. 데이터 소스 테이블의 결과는 정렬 사양에 따라 순서대로 정렬됩니다.

rowLimit

integer

반환할 행의 한도입니다. 설정하지 않으면 기본 한도가 적용됩니다. 기본 및 최대 한도는 Sheets 편집기를 참고하세요.

dataExecutionStatus

object (DataExecutionStatus)

출력 전용입니다. 데이터 실행 상태입니다.

DataSourceTableColumnSelectionType

데이터 소스 표 열 선택 유형입니다.

열거형
DATA_SOURCE_TABLE_COLUMN_SELECTION_TYPE_UNSPECIFIED 기본 열 선택 유형이며 사용하지 마세요.
SELECTED columns 필드로 지정된 열을 선택합니다.
SYNC_ALL

데이터 소스의 현재 및 향후 열을 모두 동기화합니다.

이 옵션을 설정하면 데이터 소스 테이블이 새로고침 시 데이터 소스의 모든 열을 가져옵니다.

DataSourceFormula

데이터 소스 수식

JSON 표현 
{
  "dataSourceId": string,
  "dataExecutionStatus": {
    object (DataExecutionStatus)
  }
}
필드
dataSourceId

string

수식이 연결된 데이터 소스의 ID입니다.

dataExecutionStatus

object (DataExecutionStatus)

출력 전용입니다. 데이터 실행 상태입니다.

ChipRun

칩 실행 칩은 다음 실행의 시작 색인까지 계속됩니다.

JSON 표현 
{
  "startIndex": integer,
  "chip": {
    object (Chip)
  }
}
필드
startIndex

integer

필수 항목입니다. 이 실행이 시작되는 0 기반 문자 인덱스(UTF-16 코드 단위)입니다.

chip

object (Chip)

선택사항입니다. 이 실행의 칩입니다.

칩

스마트 칩

JSON 표현 
{

  // Union field properties can be only one of the following:
  "personProperties": {
    object (PersonProperties)
  },
  "richLinkProperties": {
    object (RichLinkProperties)
  }
  // End of list of possible types for union field properties.
}
필드
공용체 필드 properties입니다. 칩의 속성입니다. properties는 다음 중 하나여야 합니다.
personProperties

object (PersonProperties)

연결된 사용자의 속성입니다.

PersonProperties

연결된 사용자와 관련된 속성입니다.

JSON 표현 
{
  "email": string,
  "displayFormat": enum (DisplayFormat)
}
필드
email

string

필수 항목입니다. 이 사용자와 연결된 이메일 주소입니다. 이 필드는 항상 표시됩니다.

displayFormat

enum (DisplayFormat)

선택사항입니다. 사용자 칩의 표시 형식입니다. 설정하지 않으면 기본 표시 형식이 사용됩니다.

DisplayFormat

가능한 경우 기본 디스플레이 형식

열거형
DISPLAY_FORMAT_UNSPECIFIED 기본값이며 사용할 수 없습니다.
DEFAULT 기본 디스플레이 형식입니다.
LAST_NAME_COMMA_FIRST_NAME 성, 이름 표시 형식입니다.
EMAIL 이메일 표시 형식입니다.

RichLinkProperties

Google 리소스 (예: Drive의 파일, YouTube 동영상, 지도 주소, Calendar 일정) 링크의 속성입니다. Drive 파일만 칩으로 작성할 수 있습니다. 다른 모든 리치 링크 유형은 읽기 전용입니다.

URI는 작성 시 2,000바이트를 초과할 수 없습니다.

참고: Drive 파일 칩을 쓰려면 drive.file, drive.readonly 또는 drive OAuth 범위 중 하나 이상이 필요합니다.

JSON 표현 
{
  "uri": string,
  "mimeType": string
}
필드
uri

string

필수 항목입니다. 링크의 URI입니다. 항상 존재합니다.

mimeType

string

출력 전용입니다. 링크의 MIME 유형입니다 (예: Drive의 파일인 경우).