Aturan dan perilaku pengeditan struktural

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

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

Bagian berikut meringkas aturan utama di semua metode ini.

Sisipkan teks

  • Menyisipkan karakter baris baru secara implisit akan membuat Paragraph pada indeks tersebut. Gaya paragraf pada paragraf baru akan disalin dari paragraf pada indeks penyisipan saat ini, termasuk daftar dan butir.
  • Teks harus disisipkan dalam batas Paragraph yang ada. Misalnya, teks tidak dapat disisipkan pada indeks awal tabel. Teks harus disisipkan di paragraf sebelumnya.
  • API dapat secara implisit menyesuaikan lokasi untuk mencegah penyisipan dalam cluster grapheme Unicode. Jika hal ini terjadi, teks akan disisipkan segera setelah cluster grafeme.
  • Gaya teks untuk teks yang disisipkan ditentukan secara otomatis, umumnya mempertahankan gaya teks di dekatnya. 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 Unicode Basic Multilingual Plane Private Use Area (U+E000-U+F8FF) 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 lebih dari 25 megapiksel, dan harus dalam format PNG, JPEG, atau GIF.
  • URI yang disediakan harus dapat diakses secara publik dan panjangnya maksimum 2 KB.
  • Gambar harus disisipkan dalam batas Paragraph yang ada. Misalnya, teks tidak dapat disisipkan pada 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 suatu rentang, pemformatan akan diterapkan ke paragraf apa pun yang tumpang tindih sebagian atau seluruhnya oleh rentang tersebut.
  • Rentang dapat diperluas untuk menyertakan baris baru yang berdekatan.
  • Jika rentang sepenuhnya berisi paragraf yang termasuk dalam daftar, butir paragraf juga akan diperbarui dengan gaya teks yang cocok.
  • Untuk mengetahui informasi selengkapnya, lihat Memformat teks.

Membuat butir paragraf

  • Membuat butir untuk semua paragraf yang tumpang tindih dengan rentang yang ditentukan.
  • Tingkat hierarki setiap paragraf ditentukan oleh jumlah tab di awal sebelum setiap paragraf.
  • Tab di awal akan dihapus saat membuat poin-poin, dan hal ini dapat mengubah indeks bagian teks.
  • Jika Anda menambahkan butir paragraf yang cocok dengan butir daftar tepat sebelum paragraf target, paragraf tersebut akan digabungkan ke daftar.
  • Untuk informasi selengkapnya, lihat Bekerja dengan daftar.

Menghapus teks

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

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

    • Menghapus satu unit kode dari pasangan surrogate.

    • 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 individual. Menghapus konten dalam sel tabel diperbolehkan.

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