Text

텍스트 콘텐츠

일반 텍스트 콘텐츠입니다. 텍스트는 호환되는 도형 (예: 텍스트 상자 또는 직사각형) 또는 표의 셀 셀에 있어야 합니다.

JSON 표현 
{
  "textElements": [
    {
      object (TextElement)
    }
  ],
  "lists": {
    string: {
      object (List)
    },
    ...
  }
}
필드
textElements[]

object (TextElement)

스타일 지정 정보를 포함하여 구성요소로 분류된 텍스트 콘텐츠입니다. 이 속성은 읽기 전용입니다.

lists

map (key: string, value: object ( List))

이 텍스트에 포함된 글머리기호 목록으로, 목록 ID로 키가 지정됩니다.

TextElement

TextElement는 도형 또는 테이블 셀의 텍스트 콘텐츠에 있는 다양한 색인의 콘텐츠를 설명합니다.

JSON 표현 
{
  "startIndex": integer,
  "endIndex": integer,

  // Union field kind can be only one of the following:
  "paragraphMarker": {
    object (ParagraphMarker)
  },
  "textRun": {
    object (TextRun)
  },
  "autoText": {
    object (AutoText)
  }
  // End of list of possible types for union field kind.
}
필드
startIndex

integer

이 텍스트 요소의 0부터 시작하는 시작 색인입니다(유니코드 코드 단위).

endIndex

integer

이 텍스트 요소의 0부터 시작하는 종료 색인(유니코드 코드 단위 제외)입니다.

공용체 필드 kind는 이 요소가 나타내는 텍스트의 종류입니다. kind는 다음 중 하나여야 합니다.
paragraphMarker

object (ParagraphMarker)

새로운 단락의 시작을 나타내는 마커입니다.

이 TextElement의 startIndex 및 endIndex는 단락의 범위를 나타냅니다. 이 단락 범위 내에 색인 범위가 포함된 다른 TextElement는 이 단락의 일부로 간주됩니다. 두 단락의 색인 범위는 결코 겹치지 않습니다.

textRun

object (TextRun)

런의 모든 문자가 동일한 TextStyle인 텍스트 런을 나타내는 TextElement입니다.

TextRun의 startIndex 및 endIndex는 항상 단일 paragraphMarker TextElement의 색인 범위에 완전히 포함됩니다. 즉, TextRun은 여러 단락으로 확장되지 않습니다.

autoText

object (AutoText)

시간이 지남에 따라 변할 수 있는 콘텐츠로 동적으로 대체되는 텍스트의 한 지점을 나타내는 TextElement입니다.

단락 마커

새 단락의 시작을 나타내는 TextElement 종류입니다.

JSON 표현 
{
  "style": {
    object (ParagraphStyle)
  },
  "bullet": {
    object (Bullet)
  }
}
필드
style

object (ParagraphStyle)

단락의 스타일

bullet

object (Bullet)

이 단락의 글머리기호입니다. 없는 경우 단락이 목록에 속하지 않습니다.

ParagraphStyle

전체 단락에 적용되는 스타일입니다.

이 텍스트가 상위 placeholder를 포함하는 도형에 포함되어 있으면 이 단락 스타일이 상위 요소로부터 상속될 수 있습니다. 상속되는 단락 스타일은 목록의 중첩 수준에 따라 다릅니다.

  • 목록에 없는 단락은 상위 자리표시자 내에서 목록의 0 중첩 수준에 있는 단락에서 단락 스타일을 상속합니다.
  • 목록의 단락은 상위 자리표시자 내 목록의 해당 중첩 수준에 있는 단락에서 단락 스타일을 상속합니다.

상속된 단락 스타일은 이 메시지에서 설정되지 않은 필드로 표시됩니다.

JSON 표현 
{
  "lineSpacing": number,
  "alignment": enum (Alignment),
  "indentStart": {
    object (Dimension)
  },
  "indentEnd": {
    object (Dimension)
  },
  "spaceAbove": {
    object (Dimension)
  },
  "spaceBelow": {
    object (Dimension)
  },
  "indentFirstLine": {
    object (Dimension)
  },
  "direction": enum (TextDirection),
  "spacingMode": enum (SpacingMode)
}
필드
lineSpacing

number

선 사이의 간격으로, 정상은 100.0으로 표시됩니다. 설정하지 않으면 값이 상위 요소로부터 상속됩니다.

alignment

enum (Alignment)

이 단락의 텍스트 정렬입니다.

indentStart

object (Dimension)

현재 텍스트 방향을 기준으로 텍스트의 시작 부분에 해당하는 단락 단락의 들여쓰기 간격입니다. 설정하지 않으면 값이 상위 요소로부터 상속됩니다.

indentEnd

object (Dimension)

현재 텍스트 방향을 기준으로 텍스트의 끝 부분에 해당하는 단락 단락의 들여쓰기 간격입니다. 설정하지 않으면 값이 상위 요소로부터 상속됩니다.

spaceAbove

object (Dimension)

단락 위의 추가 공백입니다. 설정하지 않으면 값이 상위 요소로부터 상속됩니다.

spaceBelow

object (Dimension)

단락 아래에 여분의 공간이 표시됩니다. 설정하지 않으면 값이 상위 요소로부터 상속됩니다.

indentFirstLine

object (Dimension)

단락 첫 번째 줄의 시작 부분을 들여씁니다. 설정하지 않으면 값이 상위 요소로부터 상속됩니다.

direction

enum (TextDirection)

이 단락의 텍스트 방향입니다. 설정하지 않으면 텍스트 방향이 상속되지 않으므로 값이 LEFT_TO_RIGHT로 기본 설정됩니다.

spacingMode

enum (SpacingMode)

단락의 간격 모드입니다.

정렬

단락의 텍스트 정렬 유형입니다.

열거형
ALIGNMENT_UNSPECIFIED 단락 정렬은 상위 요소로부터 상속됩니다.
START 단락이 줄의 시작 부분에 정렬됩니다. LTR 텍스트의 경우 왼쪽, 그렇지 않은 경우 오른쪽 정렬
CENTER 단락이 중앙에 표시됩니다.
END 단락이 줄의 끝에 정렬됩니다. LTR 텍스트의 경우 오른쪽 정렬, 그렇지 않은 경우 왼쪽 정렬
JUSTIFIED 단락이 정렬되었습니다.

텍스트 방향

텍스트 경로가 표시될 수 있습니다.

열거형
TEXT_DIRECTION_UNSPECIFIED 텍스트 방향은 상위 요소로부터 상속됩니다.
LEFT_TO_RIGHT 텍스트가 왼쪽에서 오른쪽으로 이동합니다.
RIGHT_TO_LEFT 텍스트가 오른쪽에서 왼쪽으로 이동합니다.

간격 모드

단락 간격의 여러 모드입니다.

열거형
SPACING_MODE_UNSPECIFIED 간격 모드는 상위 요소로부터 상속됩니다.
NEVER_COLLAPSE 단락 간격은 항상 렌더링됩니다.
COLLAPSE_LISTS 목록 요소 간에 단락 간격을 건너뜁니다.

불릿

단락의 글머리기호를 설명합니다.

JSON 표현 
{
  "listId": string,
  "nestingLevel": integer,
  "glyph": string,
  "bulletStyle": {
    object (TextStyle)
  }
}
필드
listId

string

이 단락이 속한 목록의 ID입니다.

nestingLevel

integer

목록에서 이 단락의 중첩 수준입니다.

glyph

string

이 단락에 대해 렌더링된 글머리 기호 글리프입니다.

bulletStyle

object (TextStyle)

이 글머리기호에 적용되는 단락별 텍스트 스타일입니다.

TextStyle

TextRun에 적용할 수 있는 스타일을 나타냅니다.

이 텍스트가 상위 placeholder가 있는 도형에 포함되어 있으면 이 텍스트 스타일이 상위 요소로부터 상속될 수 있습니다. 상속되는 텍스트 스타일은 목록의 중첩 수준에 따라 다릅니다.

  • 목록에 없는 단락에서 실행되는 텍스트는 상위 자리표시자 내 목록의 0 중첩 수준에서 단락의 줄바꿈 문자에서 텍스트 스타일을 상속합니다.
  • 목록에 있는 단락에서 실행되는 텍스트는 상위 자리표시자 내 목록의 해당 중첩 수준에서 단락의 줄바꿈 문자에서 텍스트 스타일을 상속합니다.

상속된 텍스트 스타일은 이 메시지에서 설정되지 않은 필드로 표시됩니다. 상위 자리표시자가 없는 도형에 텍스트가 포함된 경우 이 필드를 설정 해제하면 스타일이 Slides 편집기에서 기본값과 일치하는 값으로 되돌아갑니다.

JSON 표현 
{
  "backgroundColor": {
    object (OptionalColor)
  },
  "foregroundColor": {
    object (OptionalColor)
  },
  "bold": boolean,
  "italic": boolean,
  "fontFamily": string,
  "fontSize": {
    object (Dimension)
  },
  "link": {
    object (Link)
  },
  "baselineOffset": enum (BaselineOffset),
  "smallCaps": boolean,
  "strikethrough": boolean,
  "underline": boolean,
  "weightedFontFamily": {
    object (WeightedFontFamily)
  }
}
필드
backgroundColor

object (OptionalColor)

텍스트의 배경색입니다. 이 속성을 설정하면 색상의 opaqueColor 필드가 설정되어 있는지에 따라 색상이 불투명하거나 투명합니다.

foregroundColor

object (OptionalColor)

텍스트 자체의 색상입니다. 이 속성을 설정하면 색상의 opaqueColor 필드가 설정되어 있는지에 따라 색상이 불투명하거나 투명합니다.

bold

boolean

텍스트가 굵게 렌더링되는지 여부입니다.

italic

boolean

텍스트에 기울임꼴을 적용할지를 지정합니다.

fontFamily

string

텍스트의 글꼴입니다.

글꼴 모음은 Slides의 글꼴 메뉴 또는 Google Fonts의 글꼴일 수 있습니다. 글꼴 이름이 인식되지 않으면 텍스트가 Arial에서 렌더링됩니다.

일부 글꼴은 텍스트의 두께에 영향을 줄 수 있습니다. 업데이트 요청에서 fontFamily 및 bold 값을 모두 지정하면 명시적으로 설정된 bold 값이 사용됩니다.

fontSize

object (Dimension)

텍스트 글꼴의 크기입니다. 읽을 때 fontSize가 포인트로 지정됩니다.

baselineOffset

enum (BaselineOffset)

일반 위치에서의 텍스트 세로 오프셋입니다.

SUPERSCRIPT 또는 SUBSCRIPT 기준 오프셋이 있는 텍스트는 더 작은 글꼴 크기로 자동 렌더링되며 fontSize 필드를 기준으로 계산됩니다. fontSize 자체는 이 필드의 변경에 영향을 받지 않습니다.

smallCaps

boolean

텍스트가 작은 대문자인지를 나타냅니다.

strikethrough

boolean

취소선 표시 여부입니다.

underline

boolean

텍스트에 밑줄이 표시되는지 여부입니다.

weightedFontFamily

object (WeightedFontFamily)

글꼴 모음 및 텍스트의 렌더링된 두께입니다.

이 필드는 이전 버전과의 호환성을 손상하지 않고 명시적인 글꼴 가중치를 지원하기 위한 fontFamily의 확장 프로그램입니다. 따라서 텍스트 범위의 스타일을 읽을 때 weightedFontFamily#fontFamily 값은 항상 fontFamily 값과 같습니다. 하지만 작성할 때 두 필드가 모두 필드 마스크에 (명시적으로 또는 와일드 카드 "*"를 통해) 포함된 경우 다음과 같이 값이 조정됩니다.

  • fontFamily는 설정되고 weightedFontFamily는 설정되지 않으면 fontFamily의 값은 가중치 400('정상')으로 적용됩니다.
  • 두 필드가 모두 설정된 경우 fontFamily의 값이 weightedFontFamily#fontFamily의 값과 일치해야 합니다. 이 경우 weightedFontFamily의 글꼴 모음과 두께가 적용됩니다. 그렇지 않으면 400 잘못된 요청 오류가 반환됩니다.
  • weightedFontFamily은 설정되고 fontFamily는 설정되지 않으면 글꼴 모음과 weightedFontFamily의 두께가 적용됩니다.
  • 두 필드 모두 설정되지 않은 경우 텍스트의 글꼴 모음과 두께는 상위 요소로부터 상속됩니다. 이러한 속성은 서로 상속될 수 없습니다.

업데이트 요청에서 weightedFontFamily 및 bold 값을 모두 지정하면 weightedFontFamily가 먼저 적용된 후 bold가 적용됩니다.

weightedFontFamily#weight를 설정하지 않으면 기본값은 400입니다.

weightedFontFamily가 설정된 경우 weightedFontFamily#fontFamily도 비어 있지 않은 값으로 설정해야 합니다. 그렇지 않으면 400 잘못된 요청 오류가 반환됩니다.

선택 색상

완전히 불투명하거나 완전히 투명할 수 있는 색상입니다.

JSON 표현 
{
  "opaqueColor": {
    object (OpaqueColor)
  }
}
필드
opaqueColor

object (OpaqueColor)

설정된 경우 불투명 색상으로 사용됩니다. 설정하지 않으면 투명한 색상을 나타냅니다.

기준선 오프셋

텍스트가 정상적인 위치에서 세로로 오프셋되는 방식입니다.

열거형
BASELINE_OFFSET_UNSPECIFIED 텍스트의 기준선 오프셋은 상위 요소로부터 상속됩니다.
NONE 텍스트가 세로로 오프셋되지 않습니다.
SUPERSCRIPT 텍스트가 수직 위쪽의 오프셋 (위 첨자)입니다.
SUBSCRIPT 텍스트가 수직 아래쪽 (아래 첨자)으로 오프셋됩니다.

가중치가 적용된 글꼴 모음

TextRun 스타일을 지정하는 데 사용되는 글꼴 모음과 두께를 나타냅니다.

JSON 표현 
{
  "fontFamily": string,
  "weight": integer
}
필드
fontFamily

string

텍스트의 글꼴입니다.

글꼴 모음은 Slides의 글꼴 메뉴 또는 Google Fonts의 글꼴일 수 있습니다. 글꼴 이름이 인식되지 않으면 텍스트가 Arial에서 렌더링됩니다.

weight

integer

텍스트의 렌더링된 두께입니다. 이 필드는 100에서 900까지 100의 배수인 모든 값을 가질 수 있습니다. 이 범위는 CSS 2.1 사양, 섹션 15.6에 설명된 숫자 값에 해당하며 숫자 값이 아닌 값은 허용되지 않습니다. 700 이상의 가중치는 굵게, 700보다 낮은 가중치는 굵은 글꼴이 아닙니다. 기본값은 400('normal')입니다.

텍스트 실행

모두 스타일이 동일한 RON을 나타내는 TextElement 종류입니다.

JSON 표현 
{
  "content": string,
  "style": {
    object (TextStyle)
  }
}
필드
content

string

이 실행의 텍스트입니다.

style

object (TextStyle)

이 실행에 적용된 스타일 지정입니다.

자동 텍스트

자동 텍스트를 나타내는 TextElement 종류입니다.

JSON 표현 
{
  "type": enum (Type),
  "content": string,
  "style": {
    object (TextStyle)
  }
}
필드
type

enum (Type)

이 자동 텍스트의 유형입니다.

content

string

이 자동 텍스트의 렌더링된 콘텐츠입니다(있는 경우).

style

object (TextStyle)

이 자동 텍스트에 적용되는 스타일입니다.

유형

자동 텍스트 유형

열거형
TYPE_UNSPECIFIED 지정되지 않은 자동 텍스트 유형입니다.
SLIDE_NUMBER 현재 슬라이드 번호를 나타내는 자동 텍스트를 입력합니다.

나열

List는 목록과 연결된 단락에 속한 글머리기호의 디자인을 설명합니다. 목록의 일부인 단락에는 해당 목록의 ID에 대한 암시적 참조가 있습니다.

JSON 표현 
{
  "listId": string,
  "nestingLevel": {
    integer: {
      object (NestingLevel)
    },
    ...
  }
}
필드
listId

string

목록의 ID입니다.

nestingLevel

map (key: integer, value: object ( NestingLevel))

관련 수준의 글머리 기호 속성에 대한 중첩 수준의 맵입니다. 목록의 중첩 수준은 최대 9개이므로 이 지도에서 사용할 수 있는 키는 0부터 8까지입니다.

수습 수준

지정된 중첩 수준에서 목록 글머리기호의 디자인을 설명하는 속성이 포함되어 있습니다.

JSON 표현 
{
  "bulletStyle": {
    object (TextStyle)
  }
}
필드
bulletStyle

object (TextStyle)

이 중첩 수준의 글머리기호 스타일입니다.