Aturan dan perilaku pengeditan struktural

Bagian ini menjelaskan perilaku dan batasan yang harus Anda pahami saat mengedit dokumen menggunakan Google Dokumen API.

Secara umum, Anda tidak dapat menjalankan pengeditan yang menyebabkan struktur elemen dalam dokumen menjadi tidak valid. Tinjau setiap metode permintaan documents.batchUpdate untuk mengetahui batasan dan aturan yang berlaku untuk permintaan tersebut.

Bagian berikut merangkum aturan utama di seluruh metode ini.

Sisipkan teks

  • Menyisipkan karakter baris baru secara implisit akan membuat Paragraph pada indeks tersebut. Gaya paragraf dari paragraf baru disalin dari paragraf pada indeks penyisipan saat ini, termasuk daftar dan buletin.
  • Teks harus disisipkan dalam batas Paragraph yang ada. Misalnya, teks tidak dapat disisipkan di indeks awal tabel. Teks harus disisipkan dalam paragraf sebelumnya.
  • API dapat secara implisit menyesuaikan lokasi untuk mencegah penyisipan dalam cluster grapheme Unicode. Jika hal ini terjadi, teks akan dimasukkan segera setelah cluster grafem.
  • Gaya teks untuk teks yang disisipkan ditentukan secara otomatis, yang umumnya mempertahankan gaya teks di sekitarnya. Biasanya, gaya teks untuk teks yang disisipkan cocok dengan teks tepat sebelum indeks penyisipan.
  • Beberapa karakter kontrol (U+0000-U+0008, U+000C-U+001F) dan karakter dari Area Penggunaan Pribadi Unicode Basic Multilingual Plane (U+E000-U+F8FF) akan dihapus dari teks yang disisipkan.
  • Untuk informasi selengkapnya, lihat Menyisipkan, menghapus, dan memindahkan teks.

Sisipkan gambar inline

  • Gambar harus berukuran kurang dari 50 MB, tidak boleh melebihi 25 megapiksel, dan harus berformat PNG, JPEG, atau GIF.
  • URI yang diberikan harus dapat diakses secara publik dan panjangnya maksimal 2 KB.
  • Gambar harus disisipkan dalam batas Paragraph yang ada. Misalnya, teks tidak dapat disisipkan di indeks awal tabel.
  • Gambar tidak dapat disisipkan di dalam catatan kaki atau persamaan.
  • Untuk mengetahui informasi selengkapnya, lihat Menyisipkan gambar inline.

Memformat teks

  • Saat Anda menerapkan pemformatan tingkat paragraf ke rentang, pemformatan tersebut akan diterapkan ke paragraf yang sebagian atau seluruhnya tumpang-tindih dengan rentang tersebut.
  • Rentang dapat diperluas untuk menyertakan baris baru yang berdekatan.
  • Jika rentang sepenuhnya berisi paragraf yang termasuk dalam daftar, tanda peluru paragraf juga akan diperbarui dengan gaya teks yang cocok.
  • Untuk mengetahui informasi selengkapnya, lihat Memformat teks.

Membuat buletin paragraf

  • Membuat buletin untuk semua paragraf yang tumpang-tindih dengan rentang yang ditentukan.
  • Tingkat bertingkat setiap paragraf ditentukan oleh jumlah tab utama sebelum setiap paragraf.
  • Tab awal akan dihapus saat membuat buletin, yang dapat mengubah indeks bagian teks.
  • Jika Anda menambahkan titik butir paragraf yang cocok dengan titik butir daftar tepat sebelum paragraf target, paragraf akan digabungkan ke daftar.
  • Untuk mengetahui informasi selengkapnya, lihat Menggunakan daftar.

Hapus teks

  • Menghapus teks yang melintasi batas paragraf dapat menyebabkan perubahan pada gaya paragraf, daftar, objek yang diposisikan, dan bookmark saat kedua paragraf digabungkan.

  • Penghapusan yang menyebabkan struktur dokumen tidak valid tidak diizinkan. Beberapa contoh permintaan penghapusan yang tidak valid meliputi:

    • Menghapus satu unit kode dari pasangan pengganti.

    • Menghapus karakter baris baru terakhir dari Body, Header, Footer, Footnote, TableCell, atau TableOfContents.

    • Menghapus awal atau akhir Table, TableOfContents, atau Equation tanpa menghapus seluruh elemen.

    • Menghapus karakter baris baru sebelum Table, TableOfContents, atau SectionBreak tanpa menghapus elemen.

    • Menghapus baris atau sel tabel satu per satu. Menghapus konten di sel tabel diizinkan.

  • Untuk informasi selengkapnya, lihat Menyisipkan, menghapus, dan memindahkan teks.