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 bạn chỉnh sửa tài liệu bằng cách sử dụng API Google Tài liệu.

Nói chung, bạn không thể thực thi các chỉnh sửa gây ra cấu trúc không hợp lệ của trong một tài liệu. Xem lại từng documents.batchUpdate phương thức yêu cầu cho các điều kiện ràng buộc và quy tắc áp dụng cho 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 ký tự dòng mới sẽ ngầm tạo Paragraph ở thời điểm đó chỉ mục. Kiểu đoạn của đoạn mới đượ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. Văn bản phải được chèn vào đoạn trước.
  • API có thể điều chỉnh vị trí một cách ngầm ẩn để ngăn việc chèn quảng cáo trong đó Các cụm grapheme 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 được chèn được xác định tự động, thường duy trì 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 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) là 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 ở mức đoạn văn cho một dải ô, định dạng sẽ là đượ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ộ bởi 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 danh sách, thì giá trị của đoạn dấu đầu dòng cũng được cập nhật với 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ởi số lượng thẻ 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ể 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, đoạn đó sẽ được tham gia vào 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 văn bản có thể gây ra các thay đổi đối với kiểu đoạn văn bản, danh sách, đối tượng được định vị và dấu trang. các đ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ệ. Hơi nhiều 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.

    • Xóa phần đầu hoặc phần cuối của Table, TableOfContents hoặc Equation không có 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. Xoá nội dung trong ô của bảng được phép.

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