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

Bu bölümde, dokümanları Google Docs API'yi kullanarak 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 isteklerde geçerli olan kısıtlamalar ve kurallar için her bir documents.batchUpdate istek yöntemini inceleyin.

Aşağıdaki bölümlerde, bu yöntemlere ilişkin temel kurallar özetlenmiştir.

Metin ekle

  • Yeni satır karakteri eklendiğinde bu dizinde dolaylı olarak bir Paragraph oluşturulur. 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 sınırları içinde eklenmelidir. Örneğin, metin tablonun başlangıç dizinine eklenemez. Metin, önceki paragrafa eklenmelidir.
  • API, Unicode grafik kümeleri içinde eklemeleri önlemek için konumu dolaylı olarak ayarlayabilir. Bu durumda metin, grafik 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.
  • 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 çıkarıldı.
  • Daha fazla bilgi için Metin ekleme, silme ve taşıma bölümüne bakın.

Satır içi resimler 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 herkesin erişimine açık olmalı ve en fazla 2 KB uzunluğunda olmalıdır.
  • Resim, mevcut bir Paragraph sınırları içinde olmalıdır. Örneğin, metin tablonun başlangıç dizinine eklenemez.
  • Dipnot veya denklem içine resim eklenemez.
  • Daha fazla bilgi için Satır içi resimler ekleme konusuna bakın.

Metin biçimlendirme

  • Bir aralığa paragraf düzeyinde biçimlendirme uyguladığınızda, biçimlendirme bu aralıkla kısmen veya tamamen çakışan tüm paragraflara uygulanır.
  • Aralık, bitişik yeni satırları içerecek şekilde genişletilebilir.
  • Aralık tamamen bir listeye ait 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ş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, paragraftan önce gelen sekmelerin sayısına göre belirlenir.
  • Madde işaretleri oluşturulurken ilk sekmeler kaldırılır. Bu durum, metin bölümlerinin dizinlerini değiştirebilir.
  • Bir listedeki maddelerle eşleşen paragraf maddelerini hedef paragrafın hemen önüne eklerseniz paragraf listeye birleştirilir.
  • 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 belge yapısına neden olan silme işlemlerine izin verilmez. Geçersiz silme isteğine ilişkin bazı örnekler şunlardır:

    • Bir vekil çiftinin bir kod birimini silme.

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

    • Öğenin tamamını silmeden Table, TableOfContents veya Equation öğelerinin başını ya da sonunu silme.

    • Table, TableOfContents veya SectionBreak öğesinden önceki yeni satır karakterini öğeyi silmeden silme.

    • Bir tablodaki satır veya hücreleri silme. Bir 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.