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)
  }
}
필드
userEnteredValue

object (ExtendedValue)

사용자가 셀에 입력한 값입니다. 예: 1234, 'Hello' 또는 <ph type="x-smartling-placeholder">=NOW()</ph> 참고: Dates, Times 및 DateTime은 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)입니다.

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

테두리의 너비입니다(단위: 픽셀). 지원 중단됨 너비는 '스타일'에 의해 결정됩니다. 필드를 확인합니다.

color
(deprecated)

object (Color)

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

colorStyle

object (ColorStyle)

테두리의 색상입니다. 만약 color 도 설정되어 있으면 이 필드가 우선합니다.

스타일

테두리 스타일입니다.

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

패딩

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

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인 경우 'List' 드롭다운이 표시됩니다.

DataSourceTable

사용자가 DataSource 스프레드시트로 변환할 수 있습니다. 이를 '추출'이라고도 합니다. 스프레드시트 편집기에서 확인할 수 있습니다

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)

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