이 섹션에서는 Google Docs API를 사용하여 문서를 수정할 때 알아야 하는 동작 및 제한사항에 대해 설명합니다.
일반적으로 문서 내에서 요소의 잘못된 구조를 야기하는 편집은 실행할 수 없습니다. 각 documents.batchUpdate
요청 메서드에서 요청에 적용되는 제약 조건과 규칙을 검토합니다.
다음 섹션에서는 이러한 방법에 대한 주요 규칙을 요약합니다.
텍스트 삽입
- 줄바꿈 문자를 암시적으로 삽입하면 해당 색인에
Paragraph
이 생성됩니다. 새 단락의 단락 스타일은 목록 및 글머리기호를 포함하여 현재 삽입 색인의 단락에서 복사됩니다. - 텍스트는 기존
Paragraph
의 경계 내에 삽입되어야 합니다. 예를 들어 테이블의 시작 색인에는 텍스트를 삽입할 수 없습니다. 텍스트는 이전 단락에 삽입해야 합니다. - API는 유니코드 그래픽 클러스터 내에 삽입이 삽입되지 않도록 위치를 암시적으로 조정할 수 있습니다. 이 경우 텍스트는 그래프 성단 바로 뒤에 삽입됩니다
- 삽입된 텍스트의 텍스트 스타일은 자동으로 결정되며 일반적으로 주변 텍스트의 스타일은 유지됩니다. 일반적으로 삽입된 텍스트의 텍스트 스타일은 삽입 색인 바로 앞에 있는 텍스트와 일치합니다.
- 일부 제어 문자 (
U+0000-U+0008, U+000C-U+001F
)와 유니코드 기본 다국어 평면 개인 사용 영역 (U+E000-U+F8FF
)의 문자는 삽입된 텍스트에서 제거됩니다. - 자세한 내용은 텍스트 삽입, 삭제, 이동을 참고하세요.
인라인 이미지 삽입
- 이미지 크기는 50MB 미만이어야 하고 25메가픽셀을 초과할 수 없으며 PNG, JPEG, GIF 형식 중 하나여야 합니다.
- 제공된 URI는 공개적으로 액세스할 수 있어야 하며 길이가 2KB 이하여야 합니다.
- 이미지는 기존
Paragraph
의 경계 내에 삽입해야 합니다. 예를 들어 테이블의 시작 색인에는 텍스트를 삽입할 수 없습니다. - 각주 또는 등식 안에는 이미지를 삽입할 수 없습니다.
- 자세한 내용은 인라인 이미지 삽입을 참고하세요.
텍스트 서식 지정
- 단락 수준 서식을 범위에 적용하면 해당 범위와 부분적으로 또는 완전히 겹치는 모든 단락에 서식이 적용됩니다.
- 인접한 줄바꿈을 포함하도록 범위를 확장할 수 있습니다.
- 범위에 목록에 속한 단락이 완전히 포함된 경우 단락의 글머리기호도 일치하는 텍스트 스타일로 업데이트됩니다.
- 자세한 내용은 텍스트 서식 지정을 참고하세요.
단락 글머리기호 만들기
- 지정된 범위와 겹치는 모든 단락에 글머리기호를 만듭니다.
- 각 단락의 중첩 수준은 각 단락 앞에 오는 탭 수에 따라 결정됩니다.
- 글머리기호를 만들 때 선행 탭이 삭제되어 텍스트 부분의 색인이 변경될 수 있습니다.
- 목록의 항목과 일치하는 단락 글머리기호를 대상 단락 바로 앞에 추가하면 단락이 목록에 조인됩니다.
- 자세한 내용은 목록 작업을 참고하세요.
텍스트 삭제
단락 경계를 가로지르는 텍스트를 삭제하면 두 단락이 병합될 때 단락 스타일, 목록, 위치가 지정된 객체, 북마크가 변경될 수 있습니다.
잘못된 문서 구조를 유발하는 삭제는 허용되지 않습니다. 잘못된 삭제 요청의 예는 다음과 같습니다.
서로게이트 쌍의 코드 단위 한 개를 삭제합니다.
Body
,Header
,Footer
,Footnote
,TableCell
또는TableOfContents
의 마지막 줄바꿈 문자 삭제전체 요소를 삭제하지 않고
Table
,TableOfContents
또는Equation
의 시작이나 끝 삭제요소를 삭제하지 않고
Table
,TableOfContents
또는SectionBreak
앞의 줄바꿈 문자 삭제표의 개별 행 또는 셀 삭제 테이블 셀의 콘텐츠는 삭제할 수 있습니다.
자세한 내용은 텍스트 삽입, 삭제, 이동을 참고하세요.