Yapısal düzenleme kuralları ve davranışı

Bu bölümde, Google Dokümanlar API'yi kullanarak dokümanları düzenlerken bilmeniz gereken davranışlar ve sınırlamalar açıklanmaktadır.

Genel olarak, bir dokümandaki öğelerin geçersiz bir yapıya sahip olmasına neden olan düzenlemeleri yapamazsınız. İstekler için geçerli olan kısıtlamalar ve kurallar açısından her documents.batchUpdate istek yöntemini inceleyin.

Aşağıdaki bölümlerde bu yöntemlerdeki temel kurallar özetlenmiştir.

Metin ekle

  • Yeni satır karakteri eklemek, söz konusu dizinde dolaylı olarak bir Paragraph oluşturur. Yeni paragrafın paragraf stili, listeler ve madde işaretleri de dahil olmak üzere geçerli ekleme dizinindeki paragraftan kopyalanır.
  • Metin, mevcut bir Paragraph'ün sınırlarına yerleştirilmelidir. Örneğin, metin tablonun başlangıç dizinine eklenemez. Metin, önceki paragrafa eklenmelidir.
  • API, Unicode grafeme kümelerine ekleme yapılmasını önlemek için konumu dolaylı olarak ayarlayabilir. Bu durumda metin, grafeme kümesinden hemen sonra eklenir.
  • Eklenen metnin metin stilleri otomatik olarak belirlenir ve genellikle komşu metnin stili korunur. Genellikle, eklenen metnin metin stili, ekleme dizininden hemen önceki metinle eşleşir.
  • Bazı kontrol karakterleri (U+0000-U+0008, U+000C-U+001F) ve Unicode Temel Çok Dilli Düzlem Özel Kullanım Alanı'ndaki (U+E000-U+F8FF) karakterler, eklenen metinden çıkarılır.
  • Daha fazla bilgi için Metin ekleme, silme ve taşıma başlıklı makaleyi inceleyin.

Satır içi resim ekleme

  • Resim boyutu 50 MB'tan küçük olmalı, 25 megapikselden büyük olmamalıdır ve PNG, JPEG veya GIF biçimlerinden birinde olmalıdır.
  • Sağlanan URI herkese açık olmalı ve en fazla 2 KB uzunluğunda olmalıdır.
  • Resim, mevcut bir Paragraph'ün sınırlarına yerleştirilmelidir. Örneğin, bir tablonun başlangıç dizine metin eklenemez.
  • Resimler dipnot veya denklem içine eklenemez.
  • Daha fazla bilgi için Satır içi resim ekleme başlıklı makaleyi inceleyin.

Metin biçimlendirme

  • Bir alana paragraf düzeyinde biçimlendirme uyguladığınızda, biçimlendirme bu alanla kısmen veya tamamen örtüşen tüm paragraflara uygulanır.
  • Aralık, bitişik yeni satırları içerecek şekilde genişletilebilir.
  • Aralık, bir listeye ait bir paragrafı tamamen içeriyorsa paragrafın listesi de eşleşen metin stiliyle güncellenir.
  • Daha fazla bilgi için Metni biçimlendirme bölümüne bakın.

Paragraf madde işaretleri oluştur

  • Verilen aralıkla çakışan tüm paragraflar için madde işaretleri oluşturur.
  • Her paragrafın iç içe yerleştirme düzeyi, her paragraftan önce gelen sekmelerin sayısına göre belirlenir.
  • Noktalı listeler oluşturulurken öndeki sekmeler kaldırılır. Bu da metnin bazı bölümlerinin dizinlerini değiştirebilir.
  • Hedef paragraftan hemen önce bir listeninkilerle eşleşen paragraf imleri eklerseniz paragraf listeye katılır.
  • Daha fazla bilgi için Listelerle çalışma başlıklı makaleyi inceleyin.

Metin silme

  • Bir paragraf sınırını aşan metnin silinmesi, bu iki paragraf birleştirilirken paragraf stilleri, listeler, konumlandırılmış nesneler ve yer işaretlerinde değişikliklere neden olabilir.

  • Geçersiz doküman yapısına neden olan silmelere izin verilmez. Geçersiz silme isteklerine örnek olarak şunlar verilebilir:

    • Bir vekil çiftinin bir kod birimini silme.

    • Body, Header, Footer, Footnote, TableCell veya TableOfContents öğesinin son yeni satır karakterini silme.

    • Bir Table, TableOfContents veya Equation öğesinin tamamını silmeden başlangıcını ya da sonunu silme

    • Öğeyi silmeden önce Table, TableOfContents veya SectionBreak karakterinden önce yeni satır karakterini silme

    • Tablodaki satırları veya hücreleri tek tek silme. Tablo hücresindeki içeriğin silinmesine izin verilir.

  • Daha fazla bilgi için Metin ekleme, silme ve taşıma başlıklı makaleyi inceleyin.