REST Resource: documents

리소스: Document

Google Docs 문서

JSON 표현
{
  "documentId": string,
  "title": string,
  "tabs": [
    {
      object (Tab)
    }
  ],
  "revisionId": string,
  "suggestionsViewMode": enum (SuggestionsViewMode),
  "body": {
    object (Body)
  },
  "headers": {
    string: {
      object (Header)
    },
    ...
  },
  "footers": {
    string: {
      object (Footer)
    },
    ...
  },
  "footnotes": {
    string: {
      object (Footnote)
    },
    ...
  },
  "documentStyle": {
    object (DocumentStyle)
  },
  "suggestedDocumentStyleChanges": {
    string: {
      object (SuggestedDocumentStyle)
    },
    ...
  },
  "namedStyles": {
    object (NamedStyles)
  },
  "suggestedNamedStylesChanges": {
    string: {
      object (SuggestedNamedStyles)
    },
    ...
  },
  "lists": {
    string: {
      object (List)
    },
    ...
  },
  "namedRanges": {
    string: {
      object (NamedRanges)
    },
    ...
  },
  "inlineObjects": {
    string: {
      object (InlineObject)
    },
    ...
  },
  "positionedObjects": {
    string: {
      object (PositionedObject)
    },
    ...
  }
}
필드
documentId

string

출력 전용입니다. 문서의 ID입니다.

title

string

문서의 제목입니다.

tabs[]

object (Tab)

문서에 포함된 탭입니다.

탭에는 하위 탭(다른 탭 내에 중첩된 탭)이 포함될 수 있습니다. 하위 탭은 Tab.childTabs 필드로 표시됩니다.

revisionId

string

출력 전용입니다. 문서의 버전 ID입니다. 업데이트 요청에서 업데이트를 적용할 문서의 버전을 지정하고 해당 버전 이후 문서가 수정된 경우 요청이 어떻게 작동해야 하는지 지정하는 데 사용할 수 있습니다. 사용자에게 문서에 대한 수정 액세스 권한이 있는 경우에만 채워집니다.

버전 ID는 순차 번호가 아닌 불투명 문자열입니다. 수정 버전 ID의 형식은 시간이 지남에 따라 변경될 수 있습니다. 반환된 수정 버전 ID는 반환된 후 24시간 동안만 유효하며 사용자 간에 공유할 수 없습니다. 호출 간에 버전 ID가 변경되지 않으면 문서가 변경되지 않은 것입니다. 반대로 동일한 문서와 사용자의 ID가 변경되면 일반적으로 문서가 업데이트되었음을 의미합니다. 하지만 ID 형식 변경과 같은 내부 요인으로 인해 ID가 변경될 수도 있습니다.

suggestionsViewMode

enum (SuggestionsViewMode)

출력 전용입니다. 문서에 적용된 제안 보기 모드입니다.

참고: 문서를 수정할 때는 SUGGESTIONS_INLINE이(가) 있는 문서를 기반으로 변경해야 합니다.

body

object (Body)

출력 전용입니다. 문서의 기본 본문입니다.

기존 필드: 대신 includeTabsContent 매개변수가 true로 설정된 경우 모든 탭의 실제 문서 콘텐츠를 노출하는 Document.tabs.documentTab.body를 사용하세요. false이거나 설정되지 않은 경우 이 필드에는 문서의 첫 번째 탭에 관한 정보가 포함됩니다.

headers

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

출력 전용입니다. 문서의 헤더로, 헤더 ID를 키로 사용합니다.

기존 필드: 대신 includeTabsContent 매개변수가 true로 설정된 경우 모든 탭의 실제 문서 콘텐츠를 노출하는 Document.tabs.documentTab.headers를 사용하세요. false이거나 설정되지 않은 경우 이 필드에는 문서의 첫 번째 탭에 관한 정보가 포함됩니다.

footers

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

출력 전용입니다. 문서의 바닥글입니다. 바닥글 ID로 키가 지정됩니다.

기존 필드: 대신 includeTabsContent 매개변수가 true로 설정된 경우 모든 탭의 실제 문서 콘텐츠를 노출하는 Document.tabs.documentTab.footers를 사용하세요. false이거나 설정되지 않은 경우 이 필드에는 문서의 첫 번째 탭에 관한 정보가 포함됩니다.

footnotes

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

출력 전용입니다. 문서의 각주로, 각주 ID를 키로 사용합니다.

기존 필드: 대신 includeTabsContent 매개변수가 true로 설정된 경우 모든 탭의 실제 문서 콘텐츠를 노출하는 Document.tabs.documentTab.footnotes를 사용하세요. false이거나 설정되지 않은 경우 이 필드에는 문서의 첫 번째 탭에 관한 정보가 포함됩니다.

documentStyle

object (DocumentStyle)

출력 전용입니다. 문서의 스타일입니다.

기존 필드: 대신 includeTabsContent 매개변수가 true로 설정된 경우 모든 탭의 실제 문서 콘텐츠를 노출하는 Document.tabs.documentTab.documentStyle를 사용하세요. false이거나 설정되지 않은 경우 이 필드에는 문서의 첫 번째 탭에 관한 정보가 포함됩니다.

suggestedDocumentStyleChanges

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

출력 전용입니다. 제안 ID로 키가 지정된 문서 스타일의 제안된 변경사항입니다.

기존 필드: 대신 includeTabsContent 매개변수가 true로 설정된 경우 모든 탭의 실제 문서 콘텐츠를 노출하는 Document.tabs.documentTab.suggestedDocumentStyleChanges를 사용하세요. false이거나 설정되지 않은 경우 이 필드에는 문서의 첫 번째 탭에 관한 정보가 포함됩니다.

namedStyles

object (NamedStyles)

출력 전용입니다. 문서의 명명된 스타일입니다.

기존 필드: 대신 includeTabsContent 매개변수가 true로 설정된 경우 모든 탭의 실제 문서 콘텐츠를 노출하는 Document.tabs.documentTab.namedStyles를 사용하세요. false이거나 설정되지 않은 경우 이 필드에는 문서의 첫 번째 탭에 관한 정보가 포함됩니다.

suggestedNamedStylesChanges

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

출력 전용입니다. 제안 ID를 키로 사용하여 문서의 명명된 스타일을 변경하도록 제안합니다.

기존 필드: 대신 includeTabsContent 매개변수가 true로 설정된 경우 모든 탭의 실제 문서 콘텐츠를 노출하는 Document.tabs.documentTab.suggestedNamedStylesChanges를 사용하세요. false이거나 설정되지 않은 경우 이 필드에는 문서의 첫 번째 탭에 관한 정보가 포함됩니다.

lists

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

출력 전용입니다. 문서의 목록으로, 목록 ID를 키로 사용합니다.

기존 필드: 대신 includeTabsContent 매개변수가 true로 설정된 경우 모든 탭의 실제 문서 콘텐츠를 노출하는 Document.tabs.documentTab.lists를 사용하세요. false이거나 설정되지 않은 경우 이 필드에는 문서의 첫 번째 탭에 관한 정보가 포함됩니다.

namedRanges

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

출력 전용입니다. 문서의 이름이 지정된 범위입니다. 이름으로 키가 지정됩니다.

기존 필드: 대신 includeTabsContent 매개변수가 true로 설정된 경우 모든 탭의 실제 문서 콘텐츠를 노출하는 Document.tabs.documentTab.namedRanges를 사용하세요. false이거나 설정되지 않은 경우 이 필드에는 문서의 첫 번째 탭에 관한 정보가 포함됩니다.

inlineObjects

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

출력 전용입니다. 문서의 인라인 객체입니다. 객체 ID를 키로 사용합니다.

기존 필드: 대신 includeTabsContent 매개변수가 true로 설정된 경우 모든 탭의 실제 문서 콘텐츠를 노출하는 Document.tabs.documentTab.inlineObjects를 사용하세요. false이거나 설정되지 않은 경우 이 필드에는 문서의 첫 번째 탭에 관한 정보가 포함됩니다.

positionedObjects

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

출력 전용입니다. 문서에서 위치가 지정된 객체입니다(객체 ID를 키로 사용).

기존 필드: 대신 includeTabsContent 매개변수가 true로 설정된 경우 모든 탭의 실제 문서 콘텐츠를 노출하는 Document.tabs.documentTab.positionedObjects를 사용하세요. false이거나 설정되지 않은 경우 이 필드에는 문서의 첫 번째 탭에 관한 정보가 포함됩니다.

Tab

문서의 탭입니다.

JSON 표현
{
  "tabProperties": {
    object (TabProperties)
  },
  "childTabs": [
    {
      object (Tab)
    }
  ],

  // Union field content can be only one of the following:
  "documentTab": {
    object (DocumentTab)
  }
  // End of list of possible types for union field content.
}
필드
tabProperties

object (TabProperties)

탭의 속성(예: ID, 제목)입니다.

childTabs[]

object (Tab)

이 탭 내에 중첩된 하위 탭입니다.

통합 필드 content. 탭의 콘텐츠입니다. content은 다음 중 하나여야 합니다.
documentTab

object (DocumentTab)

텍스트, 이미지와 같은 문서 콘텐츠가 포함된 탭

TabProperties

탭의 속성입니다.

JSON 표현
{
  "tabId": string,
  "title": string,
  "parentTabId": string,
  "index": integer,
  "nestingLevel": integer
}
필드
tabId

string

출력 전용입니다. 탭의 ID입니다. 이 필드는 변경할 수 없습니다.

title

string

사용자에게 표시되는 탭 이름입니다.

parentTabId

string

선택사항입니다. 상위 탭의 ID입니다. 현재 탭이 루트 수준 탭인 경우 비어 있습니다. 즉, 상위 탭이 없습니다.

index

integer

상위 요소 내 탭의 0부터 시작하는 색인입니다.

nestingLevel

integer

출력 전용입니다. 문서 내 탭의 깊이입니다. 루트 수준 탭은 0부터 시작합니다.

DocumentTab

문서 콘텐츠가 포함된 탭

JSON 표현
{
  "body": {
    object (Body)
  },
  "headers": {
    string: {
      object (Header)
    },
    ...
  },
  "footers": {
    string: {
      object (Footer)
    },
    ...
  },
  "footnotes": {
    string: {
      object (Footnote)
    },
    ...
  },
  "documentStyle": {
    object (DocumentStyle)
  },
  "suggestedDocumentStyleChanges": {
    string: {
      object (SuggestedDocumentStyle)
    },
    ...
  },
  "namedStyles": {
    object (NamedStyles)
  },
  "suggestedNamedStylesChanges": {
    string: {
      object (SuggestedNamedStyles)
    },
    ...
  },
  "lists": {
    string: {
      object (List)
    },
    ...
  },
  "namedRanges": {
    string: {
      object (NamedRanges)
    },
    ...
  },
  "inlineObjects": {
    string: {
      object (InlineObject)
    },
    ...
  },
  "positionedObjects": {
    string: {
      object (PositionedObject)
    },
    ...
  }
}
필드
body

object (Body)

문서 탭의 기본 본문입니다.

headers

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

문서 탭의 헤더로, 헤더 ID로 키가 지정됩니다.

footers

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

문서 탭의 바닥글입니다. 바닥글 ID로 키가 지정됩니다.

footnotes

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

문서 탭의 각주로, 각주 ID를 키로 사용합니다.

documentStyle

object (DocumentStyle)

문서 탭의 스타일입니다.

suggestedDocumentStyleChanges

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

제안 ID로 키가 지정된 문서 탭의 스타일 변경사항이 제안됩니다.

namedStyles

object (NamedStyles)

문서 탭의 명명된 스타일입니다.

suggestedNamedStylesChanges

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

문서 탭의 명명된 스타일의 제안된 변경사항입니다. 제안 ID로 키가 지정됩니다.

lists

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

문서 탭의 목록으로, 목록 ID를 키로 사용합니다.

namedRanges

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

문서 탭의 이름이 지정된 범위로, 이름별로 키가 지정됩니다.

inlineObjects

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

문서 탭의 인라인 객체로, 객체 ID를 키로 사용합니다.

positionedObjects

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

문서 탭에 배치된 객체입니다(객체 ID를 키로 사용).

본문

문서 본문입니다.

본문에는 일반적으로 headers, footers, footnotes를 제외한 전체 문서 콘텐츠가 포함됩니다.

JSON 표현
{
  "content": [
    {
      object (StructuralElement)
    }
  ]
}
필드
content[]

object (StructuralElement)

본문의 콘텐츠입니다.

본문의 콘텐츠 색인은 0부터 시작합니다.

StructuralElement

StructuralElement는 문서에 구조를 제공하는 콘텐츠를 설명합니다.

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

  // Union field content can be only one of the following:
  "paragraph": {
    object (Paragraph)
  },
  "sectionBreak": {
    object (SectionBreak)
  },
  "table": {
    object (Table)
  },
  "tableOfContents": {
    object (TableOfContents)
  }
  // End of list of possible types for union field content.
}
필드
startIndex

integer

이 구조적 요소의 0부터 시작하는 시작 색인입니다(UTF-16 코드 단위).

endIndex

integer

이 구조적 요소의 0부터 시작하는 종료 색인입니다(제외). UTF-16 코드 단위로 표시됩니다.

통합 필드 content. 구조적 요소의 콘텐츠입니다. content은 다음 중 하나여야 합니다.
paragraph

object (Paragraph)

단락 유형의 구조적 요소입니다.

sectionBreak

object (SectionBreak)

구조적 요소의 섹션 나누기 유형입니다.

table

object (Table)

구조적 요소의 표 유형입니다.

tableOfContents

object (TableOfContents)

목차 유형의 구조적 요소입니다.

단락

단락을 나타내는 StructuralElement입니다. 단락은 줄바꿈 문자로 종료되는 콘텐츠 범위입니다.

JSON 표현
{
  "elements": [
    {
      object (ParagraphElement)
    }
  ],
  "paragraphStyle": {
    object (ParagraphStyle)
  },
  "suggestedParagraphStyleChanges": {
    string: {
      object (SuggestedParagraphStyle)
    },
    ...
  },
  "bullet": {
    object (Bullet)
  },
  "suggestedBulletChanges": {
    string: {
      object (SuggestedBullet)
    },
    ...
  },
  "positionedObjectIds": [
    string
  ],
  "suggestedPositionedObjectIds": {
    string: {
      object (ObjectReferences)
    },
    ...
  }
}
필드
elements[]

object (ParagraphElement)

단락의 콘텐츠를 구성요소로 나눈 것입니다.

paragraphStyle

object (ParagraphStyle)

이 단락의 스타일입니다.

suggestedParagraphStyleChanges

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

추천된 단락 스타일이 제안 ID로 키가 지정된 이 단락으로 변경됩니다.

bullet

object (Bullet)

이 단락의 글머리 기호입니다. 이 속성이 없으면 단락이 목록에 속하지 않습니다.

suggestedBulletChanges

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

이 단락의 글머리기호에 제안된 변경사항입니다.

positionedObjectIds[]

string

이 단락에 연결된 위치가 지정된 객체의 ID입니다.

suggestedPositionedObjectIds

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

이 단락에 첨부하도록 제안된 위치 지정 객체의 ID입니다(제안 ID를 키로 사용).

ParagraphElement

ParagraphElement는 Paragraph 내의 콘텐츠를 설명합니다.

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

  // Union field content can be only one of the following:
  "textRun": {
    object (TextRun)
  },
  "autoText": {
    object (AutoText)
  },
  "pageBreak": {
    object (PageBreak)
  },
  "columnBreak": {
    object (ColumnBreak)
  },
  "footnoteReference": {
    object (FootnoteReference)
  },
  "horizontalRule": {
    object (HorizontalRule)
  },
  "equation": {
    object (Equation)
  },
  "inlineObjectElement": {
    object (InlineObjectElement)
  },
  "person": {
    object (Person)
  },
  "richLink": {
    object (RichLink)
  }
  // End of list of possible types for union field content.
}
필드
startIndex

integer

이 단락 요소의 0 기반 시작 색인(UTF-16 코드 단위)입니다.

endIndex

integer

이 단락 요소의 0부터 시작하는 종료 색인입니다(제외). UTF-16 코드 단위로 나타냅니다.

통합 필드 content. 단락 요소의 콘텐츠입니다. content은 다음 중 하나여야 합니다.
textRun

object (TextRun)

텍스트 실행 단락 요소입니다.

autoText

object (AutoText)

자동 텍스트 단락 요소입니다.

pageBreak

object (PageBreak)

페이지 나누기 단락 요소입니다.

columnBreak

object (ColumnBreak)

열 나누기 단락 요소입니다.

footnoteReference

object (FootnoteReference)

각주 참조 단락 요소입니다.

horizontalRule

object (HorizontalRule)

가로선 단락 요소입니다.

equation

object (Equation)

수식 단락 요소입니다.

inlineObjectElement

object (InlineObjectElement)

인라인 객체 단락 요소입니다.

person

object (Person)

사용자 또는 이메일 주소로 연결되는 단락 요소입니다.

TextRun

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

JSON 표현
{
  "content": string,
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}
필드
content

string

이 실행의 텍스트입니다.

실행의 텍스트가 아닌 요소는 유니코드 문자 U+E907로 대체됩니다.

suggestedInsertionIds[]

string

추천 삽입 ID입니다. TextRun가 중첩된 추천 변경사항인 경우 삽입 ID가 여러 개 있을 수 있습니다. 비어 있으면 추천 삽입이 아닙니다.

suggestedDeletionIds[]

string

추천 삭제 ID입니다. 비어 있으면 이 콘텐츠의 삭제 추천이 없습니다.

textStyle

object (TextStyle)

이 실행의 텍스트 스타일입니다.

suggestedTextStyleChanges

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

추천 텍스트 스타일이 제안 ID로 키가 지정된 이 실행으로 변경됩니다.

TextStyle

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

상속된 텍스트 스타일은 이 메시지에서 설정되지 않은 필드로 표시됩니다. 텍스트 스타일의 상위 요소는 텍스트 스타일이 정의된 위치에 따라 다릅니다.

  • Paragraph의 텍스트 TextStyle은 단락의 해당 named style type에서 상속됩니다.
  • named style의 TextStyle은 normal text라는 스타일에서 상속됩니다.
  • normal text라는 스타일의 TextStyle은 Docs 편집기의 기본 텍스트 스타일에서 상속됩니다.
  • 표에 포함된 Paragraph 요소의 TextStyle은 표 스타일에서 텍스트 스타일을 상속할 수 있습니다.

텍스트 스타일이 상위 요소에서 상속되지 않는 경우 필드를 설정 해제하면 스타일이 Docs 편집기의 기본값과 일치하는 값으로 되돌아갑니다.

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

boolean

텍스트가 굵게 표시되는지 여부입니다.

italic

boolean

텍스트의 기울임체 여부입니다.

underline

boolean

텍스트에 밑줄이 그어져 있는지 여부입니다.

strikethrough

boolean

텍스트에 취소선이 그어져 있는지 여부입니다.

smallCaps

boolean

텍스트가 스몰캡인지 여부입니다.

backgroundColor

object (OptionalColor)

텍스트의 배경색입니다. 설정된 경우 색상은 color 필드에 따라 RGB 색상 또는 투명입니다.

foregroundColor

object (OptionalColor)

텍스트의 전경색입니다. 설정된 경우 색상은 color 필드에 따라 RGB 색상 또는 투명입니다.

fontSize

object (Dimension)

텍스트의 글꼴 크기입니다.

weightedFontFamily

object (WeightedFontFamily)

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

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

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

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

baselineOffset

enum (BaselineOffset)

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

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

OptionalColor

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

JSON 표현
{
  "color": {
    object (Color)
  }
}
필드
color

object (Color)

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

색상

단색입니다.

JSON 표현
{
  "rgbColor": {
    object (RgbColor)
  }
}
필드
rgbColor

object (RgbColor)

RGB 색상 값입니다.

RgbColor

RGB 색상입니다.

JSON 표현
{
  "red": number,
  "green": number,
  "blue": number
}
필드
red

number

색상의 빨간색 구성요소(0.0~1.0)

green

number

색상의 녹색 구성요소입니다(0.0~1.0).

blue

number

색상의 파란색 구성요소입니다(0.0~1.0).

측정기준

지정된 단위의 단일 방향에 있는 크기입니다.

JSON 표현
{
  "magnitude": number,
  "unit": enum (Unit)
}
필드
magnitude

number

크기입니다.

unit

enum (Unit)

크기의 단위입니다.

단위

측정 단위를 탭합니다.

열거형
UNIT_UNSPECIFIED 단위를 알 수 없습니다.
PT 포인트(1/72인치)

WeightedFontFamily

텍스트의 글꼴 모음과 두께를 나타냅니다.

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

string

텍스트의 글꼴 모음입니다.

글꼴 모음은 Docs의 글꼴 메뉴 또는 Google Fonts의 글꼴일 수 있습니다. 글꼴 이름을 인식할 수 없는 경우 텍스트는 Arial로 렌더링됩니다.

weight

integer

글꼴의 두께입니다. 이 필드는 100900 사이의 100의 배수 값(양 끝값 포함)을 가질 수 있습니다. 이 범위는 CSS 2.1 사양의 섹션 15.6에 설명된 숫자 값에 해당하며 숫자 이외의 값은 허용되지 않습니다.

기본값은 400 ('normal')입니다.

글꼴 두께는 렌더링된 글꼴 두께의 한 구성요소일 뿐입니다. weight와 텍스트 스타일의 확인된 bold 값의 조합이 상속을 고려한 후 렌더링된 가중치를 결정합니다.

  • 텍스트가 굵고 가중치가 400보다 작으면 렌더링된 가중치는 400입니다.
  • 텍스트가 굵고 가중치가 400 이상이지만 700 미만이면 렌더링된 가중치는 700입니다.
  • 가중치가 700 이상이면 렌더링된 가중치는 가중치와 같습니다.
  • 텍스트가 굵게 표시되지 않으면 렌더링된 가중치는 가중치와 같습니다.

BaselineOffset

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

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

SuggestedTextStyle

TextStyle에 대한 제안된 변경사항입니다.

JSON 표현
{
  "textStyle": {
    object (TextStyle)
  },
  "textStyleSuggestionState": {
    object (TextStyleSuggestionState)
  }
}
필드
textStyle

object (TextStyle)

이 제안에서 이루어진 변경사항만 포함하는 TextStyle textStyleSuggestionState와 함께 사용하여 변경된 필드와 새 값을 확인할 수 있습니다.

textStyleSuggestionState

object (TextStyleSuggestionState)

이 제안에서 기본 TextStyle의 어떤 필드가 변경되었는지 나타내는 마스크입니다.

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

boolean

bold에 추천된 변경사항이 있는지 나타냅니다.

italicSuggested

boolean

italic에 추천된 변경사항이 있는지 나타냅니다.

underlineSuggested

boolean

underline에 추천된 변경사항이 있는지 나타냅니다.

strikethroughSuggested

boolean

strikethrough에 추천된 변경사항이 있는지 나타냅니다.

smallCapsSuggested

boolean

smallCaps에 추천된 변경사항이 있는지 나타냅니다.

backgroundColorSuggested

boolean

backgroundColor에 추천된 변경사항이 있는지 나타냅니다.

foregroundColorSuggested

boolean

foregroundColor에 추천된 변경사항이 있는지 나타냅니다.

fontSizeSuggested

boolean

fontSize에 추천된 변경사항이 있는지 나타냅니다.

weightedFontFamilySuggested

boolean

weightedFontFamily에 추천된 변경사항이 있는지 나타냅니다.

baselineOffsetSuggested

boolean

baselineOffset에 추천된 변경사항이 있는지 나타냅니다.

AutoText

시간이 지남에 따라 변경될 수 있는 콘텐츠(예: 페이지 번호)로 동적으로 대체되는 텍스트의 위치를 나타내는 ParagraphElement입니다.

JSON 표현
{
  "type": enum (Type),
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}
필드
type

enum (Type)

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

suggestedInsertionIds[]

string

추천 삽입 ID입니다. AutoText가 중첩된 추천 변경사항인 경우 삽입 ID가 여러 개 있을 수 있습니다. 비어 있으면 추천 삽입이 아닙니다.

suggestedDeletionIds[]

string

추천 삭제 ID입니다. 비어 있으면 이 콘텐츠의 삭제 추천이 없습니다.

textStyle

object (TextStyle)

이 자동 텍스트의 텍스트 스타일입니다.

suggestedTextStyleChanges

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

추천 텍스트 스타일이 제안 ID로 키가 지정된 이 AutoText로 변경됩니다.

유형

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

열거형
TYPE_UNSPECIFIED 지정되지 않은 자동 텍스트 유형입니다.
PAGE_NUMBER 현재 페이지 번호를 나타내는 자동 텍스트를 입력합니다.
PAGE_COUNT 문서의 총 페이지 수를 나타내는 자동 텍스트의 유형입니다.

PageBreak

페이지 나누기를 나타내는 ParagraphElement입니다. 페이지 나누기를 사용하면 다음 텍스트가 다음 페이지의 상단에서 시작됩니다.

JSON 표현
{
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}
필드
suggestedInsertionIds[]

string

추천 삽입 ID입니다. PageBreak가 중첩된 추천 변경사항인 경우 삽입 ID가 여러 개 있을 수 있습니다. 비어 있으면 추천 삽입이 아닙니다.

suggestedDeletionIds[]

string

추천 삭제 ID입니다. 비어 있으면 이 콘텐츠의 삭제 추천이 없습니다.

textStyle

object (TextStyle)

이 PageBreak의 텍스트 스타일입니다.

텍스트 콘텐츠(예: 텍스트 실행 및 각주 참조)와 마찬가지로 페이지 나누기의 텍스트 스타일은 콘텐츠 레이아웃뿐만 아니라 페이지 나누기 옆에 삽입된 텍스트의 스타일에도 영향을 미칠 수 있습니다.

suggestedTextStyleChanges

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

추천 텍스트 스타일이 추천 ID로 키가 지정된 이 PageBreak로 변경됩니다.

ColumnBreak

열 나누기를 나타내는 ParagraphElement입니다. 열 나누기를 사용하면 다음 텍스트가 다음 열의 상단에서 시작됩니다.

JSON 표현
{
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}
필드
suggestedInsertionIds[]

string

추천 삽입 ID입니다. ColumnBreak가 중첩된 추천 변경사항인 경우 삽입 ID가 여러 개 있을 수 있습니다. 비어 있으면 추천 삽입이 아닙니다.

suggestedDeletionIds[]

string

추천 삭제 ID입니다. 비어 있으면 이 콘텐츠의 삭제 추천이 없습니다.

textStyle

object (TextStyle)

이 ColumnBreak의 텍스트 스타일입니다.

텍스트 콘텐츠(예: 텍스트 실행 및 각주 참조)와 마찬가지로 열 바꿈의 텍스트 스타일은 콘텐츠 레이아웃뿐만 아니라 옆에 삽입된 텍스트의 스타일에도 영향을 미칠 수 있습니다.

suggestedTextStyleChanges

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

추천 텍스트 스타일이 추천 ID로 키가 지정된 이 ColumnBreak로 변경됩니다.

FootnoteReference

각주 참조를 나타내는 ParagraphElement입니다. 각주 참조는 숫자로 렌더링되는 인라인 콘텐츠로, 각주를 식별하는 데 사용됩니다.

JSON 표현
{
  "footnoteId": string,
  "footnoteNumber": string,
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}
필드
footnoteId

string

이 각주 참조의 콘텐츠가 포함된 footnote의 ID입니다.

footnoteNumber

string

렌더링된 각주의 번호입니다.

suggestedInsertionIds[]

string

추천 삽입 ID입니다. FootnoteReference가 중첩된 추천 변경사항인 경우 삽입 ID가 여러 개 있을 수 있습니다. 비어 있으면 추천 삽입이 아닙니다.

suggestedDeletionIds[]

string

추천 삭제 ID입니다. 비어 있으면 이 콘텐츠의 삭제 추천이 없습니다.

textStyle

object (TextStyle)

이 FootnoteReference의 텍스트 스타일입니다.

suggestedTextStyleChanges

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

추천 텍스트 스타일이 제안 ID로 키가 지정된 이 FootnoteReference로 변경됩니다.

HorizontalRule

가로선을 나타내는 ParagraphElement입니다.

JSON 표현
{
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}
필드
suggestedInsertionIds[]

string

추천 삽입 ID입니다. HorizontalRule가 중첩된 추천 변경사항인 경우 삽입 ID가 여러 개 있을 수 있습니다. 비어 있으면 추천 삽입이 아닙니다.

suggestedDeletionIds[]

string

추천 삭제 ID입니다. 비어 있으면 이 콘텐츠의 삭제 추천이 없습니다.

textStyle

object (TextStyle)

이 HorizontalRule의 텍스트 스타일입니다.

텍스트 실행 및 각주 참조와 같은 텍스트 콘텐츠와 마찬가지로 가로 규칙의 텍스트 스타일은 콘텐츠 레이아웃뿐만 아니라 옆에 삽입된 텍스트의 스타일에도 영향을 미칠 수 있습니다.

suggestedTextStyleChanges

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

추천 텍스트 스타일이 제안 ID로 키가 지정된 이 HorizontalRule로 변경됩니다.

등식

방정식을 나타내는 ParagraphElement입니다.

JSON 표현
{
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ]
}
필드
suggestedInsertionIds[]

string

추천 삽입 ID입니다. Equation가 중첩된 추천 변경사항인 경우 삽입 ID가 여러 개 있을 수 있습니다. 비어 있으면 추천 삽입이 아닙니다.

suggestedDeletionIds[]

string

추천 삭제 ID입니다. 비어 있으면 이 콘텐츠의 삭제 추천이 없습니다.

InlineObjectElement

InlineObject을 포함하는 ParagraphElement

JSON 표현
{
  "inlineObjectId": string,
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}
필드
inlineObjectId

string

이 요소가 포함하는 InlineObject의 ID입니다.

suggestedInsertionIds[]

string

추천 삽입 ID입니다. InlineObjectElement가 중첩된 추천 변경사항인 경우 삽입 ID가 여러 개 있을 수 있습니다. 비어 있으면 추천 삽입이 아닙니다.

suggestedDeletionIds[]

string

추천 삭제 ID입니다. 비어 있으면 이 콘텐츠의 삭제 추천이 없습니다.

textStyle

object (TextStyle)

이 InlineObjectElement의 텍스트 스타일입니다.

텍스트 콘텐츠(예: 텍스트 실행 및 각주 참조)와 마찬가지로 인라인 객체 요소의 텍스트 스타일은 콘텐츠 레이아웃뿐만 아니라 옆에 삽입된 텍스트의 스타일에도 영향을 미칠 수 있습니다.

suggestedTextStyleChanges

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

추천 텍스트 스타일이 제안 ID로 키가 지정된 이 InlineObject로 변경됩니다.

사람

문서에서 언급된 사용자 또는 이메일 주소입니다. 이러한 멘션은 사용자의 이름이나 이메일 주소를 포함하는 단일의 변경 불가능한 요소로 작동합니다.

JSON 표현
{
  "personId": string,
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  },
  "personProperties": {
    object (PersonProperties)
  }
}
필드
personId

string

출력 전용입니다. 이 링크의 고유 ID입니다.

suggestedInsertionIds[]

string

이 사용자 링크를 문서에 삽입하는 추천의 ID입니다. Person는 중첩된 추천 변경사항 (예: 다른 사용자가 한 추천 내의 추천)인 경우 삽입 ID가 여러 개 있을 수 있습니다. 비어 있으면 이 사용자 링크는 추천 삽입이 아닙니다.

suggestedDeletionIds[]

string

문서에서 이 사용자 링크를 삭제하는 추천의 ID입니다. 예를 들어 여러 사용자가 삭제를 제안하는 경우 Person에 삭제 ID가 여러 개 있을 수 있습니다. 비어 있으면 이 사용자 링크가 삭제 대상으로 추천되지 않습니다.

textStyle

object (TextStyle)

Person의 텍스트 스타일입니다.

suggestedTextStyleChanges

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

추천 텍스트 스타일이 추천 ID로 키가 지정된 이 Person로 변경됩니다.

personProperties

object (PersonProperties)

출력 전용입니다. 이 Person의 속성입니다. 이 필드는 항상 표시됩니다.

PersonProperties

연결된 Person에만 적용되는 속성입니다.

JSON 표현
{
  "name": string,
  "email": string
}
필드
name

string

사람의 이메일 주소 대신 링크 텍스트에 표시되는 사람의 이름입니다.

email

string

Person에 연결된 이메일 주소입니다. 이 필드는 항상 표시됩니다.

RichLinkProperties

RichLink에만 적용되는 속성입니다.

JSON 표현
{
  "title": string,
  "uri": string,
  "mimeType": string
}
필드
title

string

출력 전용입니다. 링크에 표시되는 RichLink의 제목입니다. 이 제목은 링크가 삽입되거나 마지막으로 업데이트된 시점의 연결된 리소스 제목과 일치합니다. 이 필드는 항상 표시됩니다.

uri

string

출력 전용입니다. RichLink의 URI입니다. 항상 표시됩니다.

mimeType

string

출력 전용입니다. RichLinkMIME 유형 (있는 경우, 예를 들어 드라이브의 파일인 경우)

ParagraphStyle

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

상속된 단락 스타일은 이 메시지에서 설정되지 않은 필드로 표시됩니다. 단락 스타일의 상위 요소는 단락 스타일이 정의된 위치에 따라 다릅니다.

  • Paragraph의 ParagraphStyle은 단락의 해당 named style type에서 상속됩니다.
  • named style의 ParagraphStyle은 normal text 명명된 스타일에서 상속됩니다.
  • normal text라는 스타일의 ParagraphStyle은 Docs 편집기의 기본 단락 스타일에서 상속됩니다.
  • 표에 포함된 Paragraph 요소의 ParagraphStyle은 표 스타일에서 단락 스타일을 상속할 수 있습니다.

단락 스타일이 상위 항목에서 상속되지 않는 경우 필드를 설정 해제하면 스타일이 Docs 편집기의 기본값과 일치하는 값으로 되돌아갑니다.

JSON 표현
{
  "headingId": string,
  "namedStyleType": enum (NamedStyleType),
  "alignment": enum (Alignment),
  "lineSpacing": number,
  "direction": enum (ContentDirection),
  "spacingMode": enum (SpacingMode),
  "spaceAbove": {
    object (Dimension)
  },
  "spaceBelow": {
    object (Dimension)
  },
  "borderBetween": {
    object (ParagraphBorder)
  },
  "borderTop": {
    object (ParagraphBorder)
  },
  "borderBottom": {
    object (ParagraphBorder)
  },
  "borderLeft": {
    object (ParagraphBorder)
  },
  "borderRight": {
    object (ParagraphBorder)
  },
  "indentFirstLine": {
    object (Dimension)
  },
  "indentStart": {
    object (Dimension)
  },
  "indentEnd": {
    object (Dimension)
  },
  "tabStops": [
    {
      object (TabStop)
    }
  ],
  "keepLinesTogether": boolean,
  "keepWithNext": boolean,
  "avoidWidowAndOrphan": boolean,
  "shading": {
    object (Shading)
  },
  "pageBreakBefore": boolean
}
필드
headingId

string

단락의 제목 ID입니다. 비어 있으면 이 단락은 제목이 아닙니다.

이 속성은 읽기 전용입니다.

namedStyleType

enum (NamedStyleType)

단락의 명명된 스타일 유형입니다.

이름이 지정된 스타일 유형을 업데이트하면 ParagraphStyle 내의 다른 속성에 영향을 미치므로 이름이 지정된 스타일 유형은 다른 속성이 업데이트되기 전에 적용됩니다.

alignment

enum (Alignment)

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

lineSpacing

number

일반을 100.0으로 나타낼 때 일반의 백분율로 표시되는 줄 사이의 공간입니다. 설정되지 않은 경우 상위 항목에서 값을 상속합니다.

direction

enum (ContentDirection)

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

spacingMode

enum (SpacingMode)

단락의 간격 모드입니다.

spaceAbove

object (Dimension)

단락 위의 추가 공간 크기입니다. 설정되지 않은 경우 상위 항목에서 값을 상속합니다.

spaceBelow

object (Dimension)

단락 아래의 추가 공간 크기입니다. 설정되지 않은 경우 상위 항목에서 값을 상속합니다.

borderBetween

object (ParagraphBorder)

이 단락과 다음 단락 및 이전 단락 사이의 테두리입니다. 설정되지 않은 경우 상위 항목에서 값을 상속합니다.

인접한 단락의 테두리 및 들여쓰기 속성이 동일한 경우 사이 테두리가 렌더링됩니다.

단락 테두리는 부분적으로 업데이트할 수 없습니다. 단락 테두리를 변경할 때는 새 테두리를 완전히 지정해야 합니다.

borderTop

object (ParagraphBorder)

이 단락의 상단에 있는 테두리입니다. 설정되지 않은 경우 상위 항목에서 값을 상속합니다.

위 단락의 테두리 및 들여쓰기 속성이 다른 경우 상단 테두리가 렌더링됩니다.

단락 테두리는 부분적으로 업데이트할 수 없습니다. 단락 테두리를 변경할 때는 새 테두리를 완전히 지정해야 합니다.

borderBottom

object (ParagraphBorder)

이 단락의 하단 테두리입니다. 설정되지 않은 경우 상위 항목에서 값을 상속합니다.

아래 단락에 다른 테두리 및 들여쓰기 속성이 있는 경우 하단 테두리가 렌더링됩니다.

단락 테두리는 부분적으로 업데이트할 수 없습니다. 단락 테두리를 변경할 때는 새 테두리를 완전히 지정해야 합니다.

borderLeft

object (ParagraphBorder)

이 단락의 왼쪽 테두리입니다. 설정되지 않은 경우 상위 항목에서 값을 상속합니다.

단락 테두리는 부분적으로 업데이트할 수 없습니다. 단락 테두리를 변경할 때는 새 테두리를 완전히 지정해야 합니다.

borderRight

object (ParagraphBorder)

이 단락의 오른쪽 테두리입니다. 설정되지 않은 경우 상위 항목에서 값을 상속합니다.

단락 테두리는 부분적으로 업데이트할 수 없습니다. 단락 테두리를 변경할 때는 새 테두리를 완전히 지정해야 합니다.

indentFirstLine

object (Dimension)

단락의 첫 번째 줄의 들여쓰기 양입니다. 설정되지 않은 경우 상위 항목에서 값을 상속합니다.

indentStart

object (Dimension)

현재 단락 방향을 기준으로 텍스트 시작에 해당하는 측면의 단락 들여쓰기 양입니다. 설정되지 않은 경우 상위 항목에서 값을 상속합니다.

indentEnd

object (Dimension)

현재 단락 방향을 기준으로 텍스트 끝에 해당하는 측면의 단락 들여쓰기 양입니다. 설정되지 않은 경우 상위 항목에서 값을 상속합니다.

tabStops[]

object (TabStop)

이 단락의 탭 정지 목록입니다. 탭 정지 위치 목록은 상속되지 않습니다.

이 속성은 읽기 전용입니다.

keepLinesTogether

boolean

가능한 경우 단락의 모든 줄을 동일한 페이지 또는 열에 배치해야 하는지 여부입니다. 설정되지 않은 경우 상위 항목에서 값을 상속합니다.

keepWithNext

boolean

가능한 경우 이 단락의 일부를 다음 단락과 동일한 페이지 또는 열에 배치해야 하는지 여부입니다. 설정되지 않은 경우 상위 항목에서 값을 상속합니다.

avoidWidowAndOrphan

boolean

단락의 과부와 고아를 방지할지 여부입니다. 설정되지 않은 경우 상위 항목에서 값을 상속합니다.

shading

object (Shading)

단락의 음영입니다. 설정되지 않은 경우 상위 항목에서 값을 상속합니다.

pageBreakBefore

boolean

현재 단락이 항상 페이지 시작 부분에서 시작해야 하는지 여부입니다. 설정되지 않은 경우 상위 항목에서 값을 상속합니다.

Table, Header, Footer, Footnote 등 지원되지 않는 지역의 단락에 대해 pageBreakBefore를 업데이트하려고 하면 잘못된 문서 상태가 되어 400 잘못된 요청 오류가 반환될 수 있습니다.

NamedStyleType

이름이 지정된 스타일의 유형입니다.

열거형
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 콘텐츠가 오른쪽에서 왼쪽으로 이동합니다.

SpacingMode

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

열거형
SPACING_MODE_UNSPECIFIED 간격 모드는 상위 항목에서 상속됩니다.
NEVER_COLLAPSE 단락 간격은 항상 렌더링됩니다.
COLLAPSE_LISTS 목록 요소 사이에는 단락 간격이 적용되지 않습니다.

ParagraphBorder

단락 주위의 테두리

JSON 표현
{
  "color": {
    object (OptionalColor)
  },
  "width": {
    object (Dimension)
  },
  "padding": {
    object (Dimension)
  },
  "dashStyle": enum (DashStyle)
}
필드
color

object (OptionalColor)

테두리 색상입니다.

width

object (Dimension)

테두리의 너비입니다.

padding

object (Dimension)

테두리의 패딩입니다.

dashStyle

enum (DashStyle)

테두리의 대시 스타일입니다.

DashStyle

선형 지오메트리를 렌더링할 수 있는 대시 종류입니다. 이러한 값은 ECMA-376 5판 1부의 'Office Open XML 파일 형식 - 기본사항 및 마크업 언어 참조' 20.1.10.49절에 설명된 'ST_PresetLineDashVal' 단순 유형을 기반으로 합니다.

열거형
DASH_STYLE_UNSPECIFIED 지정되지 않은 대시 스타일입니다.
SOLID 실선 ECMA-376 ST_PresetLineDashVal 값 'solid'에 해당합니다. 기본 대시 스타일입니다.
DOT 점선 ECMA-376 ST_PresetLineDashVal 값 'dot'에 해당합니다.
DASH 점선 ECMA-376 ST_PresetLineDashVal 값 'dash'에 해당합니다.

TabStop

단락 내의 탭 정지입니다.

JSON 표현
{
  "offset": {
    object (Dimension)
  },
  "alignment": enum (TabStopAlignment)
}
필드
offset

object (Dimension)

이 탭 정지와 시작 여백 사이의 오프셋입니다.

alignment

enum (TabStopAlignment)

이 탭 정지의 정렬입니다. 설정하지 않으면 기본값은 START입니다.

TabStopAlignment

탭 정지의 정렬입니다.

열거형
TAB_STOP_ALIGNMENT_UNSPECIFIED 탭 정지 정렬이 지정되지 않았습니다.
START 탭 정지는 줄의 시작 부분에 맞춰 정렬됩니다. 이는 기본값입니다.
CENTER 탭 정지가 줄의 가운데에 정렬됩니다.
END 탭 정지가 줄 끝에 정렬됩니다.

음영

단락의 음영입니다.

JSON 표현
{
  "backgroundColor": {
    object (OptionalColor)
  }
}
필드
backgroundColor

object (OptionalColor)

이 단락 음영의 배경색입니다.

SuggestedParagraphStyle

ParagraphStyle에 대한 제안된 변경사항입니다.

JSON 표현
{
  "paragraphStyle": {
    object (ParagraphStyle)
  },
  "paragraphStyleSuggestionState": {
    object (ParagraphStyleSuggestionState)
  }
}
필드
paragraphStyle

object (ParagraphStyle)

이 제안에서 이루어진 변경사항만 포함하는 ParagraphStyle paragraphStyleSuggestionState와 함께 사용하여 변경된 필드와 새 값을 확인할 수 있습니다.

paragraphStyleSuggestionState

object (ParagraphStyleSuggestionState)

이 제안에서 기본 ParagraphStyle의 어떤 필드가 변경되었는지 나타내는 마스크입니다.

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 (ShadingSuggestionState)
  },
  "pageBreakBeforeSuggested": boolean
}
필드
headingIdSuggested

boolean

headingId에 추천된 변경사항이 있는지 나타냅니다.

namedStyleTypeSuggested

boolean

namedStyleType에 추천된 변경사항이 있는지 나타냅니다.

alignmentSuggested

boolean

alignment에 추천된 변경사항이 있는지 나타냅니다.

lineSpacingSuggested

boolean

lineSpacing에 추천된 변경사항이 있는지 나타냅니다.

directionSuggested

boolean

direction에 추천된 변경사항이 있는지 나타냅니다.

spacingModeSuggested

boolean

spacingMode에 추천된 변경사항이 있는지 나타냅니다.

spaceAboveSuggested

boolean

spaceAbove에 추천된 변경사항이 있는지 나타냅니다.

spaceBelowSuggested

boolean

spaceBelow에 추천된 변경사항이 있는지 나타냅니다.

borderBetweenSuggested

boolean

borderBetween에 추천된 변경사항이 있는지 나타냅니다.

borderTopSuggested

boolean

borderTop에 추천된 변경사항이 있는지 나타냅니다.

borderBottomSuggested

boolean

borderBottom에 추천된 변경사항이 있는지 나타냅니다.

borderLeftSuggested

boolean

borderLeft에 추천된 변경사항이 있는지 나타냅니다.

borderRightSuggested

boolean

borderRight에 추천된 변경사항이 있는지 나타냅니다.

indentFirstLineSuggested

boolean

indentFirstLine에 추천된 변경사항이 있는지 나타냅니다.

indentStartSuggested

boolean

indentStart에 추천된 변경사항이 있는지 나타냅니다.

indentEndSuggested

boolean

indentEnd에 추천된 변경사항이 있는지 나타냅니다.

keepLinesTogetherSuggested

boolean

keepLinesTogether에 추천된 변경사항이 있는지 나타냅니다.

keepWithNextSuggested

boolean

keepWithNext에 추천된 변경사항이 있는지 나타냅니다.

avoidWidowAndOrphanSuggested

boolean

avoidWidowAndOrphan에 추천된 변경사항이 있는지 나타냅니다.

shadingSuggestionState

object (ShadingSuggestionState)

이 추천에서 shading의 어떤 필드가 변경되었는지 나타내는 마스크입니다.

pageBreakBeforeSuggested

boolean

pageBreakBefore에 추천된 변경사항이 있는지 나타냅니다.

ShadingSuggestionState

이 추천 변경사항에서 기본 Shading의 어떤 필드가 변경되었는지 나타내는 마스크입니다. true로 설정된 필드에는 새로운 추천 값이 있습니다.

JSON 표현
{
  "backgroundColorSuggested": boolean
}
필드
backgroundColorSuggested

boolean

Shading에 제안된 변경사항이 있었는지 여부를 나타냅니다.

글머리기호

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

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

string

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

nestingLevel

integer

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

textStyle

object (TextStyle)

이 글머리에 적용된 단락별 텍스트 스타일입니다.

SuggestedBullet

Bullet에 대한 제안된 변경사항입니다.

JSON 표현
{
  "bullet": {
    object (Bullet)
  },
  "bulletSuggestionState": {
    object (BulletSuggestionState)
  }
}
필드
bullet

object (Bullet)

이 제안에서 이루어진 변경사항만 포함하는 Bullet bulletSuggestionState와 함께 사용하여 변경된 필드와 새 값을 확인할 수 있습니다.

bulletSuggestionState

object (BulletSuggestionState)

이 제안에서 기본 Bullet의 어떤 필드가 변경되었는지 나타내는 마스크입니다.

BulletSuggestionState

이 제안에서 기본 Bullet의 어떤 필드가 변경되었는지 나타내는 마스크입니다. true로 설정된 필드에는 새로운 추천 값이 있습니다.

JSON 표현
{
  "listIdSuggested": boolean,
  "nestingLevelSuggested": boolean,
  "textStyleSuggestionState": {
    object (TextStyleSuggestionState)
  }
}
필드
listIdSuggested

boolean

listId에 제안된 변경사항이 있었는지 여부를 나타냅니다.

nestingLevelSuggested

boolean

nestingLevel에 제안된 변경사항이 있었는지 여부를 나타냅니다.

textStyleSuggestionState

object (TextStyleSuggestionState)

이 추천에서 text style의 어떤 필드가 변경되었는지 나타내는 마스크입니다.

ObjectReferences

객체 ID의 컬렉션입니다.

JSON 표현
{
  "objectIds": [
    string
  ]
}
필드
objectIds[]

string

객체 ID입니다.

SectionBreak

섹션 나누기를 나타내는 StructuralElement입니다. 섹션은 동일한 SectionStyle를 갖는 콘텐츠 범위입니다. 섹션 나누기는 새 섹션의 시작을 나타내며 섹션 스타일은 섹션 나누기 이후의 섹션에 적용됩니다.

문서 본문은 항상 섹션 나누기로 시작합니다.

JSON 표현
{
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "sectionStyle": {
    object (SectionStyle)
  }
}
필드
suggestedInsertionIds[]

string

추천 삽입 ID입니다. SectionBreak가 중첩된 추천 변경사항인 경우 삽입 ID가 여러 개 있을 수 있습니다. 비어 있으면 추천 삽입이 아닙니다.

suggestedDeletionIds[]

string

추천 삭제 ID입니다. 비어 있으면 이 콘텐츠의 삭제 추천이 없습니다.

sectionStyle

object (SectionStyle)

이 섹션 나누기 이후 섹션의 스타일입니다.

SectionStyle

섹션에 적용되는 스타일입니다.

JSON 표현
{
  "columnProperties": [
    {
      object (SectionColumnProperties)
    }
  ],
  "columnSeparatorStyle": enum (ColumnSeparatorStyle),
  "contentDirection": enum (ContentDirection),
  "marginTop": {
    object (Dimension)
  },
  "marginBottom": {
    object (Dimension)
  },
  "marginRight": {
    object (Dimension)
  },
  "marginLeft": {
    object (Dimension)
  },
  "marginHeader": {
    object (Dimension)
  },
  "marginFooter": {
    object (Dimension)
  },
  "sectionType": enum (SectionType),
  "defaultHeaderId": string,
  "defaultFooterId": string,
  "firstPageHeaderId": string,
  "firstPageFooterId": string,
  "evenPageHeaderId": string,
  "evenPageFooterId": string,
  "useFirstPageHeaderFooter": boolean,
  "pageNumberStart": integer,
  "flipPageOrientation": boolean
}
필드
columnProperties[]

object (SectionColumnProperties)

섹션의 열 속성입니다.

비어 있으면 섹션에 문서 편집기의 기본 속성이 있는 열이 하나 포함됩니다. 섹션은 최대 3개의 열을 갖도록 업데이트할 수 있습니다.

이 속성을 업데이트할 때는 구체적인 값을 설정해야 합니다. 이 속성을 설정 해제하면 400 잘못된 요청 오류가 발생합니다.

columnSeparatorStyle

enum (ColumnSeparatorStyle)

열 구분 기호의 스타일입니다.

이 스타일은 섹션에 열이 하나만 있는 경우에도 설정할 수 있습니다.

이 속성을 업데이트할 때는 구체적인 값을 설정해야 합니다. 이 속성을 설정 해제하면 400 잘못된 요청 오류가 발생합니다.

contentDirection

enum (ContentDirection)

이 섹션의 콘텐츠 방향입니다. 설정하지 않으면 기본값은 LEFT_TO_RIGHT입니다.

이 속성을 업데이트할 때는 구체적인 값을 설정해야 합니다. 이 속성을 설정 해제하면 400 잘못된 요청 오류가 발생합니다.

marginTop

object (Dimension)

섹션의 상단 페이지 여백입니다. 설정하지 않으면 값이 DocumentStyle의 marginTop으로 기본 설정됩니다.

이 속성을 업데이트할 때는 구체적인 값을 설정해야 합니다. 이 속성을 설정 해제하면 400 잘못된 요청 오류가 발생합니다.

marginBottom

object (Dimension)

섹션의 하단 페이지 여백입니다. 설정하지 않으면 값이 DocumentStyle의 marginBottom으로 기본 설정됩니다.

이 속성을 업데이트할 때는 구체적인 값을 설정해야 합니다. 이 속성을 설정 해제하면 400 잘못된 요청 오류가 발생합니다.

marginRight

object (Dimension)

섹션의 오른쪽 페이지 여백입니다. 설정하지 않으면 값이 DocumentStyle의 marginRight으로 기본 설정됩니다. 오른쪽 여백을 업데이트하면 이 섹션의 열 크기가 조정됩니다. 여백은 열 너비에 영향을 미치므로 열 속성 전에 적용됩니다.

이 속성을 업데이트할 때는 구체적인 값을 설정해야 합니다. 이 속성을 설정 해제하면 400 잘못된 요청 오류가 발생합니다.

marginLeft

object (Dimension)

섹션의 왼쪽 페이지 여백입니다. 설정하지 않으면 값이 DocumentStyle의 marginLeft으로 기본 설정됩니다. 왼쪽 여백을 업데이트하면 이 섹션의 열 크기가 조정됩니다. 여백은 열 너비에 영향을 미치므로 열 속성 전에 적용됩니다.

이 속성을 업데이트할 때는 구체적인 값을 설정해야 합니다. 이 속성을 설정 해제하면 400 잘못된 요청 오류가 발생합니다.

marginHeader

object (Dimension)

섹션의 헤더 여백입니다. 설정하지 않으면 값이 DocumentStyle의 marginHeader으로 기본 설정됩니다. 업데이트된 경우 DocumentStyle에서 useCustomHeaderFooterMargins가 true로 설정됩니다. DocumentStyle의 useCustomHeaderFooterMargins 값은 이 섹션에 대해 헤더 여백이 적용되는지 여부를 나타냅니다.

이 속성을 업데이트할 때는 구체적인 값을 설정해야 합니다. 이 속성을 설정 해제하면 400 잘못된 요청 오류가 발생합니다.

sectionType

enum (SectionType)

출력 전용입니다. 섹션의 유형입니다.

defaultHeaderId

string

기본 헤더의 ID입니다. 설정되지 않은 경우 값은 이전 SectionBreak's SectionStyle에서 상속됩니다. 첫 번째 SectionBreak에서 값이 설정되지 않은 경우 DocumentStyle의 defaultHeaderId에서 상속됩니다.

이 속성은 읽기 전용입니다.

firstPageHeaderId

string

섹션의 첫 번째 페이지에만 사용되는 헤더의 ID입니다. useFirstPageHeaderFooter이 true이면 이 값이 섹션의 첫 페이지에 있는 헤더에 사용됩니다. false인 경우 섹션의 첫 페이지에 있는 헤더는 defaultHeaderId를 사용합니다. 설정되지 않은 경우 값은 이전 SectionBreak's SectionStyle에서 상속됩니다. 첫 번째 SectionBreak에서 값이 설정되지 않은 경우 DocumentStyle의 firstPageHeaderId에서 상속됩니다.

이 속성은 읽기 전용입니다.

evenPageHeaderId

string

짝수 페이지에만 사용되는 헤더의 ID입니다. DocumentStyle의 useEvenPageHeaderFooter 값이 true이면 이 값이 섹션의 짝수 페이지에 있는 헤더에 사용됩니다. false인 경우 짝수 페이지의 헤더는 defaultHeaderId를 사용합니다. 설정되지 않은 경우 값은 이전 SectionBreak's SectionStyle에서 상속됩니다. 첫 번째 SectionBreak에서 값이 설정되지 않은 경우 DocumentStyle의 evenPageHeaderId에서 상속됩니다.

이 속성은 읽기 전용입니다.

pageNumberStart

integer

이 섹션의 페이지 수 계산을 시작할 페이지 번호입니다. 설정하지 않으면 이전 섹션부터 페이지 번호 매기기가 계속됩니다. 첫 번째 SectionBreak에서 값이 설정되지 않은 경우 DocumentStyle의 pageNumberStart를 참고하세요.

이 속성을 업데이트할 때는 구체적인 값을 설정해야 합니다. 이 속성을 설정 해제하면 400 잘못된 요청 오류가 발생합니다.

flipPageOrientation

boolean

선택사항입니다. 이 섹션의 DocumentStyle의 pageSize의 크기를 뒤집을지 여부를 나타냅니다. 이를 통해 세로와 가로 간에 페이지 방향을 변경할 수 있습니다. 설정되지 않은 경우 DocumentStyle의 flipPageOrientation에서 값을 상속합니다.

이 속성을 업데이트할 때는 구체적인 값을 설정해야 합니다. 이 속성을 설정 해제하면 400 잘못된 요청 오류가 발생합니다.

SectionColumnProperties

섹션의 열에 적용되는 속성입니다.

JSON 표현
{
  "width": {
    object (Dimension)
  },
  "paddingEnd": {
    object (Dimension)
  }
}
필드
width

object (Dimension)

출력 전용입니다. 열의 너비입니다.

paddingEnd

object (Dimension)

열 끝의 패딩입니다.

ColumnSeparatorStyle

열 사이의 열 구분 기호 스타일입니다.

열거형
COLUMN_SEPARATOR_STYLE_UNSPECIFIED 지정되지 않은 열 구분 기호 스타일입니다.
NONE 열 사이에 열 구분선이 없습니다.
BETWEEN_EACH_COLUMN 각 열 사이에 열 구분선이 렌더링됩니다.

SectionType

이전 섹션을 기준으로 현재 섹션의 시작 위치를 나타냅니다.

열거형
SECTION_TYPE_UNSPECIFIED 섹션 유형이 지정되지 않았습니다.
CONTINUOUS 이 섹션은 이전 섹션의 마지막 단락 바로 뒤에 시작됩니다.
NEXT_PAGE 섹션은 다음 페이지에서 시작됩니다.

표를 나타내는 StructuralElement입니다.

JSON 표현
{
  "rows": integer,
  "columns": integer,
  "tableRows": [
    {
      object (TableRow)
    }
  ],
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "tableStyle": {
    object (TableStyle)
  }
}
필드
rows

integer

테이블의 행 수입니다.

columns

integer

테이블의 열 수입니다.

표가 직사각형이 아닐 수 있으므로 일부 행의 셀 수가 다를 수 있습니다.

tableRows[]

object (TableRow)

각 행의 콘텐츠와 스타일입니다.

suggestedInsertionIds[]

string

추천 삽입 ID입니다. Table가 중첩된 추천 변경사항인 경우 삽입 ID가 여러 개 있을 수 있습니다. 비어 있으면 추천 삽입이 아닙니다.

suggestedDeletionIds[]

string

추천 삭제 ID입니다. 비어 있으면 이 콘텐츠의 삭제 추천이 없습니다.

tableStyle

object (TableStyle)

표의 스타일입니다.

TableRow

Table의 행 콘텐츠와 스타일입니다.

JSON 표현
{
  "startIndex": integer,
  "endIndex": integer,
  "tableCells": [
    {
      object (TableCell)
    }
  ],
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "tableRowStyle": {
    object (TableRowStyle)
  },
  "suggestedTableRowStyleChanges": {
    string: {
      object (SuggestedTableRowStyle)
    },
    ...
  }
}
필드
startIndex

integer

이 행의 0부터 시작하는 시작 색인(UTF-16 코드 단위)입니다.

endIndex

integer

이 행의 0부터 시작하는 종료 색인입니다(제외). UTF-16 코드 단위로 나타냅니다.

tableCells[]

object (TableCell)

이 행에 있는 각 셀의 콘텐츠와 스타일입니다.

표가 직사각형이 아닐 수 있으므로 일부 행의 셀 수가 동일한 표의 다른 행과 다를 수 있습니다.

suggestedInsertionIds[]

string

추천 삽입 ID입니다. TableRow가 중첩된 추천 변경사항인 경우 삽입 ID가 여러 개 있을 수 있습니다. 비어 있으면 추천 삽입이 아닙니다.

suggestedDeletionIds[]

string

추천 삭제 ID입니다. 비어 있으면 이 콘텐츠의 삭제 추천이 없습니다.

tableRowStyle

object (TableRowStyle)

표 행의 스타일입니다.

suggestedTableRowStyleChanges

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

추천 ID로 키가 지정된 이 행에 대한 추천 스타일 변경사항입니다.

TableCell

Table의 셀 콘텐츠와 스타일입니다.

JSON 표현
{
  "startIndex": integer,
  "endIndex": integer,
  "content": [
    {
      object (StructuralElement)
    }
  ],
  "tableCellStyle": {
    object (TableCellStyle)
  },
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "suggestedTableCellStyleChanges": {
    string: {
      object (SuggestedTableCellStyle)
    },
    ...
  }
}
필드
startIndex

integer

이 셀의 0부터 시작하는 시작 색인입니다(UTF-16 코드 단위).

endIndex

integer

이 셀의 0부터 시작하는 종료 색인입니다(제외). UTF-16 코드 단위로 표시됩니다.

content[]

object (StructuralElement)

셀의 콘텐츠입니다.

tableCellStyle

object (TableCellStyle)

셀의 스타일입니다.

suggestedInsertionIds[]

string

추천 삽입 ID입니다. TableCell가 중첩된 추천 변경사항인 경우 삽입 ID가 여러 개 있을 수 있습니다. 비어 있으면 추천 삽입이 아닙니다.

suggestedDeletionIds[]

string

추천 삭제 ID입니다. 비어 있으면 이 콘텐츠의 삭제 추천이 없습니다.

suggestedTableCellStyleChanges

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

표 셀 스타일의 제안된 변경사항입니다(제안 ID로 키가 지정됨).

TableCellStyle

TableCell의 스타일입니다.

상속된 표 셀 스타일은 이 메시지에서 설정되지 않은 필드로 표시됩니다. 표 셀 스타일은 표의 스타일에서 상속받을 수 있습니다.

JSON 표현
{
  "rowSpan": integer,
  "columnSpan": integer,
  "backgroundColor": {
    object (OptionalColor)
  },
  "borderLeft": {
    object (TableCellBorder)
  },
  "borderRight": {
    object (TableCellBorder)
  },
  "borderTop": {
    object (TableCellBorder)
  },
  "borderBottom": {
    object (TableCellBorder)
  },
  "paddingLeft": {
    object (Dimension)
  },
  "paddingRight": {
    object (Dimension)
  },
  "paddingTop": {
    object (Dimension)
  },
  "paddingBottom": {
    object (Dimension)
  },
  "contentAlignment": enum (ContentAlignment)
}
필드
rowSpan

integer

셀의 행 범위입니다.

이 속성은 읽기 전용입니다.

columnSpan

integer

셀의 열 범위입니다.

이 속성은 읽기 전용입니다.

backgroundColor

object (OptionalColor)

셀의 배경색입니다.

borderLeft

object (TableCellBorder)

셀의 왼쪽 테두리입니다.

borderRight

object (TableCellBorder)

셀의 오른쪽 테두리입니다.

borderTop

object (TableCellBorder)

셀의 상단 테두리입니다.

borderBottom

object (TableCellBorder)

셀의 하단 테두리입니다.

paddingLeft

object (Dimension)

셀의 왼쪽 패딩입니다.

paddingRight

object (Dimension)

셀의 오른쪽 패딩입니다.

paddingTop

object (Dimension)

셀의 상단 패딩입니다.

paddingBottom

object (Dimension)

셀의 하단 패딩입니다.

contentAlignment

enum (ContentAlignment)

표 셀의 콘텐츠 정렬입니다. 기본 정렬은 Docs 편집기에서 새로 생성된 표 셀의 정렬과 일치합니다.

TableCellBorder

테이블 셀 주위의 테두리입니다.

표 셀 테두리는 투명할 수 없습니다. 표 셀 테두리를 숨기려면 너비를 0으로 설정합니다.

JSON 표현
{
  "color": {
    object (OptionalColor)
  },
  "width": {
    object (Dimension)
  },
  "dashStyle": enum (DashStyle)
}
필드
color

object (OptionalColor)

테두리 색상입니다.

이 색상은 투명할 수 없습니다.

width

object (Dimension)

테두리의 너비입니다.

dashStyle

enum (DashStyle)

테두리의 대시 스타일입니다.

ContentAlignment

콘텐츠 정렬 유형입니다.

ECMA-376 5번째 버전 1부의 'Office Open XML 파일 형식 - 기본 사항 및 마크업 언어 참조' 섹션 20.1.10.60에 있는 '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'에 해당합니다.

SuggestedTableCellStyle

TableCellStyle에 대한 제안된 변경사항입니다.

JSON 표현
{
  "tableCellStyle": {
    object (TableCellStyle)
  },
  "tableCellStyleSuggestionState": {
    object (TableCellStyleSuggestionState)
  }
}
필드
tableCellStyle

object (TableCellStyle)

이 제안에서 이루어진 변경사항만 포함하는 TableCellStyle tableCellStyleSuggestionState와 함께 사용하여 변경된 필드와 새 값을 확인할 수 있습니다.

tableCellStyleSuggestionState

object (TableCellStyleSuggestionState)

이 제안에서 기본 TableCellStyle의 어떤 필드가 변경되었는지 나타내는 마스크입니다.

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

boolean

rowSpan에 추천된 변경사항이 있는지 나타냅니다.

columnSpanSuggested

boolean

columnSpan에 추천된 변경사항이 있는지 나타냅니다.

backgroundColorSuggested

boolean

backgroundColor에 추천된 변경사항이 있는지 나타냅니다.

borderLeftSuggested

boolean

borderLeft에 추천된 변경사항이 있는지 나타냅니다.

borderRightSuggested

boolean

borderRight에 추천된 변경사항이 있는지 나타냅니다.

borderTopSuggested

boolean

borderTop에 추천된 변경사항이 있는지 나타냅니다.

borderBottomSuggested

boolean

borderBottom에 추천된 변경사항이 있는지 나타냅니다.

paddingLeftSuggested

boolean

paddingLeft에 추천된 변경사항이 있는지 나타냅니다.

paddingRightSuggested

boolean

paddingRight에 추천된 변경사항이 있는지 나타냅니다.

paddingTopSuggested

boolean

paddingTop에 추천된 변경사항이 있는지 나타냅니다.

paddingBottomSuggested

boolean

paddingBottom에 추천된 변경사항이 있는지 나타냅니다.

contentAlignmentSuggested

boolean

contentAlignment에 추천된 변경사항이 있는지 나타냅니다.

TableRowStyle

표 행에 적용되는 스타일입니다.

JSON 표현
{
  "minRowHeight": {
    object (Dimension)
  },
  "tableHeader": boolean,
  "preventOverflow": boolean
}
필드
minRowHeight

object (Dimension)

행의 최소 높이입니다. 행의 모든 콘텐츠를 표시하기 위해 행은 Docs 편집기에서 이 값보다 크거나 같은 높이로 렌더링됩니다.

tableHeader

boolean

행이 표 헤더인지 여부입니다.

preventOverflow

boolean

행이 페이지 또는 열 경계를 넘어 오버플로될 수 없는지 여부입니다.

SuggestedTableRowStyle

TableRowStyle에 대한 제안된 변경사항입니다.

JSON 표현
{
  "tableRowStyle": {
    object (TableRowStyle)
  },
  "tableRowStyleSuggestionState": {
    object (TableRowStyleSuggestionState)
  }
}
필드
tableRowStyle

object (TableRowStyle)

이 제안에서 이루어진 변경사항만 포함하는 TableRowStyle tableRowStyleSuggestionState와 함께 사용하여 변경된 필드와 새 값을 확인할 수 있습니다.

tableRowStyleSuggestionState

object (TableRowStyleSuggestionState)

이 제안에서 기본 TableRowStyle의 어떤 필드가 변경되었는지 나타내는 마스크입니다.

TableRowStyleSuggestionState

이 제안에서 기본 TableRowStyle의 어떤 필드가 변경되었는지 나타내는 마스크입니다. true로 설정된 필드에는 새로운 추천 값이 있습니다.

JSON 표현
{
  "minRowHeightSuggested": boolean
}
필드
minRowHeightSuggested

boolean

minRowHeight에 추천된 변경사항이 있는지 나타냅니다.

TableStyle

표에 적용되는 스타일입니다.

JSON 표현
{
  "tableColumnProperties": [
    {
      object (TableColumnProperties)
    }
  ]
}
필드
tableColumnProperties[]

object (TableColumnProperties)

각 열의 속성입니다.

Docs에서 표에는 행이 포함되고 행에는 셀이 포함됩니다(HTML과 유사). 따라서 행의 속성은 행의 tableRowStyle에서 확인할 수 있습니다.

TableColumnProperties

표의 열 속성입니다.

JSON 표현
{
  "widthType": enum (WidthType),
  "width": {
    object (Dimension)
  }
}
필드
widthType

enum (WidthType)

열의 너비 유형입니다.

width

object (Dimension)

열의 너비입니다. 열의 widthTypeFIXED_WIDTH인 경우 설정됩니다.

WidthType

열의 너비 유형입니다.

열거형
WIDTH_TYPE_UNSPECIFIED 열 너비 유형이 지정되지 않았습니다.
EVENLY_DISTRIBUTED

열 너비는 균등하게 분배된 다른 열 간에 균등하게 분배됩니다.

열의 너비는 자동으로 결정되며 지정된 너비가 있는 모든 열을 고려한 후 표에 남아 있는 너비의 동일한 부분을 갖습니다.

FIXED_WIDTH 고정 열 너비입니다. [너비][google.apps.docs.v1.TableColumnProperties.width 속성에는 열의 너비가 포함됩니다.

TableOfContents

목차를 나타내는 StructuralElement입니다.

JSON 표현
{
  "content": [
    {
      object (StructuralElement)
    }
  ],
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ]
}
필드
content[]

object (StructuralElement)

목차의 내용입니다.

suggestedInsertionIds[]

string

추천 삽입 ID입니다. TableOfContents가 중첩된 추천 변경사항인 경우 삽입 ID가 여러 개 있을 수 있습니다. 비어 있으면 추천 삽입이 아닙니다.

suggestedDeletionIds[]

string

추천 삭제 ID입니다. 비어 있으면 이 콘텐츠의 삭제 추천이 없습니다.

각주

문서 각주입니다.

JSON 표현
{
  "footnoteId": string,
  "content": [
    {
      object (StructuralElement)
    }
  ]
}
필드
footnoteId

string

각주의 ID입니다.

content[]

object (StructuralElement)

각주의 내용입니다.

각주 콘텐츠의 색인은 0부터 시작합니다.

DocumentStyle

문서의 스타일입니다.

JSON 표현
{
  "background": {
    object (Background)
  },
  "defaultHeaderId": string,
  "defaultFooterId": string,
  "evenPageHeaderId": string,
  "evenPageFooterId": string,
  "firstPageHeaderId": string,
  "firstPageFooterId": string,
  "useFirstPageHeaderFooter": boolean,
  "useEvenPageHeaderFooter": boolean,
  "pageNumberStart": integer,
  "marginTop": {
    object (Dimension)
  },
  "marginBottom": {
    object (Dimension)
  },
  "marginRight": {
    object (Dimension)
  },
  "marginLeft": {
    object (Dimension)
  },
  "pageSize": {
    object (Size)
  },
  "marginHeader": {
    object (Dimension)
  },
  "marginFooter": {
    object (Dimension)
  },
  "useCustomHeaderFooterMargins": boolean,
  "flipPageOrientation": boolean
}
필드
background

object (Background)

문서의 배경입니다. 문서의 배경색은 투명할 수 없습니다.

defaultHeaderId

string

기본 헤더의 ID입니다. 설정하지 않으면 기본 헤더가 없습니다.

이 속성은 읽기 전용입니다.

evenPageHeaderId

string

짝수 페이지에만 사용되는 헤더의 ID입니다. useEvenPageHeaderFooter 값은 짝수 페이지의 헤더에 defaultHeaderId 또는 이 값을 사용할지 여부를 결정합니다. 설정하지 않으면 짝수 페이지 머리글이 없습니다.

이 속성은 읽기 전용입니다.

firstPageHeaderId

string

첫 번째 페이지에만 사용되는 헤더의 ID입니다. 설정되지 않은 경우 첫 번째 페이지의 고유한 헤더가 존재하지 않습니다. useFirstPageHeaderFooter 값에 따라 첫 페이지의 헤더에 defaultHeaderId 또는 이 값을 사용할지 결정됩니다. 설정하지 않으면 첫 페이지 헤더가 없습니다.

이 속성은 읽기 전용입니다.

pageNumberStart

integer

페이지 수 계산을 시작할 페이지 번호입니다.

marginTop

object (Dimension)

상단 페이지 여백입니다.

문서 스타일의 상단 페이지 여백을 업데이트하면 모든 섹션 스타일의 상단 페이지 여백이 지워집니다.

marginBottom

object (Dimension)

하단 페이지 여백입니다.

문서 스타일에서 하단 페이지 여백을 업데이트하면 모든 섹션 스타일의 하단 페이지 여백이 지워집니다.

marginRight

object (Dimension)

오른쪽 페이지 여백입니다.

문서 스타일의 오른쪽 페이지 여백을 업데이트하면 모든 섹션 스타일의 오른쪽 페이지 여백이 지워집니다. 또한 모든 섹션에서 열의 크기가 조정될 수 있습니다.

marginLeft

object (Dimension)

왼쪽 페이지 여백입니다.

문서 스타일에서 왼쪽 페이지 여백을 업데이트하면 모든 섹션 스타일의 왼쪽 페이지 여백이 지워집니다. 또한 모든 섹션에서 열의 크기가 조정될 수 있습니다.

pageSize

object (Size)

문서의 페이지 크기입니다.

marginHeader

object (Dimension)

페이지 상단과 헤더 콘텐츠 사이의 공간 크기입니다.

flipPageOrientation

boolean

선택사항입니다. pageSize의 크기를 뒤집을지 여부를 나타냅니다. 이를 통해 페이지 방향을 세로와 가로 간에 변경할 수 있습니다.

배경

문서의 배경을 나타냅니다.

JSON 표현
{
  "color": {
    object (OptionalColor)
  }
}
필드
color

object (OptionalColor)

배경색입니다.

크기

너비와 높이

JSON 표현
{
  "height": {
    object (Dimension)
  },
  "width": {
    object (Dimension)
  }
}
필드
height

object (Dimension)

객체의 높이입니다.

width

object (Dimension)

객체의 너비입니다.

SuggestedDocumentStyle

DocumentStyle에 대한 제안된 변경사항입니다.

JSON 표현
{
  "documentStyle": {
    object (DocumentStyle)
  },
  "documentStyleSuggestionState": {
    object (DocumentStyleSuggestionState)
  }
}
필드
documentStyle

object (DocumentStyle)

이 제안에서 이루어진 변경사항만 포함하는 DocumentStyle documentStyleSuggestionState와 함께 사용하여 변경된 필드와 새 값을 확인할 수 있습니다.

documentStyleSuggestionState

object (DocumentStyleSuggestionState)

이 제안에서 기본 DocumentStyle의 어떤 필드가 변경되었는지 나타내는 마스크입니다.

DocumentStyleSuggestionState

이 제안에서 기본 DocumentStyle의 어떤 필드가 변경되었는지 나타내는 마스크입니다. true로 설정된 필드에는 새로운 추천 값이 있습니다.

JSON 표현
{
  "backgroundSuggestionState": {
    object (BackgroundSuggestionState)
  },
  "defaultHeaderIdSuggested": boolean,
  "defaultFooterIdSuggested": boolean,
  "evenPageHeaderIdSuggested": boolean,
  "evenPageFooterIdSuggested": boolean,
  "firstPageHeaderIdSuggested": boolean,
  "firstPageFooterIdSuggested": boolean,
  "useFirstPageHeaderFooterSuggested": boolean,
  "useEvenPageHeaderFooterSuggested": boolean,
  "pageNumberStartSuggested": boolean,
  "marginTopSuggested": boolean,
  "marginBottomSuggested": boolean,
  "marginRightSuggested": boolean,
  "marginLeftSuggested": boolean,
  "pageSizeSuggestionState": {
    object (SizeSuggestionState)
  },
  "marginHeaderSuggested": boolean,
  "marginFooterSuggested": boolean,
  "useCustomHeaderFooterMarginsSuggested": boolean,
  "flipPageOrientationSuggested": boolean
}
필드
backgroundSuggestionState

object (BackgroundSuggestionState)

이 추천에서 background의 어떤 필드가 변경되었는지 나타내는 마스크입니다.

defaultHeaderIdSuggested

boolean

defaultHeaderId에 추천된 변경사항이 있는지 나타냅니다.

evenPageHeaderIdSuggested

boolean

evenPageHeaderId에 추천된 변경사항이 있는지 나타냅니다.

firstPageHeaderIdSuggested

boolean

firstPageHeaderId에 추천된 변경사항이 있는지 나타냅니다.

pageNumberStartSuggested

boolean

pageNumberStart에 추천된 변경사항이 있는지 나타냅니다.

marginTopSuggested

boolean

marginTop에 추천된 변경사항이 있는지 나타냅니다.

marginBottomSuggested

boolean

marginBottom에 추천된 변경사항이 있는지 나타냅니다.

marginRightSuggested

boolean

marginRight에 추천된 변경사항이 있는지 나타냅니다.

marginLeftSuggested

boolean

marginLeft에 추천된 변경사항이 있는지 나타냅니다.

pageSizeSuggestionState

object (SizeSuggestionState)

이 제안에서 [size][google.apps.docs.v1.DocumentStyle.size] 의 어떤 필드가 변경되었는지 나타내는 마스크입니다.

marginHeaderSuggested

boolean

marginHeader에 추천된 변경사항이 있는지 나타냅니다.

flipPageOrientationSuggested

boolean

선택사항입니다. flipPageOrientation에 추천된 변경사항이 있는지 나타냅니다.

BackgroundSuggestionState

이 제안에서 기본 Background의 어떤 필드가 변경되었는지 나타내는 마스크입니다. true로 설정된 필드의 경우 Backgound에 새로운 추천 값이 있습니다.

JSON 표현
{
  "backgroundColorSuggested": boolean
}
필드
backgroundColorSuggested

boolean

이 추천에서 현재 배경색이 수정되었는지 여부를 나타냅니다.

SizeSuggestionState

이 제안에서 기본 Size의 어떤 필드가 변경되었는지 나타내는 마스크입니다. true로 설정된 필드의 경우 Size에 새로운 추천 값이 있습니다.

JSON 표현
{
  "heightSuggested": boolean,
  "widthSuggested": boolean
}
필드
heightSuggested

boolean

height에 추천된 변경사항이 있는지 나타냅니다.

widthSuggested

boolean

width에 추천된 변경사항이 있는지 나타냅니다.

NamedStyles

이름이 지정된 스타일입니다. 문서의 단락은 이러한 명명된 스타일에서 TextStyleParagraphStyle을 상속받을 수 있습니다.

JSON 표현
{
  "styles": [
    {
      object (NamedStyle)
    }
  ]
}
필드
styles[]

object (NamedStyle)

이름이 지정된 스타일입니다.

가능한 각 named style types에 대한 항목이 있습니다.

NamedStyle

이름이 지정된 스타일입니다. 문서의 단락은 이름이 지정된 스타일 유형이 동일한 경우 이 이름이 지정된 스타일에서 TextStyleParagraphStyle을 상속할 수 있습니다.

JSON 표현
{
  "namedStyleType": enum (NamedStyleType),
  "textStyle": {
    object (TextStyle)
  },
  "paragraphStyle": {
    object (ParagraphStyle)
  }
}
필드
namedStyleType

enum (NamedStyleType)

이 명명된 스타일의 유형입니다.

textStyle

object (TextStyle)

이 명명된 스타일의 텍스트 스타일입니다.

paragraphStyle

object (ParagraphStyle)

이 이름이 지정된 스타일의 단락 스타일입니다.

SuggestedNamedStyles

NamedStyles에 대한 제안된 변경사항입니다.

JSON 표현
{
  "namedStyles": {
    object (NamedStyles)
  },
  "namedStylesSuggestionState": {
    object (NamedStylesSuggestionState)
  }
}
필드
namedStyles

object (NamedStyles)

이 제안에서 이루어진 변경사항만 포함하는 NamedStyles namedStylesSuggestionState와 함께 사용하여 변경된 필드와 새 값을 확인할 수 있습니다.

namedStylesSuggestionState

object (NamedStylesSuggestionState)

이 제안에서 기본 NamedStyles의 어떤 필드가 변경되었는지 나타내는 마스크입니다.

NamedStylesSuggestionState

NamedStyles 메시지의 제안 상태입니다.

JSON 표현
{
  "stylesSuggestionStates": [
    {
      object (NamedStyleSuggestionState)
    }
  ]
}
필드
stylesSuggestionStates[]

object (NamedStyleSuggestionState)

styles의 해당 NamedStyle 필드 중 이 추천에서 변경된 필드를 나타내는 마스크입니다.

이러한 명명된 스타일 제안 상태의 순서는 named styles 제안 내 해당 명명된 스타일의 순서와 일치합니다.

NamedStyleSuggestionState

NamedStyle 메시지의 제안 상태입니다.

JSON 표현
{
  "namedStyleType": enum (NamedStyleType),
  "textStyleSuggestionState": {
    object (TextStyleSuggestionState)
  },
  "paragraphStyleSuggestionState": {
    object (ParagraphStyleSuggestionState)
  }
}
필드
namedStyleType

enum (NamedStyleType)

이 추천 상태에 해당하는 명명된 스타일 유형입니다.

이 필드는 NamedStyleSuggestionState를 해당 NamedStyle와 일치시키기 위해 편의상 제공됩니다.

textStyleSuggestionState

object (TextStyleSuggestionState)

이 추천에서 text style의 어떤 필드가 변경되었는지 나타내는 마스크입니다.

paragraphStyleSuggestionState

object (ParagraphStyleSuggestionState)

이 추천에서 paragraph style의 어떤 필드가 변경되었는지 나타내는 마스크입니다.

목록

목록은 모두 동일한 목록에 속하는 단락 그룹의 목록 속성을 나타냅니다. 목록의 일부인 단락에는 bullet에 목록의 ID에 대한 참조가 있습니다.

JSON 표현
{
  "listProperties": {
    object (ListProperties)
  },
  "suggestedListPropertiesChanges": {
    string: {
      object (SuggestedListProperties)
    },
    ...
  },
  "suggestedInsertionId": string,
  "suggestedDeletionIds": [
    string
  ]
}
필드
listProperties

object (ListProperties)

목록의 속성입니다.

suggestedListPropertiesChanges

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

목록 속성에 대한 추천 변경사항입니다(추천 ID로 키가 지정됨).

suggestedInsertionId

string

추천 삽입 ID입니다. 비어 있으면 추천 삽입이 아닙니다.

suggestedDeletionIds[]

string

추천 삭제 ID입니다. 비어 있으면 이 목록의 제안된 삭제가 없습니다.

ListProperties

목록과 연결된 단락에 속하는 글머리 기호의 디자인을 설명하는 list의 속성입니다.

JSON 표현
{
  "nestingLevels": [
    {
      object (NestingLevel)
    }
  ]
}
필드
nestingLevels[]

object (NestingLevel)

연결된 수준의 글머리 기호 속성을 설명합니다.

목록에는 최대 9개의 중첩 수준이 있으며 중첩 수준 0은 최상위 수준에 해당하고 중첩 수준 8은 가장 중첩된 수준에 해당합니다. 중첩 수준은 중첩이 가장 적은 수준이 먼저 반환되는 오름차순으로 반환됩니다.

NestingLevel

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

JSON 표현
{
  "bulletAlignment": enum (BulletAlignment),
  "glyphFormat": string,
  "indentFirstLine": {
    object (Dimension)
  },
  "indentStart": {
    object (Dimension)
  },
  "textStyle": {
    object (TextStyle)
  },
  "startNumber": integer,

  // Union field glyph_kind can be only one of the following:
  "glyphType": enum (GlyphType),
  "glyphSymbol": string
  // End of list of possible types for union field glyph_kind.
}
필드
bulletAlignment

enum (BulletAlignment)

글머리 기호를 렌더링하기 위해 할당된 공간 내에서 글머리 기호의 정렬입니다.

glyphFormat

string

이 수준의 중첩에서 글머리 기호가 사용하는 형식 문자열입니다.

글리프 형식에는 하나 이상의 자리표시자가 포함되어 있으며 이러한 자리표시자는 glyphType 또는 glyphSymbol에 따라 적절한 값으로 대체됩니다. 자리표시자는 %[nestingLevel] 패턴을 따릅니다. 또한 자리표시자에는 접두사와 접미사가 있을 수 있습니다. 따라서 글리프 형식은 <prefix>%[nestingLevel]<suffix> 패턴을 따릅니다. 접두사와 접미사는 선택사항이며 임의의 문자열일 수 있습니다.

예를 들어 글리프 형식 %0.는 렌더링된 글리프가 자리표시자를 중첩 수준 0의 해당 글리프로 바꾸고 마침표가 접미사로 추가됨을 나타냅니다. 따라서 중첩 수준 0에서 글리프 유형이 UPPER_ALPHA이고 글리프 형식이 %0.인 목록은 렌더링된 글리프가 있는 목록이 됩니다.

A.

B.

C.

글리프 형식에는 현재 중첩 수준의 자리표시자와 상위 중첩 수준의 자리표시자가 포함될 수 있습니다. 예를 들어 목록의 중첩 수준 0에는 %0. 글리프 형식이 있고 중첩 수준 1에는 %0.%1. 글리프 형식이 있을 수 있습니다. 두 중첩 수준 모두 DECIMAL 글리프 유형이 있다고 가정하면 렌더링된 글리프가 있는 목록이 생성됩니다.

1.

2.

2.1.

2.2.

3.

순서가 지정된 중첩 수준의 경우 특정 단락의 글리프 형식에서 자리표시자를 대체하는 문자열은 목록 내 단락의 순서에 따라 달라집니다.

indentFirstLine

object (Dimension)

이 중첩 수준에서 단락의 첫 번째 줄에 적용할 들여쓰기 양입니다.

indentStart

object (Dimension)

이 중첩 수준의 단락에 대한 들여쓰기 양입니다. 단락의 콘텐츠 방향에 따라 텍스트 시작에 해당하는 측면에 적용됩니다.

textStyle

object (TextStyle)

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

startNumber

integer

이 중첩 수준의 첫 번째 목록 항목 번호입니다.

문자 목록과 로마 숫자 목록의 경우 0 값은 1 값으로 처리됩니다. 값이 0과 1인 경우 문자 목록과 로마 숫자 목록은 각각 ai에서 시작합니다.

이 값은 순서가 지정되지 않은 글리프가 있는 중첩 수준에서는 무시됩니다.

통합 필드 glyph_kind. 글머리 기호에 사용되는 글리프의 종류입니다. glyph_format의 자리표시자를 대체하는 글머리 기호 글리프를 정의합니다. glyph_kind은 다음 중 하나일 수 있습니다.
glyphType

enum (GlyphType)

이 수준의 중첩된 단락이 정렬될 때 글머리 기호에서 사용되는 글리프 유형입니다.

글리프 유형은 이 수준의 중첩에 있는 단락이 정렬될 때 glyphFormat 내에서 자리표시자를 대체하는 데 사용되는 글리프의 유형을 결정합니다. 예를 들어 중첩 수준이 0이고 glyphFormat%0.이며 글리프 유형이 DECIMAL인 경우 렌더링된 글리프는 글리프 형식의 자리표시자 %0를 목록 내 목록 항목의 순서에 해당하는 숫자로 대체합니다.

glyphSymbol

string

이 수준의 중첩에 있는 단락이 순서가 지정되지 않은 경우 글머리 기호에서 사용되는 맞춤 글리프 기호입니다.

문자 기호는 glyphFormat 내의 자리표시자를 대체합니다. 예를 들어 glyphSymbol이 유니코드 U+25cf 코드 포인트에 해당하는 단색 원이고 glyphFormat%0이면 렌더링된 글리프는 단색 원입니다.

BulletAlignment

글머리 기호의 정렬 유형입니다.

열거형
BULLET_ALIGNMENT_UNSPECIFIED 글머리 기호 정렬이 지정되지 않았습니다.
START 글머리 기호는 글머리 기호를 렌더링하기 위해 할당된 공간의 시작 부분에 맞춰 정렬됩니다. LTR 텍스트의 경우 왼쪽 정렬, 그 외의 경우 오른쪽 정렬
CENTER 불릿은 불릿을 렌더링하기 위해 할당된 공간의 중앙에 정렬됩니다.
END 글머리 기호는 글머리 기호를 렌더링하기 위해 할당된 공간의 끝에 정렬됩니다. LTR 텍스트의 경우 오른쪽 정렬, 그 외의 경우 왼쪽 정렬

GlyphType

이 수준의 중첩에 있는 단락이 정렬될 때 글머리 기호에서 사용되는 글리프 유형입니다.

열거형
GLYPH_TYPE_UNSPECIFIED 글리프 유형이 지정되지 않았거나 지원되지 않습니다.
NONE 빈 문자열.
DECIMAL 1, 2, 3와 같은 숫자입니다.
ZERO_DECIMAL 한 자리 숫자에 0이 접두사로 붙은 숫자입니다(예: 01, 02, 03). 두 자리 이상의 숫자는 0으로 시작하지 않습니다.
UPPER_ALPHA A, B, C와 같은 대문자입니다.
ALPHA a, b, c와 같은 소문자
UPPER_ROMAN I, II, III와 같은 대문자 로마 숫자
ROMAN i, ii, iii과 같은 소문자 로마 숫자

SuggestedListProperties

ListProperties에 대한 제안된 변경사항입니다.

JSON 표현
{
  "listProperties": {
    object (ListProperties)
  },
  "listPropertiesSuggestionState": {
    object (ListPropertiesSuggestionState)
  }
}
필드
listProperties

object (ListProperties)

이 제안에서 이루어진 변경사항만 포함하는 ListProperties listPropertiesSuggestionState와 함께 사용하여 변경된 필드와 새 값을 확인할 수 있습니다.

listPropertiesSuggestionState

object (ListPropertiesSuggestionState)

이 제안에서 기본 ListProperties의 어떤 필드가 변경되었는지 나타내는 마스크입니다.

ListPropertiesSuggestionState

이 제안에서 기본 ListProperties의 어떤 필드가 변경되었는지 나타내는 마스크입니다. true로 설정된 필드에는 새로운 추천 값이 있습니다.

JSON 표현
{
  "nestingLevelsSuggestionStates": [
    {
      object (NestingLevelSuggestionState)
    }
  ]
}
필드
nestingLevelsSuggestionStates[]

object (NestingLevelSuggestionState)

nestingLevels의 해당 NestingLevel 필드 중 이 추천에서 변경된 필드를 나타내는 마스크입니다.

중첩 수준 제안 상태는 중첩 수준의 오름차순으로 반환되며, 중첩이 가장 적은 항목이 먼저 반환됩니다.

NestingLevelSuggestionState

이 제안에서 기본 NestingLevel의 어떤 필드가 변경되었는지 나타내는 마스크입니다. true로 설정된 필드에는 새로운 추천 값이 있습니다.

JSON 표현
{
  "bulletAlignmentSuggested": boolean,
  "glyphTypeSuggested": boolean,
  "glyphFormatSuggested": boolean,
  "glyphSymbolSuggested": boolean,
  "indentFirstLineSuggested": boolean,
  "indentStartSuggested": boolean,
  "textStyleSuggestionState": {
    object (TextStyleSuggestionState)
  },
  "startNumberSuggested": boolean
}
필드
bulletAlignmentSuggested

boolean

bulletAlignment에 추천된 변경사항이 있는지 나타냅니다.

glyphTypeSuggested

boolean

glyphType에 추천된 변경사항이 있는지 나타냅니다.

glyphFormatSuggested

boolean

glyphFormat에 추천된 변경사항이 있는지 나타냅니다.

glyphSymbolSuggested

boolean

glyphSymbol에 추천된 변경사항이 있는지 나타냅니다.

indentFirstLineSuggested

boolean

indentFirstLine에 추천된 변경사항이 있는지 나타냅니다.

indentStartSuggested

boolean

indentStart에 추천된 변경사항이 있는지 나타냅니다.

textStyleSuggestionState

object (TextStyleSuggestionState)

이 추천에서 text style의 어떤 필드가 변경되었는지 나타내는 마스크입니다.

startNumberSuggested

boolean

startNumber에 추천된 변경사항이 있는지 나타냅니다.

NamedRanges

지정된 이름을 공유하는 문서의 모든 NamedRange 컬렉션입니다.

JSON 표현
{
  "name": string,
  "namedRanges": [
    {
      object (NamedRange)
    }
  ]
}
필드
name

string

모든 named ranges가 공유하는 이름입니다.

namedRanges[]

object (NamedRange)

이름이 같은 NamedRange입니다.

NamedRange

이름이 지정된 범위 ID가 동일한 Range의 컬렉션입니다.

명명된 범위를 사용하면 개발자가 문서의 일부를 임의의 사용자 정의 라벨과 연결하여 나중에 콘텐츠를 프로그래매틱 방식으로 읽거나 수정할 수 있습니다. 문서에는 이름이 같은 명명된 범위가 여러 개 포함될 수 있지만 모든 명명된 범위에는 고유 ID가 있습니다.

이름이 지정된 범위는 단일 Range로 생성되며 이름이 지정된 범위 내에 삽입된 콘텐츠는 일반적으로 해당 범위를 확장합니다. 하지만 특정 문서 변경사항으로 인해 범위가 여러 범위로 분할될 수 있습니다.

이름이 지정된 범위는 비공개가 아닙니다. 문서에 액세스할 수 있는 모든 애플리케이션과 공동작업자는 명명된 범위를 볼 수 있습니다.

JSON 표현
{
  "namedRangeId": string,
  "name": string,
  "ranges": [
    {
      object (Range)
    }
  ]
}
필드
namedRangeId

string

이름이 지정된 범위의 ID입니다.

name

string

이름이 지정된 범위의 이름입니다.

ranges[]

object (Range)

이 이름이 지정된 범위에 속하는 범위입니다.

범위

연속된 텍스트 범위를 지정합니다.

JSON 표현
{
  "segmentId": string,
  "startIndex": integer,
  "endIndex": integer,
  "tabId": string
}
필드
segmentId

string

이 범위가 포함된 머리글, 바닥글 또는 각주의 ID입니다. 빈 세그먼트 ID는 문서의 본문을 나타냅니다.

startIndex

integer

이 범위의 0부터 시작하는 시작 색인(UTF-16 코드 단위)입니다.

현재 사용 사례에서는 모두 시작 색인을 제공해야 합니다. 이 필드는 개방형 범위의 향후 사용 사례를 수용하기 위해 Int32Value입니다.

endIndex

integer

이 범위의 0부터 시작하는 종료 색인입니다(제외). UTF-16 코드 단위로 표시됩니다.

현재 사용 사례에서는 모두 종료 색인을 제공해야 합니다. 이 필드는 개방형 범위의 향후 사용 사례를 수용하기 위해 Int32Value입니다.

tabId

string

이 범위를 포함하는 탭입니다. 생략하면 요청이 첫 번째 탭에 적용됩니다.

탭이 하나만 포함된 문서의 경우:

  • 제공되는 경우 단수 탭의 ID와 일치해야 합니다.

  • 생략하면 요청이 단일 탭에 적용됩니다.

탭이 여러 개인 문서의 경우:

  • 제공된 경우 요청이 지정된 탭에 적용됩니다.

  • 생략하면 요청이 문서의 첫 번째 탭에 적용됩니다.

InlineObject

텍스트와 함께 인라인으로 표시되는 객체입니다. InlineObject에는 이미지와 같은 EmbeddedObject가 포함됩니다.

JSON 표현
{
  "objectId": string,
  "inlineObjectProperties": {
    object (InlineObjectProperties)
  },
  "suggestedInlineObjectPropertiesChanges": {
    string: {
      object (SuggestedInlineObjectProperties)
    },
    ...
  },
  "suggestedInsertionId": string,
  "suggestedDeletionIds": [
    string
  ]
}
필드
objectId

string

이 인라인 객체의 ID입니다. 객체의 속성을 업데이트하는 데 사용할 수 있습니다.

inlineObjectProperties

object (InlineObjectProperties)

이 인라인 객체의 속성입니다.

suggestedInlineObjectPropertiesChanges

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

제안 ID로 키가 지정된 인라인 객체 속성에 대한 제안된 변경사항입니다.

suggestedInsertionId

string

추천 삽입 ID입니다. 비어 있으면 추천 삽입이 아닙니다.

suggestedDeletionIds[]

string

추천 삭제 ID입니다. 비어 있으면 이 콘텐츠의 삭제 추천이 없습니다.

InlineObjectProperties

InlineObject의 속성입니다.

JSON 표현
{
  "embeddedObject": {
    object (EmbeddedObject)
  }
}
필드
embeddedObject

object (EmbeddedObject)

이 인라인 객체의 삽입된 객체입니다.

EmbeddedObject

문서에 삽입된 객체입니다.

JSON 표현
{
  "title": string,
  "description": string,
  "embeddedObjectBorder": {
    object (EmbeddedObjectBorder)
  },
  "size": {
    object (Size)
  },
  "marginTop": {
    object (Dimension)
  },
  "marginBottom": {
    object (Dimension)
  },
  "marginRight": {
    object (Dimension)
  },
  "marginLeft": {
    object (Dimension)
  },
  "linkedContentReference": {
    object (LinkedContentReference)
  },

  // Union field properties can be only one of the following:
  "embeddedDrawingProperties": {
    object (EmbeddedDrawingProperties)
  },
  "imageProperties": {
    object (ImageProperties)
  }
  // End of list of possible types for union field properties.
}
필드
title

string

삽입된 객체의 제목입니다. titledescription가 모두 결합되어 대체 텍스트를 표시합니다.

description

string

삽입된 객체에 대한 설명입니다. titledescription가 모두 결합되어 대체 텍스트를 표시합니다.

embeddedObjectBorder

object (EmbeddedObjectBorder)

삽입된 객체의 테두리입니다.

size

object (Size)

자른 후 이미지의 표시되는 크기입니다.

marginTop

object (Dimension)

삽입된 객체의 상단 여백입니다.

marginBottom

object (Dimension)

삽입된 객체의 하단 여백입니다.

marginRight

object (Dimension)

삽입된 객체의 오른쪽 여백입니다.

marginLeft

object (Dimension)

삽입된 객체의 왼쪽 여백입니다.

linkedContentReference

object (LinkedContentReference)

외부 연결 소스 콘텐츠에 대한 참조입니다. 예를 들어 삽입된 객체가 연결된 차트인 경우 소스 Google Sheets 차트에 대한 참조가 포함됩니다.

설정되지 않은 경우 삽입된 객체는 연결되지 않습니다.

통합 필드 properties. 각 삽입된 객체 유형에 고유한 속성입니다. properties은 다음 중 하나여야 합니다.
embeddedDrawingProperties

object (EmbeddedDrawingProperties)

삽입된 그림의 속성입니다.

imageProperties

object (ImageProperties)

이미지의 속성입니다.

EmbeddedDrawingProperties

이 유형에는 필드가 없습니다.

삽입된 그림의 속성이며 객체 유형을 구분하는 데 사용됩니다. 삽입된 그림은 문서 내에서 생성되고 수정된 그림입니다. 자세한 내용은 지원되지 않습니다.

ImageProperties

이미지의 속성입니다.

JSON 표현
{
  "contentUri": string,
  "sourceUri": string,
  "brightness": number,
  "contrast": number,
  "transparency": number,
  "cropProperties": {
    object (CropProperties)
  },
  "angle": number
}
필드
contentUri

string

기본 수명이 30분인 이미지의 URI입니다. 이 URI에는 요청자의 계정이 태그되어 있습니다. URI가 있는 사용자는 사실상 원래 요청자로서 이미지에 액세스합니다. 문서의 공유 설정이 변경되면 이미지에 대한 액세스 권한이 손실될 수 있습니다.

sourceUri

string

소스 URI는 이미지를 삽입하는 데 사용되는 URI입니다. 소스 URI는 비워 둘 수 있습니다.

brightness

number

이미지의 밝기 효과입니다. 값은 [-1.0, 1.0] 구간에 있어야 하며 0은 효과가 없음을 의미합니다.

contrast

number

이미지의 대비 효과입니다. 값은 [-1.0, 1.0] 구간에 있어야 하며 0은 효과가 없음을 의미합니다.

transparency

number

이미지의 투명도 효과입니다. 값은 [0.0, 1.0] 구간에 있어야 합니다. 여기서 0은 효과가 없음을, 1은 투명함을 의미합니다.

cropProperties

object (CropProperties)

이미지의 자르기 속성입니다.

angle

number

이미지의 시계 방향 회전 각도(라디안)입니다.

CropProperties

이미지의 자르기 속성입니다.

자르기 사각형은 원본 콘텐츠의 4개 모서리에서 분수 오프셋을 사용하여 표현됩니다.

  • 오프셋이 (0, 1) 구간에 있으면 자르기 직사각형의 해당 가장자리가 이미지의 원래 경계 직사각형 내부에 배치됩니다.
  • 오프셋이 음수이거나 1보다 큰 경우 자르기 사각형의 해당 가장자리가 이미지의 원래 경계 사각형 외부에 배치됩니다.
  • 모든 오프셋과 회전 각도가 0이면 이미지가 잘리지 않습니다.
JSON 표현
{
  "offsetLeft": number,
  "offsetRight": number,
  "offsetTop": number,
  "offsetBottom": number,
  "angle": number
}
필드
offsetLeft

number

오프셋은 자르기 직사각형의 왼쪽 가장자리가 원래 콘텐츠의 왼쪽 가장자리에서 얼마나 안쪽으로 떨어져 있는지를 원래 콘텐츠 너비의 비율로 지정합니다.

offsetRight

number

오프셋은 자르기 직사각형의 오른쪽 가장자리가 원래 콘텐츠의 오른쪽 가장자리에서 얼마나 안쪽으로 떨어져 있는지를 원래 콘텐츠 너비의 비율로 지정합니다.

offsetTop

number

오프셋은 자르기 직사각형의 상단 가장자리가 원본 콘텐츠의 상단 가장자리에서 얼마나 안쪽으로 떨어져 있는지를 원본 콘텐츠 높이의 비율로 지정합니다.

offsetBottom

number

오프셋은 자르기 사각형의 하단 가장자리가 원본 콘텐츠의 하단 가장자리에서 얼마나 안쪽으로 떨어져 있는지를 원본 콘텐츠 높이의 비율로 지정합니다.

angle

number

자르기 직사각형이 중심을 기준으로 시계 방향으로 회전한 각도(라디안)입니다. 회전은 오프셋 후에 적용됩니다.

EmbeddedObjectBorder

EmbeddedObject 주변의 테두리

JSON 표현
{
  "color": {
    object (OptionalColor)
  },
  "width": {
    object (Dimension)
  },
  "dashStyle": enum (DashStyle),
  "propertyState": enum (PropertyState)
}
필드
color

object (OptionalColor)

테두리 색상입니다.

width

object (Dimension)

테두리의 너비입니다.

dashStyle

enum (DashStyle)

테두리의 대시 스타일입니다.

propertyState

enum (PropertyState)

테두리 속성의 속성 상태입니다.

PropertyState

속성의 가능한 상태입니다.

열거형
RENDERED 속성의 상태가 RENDERED이면 문서를 렌더링할 때 요소에 해당 속성이 있습니다. 기본값입니다.
NOT_RENDERED 속성의 상태가 NOT_RENDERED이면 문서를 렌더링할 때 요소에 해당 속성이 없습니다.

LinkedContentReference

외부 연결 소스 콘텐츠에 대한 참조입니다.

JSON 표현
{

  // Union field reference can be only one of the following:
  "sheetsChartReference": {
    object (SheetsChartReference)
  }
  // End of list of possible types for union field reference.
}
필드
통합 필드 reference. 연결된 콘텐츠 유형과 관련된 참조입니다. reference은 다음 중 하나여야 합니다.
sheetsChartReference

object (SheetsChartReference)

연결된 차트에 대한 참조입니다.

SheetsChartReference

Google Sheets에서 삽입된 연결된 차트에 대한 참조입니다.

JSON 표현
{
  "spreadsheetId": string,
  "chartId": integer
}
필드
spreadsheetId

string

소스 차트가 포함된 Google Sheets 스프레드시트의 ID입니다.

chartId

integer

삽입된 Google Sheets 스프레드시트의 특정 차트 ID입니다.

SuggestedInlineObjectProperties

InlineObjectProperties에 대한 제안된 변경사항입니다.

JSON 표현
{
  "inlineObjectProperties": {
    object (InlineObjectProperties)
  },
  "inlineObjectPropertiesSuggestionState": {
    object (InlineObjectPropertiesSuggestionState)
  }
}
필드
inlineObjectProperties

object (InlineObjectProperties)

이 제안에서 이루어진 변경사항만 포함하는 InlineObjectProperties입니다. inlineObjectPropertiesSuggestionState와 함께 사용하여 변경된 필드와 새 값을 확인할 수 있습니다.

inlineObjectPropertiesSuggestionState

object (InlineObjectPropertiesSuggestionState)

이 제안에서 기본 InlineObjectProperties의 어떤 필드가 변경되었는지 나타내는 마스크입니다.

InlineObjectPropertiesSuggestionState

이 제안에서 기본 InlineObjectProperties의 어떤 필드가 변경되었는지 나타내는 마스크입니다. true로 설정된 필드에는 새로운 추천 값이 있습니다.

JSON 표현
{
  "embeddedObjectSuggestionState": {
    object (EmbeddedObjectSuggestionState)
  }
}
필드
embeddedObjectSuggestionState

object (EmbeddedObjectSuggestionState)

이 추천에서 embeddedObject의 어떤 필드가 변경되었는지 나타내는 마스크입니다.

EmbeddedObjectSuggestionState

이 제안에서 기본 EmbeddedObject의 어떤 필드가 변경되었는지 나타내는 마스크입니다. true로 설정된 필드에는 새로운 추천 값이 있습니다.

JSON 표현
{
  "embeddedDrawingPropertiesSuggestionState": {
    object (EmbeddedDrawingPropertiesSuggestionState)
  },
  "imagePropertiesSuggestionState": {
    object (ImagePropertiesSuggestionState)
  },
  "titleSuggested": boolean,
  "descriptionSuggested": boolean,
  "embeddedObjectBorderSuggestionState": {
    object (EmbeddedObjectBorderSuggestionState)
  },
  "sizeSuggestionState": {
    object (SizeSuggestionState)
  },
  "marginLeftSuggested": boolean,
  "marginRightSuggested": boolean,
  "marginTopSuggested": boolean,
  "marginBottomSuggested": boolean,
  "linkedContentReferenceSuggestionState": {
    object (LinkedContentReferenceSuggestionState)
  }
}
필드
embeddedDrawingPropertiesSuggestionState

object (EmbeddedDrawingPropertiesSuggestionState)

이 추천에서 embeddedDrawingProperties의 어떤 필드가 변경되었는지 나타내는 마스크입니다.

imagePropertiesSuggestionState

object (ImagePropertiesSuggestionState)

이 추천에서 imageProperties의 어떤 필드가 변경되었는지 나타내는 마스크입니다.

titleSuggested

boolean

title에 추천된 변경사항이 있는지 나타냅니다.

descriptionSuggested

boolean

description에 추천된 변경사항이 있는지 나타냅니다.

embeddedObjectBorderSuggestionState

object (EmbeddedObjectBorderSuggestionState)

이 추천에서 embeddedObjectBorder의 어떤 필드가 변경되었는지 나타내는 마스크입니다.

sizeSuggestionState

object (SizeSuggestionState)

이 추천에서 size의 어떤 필드가 변경되었는지 나타내는 마스크입니다.

marginLeftSuggested

boolean

marginLeft에 추천된 변경사항이 있는지 나타냅니다.

marginRightSuggested

boolean

marginRight에 추천된 변경사항이 있는지 나타냅니다.

marginTopSuggested

boolean

marginTop에 추천된 변경사항이 있는지 나타냅니다.

marginBottomSuggested

boolean

marginBottom에 추천된 변경사항이 있는지 나타냅니다.

linkedContentReferenceSuggestionState

object (LinkedContentReferenceSuggestionState)

이 추천에서 linkedContentReference의 어떤 필드가 변경되었는지 나타내는 마스크입니다.

EmbeddedDrawingPropertiesSuggestionState

이 유형에는 필드가 없습니다.

이 제안에서 기본 EmbeddedDrawingProperties의 어떤 필드가 변경되었는지 나타내는 마스크입니다. true로 설정된 필드에는 새로운 추천 값이 있습니다.

ImagePropertiesSuggestionState

이 제안에서 기본 ImageProperties의 어떤 필드가 변경되었는지 나타내는 마스크입니다. true로 설정된 필드에는 새로운 추천 값이 있습니다.

JSON 표현
{
  "contentUriSuggested": boolean,
  "sourceUriSuggested": boolean,
  "brightnessSuggested": boolean,
  "contrastSuggested": boolean,
  "transparencySuggested": boolean,
  "cropPropertiesSuggestionState": {
    object (CropPropertiesSuggestionState)
  },
  "angleSuggested": boolean
}
필드
contentUriSuggested

boolean

contentUri에 추천된 변경사항이 있는지 나타냅니다.

sourceUriSuggested

boolean

[sourceUri] [google.apps.docs.v1.EmbeddedObject.source_uri]에 제안된 변경사항이 있는지 나타냅니다.

brightnessSuggested

boolean

[밝기][google.apps.docs.v1.EmbeddedObject.brightness]에 제안된 변경사항이 있는지 나타냅니다.

contrastSuggested

boolean

[대비] [google.apps.docs.v1.EmbeddedObject.contrast]에 제안된 변경사항이 있었는지 나타냅니다.

transparencySuggested

boolean

[투명도] [google.apps.docs.v1.EmbeddedObject.transparency]에 제안된 변경사항이 있었는지 나타냅니다.

cropPropertiesSuggestionState

object (CropPropertiesSuggestionState)

이 추천에서 cropProperties의 어떤 필드가 변경되었는지 나타내는 마스크입니다.

angleSuggested

boolean

[angle][google.apps.docs.v1.EmbeddedObject.angle]에 제안된 변경사항이 있었는지 나타냅니다.

CropPropertiesSuggestionState

이 제안에서 기본 CropProperties의 어떤 필드가 변경되었는지 나타내는 마스크입니다. true로 설정된 필드에는 새로운 추천 값이 있습니다.

JSON 표현
{
  "offsetLeftSuggested": boolean,
  "offsetRightSuggested": boolean,
  "offsetTopSuggested": boolean,
  "offsetBottomSuggested": boolean,
  "angleSuggested": boolean
}
필드
offsetLeftSuggested

boolean

offsetLeft에 추천된 변경사항이 있는지 나타냅니다.

offsetRightSuggested

boolean

offsetRight에 추천된 변경사항이 있는지 나타냅니다.

offsetTopSuggested

boolean

offsetTop에 추천된 변경사항이 있는지 나타냅니다.

offsetBottomSuggested

boolean

offsetBottom에 추천된 변경사항이 있는지 나타냅니다.

angleSuggested

boolean

angle에 추천된 변경사항이 있는지 나타냅니다.

EmbeddedObjectBorderSuggestionState

이 제안에서 기본 EmbeddedObjectBorder의 어떤 필드가 변경되었는지 나타내는 마스크입니다. true로 설정된 필드에는 새로운 추천 값이 있습니다.

JSON 표현
{
  "colorSuggested": boolean,
  "widthSuggested": boolean,
  "dashStyleSuggested": boolean,
  "propertyStateSuggested": boolean
}
필드
colorSuggested

boolean

[color] [google.apps.docs.v1.EmbeddedBorderObject.color]에 제안된 변경사항이 있는지 나타냅니다.

widthSuggested

boolean

[width][google.apps.docs.v1.EmbeddedBorderObject.width]에 제안된 변경사항이 있는지 나타냅니다.

dashStyleSuggested

boolean

[dashStyle] [google.apps.docs.v1.EmbeddedBorderObject.dash_style]에 제안된 변경사항이 있었는지 나타냅니다.

propertyStateSuggested

boolean

[propertyState] [google.apps.docs.v1.EmbeddedBorderObject.property_state]에 제안된 변경사항이 있는지 나타냅니다.

LinkedContentReferenceSuggestionState

이 제안에서 기본 LinkedContentReference의 어떤 필드가 변경되었는지 나타내는 마스크입니다. true로 설정된 필드에는 새로운 추천 값이 있습니다.

JSON 표현
{
  "sheetsChartReferenceSuggestionState": {
    object (SheetsChartReferenceSuggestionState)
  }
}
필드
sheetsChartReferenceSuggestionState

object (SheetsChartReferenceSuggestionState)

이 추천에서 sheetsChartReference의 어떤 필드가 변경되었는지 나타내는 마스크입니다.

SheetsChartReferenceSuggestionState

이 제안에서 기본 SheetsChartReference의 어떤 필드가 변경되었는지 나타내는 마스크입니다. true로 설정된 필드에는 새로운 추천 값이 있습니다.

JSON 표현
{
  "spreadsheetIdSuggested": boolean,
  "chartIdSuggested": boolean
}
필드
spreadsheetIdSuggested

boolean

spreadsheetId에 추천된 변경사항이 있는지 나타냅니다.

chartIdSuggested

boolean

chartId에 추천된 변경사항이 있는지 나타냅니다.

PositionedObject

Paragraph에 테더링되고 단락의 시작을 기준으로 배치된 객체입니다. PositionedObject에는 이미지와 같은 EmbeddedObject가 포함됩니다.

JSON 표현
{
  "objectId": string,
  "positionedObjectProperties": {
    object (PositionedObjectProperties)
  },
  "suggestedPositionedObjectPropertiesChanges": {
    string: {
      object (SuggestedPositionedObjectProperties)
    },
    ...
  },
  "suggestedInsertionId": string,
  "suggestedDeletionIds": [
    string
  ]
}
필드
objectId

string

이 위치 지정 객체의 ID입니다.

positionedObjectProperties

object (PositionedObjectProperties)

이 위치 지정 객체의 속성입니다.

suggestedPositionedObjectPropertiesChanges

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

제안 ID로 키가 지정된 위치가 지정된 객체 속성에 대한 제안된 변경사항입니다.

suggestedInsertionId

string

추천 삽입 ID입니다. 비어 있으면 추천 삽입이 아닙니다.

suggestedDeletionIds[]

string

추천 삭제 ID입니다. 비어 있으면 이 콘텐츠의 삭제 추천이 없습니다.

PositionedObjectProperties

PositionedObject의 속성입니다.

JSON 표현
{
  "positioning": {
    object (PositionedObjectPositioning)
  },
  "embeddedObject": {
    object (EmbeddedObject)
  }
}
필드
positioning

object (PositionedObjectPositioning)

이 위치 지정 객체를 참조하는 Paragraph의 줄바꿈을 기준으로 한 이 위치 지정 객체의 위치입니다.

embeddedObject

object (EmbeddedObject)

위치가 지정된 이 객체의 삽입된 객체입니다.

PositionedObjectPositioning

PositionedObject의 위치입니다. 위치가 지정된 객체는 테더링된 Paragraph의 시작 부분을 기준으로 위치가 지정됩니다.

JSON 표현
{
  "layout": enum (PositionedObjectLayout),
  "leftOffset": {
    object (Dimension)
  },
  "topOffset": {
    object (Dimension)
  }
}
필드
layout

enum (PositionedObjectLayout)

이 위치 지정 객체의 레이아웃입니다.

leftOffset

object (Dimension)

위치가 지정된 객체의 왼쪽 가장자리의 오프셋입니다. 이 오프셋은 객체가 연결된 Paragraph의 시작을 기준으로 합니다. 객체의 정확한 위치는 문서의 다른 콘텐츠와 문서의 스타일 지정에 따라 달라질 수 있습니다.

topOffset

object (Dimension)

위치가 지정된 객체의 상단 가장자리가 테더링된 Paragraph의 시작을 기준으로 오프셋됩니다. 객체의 정확한 위치는 문서의 다른 콘텐츠와 문서의 스타일 지정에 따라 달라질 수 있습니다.

PositionedObjectLayout

[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": {
    object (PositionedObjectPropertiesSuggestionState)
  }
}
필드
positionedObjectProperties

object (PositionedObjectProperties)

이 제안에서 이루어진 변경사항만 포함하는 PositionedObjectProperties positionedObjectPropertiesSuggestionState와 함께 사용하여 변경된 필드와 새 값을 확인할 수 있습니다.

positionedObjectPropertiesSuggestionState

object (PositionedObjectPropertiesSuggestionState)

이 제안에서 기본 PositionedObjectProperties의 어떤 필드가 변경되었는지 나타내는 마스크입니다.

PositionedObjectPropertiesSuggestionState

이 제안에서 기본 PositionedObjectProperties의 어떤 필드가 변경되었는지 나타내는 마스크입니다. true로 설정된 필드에는 새로운 추천 값이 있습니다.

JSON 표현
{
  "positioningSuggestionState": {
    object (PositionedObjectPositioningSuggestionState)
  },
  "embeddedObjectSuggestionState": {
    object (EmbeddedObjectSuggestionState)
  }
}
필드
positioningSuggestionState

object (PositionedObjectPositioningSuggestionState)

이 추천에서 positioning의 어떤 필드가 변경되었는지 나타내는 마스크입니다.

embeddedObjectSuggestionState

object (EmbeddedObjectSuggestionState)

이 추천에서 embeddedObject의 어떤 필드가 변경되었는지 나타내는 마스크입니다.

PositionedObjectPositioningSuggestionState

이 제안에서 기본 PositionedObjectPositioning의 어떤 필드가 변경되었는지 나타내는 마스크입니다. true로 설정된 필드에는 새로운 추천 값이 있습니다.

JSON 표현
{
  "layoutSuggested": boolean,
  "leftOffsetSuggested": boolean,
  "topOffsetSuggested": boolean
}
필드
layoutSuggested

boolean

layout에 추천된 변경사항이 있는지 나타냅니다.

leftOffsetSuggested

boolean

leftOffset에 추천된 변경사항이 있는지 나타냅니다.

topOffsetSuggested

boolean

topOffset에 추천된 변경사항이 있는지 나타냅니다.

SuggestionsViewMode

제안된 변경사항이 표시되는 방식을 나타내는 문서에 적용된 제안 보기 모드입니다. 모든 제안사항이 인라인으로 표시되거나, 수락되거나, 거부된 상태로 문서를 읽는 옵션을 제공합니다.

열거형
DEFAULT_FOR_CURRENT_ACCESS 반환된 문서에 적용된 SuggestionsViewMode는 사용자의 현재 액세스 수준에 따라 달라집니다. 사용자에게 보기 액세스 권한만 있는 경우 PREVIEW_WITHOUT_SUGGESTIONS이 적용됩니다. 그렇지 않으면 SUGGESTIONS_INLINE이 적용됩니다. 이는 기본 추천 보기 모드입니다.
SUGGESTIONS_INLINE

반환된 문서에 인라인으로 추천이 표시됩니다. 제안된 변경사항은 문서 내에서 기본 콘텐츠와 구분됩니다.

이 모드를 사용하여 문서를 가져오는 요청은 사용자에게 추천 변경사항을 볼 권한이 없는 경우 403 오류를 반환합니다.

PREVIEW_SUGGESTIONS_ACCEPTED

반환된 문서는 제안된 모든 변경사항이 적용된 미리보기입니다.

이 모드를 사용하여 문서를 가져오는 요청은 사용자에게 추천 변경사항을 볼 권한이 없는 경우 403 오류를 반환합니다.

PREVIEW_WITHOUT_SUGGESTIONS 문서에 제안사항이 있는 경우 반환된 문서는 모든 제안된 변경사항이 거부된 미리보기입니다.

메서드

batchUpdate

문서에 하나 이상의 업데이트를 적용합니다.

create

요청에 제공된 제목을 사용하여 빈 문서를 만듭니다.

get

지정된 문서의 최신 버전을 가져옵니다.