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 rõ 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 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 từng phương thức yêu cầu documents.batchUpdate để biết những điều kiện ràng buộc và quy tắc áp dụng cho những 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 pháp này.

Chèn văn bản

  • Việc chèn một ký tự dòng mới sẽ ngầm tạo ra Paragraph tại chỉ mục đó. Kiểu đoạn của đoạn mới sẽ được sao chép từ đoạn đó ở chỉ mục chèn hiện tại, bao gồm cả danh sách và dấu đầu dòng.
  • Bạn phải chèn văn bản trong giới hạn của Paragraph hiện có. Ví dụ: không thể chèn văn bản vào chỉ mục bắt đầu của bảng. Bạn phải chèn văn bản này vào đoạn trước.
  • API có thể điều chỉnh vị trí một cách ngầm ẩn để ngăn tình trạng chèn vào các cụm biểu đồ Unicode. Khi điều này xảy ra, văn bản sẽ được chèn ngay sau cụm grapheme.
  • Kiểu văn bản cho văn bản đã chèn được xác định tự động, thường giữ nguyên kiểu của văn bản bên cạnh. Thông thường, kiểu văn bản của văn bản được chèn 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ự trong Khu vực sử dụng riêng trên máy bay đa ngôn ngữ cơ bản Unicode (U+E000-U+F8FF) sẽ bị xoá khỏi văn bản được 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 nhỏ hơn 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ó độ dài tối đa là 2 KB.
  • Bạn phải chèn hình ảnh trong giới hạn của Paragraph hiện có. Ví dụ: không thể chèn văn bản vào chỉ mục bắt đầu của bảng.
  • 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 cùng dòng.

Đị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 bất kỳ đoạn nào bị chồng chéo một phần hoặc toàn bộ theo dải ô đó.
  • 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 đầy đủ một đoạn thuộc một danh sách, thì dấu đầu dòng của đoạ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

  • Tạo dấu đầu dòng cho tất cả các đoạn chồng chéo với dải ô đã cho.
  • Mức độ lồng ghép của mỗi đoạn được xác định bằng số lượng thẻ ở đầu trước mỗi đoạn.
  • Các thẻ ở đầu sẽ bị xoá khi bạn tạo dấu đầu dòng. Điều này có thể làm thay đổi chỉ mục của các phần văn bản.
  • Nếu bạn thêm các dấu đầu dòng khớp với các dấu đầu dòng của một danh sách ngay trước đoạn văn bản mục tiêu, thì đoạn văn đó sẽ được liên kết 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 vượt qua ranh giới của đoạn có thể gây ra các thay đổi đối với kiểu đoạn, danh sách, đối tượng có vị trí và dấu trang khi hai đoạn được hợp nhất.

  • Chúng tôi không cho phép xoá nội dung làm cho 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 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 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 ô trong bảng. Bạn được phép xoá nội dung trong một ô của 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.