구조 수정 규칙 및 동작

이 섹션에서는 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 앞에 있는 줄바꿈 문자를 삭제합니다.

    • 테이블의 개별 행 또는 셀을 삭제합니다. 테이블 셀의 콘텐츠를 삭제할 수 있습니다.

  • 자세한 내용은 텍스트 삽입, 삭제, 이동을 참고하세요.