Text

TextContent

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

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

object (TextElement)

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

lists

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

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

TextElement

TextElement는 Shape 또는 TableCell의 텍스트 콘텐츠에 있는 인덱스 범위의 콘텐츠를 설명합니다.

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입니다.

ParagraphMarker

새 단락의 시작을 나타내는 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 단락이 양쪽 맞춤입니다.

TextDirection

안내 텍스트가 표시될 수 있습니다.

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

SpacingMode

단락 간격의 다양한 모드입니다.

열거형
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('normal')과 함께 적용됩니다.
  • 두 필드가 모두 설정된 경우 fontFamily 값은 weightedFontFamily#fontFamily 값과 일치해야 합니다. 이 경우 weightedFontFamily의 글꼴 모음과 두께가 적용됩니다. 그렇지 않으면 400 잘못된 요청 오류가 반환됩니다.
  • weightedFontFamily이 설정되고 fontFamily이 설정되지 않은 경우 weightedFontFamily의 글꼴 모음과 가중치가 적용됩니다.
  • 두 필드가 모두 설정되지 않은 경우 텍스트의 글꼴 모음과 두께는 상위 요소에서 상속됩니다. 이러한 속성은 서로 별도로 상속할 수 없습니다.

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

weightedFontFamily#weight이 설정되지 않은 경우 기본값은 400입니다.

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

OptionalColor

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

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

object (OpaqueColor)

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

BaselineOffset

텍스트가 일반 위치에서 세로로 오프셋될 수 있는 방법입니다.

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

WeightedFontFamily

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')입니다.

TextRun

스타일이 모두 동일한 텍스트 실행을 나타내는 TextElement 종류입니다.

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

string

이 실행의 텍스트입니다.

style

object (TextStyle)

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

AutoText

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

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

enum (Type)

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

content

string

사용 가능한 경우 이 자동 텍스트의 렌더링된 콘텐츠입니다.

style

object (TextStyle)

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

유형

자동 텍스트 유형

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

목록

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

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

string

목록의 ID입니다.

nestingLevel

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

중첩 수준과 연결된 수준의 글머리 기호 속성의 맵입니다. 목록에는 최대 9단계의 중첩이 있으므로 이 맵의 키에 가능한 값은 0~8입니다.

NestingLevel

특정 중첩 수준의 목록 글머리 기호의 디자인을 설명하는 속성을 포함합니다.

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

object (TextStyle)

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