- 리소스: 문서
- 본문
- StructuralElement
- 단락
- ParagraphElement
- TextRun
- TextStyle
- 선택적 색상
- 색상
- RgbColor
- 크기
- 단위
- WeightedFontFamily
- 기준 오프셋
- 링크
- SuggestedTextStyle
- TextStyleSuggestionState
- AutoText
- 유형
- 페이지 나누기
- 열 나누기
- 각주참조
- HorizontalRule
- 등식
- InlineObjectElement
- 사람
- PersonProperties
- 리치 링크
- RichLinkProperties
- ParagraphStyle
- 이름 스타일 유형
- 정렬
- ContentDirection
- SpacingMode
- ParagraphBorder
- 대시 스타일
- TabStop
- TabStopAlignment
- 명암
- SuggestedParagraphStyle
- ParagraphStyleSuggestionState
- ShadingSuggestionState
- 글머리기호
- SuggestedBullet
- BulletSuggestionState
- ObjectReferences
- SectionBreak
- SectionStyle
- SectionColumnProperties
- ColumnSeparatorStyle을
- SectionType
- 표
- TableRow
- TableCell
- TableCellStyle
- TableCellBorder
- 콘텐츠 정렬
- SuggestedTableCellStyle
- TableCellStyleSuggestionState
- TableRowStyle
- SuggestedTableRowStyle
- TableRowStyleSuggestionState
- TableStyle
- TableColumnProperties
- 너비 유형
- TableOfContents
- 헤더
- 바닥글
- 각주
- DocumentStyle
- 배경
- 크기
- SuggestedDocumentStyle
- DocumentStyleSuggestionState
- BackgroundSuggestionState
- SizeSuggestionState
- NamedStyles
- NamedStyle
- SuggestedNamedStyles
- NamedStylesSuggestionState
- NamedStyleSuggestionState
- 목록
- ListProperties
- NestingLevel
- 글머리기호 정렬
- GlyphType
- SuggestedListProperties
- ListPropertiesSuggestionState
- NestingLevelSuggestionState
- NamedRanges
- NamedRange
- 범위
- SuggestionsViewMode
- InlineObject
- InlineObjectProperties
- EmbeddedObject
- EmbeddedDrawingProperties
- ImageProperties
- CropProperties
- EmbeddedObjectBorder
- PropertyState
- LinkedContentReference
- SheetsChartReference
- SuggestedInlineObjectProperties
- InlineObjectPropertiesSuggestionState
- EmbeddedObjectSuggestionState
- EmbeddedDrawingPropertiesSuggestionState
- ImagePropertiesSuggestionState
- CropPropertiesSuggestionState
- EmbeddedObjectBorderSuggestionState
- LinkedContentReferenceSuggestionState
- SheetsChartReferenceSuggestionState
- PositionedObject
- PositionedObjectProperties
- PositionedObjectPositioning
- PositionedObjectLayout
- SuggestedPositionedObjectProperties
- PositionedObjectPropertiesSuggestionState
- PositionedObjectPositioningSuggestionState
- 메서드
리소스: Document
Google Docs 문서입니다.
JSON 표현 |
---|
{ "documentId": string, "title": string, "body": { object ( |
필드 | |
---|---|
documentId |
출력 전용. 문서의 ID입니다. |
title |
문서의 제목입니다. |
body |
출력 전용. 문서의 본문입니다. |
headers |
출력 전용. 헤더 ID로 키가 지정된 문서의 헤더입니다. |
footers |
출력 전용. 문서의 바닥글로, 바닥글 ID로 키가 지정됩니다. |
footnotes |
출력 전용. 문서의 각주(각주 ID로 키가 지정됨) |
documentStyle |
출력 전용. 문서의 스타일입니다. |
suggestedDocumentStyleChanges |
출력 전용. 문서 스타일에 제안된 변경사항(추천 ID로 입력됨) |
namedStyles |
출력 전용. 문서의 이름이 지정된 스타일입니다. |
suggestedNamedStylesChanges |
출력 전용. 문서의 이름이 지정된 스타일에 제안되는 변경사항(추천 ID로 입력) |
lists |
출력 전용. 문서의 목록(목록 ID로 키가 지정됨) |
namedRanges |
출력 전용. 문서에서 이름이 지정된 범위이며 이름으로 키가 지정됩니다. |
revisionId |
출력 전용. 문서의 버전 ID입니다. 업데이트를 적용할 문서의 버전을 지정하고 해당 버전 이후에 문서가 수정된 경우 요청이 어떻게 작동하는지를 지정하기 위해 업데이트 요청에 사용할 수 있습니다. 사용자에게 문서에 대한 수정 액세스 권한이 있는 경우에만 채워집니다. 버전 ID는 순차적 숫자가 아니라 불투명 문자열입니다. 버전 ID의 형식은 시간이 지남에 따라 변경될 수 있습니다. 반환된 버전 ID는 반환 후 24시간 동안만 유효하며 사용자 간에 공유할 수 없습니다. 호출 간에 버전 ID가 변경되지 않으면 문서가 변경되지 않은 것입니다. 반대로, 동일한 문서 및 사용자에 대해 ID가 변경되면 대개 문서가 업데이트되었음을 의미합니다. 하지만 ID 형식 변경과 같은 내부 요인으로 인해 ID가 변경되었을 수도 있습니다. |
suggestionsViewMode |
출력 전용. 문서에 적용된 추천 보기 모드입니다. 참고: 문서를 수정할 때 변경사항은 |
inlineObjects |
출력 전용. 객체 ID로 키가 지정된 문서의 인라인 객체입니다. |
positionedObjects |
출력 전용. 문서에서 배치된 객체로, 객체 ID로 키가 지정됩니다. |
본체
문서 본문입니다.
본문에는 일반적으로 headers
, footers
, footnotes
를 제외한 전체 문서 콘텐츠가 포함됩니다.
JSON 표현 |
---|
{
"content": [
{
object ( |
필드 | |
---|---|
content[] |
본문의 콘텐츠입니다. 본문 콘텐츠의 색인은 0에서 시작합니다. |
StructuralElement
StructuralElement는 문서에 구조를 제공하는 콘텐츠를 설명합니다.
JSON 표현 |
---|
{ "startIndex": integer, "endIndex": integer, // Union field |
필드 | |
---|---|
startIndex |
이 구조 요소의 0부터 시작하는 시작 색인으로, UTF-16 코드 단위로 표시됩니다. |
endIndex |
이 구조 요소의 0부터 시작하는 끝 색인으로 UTF-16 코드 단위로 표시됩니다. |
통합 필드 content . 구조적 요소의 콘텐츠입니다. content 은 다음 중 하나여야 합니다. |
|
paragraph |
구조적 요소의 단락 유형입니다. |
sectionBreak |
구조 요소의 섹션 나누기 유형입니다. |
table |
구조적 요소의 테이블 유형입니다. |
tableOfContents |
구조적 요소의 목차 유형입니다. |
단락
단락을 나타내는 StructuralElement
입니다. 단락은 줄바꿈 문자로 끝나는 콘텐츠의 범위입니다.
JSON 표현 |
---|
{ "elements": [ { object ( |
필드 | |
---|---|
elements[] |
구성요소로 분류된 단락의 콘텐츠입니다. |
paragraphStyle |
이 단락의 스타일입니다. |
suggestedParagraphStyleChanges |
추천 단락 스타일이 추천 ID로 키가 지정된 이 단락으로 변경됩니다. |
bullet |
이 단락의 글머리 기호입니다. 없으면 단락은 목록에 속하지 않습니다. |
suggestedBulletChanges |
이 단락의 글머리기호에 제안된 변경사항입니다. |
positionedObjectIds[] |
이 단락에 테더링된 배치된 객체의 ID입니다. |
suggestedPositionedObjectIds |
이 단락에 연결되도록 제안된 배치된 객체의 ID로, 추천 ID로 키가 지정됩니다. |
단락 요소
ParagraphElement는 Paragraph
내의 콘텐츠를 설명합니다.
JSON 표현 |
---|
{ "startIndex": integer, "endIndex": integer, // Union field |
필드 | |
---|---|
startIndex |
이 단락 요소의 0부터 시작하는 시작 색인으로, UTF-16 코드 단위로 표시됩니다. |
endIndex |
이 단락 요소의 0부터 시작하는 끝 색인으로, UTF-16 코드 단위로 표시됩니다. |
통합 필드 content . 단락 요소의 콘텐츠입니다. content 은 다음 중 하나여야 합니다. |
|
textRun |
텍스트 실행 단락 요소입니다. |
autoText |
자동 텍스트 단락 요소입니다. |
pageBreak |
페이지 나누기 단락 요소입니다. |
columnBreak |
단 나누기 단락 요소입니다. |
footnoteReference |
각주 참조 단락 요소입니다. |
horizontalRule |
가로 규칙 단락 요소입니다. |
equation |
등식 단락 요소입니다. |
inlineObjectElement |
인라인 객체 단락 요소입니다. |
person |
사용자 또는 이메일 주소에 연결되는 단락 요소입니다. |
richLink |
Google 리소스 (예: Google Drive의 파일, YouTube 동영상 또는 캘린더 일정)에 연결되는 단락 요소입니다. |
텍스트 실행
스타일이 모두 동일한 텍스트 실행을 나타내는 ParagraphElement
JSON 표현 |
---|
{ "content": string, "suggestedInsertionIds": [ string ], "suggestedDeletionIds": [ string ], "textStyle": { object ( |
필드 | |
---|---|
content |
이 실행의 텍스트입니다. 실행에 포함된 텍스트가 아닌 요소는 유니코드 문자 U+E907로 대체됩니다. |
suggestedInsertionIds[] |
추천된 삽입 ID입니다. 중첩된 추천 변경사항인 경우 |
suggestedDeletionIds[] |
추천된 삭제 ID입니다. 비어 있으면 이 콘텐츠를 삭제할 것을 추천하지 않습니다. |
textStyle |
이 실행의 텍스트 스타일입니다. |
suggestedTextStyleChanges |
제안된 텍스트 스타일이 이번 실행에서 변경되며 추천 ID로 키가 지정됩니다. |
TextStyle
텍스트에 적용할 수 있는 스타일을 나타냅니다.
상속된 텍스트 스타일은 이 메시지에서 설정되지 않은 필드로 표시됩니다. 텍스트 스타일의 상위 요소는 텍스트 스타일이 정의된 위치에 따라 다릅니다.
Paragraph
에 있는 텍스트의 TextStyle은 단락의 상응하는named style type
에서 상속받습니다.named style
의 TextStyle은normal text
라는 스타일에서 상속됩니다.normal text
라는 이름의 TextStyle이 Docs 편집기의 기본 텍스트 스타일을 상속받습니다.- 표에 포함된
Paragraph
요소의 TextStyle은 표 스타일에서 텍스트 스타일을 상속받을 수 있습니다.
텍스트 스타일이 상위 항목에서 상속되지 않는 경우 입력란을 설정 해제하면 문서 편집기의 기본값과 일치하는 값으로 스타일이 되돌아갑니다.
JSON 표현 |
---|
{ "bold": boolean, "italic": boolean, "underline": boolean, "strikethrough": boolean, "smallCaps": boolean, "backgroundColor": { object ( |
필드 | |
---|---|
bold |
텍스트를 굵게 렌더링할지 여부입니다. |
italic |
텍스트에 기울임꼴을 표시할지 여부입니다. |
underline |
텍스트에 밑줄을 표시할지 여부입니다. |
strikethrough |
텍스트에 취소선을 적용할지 여부입니다. |
smallCaps |
텍스트가 작은 글자인지 여부입니다. |
backgroundColor |
텍스트의 배경색입니다. 설정된 경우 색상은 |
foregroundColor |
텍스트의 전경색입니다. 설정된 경우 색상은 |
fontSize |
텍스트의 글꼴 크기입니다. |
weightedFontFamily |
글꼴 모음 및 텍스트의 렌더링된 두께입니다. 업데이트 요청이
|
baselineOffset |
원래 위치에서부터의 텍스트 세로 오프셋입니다.
|
link |
텍스트의 하이퍼링크 대상입니다. 설정하지 않으면 링크가 표시되지 않습니다. 링크는 상위 텍스트에서 상속되지 않습니다. 업데이트 요청의 링크를 변경하면 범위의 텍스트 스타일이 추가로 변경됩니다.
|
선택 색상
완전히 불투명하거나 완전히 투명한 색상입니다.
JSON 표현 |
---|
{
"color": {
object ( |
필드 | |
---|---|
color |
설정하면 불투명 색상으로 사용됩니다. 설정하지 않으면 투명한 색상으로 표시됩니다. |
색상
단색
JSON 표현 |
---|
{
"rgbColor": {
object ( |
필드 | |
---|---|
rgbColor |
RGB 색상 값입니다. |
RGB 색상
RGB 색상입니다.
JSON 표현 |
---|
{ "red": number, "green": number, "blue": number } |
필드 | |
---|---|
red |
색상의 빨간색 구성요소입니다(0.0~1.0). |
green |
색상의 녹색 구성요소입니다(0.0~1.0). |
blue |
색상의 파란색 구성요소입니다(0.0~1.0). |
측정기준
지정된 단위로 된 단일 방향의 크기입니다.
JSON 표현 |
---|
{
"magnitude": number,
"unit": enum ( |
필드 | |
---|---|
magnitude |
규모입니다. |
unit |
크기의 단위입니다. |
단위
측정 단위를 탭합니다.
열거형 | |
---|---|
UNIT_UNSPECIFIED |
단위를 알 수 없습니다. |
PT |
1인치의 1/72인치입니다. |
가중치가 적용된 글꼴 모음
글꼴 모음과 텍스트의 두께를 나타냅니다.
JSON 표현 |
---|
{ "fontFamily": string, "weight": integer } |
필드 | |
---|---|
fontFamily |
텍스트의 글꼴 모음입니다. 글꼴 모음은 Docs의 글꼴 메뉴 또는 Google Fonts의 모든 글꼴입니다. 글꼴 이름이 인식되지 않으면 텍스트는 |
weight |
글꼴의 두께입니다. 이 필드는 기본값은 글꼴 두께는 렌더링된 글꼴 두께의 한 가지 구성요소에 불과합니다.
|
기준 오프셋
텍스트가 정상 위치에서 세로로 오프셋되는 방식입니다.
열거형 | |
---|---|
BASELINE_OFFSET_UNSPECIFIED |
텍스트의 기준선 오프셋은 상위 항목에서 상속됩니다. |
NONE |
텍스트가 세로로 오프셋되지 않았습니다. |
SUPERSCRIPT |
텍스트가 수직으로 위쪽으로 오프셋됩니다 (위 첨자). |
SUBSCRIPT |
텍스트가 아래쪽으로 수직 오프셋됩니다 (아래 첨자). |
링크
문서 또는 외부 URL 리소스의 다른 부분에 대한 참조입니다.
JSON 표현 |
---|
{ // Union field |
필드 | |
---|---|
통합 필드 destination . 링크 도착 페이지 destination 은 다음 중 하나여야 합니다. |
|
url |
외부 URL입니다. |
bookmarkId |
이 문서의 북마크 ID입니다. |
headingId |
이 문서에 있는 제목의 ID입니다. |
추천 텍스트 스타일
TextStyle
에 관한 추천 변경사항입니다.
JSON 표현 |
---|
{ "textStyle": { object ( |
필드 | |
---|---|
textStyle |
이 추천의 변경사항만 포함된 |
textStyleSuggestionState |
기본 |
TextStyleSuggestionState
기본 TextStyle
에서 이 추천에서 변경된 필드를 나타내는 마스크입니다. true로 설정된 모든 필드에 새로운 제안 값이 있습니다.
JSON 표현 |
---|
{ "boldSuggested": boolean, "italicSuggested": boolean, "underlineSuggested": boolean, "strikethroughSuggested": boolean, "smallCapsSuggested": boolean, "backgroundColorSuggested": boolean, "foregroundColorSuggested": boolean, "fontSizeSuggested": boolean, "weightedFontFamilySuggested": boolean, "baselineOffsetSuggested": boolean, "linkSuggested": boolean } |
필드 | |
---|---|
boldSuggested |
|
italicSuggested |
|
underlineSuggested |
|
strikethroughSuggested |
|
smallCapsSuggested |
|
backgroundColorSuggested |
|
foregroundColorSuggested |
|
fontSizeSuggested |
|
weightedFontFamilySuggested |
|
baselineOffsetSuggested |
|
linkSuggested |
|
자동 텍스트
시간 경과에 따라 변경될 수 있는 콘텐츠(예: 페이지 번호)로 동적으로 대체되는 텍스트의 한 지점을 나타내는 ParagraphElement
입니다.
JSON 표현 |
---|
{ "type": enum ( |
필드 | |
---|---|
type |
이 자동 텍스트의 유형입니다. |
suggestedInsertionIds[] |
추천된 삽입 ID입니다. 중첩된 추천 변경사항인 경우 |
suggestedDeletionIds[] |
추천된 삭제 ID입니다. 비어 있으면 이 콘텐츠를 삭제할 것을 추천하지 않습니다. |
textStyle |
이 AutoText의 텍스트 스타일입니다. |
suggestedTextStyleChanges |
제안된 텍스트 스타일이 추천 ID로 키가 지정된 이 AutoText로 변경됩니다. |
유형
자동 텍스트의 유형입니다.
열거형 | |
---|---|
TYPE_UNSPECIFIED |
지정되지 않은 자동 텍스트 유형입니다. |
PAGE_NUMBER |
현재 페이지 번호를 나타내는 자동 텍스트를 입력합니다. |
PAGE_COUNT |
문서의 총 페이지 수를 나타내는 자동 텍스트를 입력합니다. |
페이지 나누기
페이지 나누기를 나타내는 ParagraphElement
입니다. 페이지를 나누면 다음 텍스트가 다음 페이지의 맨 위에서 시작됩니다.
JSON 표현 |
---|
{ "suggestedInsertionIds": [ string ], "suggestedDeletionIds": [ string ], "textStyle": { object ( |
필드 | |
---|---|
suggestedInsertionIds[] |
추천된 삽입 ID입니다. 중첩된 추천 변경사항인 경우 |
suggestedDeletionIds[] |
추천된 삭제 ID입니다. 비어 있으면 이 콘텐츠를 삭제할 것을 추천하지 않습니다. |
textStyle |
이 페이지 나누기의 텍스트 스타일입니다. 텍스트 실행 및 각주 참조와 같은 텍스트 콘텐츠와 마찬가지로 페이지 나누기의 텍스트 스타일은 콘텐츠 레이아웃은 물론 그 옆에 삽입된 텍스트 스타일에도 영향을 미칠 수 있습니다. |
suggestedTextStyleChanges |
추천 텍스트 스타일이 추천 ID로 키가 지정된 이 페이지 나누기로 변경됩니다. |
열 나누기
단 나누기를 나타내는 ParagraphElement
입니다. 단 나누기를 하면 다음 텍스트가 다음 열의 맨 위에서 시작됩니다.
JSON 표현 |
---|
{ "suggestedInsertionIds": [ string ], "suggestedDeletionIds": [ string ], "textStyle": { object ( |
필드 | |
---|---|
suggestedInsertionIds[] |
추천된 삽입 ID입니다. 중첩된 추천 변경사항인 경우 |
suggestedDeletionIds[] |
추천된 삭제 ID입니다. 비어 있으면 이 콘텐츠를 삭제할 것을 추천하지 않습니다. |
textStyle |
이 ColumnBreak의 텍스트 스타일입니다. 텍스트 실행 및 각주 참조와 같은 텍스트 콘텐츠와 마찬가지로 단 나누기의 텍스트 스타일은 콘텐츠 레이아웃은 물론 옆에 삽입된 텍스트 스타일에도 영향을 미칠 수 있습니다. |
suggestedTextStyleChanges |
추천 텍스트 스타일이 추천 ID로 키가 지정된 이 ColumnBreak로 변경됩니다. |
각주 참조
각주 참조를 나타내는 ParagraphElement
각주 참조는 숫자로 렌더링된 인라인 콘텐츠이며 각주를 식별하는 데 사용됩니다.
JSON 표현 |
---|
{ "footnoteId": string, "footnoteNumber": string, "suggestedInsertionIds": [ string ], "suggestedDeletionIds": [ string ], "textStyle": { object ( |
필드 | |
---|---|
footnoteId |
이 각주 참조의 콘텐츠가 포함된 |
footnoteNumber |
이 각주의 렌더링된 번호입니다. |
suggestedInsertionIds[] |
추천된 삽입 ID입니다. 중첩된 추천 변경사항인 경우 |
suggestedDeletionIds[] |
추천된 삭제 ID입니다. 비어 있으면 이 콘텐츠를 삭제할 것을 추천하지 않습니다. |
textStyle |
이 각주 참조의 텍스트 스타일입니다. |
suggestedTextStyleChanges |
제안된 텍스트 스타일이 추천 ID로 키가 지정된 이 FootnoteReference로 변경됩니다. |
가로줄
가로선을 나타내는 ParagraphElement
입니다.
JSON 표현 |
---|
{ "suggestedInsertionIds": [ string ], "suggestedDeletionIds": [ string ], "textStyle": { object ( |
필드 | |
---|---|
suggestedInsertionIds[] |
추천된 삽입 ID입니다. 중첩된 추천 변경사항인 경우 |
suggestedDeletionIds[] |
추천된 삭제 ID입니다. 비어 있으면 이 콘텐츠를 삭제할 것을 추천하지 않습니다. |
textStyle |
이 HorizontalRule의 텍스트 스타일입니다. 텍스트 실행 및 각주 참조와 같은 텍스트 콘텐츠와 마찬가지로 가로 규칙의 텍스트 스타일은 콘텐츠 레이아웃은 물론 그 옆에 삽입된 텍스트 스타일에도 영향을 미칠 수 있습니다. |
suggestedTextStyleChanges |
추천 텍스트 스타일이 추천 ID로 키가 지정된 이 HorizontalRule로 변경됩니다. |
등식
방정식을 나타내는 ParagraphElement
입니다.
JSON 표현 |
---|
{ "suggestedInsertionIds": [ string ], "suggestedDeletionIds": [ string ] } |
필드 | |
---|---|
suggestedInsertionIds[] |
추천된 삽입 ID입니다. 중첩된 추천 변경사항인 경우 |
suggestedDeletionIds[] |
추천된 삭제 ID입니다. 비어 있으면 이 콘텐츠를 삭제할 것을 추천하지 않습니다. |
InlineObjectElement
JSON 표현 |
---|
{ "inlineObjectId": string, "suggestedInsertionIds": [ string ], "suggestedDeletionIds": [ string ], "textStyle": { object ( |
필드 | |
---|---|
inlineObjectId |
이 요소에 포함된 |
suggestedInsertionIds[] |
추천된 삽입 ID입니다. 중첩된 추천 변경사항인 경우 |
suggestedDeletionIds[] |
추천된 삭제 ID입니다. 비어 있으면 이 콘텐츠를 삭제할 것을 추천하지 않습니다. |
textStyle |
이 InlineObjectElement의 텍스트 스타일입니다. 텍스트 실행 및 각주 참조와 같은 텍스트 콘텐츠와 마찬가지로 인라인 객체 요소의 텍스트 스타일은 콘텐츠 레이아웃뿐만 아니라 옆에 삽입된 텍스트 스타일에도 영향을 미칠 수 있습니다. |
suggestedTextStyleChanges |
제안된 텍스트 스타일이 추천 ID로 키가 지정된 이 InlineObject로 변경됩니다. |
인물
문서에 언급된 사람 또는 이메일 주소입니다. 이러한 멘션은 사용자의 이름이나 이메일 주소가 포함된 변경할 수 없는 단일 요소로 작동합니다.
JSON 표현 |
---|
{ "personId": string, "suggestedInsertionIds": [ string ], "suggestedDeletionIds": [ string ], "textStyle": { object ( |
필드 | |
---|---|
personId |
출력 전용. 이 링크의 고유 ID입니다. |
suggestedInsertionIds[] |
이 사용자 링크를 문서에 삽입하는 추천의 ID입니다. 중첩된 추천 변경사항 (예: 다른 사용자가 제안한 변경사항)인 경우 |
suggestedDeletionIds[] |
문서에서 이 사용자 링크를 삭제하는 추천 항목의 ID입니다. 예를 들어 여러 사용자가 삭제를 제안하는 경우 |
textStyle |
이 |
suggestedTextStyleChanges |
추천 텍스트 스타일이 추천 ID로 키가 지정된 이 |
personProperties |
출력 전용. 이 |
사람 속성
연결된 Person
관련 속성
JSON 표현 |
---|
{ "name": string, "email": string } |
필드 | |
---|---|
name |
출력 전용. 사용자의 이메일 주소 대신 링크 텍스트에 표시되는 사용자 이름입니다. |
email |
출력 전용. |
리치 링크
Google 리소스의 링크 (예: Drive의 파일, YouTube 동영상 또는 Calendar 일정)
JSON 표현 |
---|
{ "richLinkId": string, "suggestedInsertionIds": [ string ], "suggestedDeletionIds": [ string ], "textStyle": { object ( |
필드 | |
---|---|
richLinkId |
출력 전용. 이 링크의 ID입니다. |
suggestedInsertionIds[] |
이 링크를 문서에 삽입하는 추천의 ID입니다. 중첩된 추천 변경사항 (예: 다른 사용자가 제안한 변경사항)인 경우 |
suggestedDeletionIds[] |
문서에서 이 링크를 삭제하는 추천 항목의 ID입니다. 예를 들어 여러 사용자가 삭제를 제안하는 경우 |
textStyle |
이 |
suggestedTextStyleChanges |
추천 텍스트 스타일이 추천 ID로 키가 지정된 이 |
richLinkProperties |
출력 전용. 이 |
리치 링크 속성
RichLink
관련 속성
JSON 표현 |
---|
{ "title": string, "uri": string, "mimeType": string } |
필드 | |
---|---|
title |
출력 전용. 링크에 표시되는 |
uri |
출력 전용. |
mimeType |
|
ParagraphStyle
전체 단락에 적용되는 스타일
상속된 단락 스타일은 이 메시지에서 설정되지 않은 필드로 표시됩니다. 단락 스타일의 상위 요소는 단락 스타일이 정의된 위치에 따라 다릅니다.
Paragraph
의 ParagraphStyle은 단락의 상응하는named style type
에서 상속받습니다.named style
의 ParagraphStyle은 이름이 지정된normal text
스타일에서 상속받습니다.- 이름이
normal text
인 스타일의 ParagraphStyle은 Docs 편집기의 기본 단락 스타일을 상속받습니다. - 표에 포함된
Paragraph
요소의 ParagraphStyle은 표 스타일에서 단락 스타일을 상속받을 수 있습니다.
단락 스타일이 상위 항목에서 상속되지 않는 경우 필드를 설정 해제하면 문서 편집기의 기본값과 일치하는 값으로 스타일이 되돌아갑니다.
JSON 표현 |
---|
{ "headingId": string, "namedStyleType": enum ( |
필드 | |
---|---|
headingId |
단락의 제목 ID입니다. 비어 있으면 이 단락은 제목이 아닙니다. 이 속성은 읽기 전용입니다. |
namedStyleType |
단락의 이름이 지정된 스타일 유형입니다. 이름이 지정된 스타일 유형을 업데이트하면 ParagraphStyle 내의 다른 속성에 영향을 미치므로, 다른 속성이 업데이트되기 전에 이름이 지정된 스타일 유형이 적용됩니다. |
alignment |
이 단락의 텍스트 정렬입니다. |
lineSpacing |
줄 사이의 간격(보통 비율)로, 정상은 100.0으로 표시됩니다. 설정하지 않으면 값이 상위 요소로부터 상속됩니다. |
direction |
이 단락의 텍스트 방향입니다. 설정하지 않으면 단락 방향이 상속되지 않으므로 기본값은 |
spacingMode |
단락의 간격 모드입니다. |
spaceAbove |
단락 위의 추가 공백 크기. 설정하지 않으면 값이 상위 요소로부터 상속됩니다. |
spaceBelow |
단락 아래의 추가 공백 크기. 설정하지 않으면 값이 상위 요소로부터 상속됩니다. |
borderBetween |
이 단락과 다음 및 이전 단락 사이의 테두리입니다. 설정하지 않으면 값이 상위 요소로부터 상속됩니다. 인접한 단락에 동일한 테두리 및 들여쓰기 속성이 있는 경우 사이의 테두리가 렌더링됩니다. 단락 테두리는 부분적으로 업데이트할 수 없습니다. 단락 테두리를 변경할 때는 새 테두리를 완전히 지정해야 합니다. |
borderTop |
이 단락의 맨 위에 있는 테두리입니다. 설정하지 않으면 값이 상위 요소로부터 상속됩니다. 위 단락에 다른 테두리 및 들여쓰기 속성이 있는 경우 위쪽 테두리가 렌더링됩니다. 단락 테두리는 부분적으로 업데이트할 수 없습니다. 단락 테두리를 변경할 때는 새 테두리를 완전히 지정해야 합니다. |
borderBottom |
이 단락의 하단에 있는 테두리입니다. 설정하지 않으면 값이 상위 요소로부터 상속됩니다. 아래 단락에 다른 테두리 및 들여쓰기 속성이 있는 경우 아래쪽 테두리가 렌더링됩니다. 단락 테두리는 부분적으로 업데이트할 수 없습니다. 단락 테두리를 변경할 때는 새 테두리를 완전히 지정해야 합니다. |
borderLeft |
이 단락의 왼쪽에 있는 테두리입니다. 설정하지 않으면 값이 상위 요소로부터 상속됩니다. 단락 테두리는 부분적으로 업데이트할 수 없습니다. 단락 테두리를 변경할 때는 새 테두리를 완전히 지정해야 합니다. |
borderRight |
이 단락의 오른쪽에 있는 테두리입니다. 설정하지 않으면 값이 상위 요소로부터 상속됩니다. 단락 테두리는 부분적으로 업데이트할 수 없습니다. 단락 테두리를 변경할 때는 새 테두리를 완전히 지정해야 합니다. |
indentFirstLine |
단락 첫 번째 줄의 들여쓰기 간격입니다. 설정하지 않으면 값이 상위 요소로부터 상속됩니다. |
indentStart |
현재 단락 방향을 기준으로 텍스트의 시작 부분에 해당하는 측면에서 단락의 들여쓰기 간격입니다. 설정하지 않으면 값이 상위 요소로부터 상속됩니다. |
indentEnd |
현재 단락 방향을 기준으로 텍스트의 끝에 해당하는 측면의 단락 들여쓰기 간격입니다. 설정하지 않으면 값이 상위 요소로부터 상속됩니다. |
tabStops[] |
이 단락에서 탭 목록이 중지됩니다. 탭 정류장 목록은 상속되지 않습니다. 이 속성은 읽기 전용입니다. |
keepLinesTogether |
단락의 모든 줄을 가능한 경우 같은 페이지나 열에 배치해야 하는지 여부입니다. 설정하지 않으면 값이 상위 요소로부터 상속됩니다. |
keepWithNext |
가능한 경우 이 단락의 일부를 다음 단락과 같은 페이지 또는 열에 배치해야 하는지 여부입니다. 설정하지 않으면 값이 상위 요소로부터 상속됩니다. |
avoidWidowAndOrphan |
단락에 대한 과부 및 고아를 피할지 여부입니다. 설정하지 않으면 값이 상위 요소로부터 상속됩니다. |
shading |
단락의 음영입니다. 설정하지 않으면 값이 상위 요소로부터 상속됩니다. |
pageBreakBefore |
현재 단락이 항상 페이지의 시작 부분에서 시작해야 하는지 여부입니다. 설정하지 않으면 값이 상위 요소로부터 상속됩니다.
|
이름 스타일 유형
이름이 지정된 스타일의 유형입니다.
열거형 | |
---|---|
NAMED_STYLE_TYPE_UNSPECIFIED |
이름이 지정된 스타일의 유형이 지정되지 않았습니다. |
NORMAL_TEXT |
일반 텍스트입니다. |
TITLE |
제목. |
SUBTITLE |
부제목 |
HEADING_1 |
제목 1. |
HEADING_2 |
제목 2. |
HEADING_3 |
제목 3. |
HEADING_4 |
제목 4. |
HEADING_5 |
제목 5. |
HEADING_6 |
제목 6. |
정렬
단락의 텍스트 정렬 유형입니다.
열거형 | |
---|---|
ALIGNMENT_UNSPECIFIED |
단락 정렬은 상위 항목에서 상속됩니다. |
START |
단락은 줄의 시작 부분에 맞춰 정렬됩니다. LTR 텍스트는 왼쪽 정렬되고 그렇지 않으면 오른쪽 정렬됩니다. |
CENTER |
단락이 중앙에 배치됩니다. |
END |
단락은 줄의 끝에 정렬됩니다. LTR 텍스트는 오른쪽 정렬되고 그렇지 않으면 왼쪽 정렬됩니다. |
JUSTIFIED |
단락이 타당합니다. |
ContentDirection
콘텐츠가 흐를 수 있는 방향입니다.
열거형 | |
---|---|
CONTENT_DIRECTION_UNSPECIFIED |
콘텐츠 방향이 지정되지 않았습니다. |
LEFT_TO_RIGHT |
콘텐츠가 왼쪽에서 오른쪽으로 이동합니다. |
RIGHT_TO_LEFT |
오른쪽에서 왼쪽으로 콘텐츠가 표시됩니다. |
간격 모드
단락 간격의 다양한 모드
열거형 | |
---|---|
SPACING_MODE_UNSPECIFIED |
간격 모드는 상위 항목에서 상속됩니다. |
NEVER_COLLAPSE |
단락 간격은 항상 렌더링됩니다. |
COLLAPSE_LISTS |
목록 요소 사이에서 단락 간격을 건너뜁니다. |
단락 테두리
단락 주위에 테두리
JSON 표현 |
---|
{ "color": { object ( |
필드 | |
---|---|
color |
테두리의 색상입니다. |
width |
테두리 너비입니다. |
padding |
테두리의 패딩입니다. |
dashStyle |
테두리의 파선 스타일입니다. |
파선 스타일
선형 도형을 렌더링할 수 있는 대시의 종류입니다. 이 값은 'Office Open XML File Formats - Fundamentals and Markup Language Reference' 섹션 20.1.10.48, ECMA-376 4판 파트 1에 설명된 'ST_PresetLineDashVal' 간단한 유형을 기반으로 합니다.
열거형 | |
---|---|
DASH_STYLE_UNSPECIFIED |
파선 스타일이 지정되지 않았습니다. |
SOLID |
실선. ECMA-376 ST_PresetLineDashVal 값 'solid'에 해당합니다. 기본 파선 스타일입니다. |
DOT |
점선 ECMA-376 ST_PresetLineDashVal 값 'dot'에 해당합니다. |
DASH |
파선. ECMA-376 ST_PresetLineDashVal 값 'dash'에 해당합니다. |
탭 정지
단락 내의 탭 정지
JSON 표현 |
---|
{ "offset": { object ( |
필드 | |
---|---|
offset |
이 탭 정지와 시작 여백 사이의 오프셋입니다. |
alignment |
이 탭의 정렬이 중지됩니다. 설정하지 않으면 기본값은 |
TabStopAlignment
탭 정렬입니다.
열거형 | |
---|---|
TAB_STOP_ALIGNMENT_UNSPECIFIED |
탭 중지 정렬이 지정되지 않았습니다. |
START |
탭 정지는 선의 시작 부분에 맞춰 정렬됩니다. 이는 기본값입니다. |
CENTER |
탭 정지가 선의 중앙에 정렬됩니다. |
END |
탭 정지가 줄 끝에 정렬됩니다. |
음영
단락의 음영
JSON 표현 |
---|
{
"backgroundColor": {
object ( |
필드 | |
---|---|
backgroundColor |
이 단락 음영의 배경 색상입니다. |
추천 단락 스타일
ParagraphStyle
에 관한 추천 변경사항입니다.
JSON 표현 |
---|
{ "paragraphStyle": { object ( |
필드 | |
---|---|
paragraphStyle |
이 추천의 변경사항만 포함된 |
paragraphStyleSuggestionState |
기본 |
ParagraphStyleSuggestionState
기본 ParagraphStyle
에서 이 추천에서 변경된 필드를 나타내는 마스크입니다. true로 설정된 모든 필드에 새로운 제안 값이 있습니다.
JSON 표현 |
---|
{
"headingIdSuggested": boolean,
"namedStyleTypeSuggested": boolean,
"alignmentSuggested": boolean,
"lineSpacingSuggested": boolean,
"directionSuggested": boolean,
"spacingModeSuggested": boolean,
"spaceAboveSuggested": boolean,
"spaceBelowSuggested": boolean,
"borderBetweenSuggested": boolean,
"borderTopSuggested": boolean,
"borderBottomSuggested": boolean,
"borderLeftSuggested": boolean,
"borderRightSuggested": boolean,
"indentFirstLineSuggested": boolean,
"indentStartSuggested": boolean,
"indentEndSuggested": boolean,
"keepLinesTogetherSuggested": boolean,
"keepWithNextSuggested": boolean,
"avoidWidowAndOrphanSuggested": boolean,
"shadingSuggestionState": {
object ( |
필드 | |
---|---|
headingIdSuggested |
|
namedStyleTypeSuggested |
|
alignmentSuggested |
|
lineSpacingSuggested |
|
directionSuggested |
|
spacingModeSuggested |
|
spaceAboveSuggested |
|
spaceBelowSuggested |
|
borderBetweenSuggested |
|
borderTopSuggested |
|
borderBottomSuggested |
|
borderLeftSuggested |
|
borderRightSuggested |
|
indentFirstLineSuggested |
|
indentStartSuggested |
|
indentEndSuggested |
|
keepLinesTogetherSuggested |
|
keepWithNextSuggested |
|
avoidWidowAndOrphanSuggested |
|
shadingSuggestionState |
이 추천에서 변경된 |
pageBreakBeforeSuggested |
|
ShadingSuggestionState : 셰이딩 제안 상태
이 추천 변경사항에서 변경된 기본 Shading
의 필드를 나타내는 마스크입니다. true로 설정된 모든 필드에 새로운 제안 값이 있습니다.
JSON 표현 |
---|
{ "backgroundColorSuggested": boolean } |
필드 | |
---|---|
backgroundColorSuggested |
|
불릿
단락의 글머리기호를 설명합니다.
JSON 표현 |
---|
{
"listId": string,
"nestingLevel": integer,
"textStyle": {
object ( |
필드 | |
---|---|
listId |
이 단락이 속한 목록의 ID입니다. |
nestingLevel |
목록에서 이 단락의 중첩 수준입니다. |
textStyle |
이 글머리기호에 적용된 단락별 텍스트 스타일입니다. |
추천 글머리기호
Bullet
에 관한 추천 변경사항입니다.
JSON 표현 |
---|
{ "bullet": { object ( |
필드 | |
---|---|
bullet |
이 추천의 변경사항만 포함된 |
bulletSuggestionState |
기본 |
BulletSuggestionState
기본 Bullet
에서 이 추천에서 변경된 필드를 나타내는 마스크입니다. true로 설정된 모든 필드에 새로운 제안 값이 있습니다.
JSON 표현 |
---|
{
"listIdSuggested": boolean,
"nestingLevelSuggested": boolean,
"textStyleSuggestionState": {
object ( |
필드 | |
---|---|
listIdSuggested |
|
nestingLevelSuggested |
|
textStyleSuggestionState |
이 추천에서 변경된 |
ObjectReference
객체 ID 모음입니다.
JSON 표현 |
---|
{ "objectIds": [ string ] } |
필드 | |
---|---|
objectIds[] |
객체 ID입니다. |
섹션 나누기
섹션 나누기를 나타내는 StructuralElement
입니다. 섹션은 SectionStyle
이 동일한 콘텐츠 범위입니다. 섹션 나누기는 새 섹션의 시작을 나타내며 섹션 스타일은 섹션 나누기 이후의 섹션에 적용됩니다.
문서 본문은 항상 섹션 나누기로 시작합니다.
JSON 표현 |
---|
{
"suggestedInsertionIds": [
string
],
"suggestedDeletionIds": [
string
],
"sectionStyle": {
object ( |
필드 | |
---|---|
suggestedInsertionIds[] |
추천된 삽입 ID입니다. 중첩된 추천 변경사항인 경우 |
suggestedDeletionIds[] |
추천된 삭제 ID입니다. 비어 있으면 이 콘텐츠를 삭제할 것을 추천하지 않습니다. |
sectionStyle |
이 섹션 나누기 이후의 섹션 스타일입니다. |
섹션 스타일
섹션에 적용되는 스타일입니다.
JSON 표현 |
---|
{ "columnProperties": [ { object ( |
필드 | |
---|---|
columnProperties[] |
섹션의 열 속성 비어 있으면 섹션에 문서 편집기의 기본 속성이 있는 열 1개가 포함됩니다. 3개 이하의 열을 포함하도록 섹션을 업데이트할 수 있습니다. 이 속성을 업데이트하는 경우 구체적인 값을 설정해야 합니다. 이 속성을 설정 해제하면 400 잘못된 요청 오류가 발생합니다. |
columnSeparatorStyle |
열 구분자의 스타일입니다. 이 스타일은 섹션에 열이 하나 있는 경우에도 설정할 수 있습니다. 이 속성을 업데이트하는 경우 구체적인 값을 설정해야 합니다. 이 속성을 설정 해제하면 400 잘못된 요청 오류가 발생합니다. |
contentDirection |
이 섹션의 콘텐츠 방향입니다. 설정하지 않으면 기본값은 이 속성을 업데이트하는 경우 구체적인 값을 설정해야 합니다. 이 속성을 설정 해제하면 400 잘못된 요청 오류가 발생합니다. |
marginTop |
섹션의 상단 페이지 여백입니다. 설정하지 않으면 DocumentStyle의 기본값은 이 속성을 업데이트하는 경우 구체적인 값을 설정해야 합니다. 이 속성을 설정 해제하면 400 잘못된 요청 오류가 발생합니다. |
marginBottom |
섹션의 하단 페이지 여백입니다. 설정하지 않으면 DocumentStyle의 기본값은 이 속성을 업데이트하는 경우 구체적인 값을 설정해야 합니다. 이 속성을 설정 해제하면 400 잘못된 요청 오류가 발생합니다. |
marginRight |
섹션의 오른쪽 페이지 여백입니다. 설정하지 않으면 DocumentStyle의 기본값은 이 속성을 업데이트하는 경우 구체적인 값을 설정해야 합니다. 이 속성을 설정 해제하면 400 잘못된 요청 오류가 발생합니다. |
marginLeft |
섹션의 왼쪽 페이지 여백입니다. 설정하지 않으면 DocumentStyle의 기본값은 이 속성을 업데이트하는 경우 구체적인 값을 설정해야 합니다. 이 속성을 설정 해제하면 400 잘못된 요청 오류가 발생합니다. |
marginHeader |
섹션의 헤더 여백입니다. 설정하지 않으면 DocumentStyle의 기본값은 이 속성을 업데이트하는 경우 구체적인 값을 설정해야 합니다. 이 속성을 설정 해제하면 400 잘못된 요청 오류가 발생합니다. |
marginFooter |
섹션의 바닥글 여백입니다. 설정하지 않으면 DocumentStyle의 기본값은 이 속성을 업데이트하는 경우 구체적인 값을 설정해야 합니다. 이 속성을 설정 해제하면 400 잘못된 요청 오류가 발생합니다. |
sectionType |
출력 전용. 섹션 유형입니다. |
defaultHeaderId |
기본 헤더의 ID입니다. 설정하지 않으면 값이 이전의 이 속성은 읽기 전용입니다. |
defaultFooterId |
기본 바닥글의 ID입니다. 설정하지 않으면 값이 이전의 이 속성은 읽기 전용입니다. |
firstPageHeaderId |
섹션의 첫 번째 페이지에만 사용되는 헤더의 ID입니다. 이 속성은 읽기 전용입니다. |
firstPageFooterId |
섹션의 첫 페이지에만 사용되는 바닥글 ID입니다. 이 속성은 읽기 전용입니다. |
evenPageHeaderId |
짝수 페이지에만 사용되는 헤더의 ID입니다. DocumentStyle의 이 속성은 읽기 전용입니다. |
evenPageFooterId |
짝수 페이지에만 사용되는 바닥글의 ID입니다. DocumentStyle의 이 속성은 읽기 전용입니다. |
useFirstPageHeaderFooter |
섹션의 첫 페이지에 첫 번째 페이지 머리글 / 바닥글 ID를 사용할지 여부를 나타냅니다. 설정하지 않으면 첫 번째 섹션의 DocumentStyle의 이 속성을 업데이트하는 경우 구체적인 값을 설정해야 합니다. 이 속성을 설정 해제하면 400 잘못된 요청 오류가 발생합니다. |
pageNumberStart |
이 섹션의 페이지 수를 계산하기 시작할 페이지 번호입니다. 설정하지 않으면 이전 섹션부터 페이지 번호가 계속 지정됩니다. 첫 번째 이 속성을 업데이트하는 경우 구체적인 값을 설정해야 합니다. 이 속성을 설정 해제하면 400 잘못된 요청 오류가 발생합니다. |
flipPageOrientation |
선택사항입니다. 이 섹션에서 DocumentStyle의 이 속성을 업데이트하는 경우 구체적인 값을 설정해야 합니다. 이 속성을 설정 해제하면 400 잘못된 요청 오류가 발생합니다. |
섹션 열 속성
섹션의 열에 적용되는 속성입니다.
JSON 표현 |
---|
{ "width": { object ( |
필드 | |
---|---|
width |
출력 전용. 열의 너비입니다. |
paddingEnd |
열 끝에 있는 패딩입니다. |
열 구분자 스타일
열 사이의 열 구분자 스타일입니다.
열거형 | |
---|---|
COLUMN_SEPARATOR_STYLE_UNSPECIFIED |
지정되지 않은 열 구분자 스타일. |
NONE |
열 사이에 열 구분자 행이 없습니다. |
BETWEEN_EACH_COLUMN |
각 열 사이에 열 구분선을 렌더링합니다. |
SectionType
이전 섹션을 기준으로 현재 섹션의 시작 위치가 지정되는 방식을 나타냅니다.
열거형 | |
---|---|
SECTION_TYPE_UNSPECIFIED |
섹션 유형이 지정되지 않았습니다. |
CONTINUOUS |
섹션은 이전 섹션의 마지막 단락 바로 뒤에 시작됩니다. |
NEXT_PAGE |
이 섹션은 다음 페이지에서 시작됩니다. |
테이블
테이블을 나타내는 StructuralElement
입니다.
JSON 표현 |
---|
{ "rows": integer, "columns": integer, "tableRows": [ { object ( |
필드 | |
---|---|
rows |
테이블의 행 수입니다. |
columns |
테이블의 열 수입니다. 표가 직사각형이 아닐 수도 있으므로 일부 행에는 서로 다른 셀 수를 포함할 수 있습니다. |
tableRows[] |
각 행의 콘텐츠와 스타일 |
suggestedInsertionIds[] |
추천된 삽입 ID입니다. 중첩된 추천 변경사항인 경우 |
suggestedDeletionIds[] |
추천된 삭제 ID입니다. 비어 있으면 이 콘텐츠를 삭제할 것을 추천하지 않습니다. |
tableStyle |
표의 스타일입니다. |
TableRow
Table
에 있는 행의 콘텐츠와 스타일
JSON 표현 |
---|
{ "startIndex": integer, "endIndex": integer, "tableCells": [ { object ( |
필드 | |
---|---|
startIndex |
이 행의 0부터 시작하는 시작 색인으로, UTF-16 코드 단위로 표시됩니다. |
endIndex |
이 행의 0부터 시작하는 종료 색인(UTF-16 코드 단위 제외)입니다. |
tableCells[] |
이 행에 있는 각 셀의 내용과 스타일입니다. 표가 직사각형이 아닐 수도 있으므로 일부 행에 있는 셀의 수는 같은 표의 다른 행과 다를 수 있습니다. |
suggestedInsertionIds[] |
추천된 삽입 ID입니다. 중첩된 추천 변경사항인 경우 |
suggestedDeletionIds[] |
추천된 삭제 ID입니다. 비어 있으면 이 콘텐츠를 삭제할 것을 추천하지 않습니다. |
tableRowStyle |
표 행의 스타일입니다. |
suggestedTableRowStyleChanges |
이 행에 추천 스타일이 변경되며 추천 ID로 키가 지정됩니다. |
TableCell
Table
에 있는 셀의 콘텐츠 및 스타일
JSON 표현 |
---|
{ "startIndex": integer, "endIndex": integer, "content": [ { object ( |
필드 | |
---|---|
startIndex |
셀의 0부터 시작하는 시작 색인으로, UTF-16 코드 단위로 표시됩니다. |
endIndex |
이 셀의 0부터 시작하는 끝 색인입니다(UTF-16 코드 단위 제외). |
content[] |
셀의 콘텐츠입니다. |
tableCellStyle |
셀의 스타일입니다. |
suggestedInsertionIds[] |
추천된 삽입 ID입니다. 중첩된 추천 변경사항인 경우 |
suggestedDeletionIds[] |
추천된 삭제 ID입니다. 비어 있으면 이 콘텐츠를 삭제할 것을 추천하지 않습니다. |
suggestedTableCellStyleChanges |
표 셀 스타일에 제안된 변경사항으로 추천 ID로 키가 지정됩니다. |
표 셀 스타일
TableCell
의 스타일
상속된 표 셀 스타일은 이 메시지에서 설정되지 않은 필드로 표시됩니다. 표 셀 스타일은 표 스타일에서 상속될 수 있습니다.
JSON 표현 |
---|
{ "rowSpan": integer, "columnSpan": integer, "backgroundColor": { object ( |
필드 | |
---|---|
rowSpan |
셀의 행 범위입니다. 이 속성은 읽기 전용입니다. |
columnSpan |
셀의 열 범위입니다. 이 속성은 읽기 전용입니다. |
backgroundColor |
셀의 배경 색상입니다. |
borderLeft |
셀의 왼쪽 테두리입니다. |
borderRight |
셀의 오른쪽 테두리 |
borderTop |
셀의 위쪽 테두리 |
borderBottom |
셀의 아래쪽 테두리입니다. |
paddingLeft |
셀의 왼쪽 패딩입니다. |
paddingRight |
셀의 오른쪽 패딩입니다. |
paddingTop |
셀의 상단 패딩입니다. |
paddingBottom |
셀의 하단 패딩입니다. |
contentAlignment |
표 셀의 콘텐츠 정렬입니다. 기본 정렬은 Docs 편집기에서 새로 만든 표 셀의 정렬과 일치합니다. |
표 셀 테두리
표 셀 주위에 테두리가 표시됩니다.
표 셀 테두리는 투명할 수 없습니다. 표의 셀 테두리를 숨기려면 너비를 0으로 설정합니다.
JSON 표현 |
---|
{ "color": { object ( |
필드 | |
---|---|
color |
테두리의 색상입니다. 이 색상은 투명할 수 없습니다. |
width |
테두리 너비입니다. |
dashStyle |
테두리의 파선 스타일입니다. |
콘텐츠 정렬
콘텐츠 정렬의 유형입니다.
'Office Open XML File Formats - Fundamentals and Markup Language Reference' 섹션 20.1.10.59, ECMA-376 4판 파트 1의 'ST_TextAnchoringType' 단순 유형 값 하위 집합에서 가져옵니다.
열거형 | |
---|---|
CONTENT_ALIGNMENT_UNSPECIFIED |
지정되지 않은 콘텐츠 정렬. 콘텐츠 정렬은 상위 요소로부터 상속됩니다(있는 경우). |
CONTENT_ALIGNMENT_UNSUPPORTED |
지원되지 않는 콘텐츠 정렬입니다. |
TOP |
콘텐츠를 콘텐츠 홀더의 상단에 정렬하는 정렬입니다. ECMA-376 ST_TextAnchoringType 't'에 해당합니다. |
MIDDLE |
콘텐츠를 콘텐츠 홀더의 중앙에 정렬하는 정렬입니다. ECMA-376 ST_TextAnchoringType 'ctr'에 해당합니다. |
BOTTOM |
콘텐츠를 콘텐츠 홀더의 하단에 정렬하는 정렬입니다. ECMA-376 ST_TextAnchoringType 'b'에 해당합니다. |
추천 테이블 셀 스타일
TableCellStyle
에 관한 추천 변경사항입니다.
JSON 표현 |
---|
{ "tableCellStyle": { object ( |
필드 | |
---|---|
tableCellStyle |
이 추천의 변경사항만 포함된 |
tableCellStyleSuggestionState |
기본 |
TableCellStyleSuggestionState
기본 TableCellStyle
에서 이 추천에서 변경된 필드를 나타내는 마스크입니다. true로 설정된 모든 필드에 새로운 제안 값이 있습니다.
JSON 표현 |
---|
{ "rowSpanSuggested": boolean, "columnSpanSuggested": boolean, "backgroundColorSuggested": boolean, "borderLeftSuggested": boolean, "borderRightSuggested": boolean, "borderTopSuggested": boolean, "borderBottomSuggested": boolean, "paddingLeftSuggested": boolean, "paddingRightSuggested": boolean, "paddingTopSuggested": boolean, "paddingBottomSuggested": boolean, "contentAlignmentSuggested": boolean } |
필드 | |
---|---|
rowSpanSuggested |
|
columnSpanSuggested |
|
backgroundColorSuggested |
|
borderLeftSuggested |
|
borderRightSuggested |
|
borderTopSuggested |
|
borderBottomSuggested |
|
paddingLeftSuggested |
|
paddingRightSuggested |
|
paddingTopSuggested |
|
paddingBottomSuggested |
|
contentAlignmentSuggested |
|
테이블 행 스타일
표 행에 적용되는 스타일입니다.
JSON 표현 |
---|
{
"minRowHeight": {
object ( |
필드 | |
---|---|
minRowHeight |
행의 최소 높이입니다. 행 셀의 모든 콘텐츠가 표시되도록 행은 문서 편집기에서 이 값과 같거나 큰 높이로 렌더링됩니다. |
tableHeader |
행이 표 헤더인지 여부입니다. |
preventOverflow |
행이 페이지 또는 열 경계에서 오버플로될 수 없는지 여부입니다. |
추천 테이블 행 스타일
TableRowStyle
에 관한 추천 변경사항입니다.
JSON 표현 |
---|
{ "tableRowStyle": { object ( |
필드 | |
---|---|
tableRowStyle |
이 추천의 변경사항만 포함된 |
tableRowStyleSuggestionState |
기본 |
TableRowStyleSuggestionState
기본 TableRowStyle
에서 이 추천에서 변경된 필드를 나타내는 마스크입니다. true로 설정된 모든 필드에 새로운 제안 값이 있습니다.
JSON 표현 |
---|
{ "minRowHeightSuggested": boolean } |
필드 | |
---|---|
minRowHeightSuggested |
|
표 스타일
표에 적용되는 스타일입니다.
JSON 표현 |
---|
{
"tableColumnProperties": [
{
object ( |
필드 | |
---|---|
tableColumnProperties[] |
각 열의 속성입니다. Docs에서 HTML과 마찬가지로 표에는 행이 포함되며 행에 셀이 포함됩니다. 따라서 행의 속성은 행의 |
테이블 열 속성
표의 열 속성입니다.
JSON 표현 |
---|
{ "widthType": enum ( |
필드 | |
---|---|
widthType |
열의 너비 유형입니다. |
width |
열의 너비입니다. 열의 |
너비 유형
열 너비 유형입니다.
열거형 | |
---|---|
WIDTH_TYPE_UNSPECIFIED |
열 너비 유형이 지정되지 않았습니다. |
EVENLY_DISTRIBUTED |
열 너비는 다른 균일하게 분산된 열 간에 균등하게 분배됩니다. 열의 너비는 자동으로 결정되며, 지정된 너비의 모든 열을 고려한 후 테이블의 남은 너비의 동일한 부분을 갖게 됩니다. |
FIXED_WIDTH |
고정 열 너비 [width][google.apps.docs.v1.TableColumnProperties.width 속성에는 열의 너비가 포함됩니다. |
목차
목차를 나타내는 StructuralElement
입니다.
JSON 표현 |
---|
{
"content": [
{
object ( |
필드 | |
---|---|
content[] |
목차의 콘텐츠입니다. |
suggestedInsertionIds[] |
추천된 삽입 ID입니다. 중첩된 추천 변경사항인 경우 |
suggestedDeletionIds[] |
추천된 삭제 ID입니다. 비어 있으면 이 콘텐츠를 삭제할 것을 추천하지 않습니다. |
헤더
문서 헤더입니다.
JSON 표현 |
---|
{
"headerId": string,
"content": [
{
object ( |
필드 | |
---|---|
headerId |
헤더의 ID입니다. |
content[] |
헤더의 콘텐츠입니다. 헤더 콘텐츠의 색인은 0부터 시작합니다. |
각주
문서 각주
JSON 표현 |
---|
{
"footnoteId": string,
"content": [
{
object ( |
필드 | |
---|---|
footnoteId |
각주의 ID입니다. |
content[] |
각주의 콘텐츠입니다. 각주 콘텐츠의 색인은 0부터 시작합니다. |
DocumentStyle
문서의 스타일입니다.
JSON 표현 |
---|
{ "background": { object ( |
필드 | |
---|---|
background |
문서의 배경입니다. 문서는 투명한 배경 색상을 사용할 수 없습니다. |
defaultHeaderId |
기본 헤더의 ID입니다. 설정하지 않으면 기본 헤더가 없습니다. 이 속성은 읽기 전용입니다. |
defaultFooterId |
기본 바닥글의 ID입니다. 설정하지 않으면 기본 바닥글이 없습니다. 이 속성은 읽기 전용입니다. |
evenPageHeaderId |
짝수 페이지에만 사용되는 헤더의 ID입니다. 이 속성은 읽기 전용입니다. |
evenPageFooterId |
짝수 페이지에만 사용되는 바닥글의 ID입니다. 이 속성은 읽기 전용입니다. |
firstPageHeaderId |
첫 번째 페이지에만 사용되는 헤더의 ID입니다. 설정하지 않으면 첫 번째 페이지에 대한 고유한 헤더가 존재하지 않습니다. 이 속성은 읽기 전용입니다. |
firstPageFooterId |
첫 번째 페이지에만 사용되는 바닥글의 ID입니다. 설정하지 않으면 첫 번째 페이지에 고유한 바닥글이 존재하지 않습니다. 이 속성은 읽기 전용입니다. |
useFirstPageHeaderFooter |
첫 페이지에 첫 번째 페이지 머리글 / 바닥글 ID를 사용할지 여부를 나타냅니다. |
useEvenPageHeaderFooter |
짝수 페이지에 짝수 페이지 머리글 / 바닥글 ID를 사용할지 여부를 나타냅니다. |
pageNumberStart |
페이지 수를 계산하기 시작할 페이지 번호입니다. |
marginTop |
페이지 상단 여백 문서 스타일의 상단 페이지 여백을 업데이트하면 모든 섹션 스타일의 상단 페이지 여백이 삭제됩니다. |
marginBottom |
하단 페이지 여백 문서 스타일의 하단 페이지 여백을 업데이트하면 모든 섹션 스타일의 하단 페이지 여백이 지워집니다. |
marginRight |
오른쪽 페이지 여백 문서 스타일에서 오른쪽 페이지 여백을 업데이트하면 모든 섹션 스타일에서 오른쪽 페이지 여백이 삭제됩니다. 또한 모든 섹션에서 열의 크기가 조정될 수 있습니다. |
marginLeft |
왼쪽 페이지 여백입니다. 문서 스타일의 왼쪽 페이지 여백을 업데이트하면 모든 섹션 스타일에서 왼쪽 페이지 여백이 지워집니다. 또한 모든 섹션에서 열의 크기가 조정될 수 있습니다. |
pageSize |
문서의 페이지 크기입니다. |
marginHeader |
페이지 상단과 헤더 콘텐츠 사이의 간격입니다. |
marginFooter |
페이지 하단과 바닥글 콘텐츠 사이의 간격입니다. |
useCustomHeaderFooterMargins |
DocumentStyle 이 속성은 읽기 전용입니다. |
flipPageOrientation |
선택사항입니다. |
배경
문서의 배경을 나타냅니다.
JSON 표현 |
---|
{
"color": {
object ( |
필드 | |
---|---|
color |
배경 색상입니다. |
크기
너비와 높이
JSON 표현 |
---|
{ "height": { object ( |
필드 | |
---|---|
height |
객체의 높이입니다. |
width |
객체의 너비 |
추천 문서 스타일
DocumentStyle
에 관한 추천 변경사항입니다.
JSON 표현 |
---|
{ "documentStyle": { object ( |
필드 | |
---|---|
documentStyle |
이 추천의 변경사항만 포함된 |
documentStyleSuggestionState |
기본 |
DocumentStyleSuggestionState
기본 DocumentStyle
에서 이 추천에서 변경된 필드를 나타내는 마스크입니다. true로 설정된 모든 필드에 새로운 제안 값이 있습니다.
JSON 표현 |
---|
{ "backgroundSuggestionState": { object ( |
필드 | |
---|---|
backgroundSuggestionState |
이 추천에서 변경된 |
defaultHeaderIdSuggested |
|
defaultFooterIdSuggested |
|
evenPageHeaderIdSuggested |
|
evenPageFooterIdSuggested |
|
firstPageHeaderIdSuggested |
|
firstPageFooterIdSuggested |
|
useFirstPageHeaderFooterSuggested |
|
useEvenPageHeaderFooterSuggested |
|
pageNumberStartSuggested |
|
marginTopSuggested |
|
marginBottomSuggested |
|
marginRightSuggested |
|
marginLeftSuggested |
|
pageSizeSuggestionState |
[size] [google.apps.docs.v1.DocumentStyle.size] 의 필드 중 이 추천에서 변경된 필드를 나타내는 마스크입니다. |
marginHeaderSuggested |
|
marginFooterSuggested |
|
useCustomHeaderFooterMarginsSuggested |
|
flipPageOrientationSuggested |
선택사항입니다. |
BackgroundSuggestionState
기본 Background
에서 이 추천에서 변경된 필드를 나타내는 마스크입니다. true로 설정된 모든 필드의 경우 Backgound
에 새로운 추천 값이 있습니다.
JSON 표현 |
---|
{ "backgroundColorSuggested": boolean } |
필드 | |
---|---|
backgroundColorSuggested |
이 추천에서 현재 배경 색상이 수정되었는지 여부를 나타냅니다. |
SizeSuggestionState(크기 추천 상태)
기본 Size
에서 이 추천에서 변경된 필드를 나타내는 마스크입니다. true로 설정된 모든 필드의 경우 Size
에 새로운 추천 값이 있습니다.
JSON 표현 |
---|
{ "heightSuggested": boolean, "widthSuggested": boolean } |
필드 | |
---|---|
heightSuggested |
|
widthSuggested |
|
이름 스타일(NamedStyle)
이름이 지정된 스타일 문서의 단락은 이렇게 이름이 지정된 스타일에서 TextStyle
및 ParagraphStyle
를 상속받을 수 있습니다.
JSON 표현 |
---|
{
"styles": [
{
object ( |
필드 | |
---|---|
styles[] |
이름이 지정된 스타일 가능한 |
이름 스타일(NamedStyle)
이름이 지정된 스타일 문서의 단락이 이름이 지정된 스타일 유형이 동일한 경우 이름이 지정된 스타일에서 TextStyle
및 ParagraphStyle
를 상속받을 수 있습니다.
JSON 표현 |
---|
{ "namedStyleType": enum ( |
필드 | |
---|---|
namedStyleType |
이 이름이 지정된 스타일의 유형입니다. |
textStyle |
이 이름이 지정된 스타일의 텍스트 스타일입니다. |
paragraphStyle |
이 이름이 지정된 스타일의 단락 스타일입니다. |
추천된 이름 스타일
NamedStyles
에 관한 추천 변경사항입니다.
JSON 표현 |
---|
{ "namedStyles": { object ( |
필드 | |
---|---|
namedStyles |
이 추천의 변경사항만 포함된 |
namedStylesSuggestionState |
기본 |
NamedStylesSuggestionState 참고
NamedStyles
메시지의 추천 상태입니다.
JSON 표현 |
---|
{
"stylesSuggestionStates": [
{
object ( |
필드 | |
---|---|
stylesSuggestionStates[] |
이렇게 이름이 지정된 스타일 추천 상태의 순서는 |
NamedStyleSuggestionState 클래스의 생성자
NamedStyle
메시지의 추천 상태입니다.
JSON 표현 |
---|
{ "namedStyleType": enum ( |
필드 | |
---|---|
namedStyleType |
이 추천 상태에 해당하는 이름이 지정된 스타일 유형입니다. 이 필드는 NamedStyleSuggestionState를 상응하는 |
textStyleSuggestionState |
이 추천에서 변경된 |
paragraphStyleSuggestionState |
이 추천에서 변경된 |
목록
목록은 모두 같은 목록에 속하는 단락 그룹의 목록 속성을 나타냅니다. 목록에 포함된 단락에는 bullet
의 목록 ID 참조가 있습니다.
JSON 표현 |
---|
{ "listProperties": { object ( |
필드 | |
---|---|
listProperties |
목록의 속성입니다. |
suggestedListPropertiesChanges |
목록 속성에 제안된 변경사항(추천 ID로 입력됨) |
suggestedInsertionId |
추천 삽입 ID입니다. 비어 있으면 삽입하도록 권장되지 않습니다. |
suggestedDeletionIds[] |
추천된 삭제 ID입니다. 비어 있으면 이 목록을 삭제할 것을 제안하지 않습니다. |
ListProperties
목록과 연결된 단락에 속한 글머리기호의 디자인을 설명하는 list
의 속성입니다.
JSON 표현 |
---|
{
"nestingLevels": [
{
object ( |
필드 | |
---|---|
nestingLevels[] |
연결된 수준에서 글머리기호의 속성을 설명합니다. 목록에는 최대 9개의 중첩 수준이 있습니다. 중첩 수준 0은 최상위 수준에 해당하고 중첩 수준 8은 가장 많이 중첩된 수준에 해당합니다. 중첩 수준은 오름차순으로 반환되며, 가장 낮은 중첩 단계부터 반환됩니다. |
수습 기간 수준
지정된 중첩 수준에서 목록 글머리 기호의 디자인을 설명하는 속성이 포함됩니다.
JSON 표현 |
---|
{ "bulletAlignment": enum ( |
필드 | |
---|---|
bulletAlignment |
글머리기호를 렌더링하는 데 할당된 공간 내 글머리기호의 정렬입니다. |
glyphFormat |
이 중첩 수준에서 글머리기호에 사용되는 형식 문자열입니다. 글리프 형식에는 하나 이상의 자리표시자가 있으며 이러한 자리표시자는 예를 들어 글리프 형식
글리프 형식에는 현재 중첩 수준의 자리표시자와 상위 중첩 수준의 자리표시자가 포함될 수 있습니다. 예를 들어 목록의 중첩 수준 0에서는 글리프 형식이
순서가 지정된 중첩 수준의 경우 특정 단락의 글리프 형식에서 자리표시자를 대체하는 문자열은 목록 내 단락의 순서에 따라 달라집니다. |
indentFirstLine |
이 중첩 수준에서 단락의 첫 번째 줄의 들여쓰기 간격입니다. |
indentStart |
이 중첩 수준에서 단락의 들여쓰기 간격입니다. 단락의 콘텐츠 방향에 따라 텍스트의 시작 부분에 해당하는 쪽에 적용됩니다. |
textStyle |
이 중첩 수준에서의 글머리기호 텍스트 스타일입니다. |
startNumber |
이 중첩 수준에서 첫 번째 목록 항목의 수입니다. 문자 목록과 로마 숫자 목록의 경우 값 0은 값 1로 처리됩니다. 0과 1 값 모두 문자와 로마 숫자 목록은 각각 순서가 지정되지 않은 글리프가 있는 수준을 중첩하는 경우 이 값은 무시됩니다. |
통합 필드 glyph_kind . 글머리기호에 사용되는 글리프의 종류입니다. 이는 glyph_format 의 자리표시자를 대체하는 글머리 기호 글리프를 정의합니다. glyph_kind 은 다음 중 하나여야 합니다. |
|
glyphType |
이 중첩 수준의 단락을 정렬할 때 글머리기호에 사용되는 글리프 유형입니다. 글리프 유형은 이 중첩 수준의 단락이 정렬될 때 |
glyphSymbol |
이 중첩 수준의 단락이 정렬되지 않은 경우 글머리기호에 사용되는 맞춤 글리프 기호입니다. 글리프 기호는 |
글머리기호 정렬
글머리기호의 정렬 유형입니다.
열거형 | |
---|---|
BULLET_ALIGNMENT_UNSPECIFIED |
글머리기호 정렬이 지정되지 않았습니다. |
START |
글머리기호는 글머리기호를 렌더링하는 데 할당된 공간의 시작 부분에 맞춰 정렬됩니다. LTR 텍스트는 왼쪽 정렬되고 그렇지 않으면 오른쪽 정렬됩니다. |
CENTER |
글머리기호는 글머리기호를 렌더링하는 데 할당된 공간의 중앙에 정렬됩니다. |
END |
글머리기호는 글머리기호를 렌더링하는 데 할당된 공간의 끝에 맞춰 정렬됩니다. LTR 텍스트는 오른쪽 정렬되고 그렇지 않으면 왼쪽 정렬됩니다. |
글리프 유형
이 중첩 수준의 단락을 정렬할 때 글머리기호에 사용되는 글리프 유형입니다.
열거형 | |
---|---|
GLYPH_TYPE_UNSPECIFIED |
글리프 유형이 지정되지 않았거나 지원되지 않습니다. |
NONE |
빈 문자열. |
DECIMAL |
숫자(예: 1 , 2 , 3 ) |
ZERO_DECIMAL |
01 , 02 , 03 와 같이 한 자릿수 숫자가 0으로 시작하는 숫자 2자리 이상의 숫자는 0으로 시작하지 않습니다. |
UPPER_ALPHA |
대문자(예: A , B , C ) |
ALPHA |
소문자(예: a , b , c )입니다. |
UPPER_ROMAN |
로마 숫자로 대문자(예: I , II , III ) |
ROMAN |
소문자 로마 숫자(예: i , ii , iii ) |
추천 목록 속성
ListProperties
의 변경 제안
JSON 표현 |
---|
{ "listProperties": { object ( |
필드 | |
---|---|
listProperties |
이 추천의 변경사항만 포함된 |
listPropertiesSuggestionState |
기본 |
ListPropertiesSuggestionState
기본 ListProperties
에서 이 추천에서 변경된 필드를 나타내는 마스크입니다. true로 설정된 모든 필드에 새로운 제안 값이 있습니다.
JSON 표현 |
---|
{
"nestingLevelsSuggestionStates": [
{
object ( |
필드 | |
---|---|
nestingLevelsSuggestionStates[] |
중첩 수준 제안 상태는 중첩 수준의 오름차순으로 반환되며 가장 낮은 중첩 항목이 먼저 반환됩니다. |
중첩 수준 제안 상태
기본 NestingLevel
에서 이 추천에서 변경된 필드를 나타내는 마스크입니다. true로 설정된 모든 필드에 새로운 제안 값이 있습니다.
JSON 표현 |
---|
{
"bulletAlignmentSuggested": boolean,
"glyphTypeSuggested": boolean,
"glyphFormatSuggested": boolean,
"glyphSymbolSuggested": boolean,
"indentFirstLineSuggested": boolean,
"indentStartSuggested": boolean,
"textStyleSuggestionState": {
object ( |
필드 | |
---|---|
bulletAlignmentSuggested |
|
glyphTypeSuggested |
|
glyphFormatSuggested |
|
glyphSymbolSuggested |
|
indentFirstLineSuggested |
|
indentStartSuggested |
|
textStyleSuggestionState |
이 추천에서 변경된 |
startNumberSuggested |
|
NamedRange
특정 이름을 공유하는 문서의 모든 NamedRange
컬렉션입니다.
JSON 표현 |
---|
{
"name": string,
"namedRanges": [
{
object ( |
필드 | |
---|---|
name |
모든 |
namedRanges[] |
동일한 이름을 공유하는 |
이름이 지정된 범위
이름이 지정된 범위 ID가 동일한 Range
컬렉션
이름이 지정된 범위를 사용하면 개발자가 문서의 일부를 임의의 사용자 정의 라벨과 연결할 수 있으므로 나중에 프로그래매틱 방식으로 콘텐츠를 읽거나 수정할 수 있습니다. 한 문서에 이름이 동일한 이름이 지정된 범위가 여러 개 포함될 수 있지만, 이름이 지정된 범위마다 고유 ID가 있습니다.
이름이 지정된 범위는 하나의 Range
로 생성되며 이름이 지정된 범위 내에 삽입된 콘텐츠는 일반적으로 해당 범위를 확장합니다. 하지만 특정 문서를 변경하면 범위가 여러 범위로 분할될 수 있습니다.
이름이 지정된 범위는 비공개가 아닙니다. 문서에 액세스할 수 있는 모든 애플리케이션과 공동작업자는 이름이 지정된 범위를 볼 수 있습니다.
JSON 표현 |
---|
{
"namedRangeId": string,
"name": string,
"ranges": [
{
object ( |
필드 | |
---|---|
namedRangeId |
이름이 지정된 범위의 ID입니다. |
name |
이름이 지정된 범위의 이름입니다. |
ranges[] |
이 이름이 지정된 범위에 속하는 범위입니다. |
범위
인접한 텍스트 범위를 지정합니다.
JSON 표현 |
---|
{ "segmentId": string, "startIndex": integer, "endIndex": integer } |
필드 | |
---|---|
segmentId |
이 범위가 포함된 머리글, 바닥글 또는 각주의 ID입니다. 빈 세그먼트 ID는 문서의 본문을 나타냅니다. |
startIndex |
이 범위의 0부터 시작하는 시작 색인으로, UTF-16 코드 단위로 표시됩니다. 현재 모든 사용 시 시작 색인을 제공해야 합니다. 이 필드는 서술형 범위가 있는 향후 사용 사례를 수용하기 위한 Int32Value입니다. |
endIndex |
이 범위에서 0부터 시작하는 끝 색인입니다(UTF-16 코드 단위 제외). 현재 사용 시에는 종료 색인을 제공해야 합니다. 이 필드는 서술형 범위가 있는 향후 사용 사례를 수용하기 위한 Int32Value입니다. |
제안 보기 모드
문서에 적용된 제안사항 보기 모드로, 제안된 변경사항이 표시되는 방식을 나타냅니다. 모든 제안사항을 인라인, 수락 또는 거부로 표시하여 문서를 읽을 수 있는 옵션을 제공합니다.
열거형 | |
---|---|
DEFAULT_FOR_CURRENT_ACCESS |
반환된 문서에 적용되는 TradefedViewMode는 사용자의 현재 액세스 수준에 따라 다릅니다. 사용자가 보기 권한만 있는 경우 PREVIEW_WITHOUT_SUGGESTIONS 가 적용됩니다. 그렇지 않으면 SUGGESTIONS_INLINE 가 적용됩니다. 기본 추천 보기 모드입니다. |
SUGGESTIONS_INLINE |
반환된 문서에 인라인 추천사항이 있습니다. 제안된 변경사항은 문서 내 기본 콘텐츠와 구분됩니다. 사용자에게 제안된 변경사항을 볼 권한이 없는 경우 이 모드를 사용하여 문서를 검색하도록 요청하면 403 오류가 반환됩니다. |
PREVIEW_SUGGESTIONS_ACCEPTED |
반환된 문서는 모든 추천 변경사항이 수락된 미리보기입니다. 사용자에게 제안된 변경사항을 볼 권한이 없는 경우 이 모드를 사용하여 문서를 검색하도록 요청하면 403 오류가 반환됩니다. |
PREVIEW_WITHOUT_SUGGESTIONS |
반환된 문서는 문서에 제안사항이 있는 경우 모든 제안된 변경사항이 거부된 미리보기입니다. |
인라인 객체
텍스트와 함께 인라인으로 표시되는 객체입니다. InlineObject에는 이미지와 같은 EmbeddedObject
가 포함됩니다.
JSON 표현 |
---|
{ "objectId": string, "inlineObjectProperties": { object ( |
필드 | |
---|---|
objectId |
이 인라인 객체의 ID입니다. 객체의 속성을 업데이트하는 데 사용할 수 있습니다. |
inlineObjectProperties |
이 인라인 객체의 속성입니다. |
suggestedInlineObjectPropertiesChanges |
인라인 객체 속성에 제안된 변경사항(추천 ID로 입력됨) |
suggestedInsertionId |
추천 삽입 ID입니다. 비어 있으면 삽입하도록 권장되지 않습니다. |
suggestedDeletionIds[] |
추천된 삭제 ID입니다. 비어 있으면 이 콘텐츠를 삭제할 것을 추천하지 않습니다. |
InlineObjectProperties
InlineObject
의 속성
JSON 표현 |
---|
{
"embeddedObject": {
object ( |
필드 | |
---|---|
embeddedObject |
이 인라인 객체의 삽입된 객체입니다. |
삽입된 객체
문서에 삽입된 객체입니다.
JSON 표현 |
---|
{ "title": string, "description": string, "embeddedObjectBorder": { object ( |
필드 | |
---|---|
title |
삽입된 객체의 제목입니다. |
description |
삽입된 객체의 설명입니다. |
embeddedObjectBorder |
삽입된 객체의 테두리입니다. |
size |
자른 후 표시되는 이미지 크기입니다. |
marginTop |
삽입된 객체의 상단 여백입니다. |
marginBottom |
삽입된 객체의 하단 여백입니다. |
marginRight |
삽입된 객체의 오른쪽 여백입니다. |
marginLeft |
삽입된 객체의 왼쪽 여백입니다. |
linkedContentReference |
외부에 연결된 소스 콘텐츠에 대한 참조입니다. 예를 들어 삽입된 객체가 연결된 차트인 경우 Google Sheets 소스 차트에 대한 참조가 포함됩니다. 설정하지 않으면 삽입된 객체가 연결되지 않습니다. |
통합 필드 properties . 삽입된 각 객체 유형과 관련된 속성입니다. properties 은 다음 중 하나여야 합니다. |
|
embeddedDrawingProperties |
삽입된 그림의 속성입니다. |
imageProperties |
이미지의 속성입니다. |
EmbeddedDrawingProperties
이 유형에는 필드가 없습니다.
삽입된 그림의 속성이며 개체 유형을 구분하는 데 사용됩니다. 삽입된 그림은 문서 내에서 만들고 편집하는 그림입니다. 광범위한 세부정보는 지원되지 않습니다.
ImageProperties
이미지의 속성입니다.
JSON 표현 |
---|
{
"contentUri": string,
"sourceUri": string,
"brightness": number,
"contrast": number,
"transparency": number,
"cropProperties": {
object ( |
필드 | |
---|---|
contentUri |
기본 수명이 30분인 이미지의 URI입니다. 이 URI는 요청자의 계정으로 태그가 지정됩니다. URI를 가진 사람은 누구나 원래 요청자로서 실질적으로 이미지에 액세스합니다. 문서의 공유 설정이 변경되면 이미지에 대한 액세스 권한이 손실될 수 있습니다. |
sourceUri |
소스 URI는 이미지를 삽입하는 데 사용되는 URI입니다. 소스 URI는 비워 둘 수 있습니다. |
brightness |
이미지의 밝기 효과입니다. 값은 [-1.0, 1.0] 간격이어야 합니다. 여기서 0은 효과가 없음을 의미합니다. |
contrast |
이미지의 대비 효과입니다. 값은 [-1.0, 1.0] 간격이어야 합니다. 여기서 0은 효과가 없음을 의미합니다. |
transparency |
이미지의 투명도 효과입니다. 값은 [0.0, 1.0] 간격 내에 있어야 합니다. 여기서 0은 효과가 없음을, 1은 투명을 의미합니다. |
cropProperties |
이미지의 자르기 속성입니다. |
angle |
이미지의 시계 방향 회전 각도(라디안)입니다. |
자르기 속성
이미지의 자르기 속성입니다.
자르기 사각형은 원본 콘텐츠의 네 가장자리 부분의 부분 오프셋을 사용하여 표시됩니다.
- 오프셋이 간격 (0, 1)에 있으면 자르기 사각형의 해당 가장자리가 이미지의 원래 경계 직사각형 내부에 배치됩니다.
- 오프셋이 음수이거나 1보다 크면 자르기 사각형의 해당 가장자리가 이미지의 원래 경계 직사각형 외부에 배치됩니다.
- 모든 오프셋과 회전 각도가 0이면 이미지가 잘리지 않습니다.
JSON 표현 |
---|
{ "offsetLeft": number, "offsetRight": number, "offsetTop": number, "offsetBottom": number, "angle": number } |
필드 | |
---|---|
offsetLeft |
오프셋은 자르기 사각형의 왼쪽 가장자리에서 원본 콘텐츠의 왼쪽 가장자리에서 안쪽으로 얼마나 떨어져 있는지 원본 콘텐츠 너비의 비율로 지정합니다. |
offsetRight |
오프셋은 자르기 사각형의 오른쪽 가장자리에서 원본 콘텐츠의 오른쪽 가장자리에서 안쪽으로 얼마나 떨어져 있는지 원본 콘텐츠 너비의 비율로 지정합니다. |
offsetTop |
오프셋은 자르기 사각형의 상단 가장자리가 원본 콘텐츠의 상단 가장자리에서 안쪽으로 얼마나 떨어져 있는지 원본 콘텐츠 높이의 비율로 지정합니다. |
offsetBottom |
오프셋은 자르기 사각형의 하단 가장자리에서 원본 콘텐츠의 하단 가장자리에서 안쪽으로 얼마나 떨어져 있는지 원본 콘텐츠 높이의 비율로 지정합니다. |
angle |
가운데를 중심으로 한 자르기 사각형의 시계 방향 회전 각도(라디안)입니다. 회전은 오프셋 후에 적용됩니다. |
삽입된 개체 테두리
EmbeddedObject
주위의 테두리
JSON 표현 |
---|
{ "color": { object ( |
필드 | |
---|---|
color |
테두리의 색상입니다. |
width |
테두리 너비입니다. |
dashStyle |
테두리의 파선 스타일입니다. |
propertyState |
테두리 속성의 속성 상태입니다. |
속성 상태
속성의 가능한 상태입니다.
열거형 | |
---|---|
RENDERED |
속성의 상태가 RENDERED인 경우 문서에 렌더링될 때 요소에 상응하는 속성이 있습니다. 기본값입니다. |
NOT_RENDERED |
속성의 상태가 NOT_RENDERED인 경우 문서에서 렌더링될 때 요소에 상응하는 속성이 없는 것입니다. |
LinkedContentReference
외부에 연결된 소스 콘텐츠에 대한 참조입니다.
JSON 표현 |
---|
{ // Union field |
필드 | |
---|---|
통합 필드 reference . 링크된 콘텐츠의 유형과 관련된 참조입니다. reference 은 다음 중 하나여야 합니다. |
|
sheetsChartReference |
연결된 차트에 대한 참조 |
스프레드시트 차트 참조
Google Sheets에서 삽입된 연결된 차트에 대한 참조입니다.
JSON 표현 |
---|
{ "spreadsheetId": string, "chartId": integer } |
필드 | |
---|---|
spreadsheetId |
소스 차트가 포함된 Google Sheets 스프레드시트의 ID입니다. |
chartId |
삽입된 Google Sheets 스프레드시트의 특정 차트의 ID입니다. |
SuggestedInlineObjectProperties
InlineObjectProperties
의 변경 제안
JSON 표현 |
---|
{ "inlineObjectProperties": { object ( |
필드 | |
---|---|
inlineObjectProperties |
이 추천의 변경사항만 포함된 |
inlineObjectPropertiesSuggestionState |
기본 |
InlineObjectPropertiesSuggestionState
기본 InlineObjectProperties
에서 이 추천에서 변경된 필드를 나타내는 마스크입니다. true로 설정된 모든 필드에 새로운 제안 값이 있습니다.
JSON 표현 |
---|
{
"embeddedObjectSuggestionState": {
object ( |
필드 | |
---|---|
embeddedObjectSuggestionState |
이 추천에서 변경된 |
EmbeddedObjectSuggestionState
기본 EmbeddedObject
에서 이 추천에서 변경된 필드를 나타내는 마스크입니다. true로 설정된 모든 필드에 새로운 제안 값이 있습니다.
JSON 표현 |
---|
{ "embeddedDrawingPropertiesSuggestionState": { object ( |
필드 | |
---|---|
embeddedDrawingPropertiesSuggestionState |
이 추천에서 변경된 |
imagePropertiesSuggestionState |
이 추천에서 변경된 |
titleSuggested |
|
descriptionSuggested |
|
embeddedObjectBorderSuggestionState |
이 추천에서 변경된 |
sizeSuggestionState |
이 추천에서 변경된 |
marginLeftSuggested |
|
marginRightSuggested |
|
marginTopSuggested |
|
marginBottomSuggested |
|
linkedContentReferenceSuggestionState |
이 추천에서 변경된 |
EmbeddedDrawingPropertiesSuggestionState
이 유형에는 필드가 없습니다.
기본 EmbeddedDrawingProperties
에서 이 추천에서 변경된 필드를 나타내는 마스크입니다. true로 설정된 모든 필드에 새로운 제안 값이 있습니다.
ImagePropertiesSuggestionState
기본 ImageProperties
에서 이 추천에서 변경된 필드를 나타내는 마스크입니다. true로 설정된 모든 필드에 새로운 제안 값이 있습니다.
JSON 표현 |
---|
{
"contentUriSuggested": boolean,
"sourceUriSuggested": boolean,
"brightnessSuggested": boolean,
"contrastSuggested": boolean,
"transparencySuggested": boolean,
"cropPropertiesSuggestionState": {
object ( |
필드 | |
---|---|
contentUriSuggested |
|
sourceUriSuggested |
[sourceUri] [google.apps.docs.v1.EmbeddedObject.source_uri]에 대한 추천 변경사항이 있는지 여부를 나타냅니다. |
brightnessSuggested |
[밝기] [google.apps.docs.v1.EmbeddedObject.brightness]에 관한 추천 변경사항이 있는지 여부를 나타냅니다. |
contrastSuggested |
[contrast] [google.apps.docs.v1.EmbeddedObject.contrast]에 대한 제안된 변경사항이 있는지 여부를 나타냅니다. |
transparencySuggested |
[투명도] [google.apps.docs.v1.EmbeddedObject.transparency]에 대한 제안된 변경사항이 있는지 여부를 나타냅니다. |
cropPropertiesSuggestionState |
이 추천에서 변경된 |
angleSuggested |
[angle] [google.apps.docs.v1.EmbeddedObject.angle]에 제안된 변경사항이 있는지 여부를 나타냅니다. |
CropPropertiesSuggestionState
기본 CropProperties
에서 이 추천에서 변경된 필드를 나타내는 마스크입니다. true로 설정된 모든 필드에 새로운 제안 값이 있습니다.
JSON 표현 |
---|
{ "offsetLeftSuggested": boolean, "offsetRightSuggested": boolean, "offsetTopSuggested": boolean, "offsetBottomSuggested": boolean, "angleSuggested": boolean } |
필드 | |
---|---|
offsetLeftSuggested |
|
offsetRightSuggested |
|
offsetTopSuggested |
|
offsetBottomSuggested |
|
angleSuggested |
|
EmbeddedObjectBorderSuggestionState
기본 EmbeddedObjectBorder
에서 이 추천에서 변경된 필드를 나타내는 마스크입니다. true로 설정된 모든 필드에 새로운 제안 값이 있습니다.
JSON 표현 |
---|
{ "colorSuggested": boolean, "widthSuggested": boolean, "dashStyleSuggested": boolean, "propertyStateSuggested": boolean } |
필드 | |
---|---|
colorSuggested |
[color] [google.apps.docs.v1.EmbeddedBorderObject.color]에 제안된 변경사항이 있는지 여부를 나타냅니다. |
widthSuggested |
[width] [google.apps.docs.v1.EmbeddedBorderObject.width]에 권장되는 변경사항이 있는지 여부를 나타냅니다. |
dashStyleSuggested |
[dashStyle] [google.apps.docs.v1.EmbeddedBorderObject.dash_style]에 대한 제안된 변경사항이 있는지 여부를 나타냅니다. |
propertyStateSuggested |
[propertyState] [google.apps.docs.v1.EmbeddedBorderObject.property_state]에 제안된 변경사항이 있는지 여부를 나타냅니다. |
LinkedContentReferenceSuggestionState 열거형
기본 LinkedContentReference
에서 이 추천에서 변경된 필드를 나타내는 마스크입니다. true로 설정된 모든 필드에 새로운 제안 값이 있습니다.
JSON 표현 |
---|
{
"sheetsChartReferenceSuggestionState": {
object ( |
필드 | |
---|---|
sheetsChartReferenceSuggestionState |
이 추천에서 변경된 |
SheetsChartReferenceSuggestionState
기본 SheetsChartReference
에서 이 추천에서 변경된 필드를 나타내는 마스크입니다. true로 설정된 모든 필드에 새로운 제안 값이 있습니다.
JSON 표현 |
---|
{ "spreadsheetIdSuggested": boolean, "chartIdSuggested": boolean } |
필드 | |
---|---|
spreadsheetIdSuggested |
|
chartIdSuggested |
|
위치 객체
Paragraph
에 테더링되고 단락의 시작을 기준으로 배치되는 객체입니다. PositionedObject는 이미지와 같은 EmbeddedObject
를 포함합니다.
JSON 표현 |
---|
{ "objectId": string, "positionedObjectProperties": { object ( |
필드 | |
---|---|
objectId |
이 배치된 객체의 ID입니다. |
positionedObjectProperties |
이 배치된 객체의 속성입니다. |
suggestedPositionedObjectPropertiesChanges |
위치가 지정된 객체 속성에 제안된 변경사항으로 추천 ID로 키가 지정됩니다. |
suggestedInsertionId |
추천 삽입 ID입니다. 비어 있으면 삽입하도록 권장되지 않습니다. |
suggestedDeletionIds[] |
추천된 삭제 ID입니다. 비어 있으면 이 콘텐츠를 삭제할 것을 추천하지 않습니다. |
위치 객체 속성
PositionedObject
의 속성
JSON 표현 |
---|
{ "positioning": { object ( |
필드 | |
---|---|
positioning |
배치된 이 객체를 참조하는 |
embeddedObject |
이 배치된 객체의 삽입된 객체입니다. |
PositionedObjectPositioning(위치 지정 객체 배치)
PositionedObject
의 위치. 배치된 객체는 테더링된 Paragraph
의 시작을 기준으로 배치됩니다.
JSON 표현 |
---|
{ "layout": enum ( |
필드 | |
---|---|
layout |
이 배치된 객체의 레이아웃 |
leftOffset |
배치된 객체가 테더링된 |
topOffset |
배치된 객체가 테더링된 |
위치 객체 레이아웃
[PositionedObject][google.aps.docs.v1.PositionedObject]의 가능한 레이아웃입니다.
열거형 | |
---|---|
POSITIONED_OBJECT_LAYOUT_UNSPECIFIED |
레이아웃이 지정되지 않았습니다. |
WRAP_TEXT |
텍스트가 위치가 지정된 객체를 둘러쌉니다. |
BREAK_LEFT |
배치된 객체가 왼쪽에, 텍스트가 오른쪽에 오도록 텍스트를 나눕니다. |
BREAK_RIGHT |
배치된 객체가 오른쪽에, 텍스트가 왼쪽에 오도록 텍스트를 나눕니다. |
BREAK_LEFT_RIGHT |
배치된 객체의 왼쪽이나 오른쪽에 텍스트가 없도록 텍스트를 나눕니다. |
IN_FRONT_OF_TEXT |
배치된 객체가 텍스트 앞에 있습니다. |
BEHIND_TEXT |
위치가 지정된 객체가 텍스트 뒤에 있습니다. |
SuggestedPositionedObjectProperties
PositionedObjectProperties
의 변경 제안
JSON 표현 |
---|
{ "positionedObjectProperties": { object ( |
필드 | |
---|---|
positionedObjectProperties |
이 추천의 변경사항만 포함된 |
positionedObjectPropertiesSuggestionState |
기본 |
PositionedObjectPropertiesSuggestionState 클래스의 생성자
기본 PositionedObjectProperties
에서 이 추천에서 변경된 필드를 나타내는 마스크입니다. true로 설정된 모든 필드에 새로운 제안 값이 있습니다.
JSON 표현 |
---|
{ "positioningSuggestionState": { object ( |
필드 | |
---|---|
positioningSuggestionState |
이 추천에서 변경된 |
embeddedObjectSuggestionState |
이 추천에서 변경된 |
PositionedObjectPositioningSuggestionState 클래스의 생성자
기본 PositionedObjectPositioning
에서 이 추천에서 변경된 필드를 나타내는 마스크입니다. true로 설정된 모든 필드에 새로운 제안 값이 있습니다.
JSON 표현 |
---|
{ "layoutSuggested": boolean, "leftOffsetSuggested": boolean, "topOffsetSuggested": boolean } |
필드 | |
---|---|
layoutSuggested |
|
leftOffsetSuggested |
|
topOffsetSuggested |
|
방법 |
|
---|---|
|
문서에 하나 이상의 업데이트를 적용합니다. |
|
요청에 지정된 제목을 사용하여 빈 문서를 만듭니다. |
|
지정된 문서의 최신 버전을 가져옵니다. |