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)

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

이 startIndex 및 endIndex 단락의 범위를 나타냅니다. 이 단락의 범위 내에 포함된 색인 범위를 가진 기타 TextElements는 이 단락의 일부로 간주됩니다. 두 개의 개별 단락의 색인 범위는 중복되지 않습니다.

textRun

object (TextRun)

실행에 포함된 모든 문자가 동일한 텍스트 실행 항목을 나타내는 TextElement입니다. TextStyle

이 startIndex 및 endIndex TextRuns가 항상 단일 클래스의 색인 범위에 완전히 포함됩니다. 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 글꼴 글꼴 이름을 인식할 수 없는 경우 텍스트가 Arial로 렌더링됩니다.

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

fontSize

object (Dimension)

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

baselineOffset

enum (BaselineOffset)

텍스트가 일반 위치에서 세로로 얼마나 오프셋되는지 나타냅니다.

다음 코드로 문자 보내기 SUPERSCRIPT 또는 SUBSCRIPT 기준 오프셋은 2012년 6월 10일 동안의 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 잘못된 요청 오류가 반환됩니다.

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 글꼴 글꼴 이름을 인식할 수 없는 경우 텍스트가 Arial로 렌더링됩니다.

weight

integer

텍스트의 렌더링된 가중치입니다. 이 필드는 100 다음 값 사이 100 및 900(양 끝값 포함)입니다. 이 범위는 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)

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