Aturan dan perilaku pengeditan struktural

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

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

Bagian berikut meringkas aturan utama di seluruh metode ini.

Sisipkan teks

  • Menyisipkan karakter baris baru secara implisit akan membuat Paragraph pada indeks. Gaya paragraf untuk paragraf baru disalin dari paragraf pada indeks penyisipan saat ini, termasuk daftar dan poin.
  • Teks harus disisipkan dalam batas Paragraph yang ada. Sebagai contohnya, teks tidak dapat disisipkan pada indeks awal tabel. Teks harus berupa disisipkan ke paragraf sebelumnya.
  • API dapat menyesuaikan lokasi secara implisit untuk mencegah penyisipan di dalam Gugus grafem Unicode. Jika ini terjadi, teks akan disisipkan tepat setelah gugus grafem.
  • Gaya teks untuk teks yang disisipkan ditentukan secara otomatis, umumnya mempertahankan gaya teks yang berdekatan. 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) adalah dikeluarkan dari teks yang disisipkan.
  • Untuk informasi selengkapnya, lihat Menyisipkan, menghapus, dan memindahkan teks.

Sisipkan gambar sebaris

  • Gambar harus berukuran kurang dari 50 MB, tidak boleh lebih dari 25 megapiksel, dan harus dalam salah satu format 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. Sebagai contohnya, teks tidak dapat disisipkan pada indeks awal tabel.
  • Gambar tidak dapat disisipkan di dalam catatan kaki atau persamaan.
  • Untuk informasi selengkapnya, lihat Menyisipkan gambar sisipan.

Memformat teks

  • Jika Anda menerapkan pemformatan tingkat paragraf ke rentang, pemformatannya adalah diterapkan ke paragraf yang tumpang tindih sebagian atau seluruhnya {i>range<i}.
  • Rentang ini dapat diperluas untuk menyertakan baris baru yang bersebelahan.
  • Jika rentang sepenuhnya berisi paragraf yang termasuk dalam sebuah daftar, atribut poin juga diperbarui dengan gaya teks yang cocok.
  • Untuk mengetahui informasi selengkapnya, lihat artikel Memformat teks.

Membuat butir paragraf

  • Membuat poin untuk semua paragraf yang tumpang-tindih dengan rentang yang ditentukan.
  • Tingkat bersarang (nesting) setiap paragraf ditentukan oleh jumlah sebelum setiap paragraf.
  • Tab utama dihapus saat membuat poin, yang mungkin berubah indeks bagian-bagian teks.
  • Jika Anda menambahkan butir paragraf yang cocok dengan daftar, tepat sebelum paragraf target, paragraf tersebut digabungkan ke dalam daftar.
  • Untuk mengetahui informasi selengkapnya, lihat Mengelola daftar.

Hapus teks

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

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

    • Menghapus satu unit kode dari pasangan surrogate.

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

    • Menghapus titik 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 satu per satu tabel. Menghapus konten dalam sel tabel diizinkan.

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