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

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

Genel olarak, bir doküman içindeki öğelerin geçersiz yapısına neden olan düzenlemeleri yürütemezsiniz. Bu isteklere uygulanan kısıtlamalar ve kurallar için documents.batchUpdate istek yöntemlerini inceleyin.

Aşağıdaki bölümlerde bu yöntemlerde geçerli olan temel kurallar özetlenmektedir.

Metin ekle

  • Dolaylı olarak bir yeni satır karakteri eklendiğinde ilgili dizinde bir Paragraph oluşturulur. Yeni paragrafın paragraf stili, listeler ve madde işaretleri dahil olmak üzere mevcut ekleme dizinindeki paragraftan kopyalanır.
  • Metin, mevcut bir Paragraph sınırları içine eklenmelidir. Örneğin, metin bir tablonun başlangıç dizinine eklenemez. Metin, önceki paragrafa eklenmelidir.
  • API, Unicode grafik kümeleri içine eklemeleri önlemek için konumu dolaylı olarak ayarlayabilir. Bu durumda metin, grafik kümeden hemen sonra eklenir.
  • Eklenen metnin metin stilleri, genellikle komşu metnin stilini koruyarak otomatik olarak belirlenir. Genellikle, eklenen metnin metin stili, ekleme dizininden hemen önceki metinle eşleşir.
  • Unicode Temel Çok Dilli Düzlem Özel Kullanım Alanı'ndaki (U+E000-U+F8FF) bazı kontrol karakterleri (U+0000-U+0008, U+000C-U+001F) ve karakterler, eklenen metinden çıkarılmıştır.
  • Daha fazla bilgi için Metin ekleme, silme ve taşıma bölümüne bakın.

Satır içi resimler ekle

  • Resim 50 MB'tan küçük olmalı, 25 megapikseli aşmamalı ve PNG, JPEG veya GIF biçimlerinden birinde olmalıdır.
  • Sağlanan URI, herkesin erişimine açık ve en fazla 2 KB uzunluğunda olmalıdır.
  • Resim, mevcut bir Paragraph öğesinin sınırları içine eklenmelidir. Örneğin, metin bir tablonun başlangıç dizinine eklenemez.
  • Resim, dipnot veya denklem içine eklenemez.
  • Daha fazla bilgi için Satır içi resim ekleme konusuna bakın.

Metin biçimlendirme

  • Bir aralığa paragraf düzeyinde biçimlendirme uyguladığınızda, biçimlendirme, o aralıkla kısmen veya tamamen çakışan paragrafa uygulanır.
  • Aralık, bitişik yeni satırları içerecek şekilde genişletilebilir.
  • Aralık tamamen bir listeye ait bir paragrafı içeriyorsa paragrafın madde işareti 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şturma

  • Belirtilen aralıkla çakışan tüm paragraflar için madde işaretleri oluşturur.
  • Her bir paragrafın iç içe yerleştirme düzeyi, her paragraftan önce gelen sekme sayısıyla belirlenir.
  • Madde işaretleri oluşturulurken önde gelen sekmeler kaldırılır. Bu durum, metin bölümlerinin dizinlerini değiştirebilir.
  • Hedef paragraftan hemen önce bir listedeki paragraf madde işaretleriyle eşleşen paragraf madde işaretleri eklerseniz paragraf listeye birleştirilir.
  • Daha fazla bilgi için Listelerle çalışma başlıklı makaleyi inceleyin.

Metin silme

  • Paragraf sınırını aşan metnin silinmesi, iki paragraf birleştirildiği için paragraf stillerinde, listelerde, konumlandırılmış nesnelerde ve yer işaretlerinde değişikliklere neden olabilir.

  • Geçersiz bir belge yapısına neden olan silme işlemlerine izin verilmez. Geçersiz silme isteklerine örnek olarak şunlar verilebilir:

    • Bir vekil çiftinin bir kod birimini silme.

    • Bir Body, Header, Footer, Footnote, TableCell veya TableOfContents öğesinin son yeni satır karakteri siliniyor.

    • Öğenin tamamını silmeden Table, TableOfContents veya Equation öğesinin başlangıcını ya da bitişini silme.

    • Öğe silinmeden Table, TableOfContents veya SectionBreak etiketinden önceki yeni satır karakterini silme.

    • Bir tablonun satırlarını veya hücrelerini tek tek silme. Tablo hücresindeki içeriğin silinmesine izin verilir.

  • Daha fazla bilgi için Metin ekleme, silme ve taşıma bölümüne bakın.