Cells

셀 데이터

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

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' 또는 =NOW() 참고: Date, Times, DateTime은 serial number 형식으로 double로 표현됩니다.

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)).

셀 서식

셀의 형식입니다.

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

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

숫자 형식 유형

셀의 숫자 형식입니다. 이 문서에서는 언어가 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 테두리는 두 개의 실선입니다.

패딩

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

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

integer

셀의 상단 패딩입니다.

right

integer

셀의 오른쪽 패딩

bottom

integer

셀의 하단 패딩입니다.

left

integer

셀의 왼쪽 패딩입니다.

세로 맞춤

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

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

랩전략

셀 내 텍스트 줄바꿈

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

텍스트 방향

셀 내 텍스트 방향입니다.

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

HyperlinkDisplayType 클래스의 생성자

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

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

텍스트 회전

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

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 |

텍스트 형식 실행

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

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인 경우 '목록' 조건에 드롭다운이 표시됩니다.

데이터 소스 테이블

사용자가 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)

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

데이터 소스 표 열 선택 유형

데이터 소스 표의 열 선택 유형.

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

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

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

데이터 소스 수식

데이터 소스 수식

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

string

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

dataExecutionStatus

object (DataExecutionStatus)

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