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 menjalankan pengeditan yang menyebabkan struktur elemen dalam dokumen tidak valid. Tinjau setiap metode permintaan documents.batchUpdate untuk mengetahui batasan dan aturan yang berlaku untuk permintaan tersebut.

Bagian berikut meringkas 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 di indeks penyisipan saat ini, termasuk daftar dan poin.
  • Teks harus disisipkan dalam batas Paragraph yang ada. Misalnya, teks tidak dapat disisipkan pada indeks awal tabel. Teks tersebut harus disisipkan dalam paragraf sebelumnya.
  • API dapat menyesuaikan lokasi secara implisit untuk mencegah penyisipan dalam cluster grafem Unicode. Jika ini terjadi, teks akan disisipkan segera setelah gugus grafem.
  • 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 persis sebelum indeks penyisipan.
  • Beberapa karakter kontrol (U+0000-U+0008, U+000C-U+001F) dan karakter dari Area Penggunaan Pribadi Bidang Multibahasa Unicode Dasar (U+E000-U+F8FF) dihapus 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. Misalnya, 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

  • Saat Anda menerapkan pemformatan tingkat paragraf ke rentang, pemformatan tersebut akan diterapkan ke paragraf apa pun yang tumpang-tindih sebagian atau sepenuhnya oleh rentang tersebut.
  • Rentang ini dapat diperluas untuk menyertakan baris baru yang bersebelahan.
  • Jika rentang sepenuhnya berisi paragraf yang termasuk dalam daftar, butir paragraf juga akan 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 bertingkat setiap paragraf ditentukan oleh jumlah tab utama sebelum setiap paragraf.
  • Tab utama dihapus saat membuat poin, yang mungkin mengubah indeks bagian-bagian teks.
  • Jika Anda menambahkan butir paragraf yang cocok dengan daftar yang ada tepat sebelum paragraf target, paragraf tersebut akan digabungkan ke dalam daftar.
  • Untuk mengetahui informasi selengkapnya, lihat Mengelola daftar.

Menghapus teks

  • Menghapus teks yang melintasi batas paragraf dapat menyebabkan perubahan pada gaya, daftar, objek posisi, dan bookmark paragraf 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 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 satu per satu tabel. Menghapus konten dalam sel tabel diizinkan.

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