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