Liste öğesini temsil eden bir öğe. List, bir liste kimliğiyle ilişkilendirilmiş bir Paragraph'tur. List öğesi Equation, Footnote, Horizontal, Inline, Inline, Page ve Text öğelerini içerebilir. Belge yapısı hakkında daha fazla bilgi için Google Dokümanlar'ı genişletme kılavuzuna bakın.
List yeni satır karakterleri içeremez. Yeni satır karakterleri ("\n") satır sonu karakterlerine ("\r") dönüştürülür.
Aynı liste kimliğine sahip List aynı listeye aittir ve buna göre numaralandırılır.
Belirli bir liste için List öğelerinin sekmede bitişik olması veya aynı üst öğeye sahip olması gerekmez. Aşağıdaki örnekte gösterildiği gibi, aynı listeye ait iki öğe, sekmenin herhangi bir yerinde bulunabilir ve art arda numaralandırılabilir:
const body = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody(); // Append a new list item to the body. const item1 = body.appendListItem('Item 1'); // Log the new list item's list ID. Logger.log(item1.getListId()); // Append a table after the list item. body.appendTable([['Cell 1', 'Cell 2']]); // Append a second list item with the same list ID. The two items are treated as // the same list, despite not being consecutive. const item2 = body.appendListItem('Item 2'); item2.setListId(item1);
Yöntemler
| Yöntem | Dönüş türü | Kısa açıklama | 
|---|---|---|
| add | Positioned | Belirtilen resim blob'undan yeni bir Positionedoluşturup ekler. | 
| append | Horizontal | Yeni bir Horizontaloluşturup ekler. | 
| append | Inline | Belirtilen resim blob'undan yeni bir Inlineoluşturup ekler. | 
| append | Inline | Belirtilen Inlinedeğerini ekler. | 
| append | Page | Yeni bir Pageoluşturup ekler. | 
| append | Page | Belirtilen Pagedeğerini ekler. | 
| append | Text | Belirtilen içeriklerle yeni bir Textöğesi oluşturup ekler. | 
| append | Text | Belirtilen Textöğesini ekler. | 
| clear() | List | Öğenin içeriğini temizler. | 
| copy() | List | Geçerli öğenin ayrılmış, derin bir kopyasını döndürür. | 
| edit | Text | Düzenlemek için mevcut öğenin Textsürümünü alır. | 
| find | Range | Öğenin içeriğini, belirtilen türün bir alt öğesi için arar. | 
| find | Range | Belirtilen Rangeöğesinden başlayarak öğenin içeriğini, belirtilen türün bir alt öğesi için arar. | 
| find | Range | Normal ifadeleri kullanarak öğenin içeriğinde belirtilen metin kalıbını arar. | 
| find | Range | Belirli bir arama sonucundan başlayarak öğenin içeriğini belirtilen metin kalıbıyla arar. | 
| get | Horizontal | Horizontalöğesini alır. | 
| get | Object | Öğenin özelliklerini alır. | 
| get | Element | Belirtilen alt öğe dizininde alt öğeyi alır. | 
| get | Integer | Belirtilen alt öğenin alt öğe dizini döndürülür. | 
| get | Glyph | Liste öğesinin Glyphdeğerini alır. | 
| get | Paragraph | Paragraphöğesini alır. | 
| get | Number | Son girintiyi nokta cinsinden alır. | 
| get | Number | İlk satır girintisini puan cinsinden alır. | 
| get | Number | Başlangıç girintisini alır. | 
| get | Number | Satır aralığını nokta cinsinden alır. | 
| get | String | Bağlantı URL'sini alır. | 
| get | String | Liste kimliğini alır. | 
| get | Integer | Liste öğesinin iç içe yerleştirme düzeyini alır. | 
| get | Element | Öğenin sonraki kardeş öğesini alır. | 
| get | Integer | Çocuk sayısını alır. | 
| get | Container | Öğenin üst öğesini alır. | 
| get | Positioned | Resmin kimliğine göre bir Positionedalır. | 
| get | Positioned | Paragrafa sabitlenmiş tüm Positionednesnelerini alır. | 
| get | Element | Öğenin önceki kardeş öğesini alır. | 
| get | Number | Öğeden sonraki boşluğu, punto cinsinden alır. | 
| get | Number | Öğeden önceki boşluğu punto cinsinden alır. | 
| get | String | Öğenin içeriğini metin dizesi olarak alır. | 
| get | Text | Metin hizalamasını alır. | 
| get | Element | Öğenin Elementdeğerini alır. | 
| insert | Horizontal | Belirtilen dizinde bir Horizontaloluşturup ekler. | 
| insert | Inline | Belirtilen resim blob'undan yeni bir Inlineoluşturup belirtilen dizinde ekler. | 
| insert | Inline | Belirtilen Inlineöğesini belirtilen dizin içine ekler. | 
| insert | Page | Belirtilen dizinde yeni bir Pageoluşturup ekler. | 
| insert | Page | Belirtilen Pageöğesini belirtilen dizin içine ekler. | 
| insert | Text | Belirtilen dizinde yeni bir metin öğesi oluşturur ve ekler. | 
| insert | Text | Belirtilen Textöğesini, belirtilen metin içeriğiyle birlikte belirtilen dizinde ekler. | 
| is | Boolean | Öğenin Document'ün sonunda olup olmadığını belirler. | 
| is | Boolean | Soldan sağa ayarını alır. | 
| merge() | List | Öğeyi, aynı türdeki önceki kardeş öğeyle birleştirir. | 
| remove | List | Belirtilen alt öğeyi kaldırır. | 
| remove | List | Öğeyi üst öğesinden kaldırır. | 
| remove | Boolean | Resmin kimliğine göre bir Positionedkaldırır. | 
| replace | Element | Normal ifadeler kullanılarak belirli bir metin kalıbının tüm örnekleri belirli bir değiştirme dizesiyle değiştirilir. | 
| set | List | Horizontaldeğerini belirler. | 
| set | List | Öğenin özelliklerini ayarlar. | 
| set | List | Liste öğesinin Glyphdeğerini ayarlar. | 
| set | List | Paragraphdeğerini belirler. | 
| set | List | Son girintiyi nokta cinsinden ayarlar. | 
| set | List | İlk satır girintisini nokta cinsinden ayarlar. | 
| set | List | Başlangıç girintisini nokta cinsinden ayarlar. | 
| set | List | Soldan sağa ayarını belirler. | 
| set | List | Satır aralığını, ara vermek için kullanılacak satır sayısını belirten bir miktar olarak ayarlar. | 
| set | List | Bağlantı URL'sini ayarlar. | 
| set | List | Liste kimliğini ayarlar. | 
| set | List | Liste öğesinin iç içe yerleştirme düzeyini ayarlar. | 
| set | List | Öğeden sonraki boşluğu punto cinsinden ayarlar. | 
| set | List | Öğeden önceki boşluğu punto cinsinden ayarlar. | 
| set | void | Liste öğesinin içeriğini metin olarak ayarlar. | 
| set | List | Metin hizalamasını ayarlar. | 
Ayrıntılı dokümanlar
add
Belirtilen resim blob'undan yeni bir Positioned oluşturup ekler.
Parametreler
| Ad | Tür | Açıklama | 
|---|---|---|
| image | Blob | resim verileri | 
Return
Positioned: Yeni konumlandırılmış resim
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
- 
https://www.googleapis.com/auth/documents.currentonly
- 
https://www.googleapis.com/auth/documents
append
Yeni bir Horizontal oluşturup ekler.
Return
Horizontal: yeni yatay kural
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
- 
https://www.googleapis.com/auth/documents.currentonly
- 
https://www.googleapis.com/auth/documents
append
Belirtilen resim blob'undan yeni bir Inline oluşturup ekler.
Parametreler
| Ad | Tür | Açıklama | 
|---|---|---|
| image | Blob | resim verileri | 
Return
Inline: Eklenen resim
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
- 
https://www.googleapis.com/auth/documents.currentonly
- 
https://www.googleapis.com/auth/documents
append
Belirtilen Inline değerini ekler.
Parametreler
| Ad | Tür | Açıklama | 
|---|---|---|
| image | Inline | resim verileri | 
Return
Inline: Eklenen resim
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
- 
https://www.googleapis.com/auth/documents.currentonly
- 
https://www.googleapis.com/auth/documents
append
Yeni bir Page oluşturup ekler.
Not: Page, Table içinde yer alamaz.
Mevcut öğe bir tablo hücresindeyse bir istisna atılır.
Return
Page: yeni sayfa sonu öğesi
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
- 
https://www.googleapis.com/auth/documents.currentonly
- 
https://www.googleapis.com/auth/documents
append
Belirtilen Page değerini ekler.
Not: Page, Table içinde yer alamaz.
Mevcut öğe bir tablo hücresindeyse bir istisna atılır.
Parametreler
| Ad | Tür | Açıklama | 
|---|---|---|
| page | Page | eklenecek sayfa sonu | 
Return
Page: Eklenen sayfa sonu öğesi
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
- 
https://www.googleapis.com/auth/documents.currentonly
- 
https://www.googleapis.com/auth/documents
append
Belirtilen içeriklerle yeni bir Text öğesi oluşturup ekler.
Parametreler
| Ad | Tür | Açıklama | 
|---|---|---|
| text | String | metin içerikleri | 
Return
Text: Yeni metin öğesi
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
- 
https://www.googleapis.com/auth/documents.currentonly
- 
https://www.googleapis.com/auth/documents
append
Belirtilen Text öğesini ekler.
Parametreler
| Ad | Tür | Açıklama | 
|---|---|---|
| text | Text | eklenecek metin öğesi | 
Return
Text: Eklenen metin öğesi
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
- 
https://www.googleapis.com/auth/documents.currentonly
- 
https://www.googleapis.com/auth/documents
clear()
copy()
Geçerli öğenin ayrılmış, derin bir kopyasını döndürür.
Öğede bulunan tüm alt öğeler de kopyalanır. Yeni öğenin üst öğesi yok.
Return
List: Yeni kopya.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
- 
https://www.googleapis.com/auth/documents.currentonly
- 
https://www.googleapis.com/auth/documents
edit
Düzenlemek için mevcut öğenin Text sürümünü alır.
Öğe içeriklerini zengin metin olarak değiştirmek için edit öğesini kullanın. edit modu, metin olmayan öğeleri (Inline ve Horizontal gibi) yoksayar.
Silinen bir metin aralığının tamamına sahip alt öğeler öğeden kaldırılır.
const body = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody(); // Insert two paragraphs separated by a paragraph containing an // horizontal rule. body.insertParagraph(0, 'An editAsText sample.'); body.insertHorizontalRule(0); body.insertParagraph(0, 'An example.'); // Delete " sample.\n\n An" removing the horizontal rule in the process. body.editAsText().deleteText(14, 25);
Return
Text: Mevcut öğenin metin sürümü
find
Öğenin içeriğini, belirtilen türün bir alt öğesi için arar.
Parametreler
| Ad | Tür | Açıklama | 
|---|---|---|
| element | Element | Aranacak öğe türü. | 
Return
Range: Arama öğesinin konumunu belirten bir arama sonucu.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
- 
https://www.googleapis.com/auth/documents.currentonly
- 
https://www.googleapis.com/auth/documents
find
Belirtilen Range öğesinden başlayarak öğenin içeriğini, belirtilen türün bir alt öğesi için arar.
const body = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody(); // Define the search parameters. let searchResult = null; // Search until the paragraph is found. while ( (searchResult = body.findElement( DocumentApp.ElementType.PARAGRAPH, searchResult, ))) { const par = searchResult.getElement().asParagraph(); if (par.getHeading() === DocumentApp.ParagraphHeading.HEADING1) { // Found one, update and stop. par.setText('This is the first header.'); break; } }
Parametreler
| Ad | Tür | Açıklama | 
|---|---|---|
| element | Element | Aranacak öğe türü. | 
| from | Range | Arama yapılacak arama sonucu. | 
Return
Range: Arama öğesinin sonraki konumunu gösteren bir arama sonucu.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
- 
https://www.googleapis.com/auth/documents.currentonly
- 
https://www.googleapis.com/auth/documents
find
Normal ifadeleri kullanarak öğenin içeriğinde belirtilen metin kalıbını arar.
JavaScript normal ifade özelliklerinin bir alt kümesi (ör. yakalama grupları ve mod değiştiriciler) tam olarak desteklenmez.
Sağlanan normal ifade kalıbı, geçerli öğede bulunan her metin bloğuyla bağımsız olarak eşleştirilir.
Parametreler
| Ad | Tür | Açıklama | 
|---|---|---|
| search | String | aranacak kalıp | 
Return
Range: Arama metninin konumunu gösteren bir arama sonucudur veya eşleşme yoksa null değerini alır.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
- 
https://www.googleapis.com/auth/documents.currentonly
- 
https://www.googleapis.com/auth/documents
find
Belirli bir arama sonucundan başlayarak öğenin içeriğini belirtilen metin kalıbıyla arar.
JavaScript normal ifade özelliklerinin bir alt kümesi (ör. yakalama grupları ve mod değiştiriciler) tam olarak desteklenmez.
Sağlanan normal ifade kalıbı, geçerli öğede bulunan her metin bloğuyla bağımsız olarak eşleştirilir.
Parametreler
| Ad | Tür | Açıklama | 
|---|---|---|
| search | String | aranacak kalıp | 
| from | Range | Arama yapılacak arama sonucu | 
Return
Range: Arama metninin sonraki konumunu gösteren bir arama sonucudur veya eşleşme yoksa null değerini alır.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
- 
https://www.googleapis.com/auth/documents.currentonly
- 
https://www.googleapis.com/auth/documents
get
Horizontal öğesini alır.
Return
Horizontal: Hizalama
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
- 
https://www.googleapis.com/auth/documents.currentonly
- 
https://www.googleapis.com/auth/documents
get
Öğenin özelliklerini alır.
Sonuç, her geçerli öğe özelliği için bir özellik içeren bir nesnedir. Bu nesnedeki her özellik adı, Document dizininde bir öğeye karşılık gelir.
const doc = DocumentApp.getActiveDocument(); const documentTab = doc.getActiveTab().asDocumentTab(); const body = documentTab.getBody(); // Append a styled paragraph. const par = body.appendParagraph('A bold, italicized paragraph.'); par.setBold(true); par.setItalic(true); // Retrieve the paragraph's attributes. const atts = par.getAttributes(); // Log the paragraph attributes. for (const att in atts) { Logger.log(`${att}:${atts[att]}`); }
Return
Object: Öğenin özellikleri.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
- 
https://www.googleapis.com/auth/documents.currentonly
- 
https://www.googleapis.com/auth/documents
get
Belirtilen alt öğe dizininde alt öğeyi alır.
const body = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody(); // Obtain the first element in the tab. const firstChild = body.getChild(0); // If it's a paragraph, set its contents. if (firstChild.getType() === DocumentApp.ElementType.PARAGRAPH) { firstChild.asParagraph().setText('This is the first paragraph.'); }
Parametreler
| Ad | Tür | Açıklama | 
|---|---|---|
| child | Integer | Alınacak alt öğenin dizini. | 
Return
Element: Belirtilen dizindeki alt öğe.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
- 
https://www.googleapis.com/auth/documents.currentonly
- 
https://www.googleapis.com/auth/documents
get
Belirtilen alt öğenin alt öğe dizini döndürülür.
Parametreler
| Ad | Tür | Açıklama | 
|---|---|---|
| child | Element | Dizininin alınacağı alt öğe. | 
Return
Integer: Alt dizin.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
- 
https://www.googleapis.com/auth/documents.currentonly
- 
https://www.googleapis.com/auth/documents
get
Liste öğesinin Glyph değerini alır.
Return
Glyph: Glif türü
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
- 
https://www.googleapis.com/auth/documents.currentonly
- 
https://www.googleapis.com/auth/documents
get
Paragraph öğesini alır.
Return
Paragraph: başlık
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
- 
https://www.googleapis.com/auth/documents.currentonly
- 
https://www.googleapis.com/auth/documents
get
Son girintiyi nokta cinsinden alır.
Return
Number: Bitiş girintisi (noktalar cinsinden)
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
- 
https://www.googleapis.com/auth/documents.currentonly
- 
https://www.googleapis.com/auth/documents
get
İlk satır girintisini puan cinsinden alır.
Return
Number: ilk satır girintisi (noktalar cinsinden)
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
- 
https://www.googleapis.com/auth/documents.currentonly
- 
https://www.googleapis.com/auth/documents
get
Başlangıç girintisini alır.
Return
Number: Başlangıç girintisi
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
- 
https://www.googleapis.com/auth/documents.currentonly
- 
https://www.googleapis.com/auth/documents
get
Satır aralığını nokta cinsinden alır.
Return
Number: Satır aralığı (punto cinsinden)
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
- 
https://www.googleapis.com/auth/documents.currentonly
- 
https://www.googleapis.com/auth/documents
get
Bağlantı URL'sini alır.
Return
String: Bağlantı URL'si veya öğe bu özellik için birden fazla değer içeriyorsa null
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
- 
https://www.googleapis.com/auth/documents.currentonly
- 
https://www.googleapis.com/auth/documents
get
Liste kimliğini alır.
Return
String: liste kimliği
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
- 
https://www.googleapis.com/auth/documents.currentonly
- 
https://www.googleapis.com/auth/documents
get
Liste öğesinin iç içe yerleştirme düzeyini alır.
Liste öğelerinin varsayılan iç içe yerleştirme seviyesi sıfırdır. İç içe yerleştirme seviyesi, liste öğesi tarafından kullanılan glifi belirler.
Return
Integer: İç içe yerleştirme seviyesi
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
- 
https://www.googleapis.com/auth/documents.currentonly
- 
https://www.googleapis.com/auth/documents
get
Öğenin sonraki kardeş öğesini alır.
Bir sonraki kardeş öğe, aynı üst öğeye sahiptir ve geçerli öğeyi takip eder.
Return
Element: Sonraki kardeş öğe.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
- 
https://www.googleapis.com/auth/documents.currentonly
- 
https://www.googleapis.com/auth/documents
get
Çocuk sayısını alır.
const body = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody(); // Log the number of elements in the tab. Logger.log(`There are ${body.getNumChildren()} elements in the tab's body.`);
Return
Integer: Çocuk sayısı.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
- 
https://www.googleapis.com/auth/documents.currentonly
- 
https://www.googleapis.com/auth/documents
get
Öğenin üst öğesini alır.
Üst öğe, geçerli öğeyi içerir.
Return
Container: Üst öğe.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
- 
https://www.googleapis.com/auth/documents.currentonly
- 
https://www.googleapis.com/auth/documents
get
Resmin kimliğine göre bir Positioned alır.
Parametreler
| Ad | Tür | Açıklama | 
|---|---|---|
| id | String | resim kimliği | 
Return
Positioned: Konumlandırılmış resim
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
- 
https://www.googleapis.com/auth/documents.currentonly
- 
https://www.googleapis.com/auth/documents
get
Paragrafa sabitlenmiş tüm Positioned nesnelerini alır.
Return
Positioned: Yerleştirilmiş resimlerin listesi
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
- 
https://www.googleapis.com/auth/documents.currentonly
- 
https://www.googleapis.com/auth/documents
get
Öğenin önceki kardeş öğesini alır.
Önceki kardeş öğe, aynı üst öğeye sahiptir ve geçerli öğeden önce gelir.
Return
Element: Önceki kardeş öğe.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
- 
https://www.googleapis.com/auth/documents.currentonly
- 
https://www.googleapis.com/auth/documents
get
Öğeden sonraki boşluğu, punto cinsinden alır.
Return
Number: Öğeden sonraki aralık (punto cinsinden)
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
- 
https://www.googleapis.com/auth/documents.currentonly
- 
https://www.googleapis.com/auth/documents
get
Öğeden önceki boşluğu punto cinsinden alır.
Return
Number: Öğeden önceki boşluk (punto cinsinden)
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
- 
https://www.googleapis.com/auth/documents.currentonly
- 
https://www.googleapis.com/auth/documents
get
Öğenin içeriğini metin dizesi olarak alır.
Return
String: Öğenin metin dizesi olarak içeriği
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
- 
https://www.googleapis.com/auth/documents.currentonly
- 
https://www.googleapis.com/auth/documents
get
Metin hizalamasını alır. Kullanılabilir hizalama türleri Document, Document ve Document'dir.
Return
Text: Metin hizalamasının türü veya metin birden fazla metin hizası türü içeriyorsa ya da metin hizası hiç ayarlanmadıysa null
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
- 
https://www.googleapis.com/auth/documents.currentonly
- 
https://www.googleapis.com/auth/documents
get
Öğenin Element değerini alır.
Belirli bir öğenin tam türünü belirlemek için get öğesini kullanın.
const doc = DocumentApp.getActiveDocument(); const documentTab = doc.getActiveTab().asDocumentTab(); const body = documentTab.getBody(); // Obtain the first element in the active tab's body. const firstChild = body.getChild(0); // Use getType() to determine the element's type. if (firstChild.getType() === DocumentApp.ElementType.PARAGRAPH) { Logger.log('The first element is a paragraph.'); } else { Logger.log('The first element is not a paragraph.'); }
Return
Element: Öğe türü.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
- 
https://www.googleapis.com/auth/documents.currentonly
- 
https://www.googleapis.com/auth/documents
insert
Belirtilen dizinde bir Horizontal oluşturup ekler.
Parametreler
| Ad | Tür | Açıklama | 
|---|---|---|
| child | Integer | Öğenin ekleneceği dizin | 
Return
Horizontal: yeni yatay kural öğesi
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
- 
https://www.googleapis.com/auth/documents.currentonly
- 
https://www.googleapis.com/auth/documents
insert
Belirtilen resim blob'undan yeni bir Inline oluşturup belirtilen dizinde ekler.
Parametreler
| Ad | Tür | Açıklama | 
|---|---|---|
| child | Integer | Öğenin ekleneceği dizin | 
| image | Blob | resim verileri | 
Return
Inline: Eklenen satır içi resim öğesi
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
- 
https://www.googleapis.com/auth/documents.currentonly
- 
https://www.googleapis.com/auth/documents
insert
Belirtilen Inline öğesini belirtilen dizin içine ekler.
Parametreler
| Ad | Tür | Açıklama | 
|---|---|---|
| child | Integer | Öğenin ekleneceği dizin | 
| image | Inline | resim verileri | 
Return
Inline: Eklenen satır içi resim öğesi
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
- 
https://www.googleapis.com/auth/documents.currentonly
- 
https://www.googleapis.com/auth/documents
insert
Belirtilen dizinde yeni bir Page oluşturup ekler.
Not: Page, Table içinde yer alamaz.
Mevcut öğe bir tablo hücresindeyse bir istisna atılır.
Parametreler
| Ad | Tür | Açıklama | 
|---|---|---|
| child | Integer | Öğenin ekleneceği dizin | 
Return
Page: yeni sayfa sonu öğesi
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
- 
https://www.googleapis.com/auth/documents.currentonly
- 
https://www.googleapis.com/auth/documents
insert
Belirtilen Page öğesini belirtilen dizin içine ekler.
Not: Page, Table içinde yer alamaz.
Mevcut öğe bir tablo hücresindeyse bir istisna atılır.
Parametreler
| Ad | Tür | Açıklama | 
|---|---|---|
| child | Integer | Öğenin ekleneceği dizin | 
| page | Page | eklenecek sayfa sonu | 
Return
Page: Eklenen sayfa sonu öğesi
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
- 
https://www.googleapis.com/auth/documents.currentonly
- 
https://www.googleapis.com/auth/documents
insert
Belirtilen dizinde yeni bir metin öğesi oluşturur ve ekler.
Parametreler
| Ad | Tür | Açıklama | 
|---|---|---|
| child | Integer | Öğenin ekleneceği dizin | 
| text | String | metin içerikleri | 
Return
Text: Yeni metin öğesi
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
- 
https://www.googleapis.com/auth/documents.currentonly
- 
https://www.googleapis.com/auth/documents
insert
Belirtilen Text öğesini, belirtilen metin içeriğiyle birlikte belirtilen dizinde ekler.
Parametreler
| Ad | Tür | Açıklama | 
|---|---|---|
| child | Integer | Öğenin ekleneceği dizin | 
| text | Text | eklenecek metin öğesi | 
Return
Text: Eklenen metin öğesi
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
- 
https://www.googleapis.com/auth/documents.currentonly
- 
https://www.googleapis.com/auth/documents
is
Öğenin Document'ün sonunda olup olmadığını belirler.
Return
Boolean: Öğenin sekmenin sonunda olup olmadığı.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
- 
https://www.googleapis.com/auth/documents.currentonly
- 
https://www.googleapis.com/auth/documents
is
Soldan sağa ayarını alır.
Return
Boolean: soldan sağa ayar
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
- 
https://www.googleapis.com/auth/documents.currentonly
- 
https://www.googleapis.com/auth/documents
merge()
Öğeyi, aynı türdeki önceki kardeş öğeyle birleştirir.
Yalnızca aynı Element öğeleri birleştirilebilir. Geçerli öğede bulunan tüm alt öğeler, önceki kardeş öğeye taşınır.
Mevcut öğe dokümandan kaldırılır.
const doc = DocumentApp.getActiveDocument(); const documentTab = doc.getActiveTab().asDocumentTab(); const body = documentTab.getBody(); // Example 1: Merge paragraphs // Append two paragraphs to the document's active tab. const par1 = body.appendParagraph('Paragraph 1.'); const par2 = body.appendParagraph('Paragraph 2.'); // Merge the newly added paragraphs into a single paragraph. par2.merge(); // Example 2: Merge table cells // Create a two-dimensional array containing the table's cell contents. const cells = [ ['Row 1, Cell 1', 'Row 1, Cell 2'], ['Row 2, Cell 1', 'Row 2, Cell 2'], ]; // Build a table from the array. const table = body.appendTable(cells); // Get the first row in the table. const row = table.getRow(0); // Get the two cells in this row. const cell1 = row.getCell(0); const cell2 = row.getCell(1); // Merge the current cell into its preceding sibling element. const merged = cell2.merge();
Return
List: Birleştirilmiş öğe.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
- 
https://www.googleapis.com/auth/documents.currentonly
- 
https://www.googleapis.com/auth/documents
remove
Belirtilen alt öğeyi kaldırır.
Parametreler
| Ad | Tür | Açıklama | 
|---|---|---|
| child | Element | Kaldırılacak alt öğe | 
Return
List: Geçerli öğe
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
- 
https://www.googleapis.com/auth/documents.currentonly
- 
https://www.googleapis.com/auth/documents
remove
Öğeyi üst öğesinden kaldırır.
const doc = DocumentApp.getActiveDocument(); const documentTab = doc.getActiveTab().asDocumentTab(); const body = documentTab.getBody(); // Remove all images in the active tab's body. const imgs = body.getImages(); for (let i = 0; i < imgs.length; i++) { imgs[i].removeFromParent(); }
Return
List: Kaldırılan öğe.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
- 
https://www.googleapis.com/auth/documents.currentonly
- 
https://www.googleapis.com/auth/documents
remove
Resmin kimliğine göre bir Positioned kaldırır.
Parametreler
| Ad | Tür | Açıklama | 
|---|---|---|
| id | String | 
Return
Boolean: Belirtilen resmin kaldırılıp kaldırılmadığı
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
- 
https://www.googleapis.com/auth/documents.currentonly
- 
https://www.googleapis.com/auth/documents
replace
Normal ifadeler kullanılarak belirli bir metin kalıbının tüm örnekleri belirli bir değiştirme dizesiyle değiştirilir.
Arama kalıbı, JavaScript normal ifade nesnesi değil, dize olarak iletilir. Bu nedenle, kalıptaki tüm ters eğik çizgileri koddan çıkarmanız gerekir.
Bu yöntem, desteklenen söz dizimini sınırlayan Google'ın RE2 normal ifade kitaplığını kullanır.
Sağlanan normal ifade kalıbı, geçerli öğede bulunan her metin bloğuyla bağımsız olarak eşleştirilir.
const body = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody(); // Clear the text surrounding "Apps Script", with or without text. body.replaceText('^.*Apps ?Script.*$', 'Apps Script');
Parametreler
| Ad | Tür | Açıklama | 
|---|---|---|
| search | String | Aranacak normal ifade kalıbı | 
| replacement | String | Değişim olarak kullanılacak metin | 
Return
Element: Geçerli öğe
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
- 
https://www.googleapis.com/auth/documents.currentonly
- 
https://www.googleapis.com/auth/documents
set
Horizontal değerini belirler.
Parametreler
| Ad | Tür | Açıklama | 
|---|---|---|
| alignment | Horizontal | yatay hizalama | 
Return
List: Geçerli öğe
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
- 
https://www.googleapis.com/auth/documents.currentonly
- 
https://www.googleapis.com/auth/documents
set
Öğenin özelliklerini ayarlar.
Belirtilen attributes parametresi, her bir özellik adının Document numaralandırmasında bir öğe olduğu ve her bir özellik değerinin uygulanacak yeni değer olduğu bir nesne olmalıdır.
const doc = DocumentApp.getActiveDocument(); const documentTab = doc.getActiveTab().asDocumentTab(); const body = documentTab.getBody(); // Define a custom paragraph style. const style = {}; style[DocumentApp.Attribute.HORIZONTAL_ALIGNMENT] = DocumentApp.HorizontalAlignment.RIGHT; style[DocumentApp.Attribute.FONT_FAMILY] = 'Calibri'; style[DocumentApp.Attribute.FONT_SIZE] = 18; style[DocumentApp.Attribute.BOLD] = true; // Append a plain paragraph. const par = body.appendParagraph('A paragraph with custom style.'); // Apply the custom style. par.setAttributes(style);
Parametreler
| Ad | Tür | Açıklama | 
|---|---|---|
| attributes | Object | Öğenin özellikleri. | 
Return
List: Geçerli öğe.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
- 
https://www.googleapis.com/auth/documents.currentonly
- 
https://www.googleapis.com/auth/documents
set
Liste öğesinin Glyph değerini ayarlar.
Parametreler
| Ad | Tür | Açıklama | 
|---|---|---|
| glyph | Glyph | glif türü | 
Return
List: Geçerli öğe
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
- 
https://www.googleapis.com/auth/documents.currentonly
- 
https://www.googleapis.com/auth/documents
set
Paragraph değerini belirler.
Parametreler
| Ad | Tür | Açıklama | 
|---|---|---|
| heading | Paragraph | başlık | 
Return
List: Geçerli öğe
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
- 
https://www.googleapis.com/auth/documents.currentonly
- 
https://www.googleapis.com/auth/documents
set
Son girintiyi nokta cinsinden ayarlar.
Parametreler
| Ad | Tür | Açıklama | 
|---|---|---|
| indent | Number | Bitiş girintisi (noktalar cinsinden) | 
Return
List: Geçerli öğe
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
- 
https://www.googleapis.com/auth/documents.currentonly
- 
https://www.googleapis.com/auth/documents
set
İlk satır girintisini nokta cinsinden ayarlar.
Parametreler
| Ad | Tür | Açıklama | 
|---|---|---|
| indent | Number | ilk satır girintisi (noktalar cinsinden) | 
Return
List: Geçerli öğe
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
- 
https://www.googleapis.com/auth/documents.currentonly
- 
https://www.googleapis.com/auth/documents
set
Başlangıç girintisini nokta cinsinden ayarlar.
Parametreler
| Ad | Tür | Açıklama | 
|---|---|---|
| indent | Number | Başlangıç girintisi (noktalar cinsinden) | 
Return
List: Geçerli öğe
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
- 
https://www.googleapis.com/auth/documents.currentonly
- 
https://www.googleapis.com/auth/documents
set
Soldan sağa ayarını belirler.
Parametreler
| Ad | Tür | Açıklama | 
|---|---|---|
| left | Boolean | soldan sağa ayarını | 
Return
List: Geçerli öğe
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
- 
https://www.googleapis.com/auth/documents.currentonly
- 
https://www.googleapis.com/auth/documents
set
Satır aralığını, ara vermek için kullanılacak satır sayısını belirten bir miktar olarak ayarlar.
Parametreler
| Ad | Tür | Açıklama | 
|---|---|---|
| multiplier | Number | satır sayısı | 
Return
List: Geçerli öğe
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
- 
https://www.googleapis.com/auth/documents.currentonly
- 
https://www.googleapis.com/auth/documents
set
Bağlantı URL'sini ayarlar.
Parametreler
| Ad | Tür | Açıklama | 
|---|---|---|
| url | String | bağlantı URL'si | 
Return
List: Geçerli öğe
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
- 
https://www.googleapis.com/auth/documents.currentonly
- 
https://www.googleapis.com/auth/documents
set
Liste kimliğini ayarlar.
Liste kimliği, belirtilen List için aynı değere ayarlanır. Bu iki List, aynı listenin üyeleri olarak değerlendirilir.
Parametreler
| Ad | Tür | Açıklama | 
|---|---|---|
| list | List | Kullanılacak liste kimliğine sahip liste öğesi | 
Return
List: Geçerli öğe
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
- 
https://www.googleapis.com/auth/documents.currentonly
- 
https://www.googleapis.com/auth/documents
set
Liste öğesinin iç içe yerleştirme düzeyini ayarlar.
Liste öğelerinin varsayılan iç içe yerleştirme seviyesi sıfırdır. İç içe yerleştirme seviyesi, liste öğesi tarafından kullanılan glifi belirler.
Parametreler
| Ad | Tür | Açıklama | 
|---|---|---|
| nesting | Integer | iç içe yerleştirme seviyesi | 
Return
List: Geçerli öğe
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
- 
https://www.googleapis.com/auth/documents.currentonly
- 
https://www.googleapis.com/auth/documents
set
Öğeden sonraki boşluğu punto cinsinden ayarlar.
Parametreler
| Ad | Tür | Açıklama | 
|---|---|---|
| spacing | Number | Öğeden sonraki aralık (punto cinsinden) | 
Return
List: Geçerli öğe
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
- 
https://www.googleapis.com/auth/documents.currentonly
- 
https://www.googleapis.com/auth/documents
set
Öğeden önceki boşluğu punto cinsinden ayarlar.
Parametreler
| Ad | Tür | Açıklama | 
|---|---|---|
| spacing | Number | Öğeden önceki boşluk (punto cinsinden) | 
Return
List: Geçerli öğe
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
- 
https://www.googleapis.com/auth/documents.currentonly
- 
https://www.googleapis.com/auth/documents
set
Liste öğesinin içeriğini metin olarak ayarlar.
Not: Mevcut içerikler silinir.
Parametreler
| Ad | Tür | Açıklama | 
|---|---|---|
| text | String | yeni metin içerikleri | 
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
- 
https://www.googleapis.com/auth/documents.currentonly
- 
https://www.googleapis.com/auth/documents
set
Metin hizalamasını ayarlar. Kullanılabilir hizalama türleri Document, Document ve Document'dir.
// Make the entire first paragraph in the active tab be superscript. const documentTab = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab(); const text = documentTab.getBody().getParagraphs()[0].editAsText(); text.setTextAlignment(DocumentApp.TextAlignment.SUPERSCRIPT);
Parametreler
| Ad | Tür | Açıklama | 
|---|---|---|
| text | Text | uygulanacak metin hizalamasının türü | 
Return
List: Geçerli öğe
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
- 
https://www.googleapis.com/auth/documents.currentonly
- 
https://www.googleapis.com/auth/documents