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 nội dung chỉnh sửa gây ra cấu trúc không hợp lệ của các thành phần trong tài liệu. Xem xét từng phương thức yêu cầu documents.batchUpdate để biết các quy tắc ràng buộc và quy tắ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 của 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 một Paragraph tại chỉ mục đó. Kiểu đoạn của đoạn mới được sao chép từ đoạ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.
  • Bạn phải chèn văn bản trong giới hạn của một 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. Văn bản này phải được chèn vào đoạn trước.
  • API có thể ngầm điều chỉnh vị trí để ngăn việc chèn trong 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 biểu đồ.
  • Kiểu văn bản cho văn bản được chèn được xác định tự động, thường 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 của 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ự trong Khu vực sử dụng riêng tư đa ngôn ngữ cơ bản của Unicode (U+E000-U+F8FF) sẽ bị loại bỏ khỏi văn bản được chèn.
  • Để biết thêm thông tin, hãy xem bài viết 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ó độ 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.
  • 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 cùng dòng.

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

  • Khi bạn áp dụng định dạng cấp đoạn cho một dải ô, định dạng đó sẽ được áp dụng cho bất kỳ đoạn văn bản nào chồng lên một phần hoặc toàn bộ dải ô đó.
  • Phạm vi 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 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 lên dải ô đã cho.
  • Mức độ lồng ghép của mỗi đoạn được xác định theo số lượng thẻ ở đầu trước mỗi đoạn.
  • Các thẻ ở đầu sẽ bị xoá khi 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 trong văn bản.
  • Nếu bạn thêm dấu đầu dòng của đoạn khớp với dấu đầu dòng của danh sách ngay trước đoạn văn bản, thì đoạn văn bản đó sẽ được liên kết vào danh sách.
  • Để biết thêm thông tin, hãy xem phần Làm việc với các 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 định vị và dấu trang khi hai đoạn được hợp nhất.

  • Không được phép xoá các cấu trúc tài liệu không hợp lệ. Một số ví dụ về yêu cầu xoá không hợp lệ bao gồm:

    • 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á điểm bắt đầu hoặc kết thúc 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. Cho phép xoá nội dung trong ô của bảng.

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