Quy tắc và hành vi chỉnh sửa cấu trúc

Phần này mô tả các hành vi và giới hạn mà bạn phải hiểu khi chỉnh sửa tài liệu bằng API Google Tài liệu.

Nhìn chung, bạn không thể thực thi các nội dung chỉnh sửa khiến cấu trúc của các phần tử trong tài liệu không hợp lệ. Xem xét từng phương thức yêu cầu documents.batchUpdate để biết các quy tắc và điều kiện ràng buộc áp dụng cho các yêu cầu đó.

Các phần sau đây tóm tắt các quy tắc chính trong các phương thức này.

Chèn văn bản

  • Việc chèn ký tự dòng mới sẽ ngầm tạo một Paragraph tại chỉ mục đó. Kiểu đoạn văn của đoạn văn mới được sao chép từ đoạn văn tại chỉ mục chèn hiện tại, bao gồm cả danh sách và dấu đầu dòng.
  • Văn bản phải được chèn trong giới hạn của Paragraph hiện có. Ví dụ: bạn không thể chèn văn bản vào chỉ mục bắt đầu của bảng. Văn bản phải được chèn vào đoạn văn bản trước đó.
  • API có thể điều chỉnh ngầm vị trí để ngăn việc chèn trong các cụm ký tự Unicode. Khi điều này xảy ra, văn bản sẽ được chèn ngay sau cụm ký tự.
  • Kiểu văn bản cho văn bản đã chèn được xác định tự động, thường là giữ nguyên kiểu của văn bản lân cận. Thông thường, kiểu văn bản cho văn bản được chèn sẽ khớp với văn bản ngay trước chỉ mục chèn.
  • Một số ký tự điều khiển (U+0000-U+0008, U+000C-U+001F) và ký tự từ Khu vực sử dụng riêng của Unicode Basic Multilingual Plane (U+E000-U+F8FF) sẽ bị xoá khỏi văn bản đã chèn.
  • Để biết thêm thông tin, hãy xem phần Chèn, xoá và di chuyển văn bản.

Chèn hình ảnh cùng dòng

  • Hình ảnh phải có kích thước dưới 50 MB, không được vượt quá 25 megapixel và phải ở một trong các định dạng PNG, JPEG hoặc GIF.
  • URI được cung cấp phải có thể truy cập công khai và có kích thước tối đa là 2 KB.
  • Hình ảnh phải được chèn trong giới hạn của Paragraph hiện có. Ví dụ: bạn không thể chèn văn bản vào chỉ mục bắt đầu của bảng.
  • Bạn không thể chèn hình ảnh vào chú thích cuối trang hoặc phương trình.
  • Để biết thêm thông tin, hãy xem phần Chèn hình ảnh nội tuyến.

Định dạng văn bản

  • Khi bạn áp dụng định dạng cấp đoạn văn cho một dải ô, định dạng đó sẽ được áp dụng cho mọi đoạn văn bị dải ô đó che khuất một phần hoặc toàn bộ.
  • Dải ô có thể được mở rộng để bao gồm các dòng mới liền kề.
  • Nếu dải ô chứa toàn bộ một đoạn văn thuộc một danh sách, thì dấu đầu dòng của đoạn văn đó cũng được cập nhật bằng kiểu văn bản phù hợp.
  • Để biết thêm thông tin, hãy xem phần Định dạng văn bản.

Tạo dấu đầu dòng cho đoạn văn bản

  • Tạo dấu đầu dòng cho tất cả các đoạn văn trùng lặp với dải ô đã cho.
  • Cấp độ lồng của mỗi đoạn văn được xác định bằng số lượng thẻ đầu dòng trước mỗi đoạn văn.
  • Các thẻ đầu dòng sẽ bị xoá khi tạo dấu đầu dòng, điều này có thể thay đổi chỉ mục của các phần văn bản.
  • Nếu bạn thêm dấu đầu dòng của đoạn văn bản khớp với dấu đầu dòng của danh sách ngay trước đoạn văn bản mục tiêu, thì đoạn văn bản đó sẽ được nối với danh sách.
  • Để biết thêm thông tin, hãy xem phần Làm việc với danh sách.

Xoá văn bản

  • Việc xoá văn bản nằm trên ranh giới của một đoạn văn có thể làm thay đổi kiểu đoạn văn, danh sách, đối tượng được định vị và dấu trang khi hai đoạn văn được hợp nhất.

  • Không được phép xoá nội dung khiến cấu trúc tài liệu không hợp lệ. Sau đây là một số ví dụ về yêu cầu xoá không hợp lệ:

    • Xoá một đơn vị mã của một cặp thay thế.

    • Xoá ký tự dòng mới cuối cùng của Body, Header, Footer, Footnote, TableCell hoặc TableOfContents.

    • Xoá phần đầu hoặc phần cuối của Table, TableOfContents hoặc Equation mà không xoá toàn bộ phần tử.

    • Xoá ký tự dòng mới trước Table, TableOfContents hoặc SectionBreak mà không xoá phần tử.

    • Xoá từng hàng hoặc ô của bảng. Bạn được phép xoá nội dung trong ô bảng.

  • Để biết thêm thông tin, hãy xem phần Chèn, xoá và di chuyển văn bản.