이 섹션에서는 Google Docs API를 사용하여 문서를 수정할 때 알아야 하는 동작과 제한사항을 설명합니다.
일반적으로 문서 내 요소의 구조가 잘못되게 되는 수정은 실행할 수 없습니다. 각 documents.batchUpdate
요청 메서드에서 이러한 요청에 적용되는 제약 조건과 규칙을 검토합니다.
다음 섹션에서는 이러한 메서드의 주요 규칙을 요약합니다.
텍스트 삽입
- 줄바꿈 문자를 삽입하면 해당 색인에
Paragraph
가 암시적으로 생성됩니다. 새 단락의 단락 스타일은 목록과 글머리 기호를 포함하여 현재 삽입 인덱스의 단락에서 복사됩니다. - 텍스트는 기존
Paragraph
의 경계 내에 삽입되어야 합니다. 예를 들어 표의 시작 색인에는 텍스트를 삽입할 수 없습니다. 텍스트는 앞의 단락에 삽입되어야 합니다. - API는 유니코드 그래프 클러스터 내에 삽입을 방지하기 위해 위치를 암시적으로 조정할 수 있습니다. 이 경우 텍스트가 그래프eme 클러스터 바로 뒤에 삽입됩니다.
- 삽입된 텍스트의 텍스트 스타일은 자동으로 결정되며 일반적으로 인접한 텍스트의 스타일을 유지합니다. 일반적으로 삽입된 텍스트의 텍스트 스타일은 삽입 인덱스 바로 앞의 텍스트와 일치합니다.
- 일부 제어 문자 (
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
앞에 있는 줄바꿈 문자를 삭제합니다.테이블의 개별 행 또는 셀을 삭제합니다. 테이블 셀의 콘텐츠를 삭제할 수 있습니다.
자세한 내용은 텍스트 삽입, 삭제, 이동을 참고하세요.