Yapısal düzenleme kuralları ve davranışı
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Bu bölümde, Google Dokümanlar API'sini kullanarak dokümanları düzenlerken anlamanız gereken davranışlar ve sınırlamalar açıklanmaktadır.
Genel olarak, bir dokümandaki öğelerin yapısının geçersiz olmasına neden olan düzenlemeler yapamazsınız. Her bir documents.batchUpdate
istek yöntemini, bu istekler için geçerli olan kısıtlamalar ve kurallar açısından inceleyin.
Aşağıdaki bölümlerde bu yöntemlerle ilgili temel kurallar özetlenmektedir.
Metin ekle
- Yeni satır karakteri eklemek, söz konusu dizinde örtülü 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 sınırları içine yerleştirilmelidir. Örneğin, metin bir tablonun başlangıç dizinine eklenemez. Metin, önceki paragrafa eklenmelidir.
- API, Unicode grafem kümelerine ekleme yapılmasını önlemek için konumu dolaylı olarak ayarlayabilir. Bu durumda metin, grafem kümesinden hemen sonra eklenir.
- Eklenen metinlerin metin stilleri otomatik olarak belirlenir ve genellikle komşu metinlerin 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 Basic Multilingual Plane Private Use Area'daki (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 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 olmalı ve en fazla 2 KB uzunluğunda olmalıdır.
- Resim, mevcut bir
Paragraph sınırları içine yerleştirilmelidir. Örneğin, metin bir tablonun başlangıç dizinine eklenemez.
- Resimler dipnot veya denklemin içine eklenemez.
- Daha fazla bilgi için Satır içi resim ekleme başlıklı makaleyi inceleyin.
Metin biçimlendirme
- Bir aralığa paragraf düzeyinde biçimlendirme uyguladığınızda biçimlendirme, söz konusu 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, bir listeye ait olan bir paragrafı tamamen içeriyorsa paragrafın madde işareti de eşleşen metin stiliyle güncellenir.
- Daha fazla bilgi için Metni biçimlendirme başlıklı makaleyi inceleyin.
Paragraf madde işaretleri oluşturma
- Belirtilen 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 önceki baştaki sekmelerin sayısıyla belirlenir.
- Madde işaretleri oluşturulurken baştaki sekmeler kaldırılır. Bu durum, metnin bölümlerinin dizinlerini değiştirebilir.
- Hedef paragrafın hemen öncesinde bir listeyle eşleşen paragraf madde işaretleri eklerseniz paragraf listeye katılır.
- Daha fazla bilgi için Listelerle çalışma başlıklı makaleyi inceleyin.
Metin silme
Paragraf sınırını aşan metinlerin silinmesi, iki paragraf birleştirildiğinden 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 bazı örnekler:
Bir vekil çiftinin bir kod birimini silme.
Body,
Header,
Footer,
Footnote,
TableCell veya
TableOfContents öğesinin son yeni satır karakterini silme.
Table, TableOfContents veya Equation öğesinin tamamını silmeden başlangıcını ya da bitişini silme
Öğeyi silmeden Table, TableOfContents veya SectionBreak öncesindeki yeni satır karakterini silme.
Tablonun satırlarını veya hücrelerini ayrı ayrı 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.
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-08-29 UTC.
[null,null,["Son güncelleme tarihi: 2025-08-29 UTC."],[],[],null,["# Structural edit rules and behavior\n\nThis section describes behaviors and limitations that you must understand when\nyou edit documents using the Google Docs API.\n\nIn general, you cannot execute edits that cause the invalid structure of\nelements within a document. Review each\n[`documents.batchUpdate`](/workspace/docs/api/reference/rest/v1/documents/batchUpdate)\nrequest method for constraints and rules that apply to those\n[requests](/workspace/docs/api/reference/rest/v1/documents/request).\n\nThe following sections summarize the key rules across these methods.\n\nInsert text\n-----------\n\n- Inserting a newline character implicitly creates a [`Paragraph`](/workspace/docs/api/reference/rest/v1/documents#paragraph) at that index. The paragraph style of the new paragraph is copied from the paragraph at the current insertion index, including lists and bullets.\n- Text must be inserted within the bounds of an existing `Paragraph`. For example, text cannot be inserted at a table's start index. The text must be inserted in the preceding paragraph.\n- The API may implicitly adjust the location to prevent insertions within Unicode grapheme clusters. When this happens, the text is inserted immediately after the grapheme cluster.\n- Text styles for inserted text are determined automatically, generally preserving the styling of neighboring text. Typically, the text style for the inserted text matches the text immediately before the insertion index.\n- Some control characters (`U+0000-U+0008, U+000C-U+001F`) and characters from the Unicode Basic Multilingual Plane Private Use Area (`U+E000-U+F8FF`) are stripped out of inserted text.\n- For more information, see [Insert, delete, and move\n text](/workspace/docs/api/how-tos/move-text).\n\nInsert inline images\n--------------------\n\n- Image must be less than 50 MB in size, cannot exceed 25 megapixels, and must be in one of PNG, JPEG, or GIF formats.\n- The provided URI must be publicly accessible and at most 2 KB in length.\n- Image must be inserted within the bounds of an existing `Paragraph`. For example, text cannot be inserted at a table's start index.\n- Images can't be inserted inside a footnote or equation.\n- For more information, see [Insert inline\n images](/workspace/docs/api/how-tos/images).\n\nFormat text\n-----------\n\n- When you apply paragraph-level formatting to a range, the formatting is applied to any paragraph that's partially or completely overlapped by that range.\n- The range might be extended to include adjacent newlines.\n- If the range fully contains a paragraph belonging to a list, the paragraph's bullet is also updated with the matching text style.\n- For more information, see [Format\n text](/workspace/docs/api/how-tos/format-text).\n\nCreate paragraph bullets\n------------------------\n\n- Creates bullets for all paragraphs that overlap with the given range.\n- The nesting level of each paragraph is determined by the number of leading tabs before each paragraph.\n- The leading tabs are removed when creating the bullets, which might change the indexes of parts of the text.\n- If you add paragraph bullets that match those of a list immediately before the target paragraph, the paragraph is joined to the list.\n- For more information, see [Work with lists](/workspace/docs/api/how-tos/lists).\n\nDelete text\n-----------\n\n- Deleting text that crosses a paragraph boundary might cause changes to\n paragraph styles, lists, positioned objects, and bookmarks as the two\n paragraphs are merged.\n\n- Deletions that cause an invalid document structure are not permitted. Some\n examples of invalid delete requests include:\n\n - Deleting one code unit of a surrogate pair.\n\n - Deleting the last newline character of a\n [`Body`](/workspace/docs/api/reference/rest/v1/documents#body),\n [`Header`](/workspace/docs/api/reference/rest/v1/documents#header),\n [`Footer`](/workspace/docs/api/reference/rest/v1/documents#footer),\n [`Footnote`](/workspace/docs/api/reference/rest/v1/documents#footnote),\n [`TableCell`](/workspace/docs/api/reference/rest/v1/documents#tablecell), or\n [`TableOfContents`](/workspace/docs/api/reference/rest/v1/documents#tableofcontents).\n\n - Deleting the start or end of a\n [`Table`](/workspace/docs/api/reference/rest/v1/documents#table),\n `TableOfContents`, or\n [`Equation`](/workspace/docs/api/reference/rest/v1/documents#equation)\n without deleting the entire element.\n\n - Deleting the newline character before a `Table`, `TableOfContents`, or\n [`SectionBreak`](/workspace/docs/api/reference/rest/v1/documents#sectionbreak)\n without deleting the element.\n\n - Deleting individual rows or cells of a table. Deleting the content in a\n table cell is allowed.\n\n- For more information, see [Insert, delete, and move\n text](/workspace/docs/api/how-tos/move-text).\n\nRelated topics\n--------------\n\n- [Structure of a Google Docs document](/workspace/docs/api/concepts/structure)\n- [Requests and responses](/workspace/docs/api/concepts/request-response)"]]
