Google Dokümanlar belgesindeki bir sekmenin içeriği. Body öğesi ListItem, Paragraph, Table ve TableOfContents öğelerini içerebilir. Belge yapısı hakkında daha fazla bilgi için Google Dokümanlar'ı genişletme kılavuzuna bakın.
Body genellikle HeaderSection, FooterSection ve tüm FootnoteSection öğeleri hariç olmak üzere sekmenin tüm içeriğini barındırır.
const body = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody(); // Append a paragraph and a page break to the tab's body section directly. body.appendParagraph('A paragraph.'); body.appendPageBreak();
Yöntemler
| Yöntem | Dönüş türü | Kısa açıklama |
|---|---|---|
append | Horizontal | Yeni bir Horizontal oluşturur ve ekler. |
append | Inline | Belirtilen resim blob'undan yeni bir Inline oluşturur ve ekler. |
append | Inline | Belirtilen Inline eklenir. |
append | List | Belirtilen List eklenir. |
append | List | Belirtilen metin içeriklerini içeren yeni bir List oluşturur ve ekler. |
append | Page | Yeni bir Page oluşturur ve ekler. |
append | Page | Belirtilen Page eklenir. |
append | Paragraph | Belirtilen Paragraph eklenir. |
append | Paragraph | Belirtilen metin içeriklerini içeren yeni bir Paragraph oluşturur ve ekler. |
append | Table | Yeni bir Table oluşturur ve ekler. |
append | Table | Belirtilen her dize değeri için Table içeren yeni bir Table ekler. |
append | Table | Belirtilen Table eklenir. |
clear() | Body | Öğenin içeriğini temizler. |
copy() | Body | Geçerli öğenin ayrılmış, derin bir kopyasını döndürür. |
edit | Text | Düzenlemek için mevcut öğenin Text sürümünü alır. |
find | Range | Öğenin içeriğinde, belirtilen türde bir alt öğe arar. |
find | Range | Belirtilen Range ile başlayarak, belirtilen türde bir alt öğe için öğenin içeriğini arar. |
find | Range | Normal ifadeleri kullanarak öğenin içeriğinde belirtilen metin kalıbını arar. |
find | Range | Belirtilen metin kalıbını, belirli bir arama sonucundan başlayarak öğenin içeriğinde arar. |
get | Object | Öğenin özelliklerini alır. |
get | Element | Belirtilen alt dizindeki alt öğeyi alır. |
get | Integer | Belirtilen alt öğenin alt dizinini alır. |
get | Object | Belirtilen Paragraph için özellikler grubunu alır. |
get | Inline | Bölümde bulunan tüm Inline öğelerini alır. |
get | List | Bölümde bulunan tüm List öğelerini alır. |
get | Number|null | Alt kenar boşluğunu puan cinsinden alır. |
get | Number|null | Sol kenar boşluğunu puan cinsinden alır. |
get | Number|null | Sağ kenar boşluğunu alır. |
get | Number|null | Üst kenar boşluğunu alır. |
get | Integer | Çocuk sayısını alır. |
get | Number|null | Sayfa yüksekliğini (puan cinsinden) alır. |
get | Number|null | Sayfa genişliğini puan cinsinden alır. |
get | Paragraph[]|null | Bölümde bulunan tüm Paragraphs öğelerini (List dahil) alır. |
get | Container | Öğenin üst öğesini alır. |
get | Table[]|null | Bölümde bulunan tüm Tables öğelerini alır. |
get | String | Öğenin içeriğini metin dizesi olarak alır. |
get | Text | Metin hizalamasını alır. |
get | Element | Öğenin Element değerini alır. |
insert | Horizontal | Belirtilen dizinde yeni bir Horizontal oluşturur ve ekler. |
insert | Inline | Belirtilen görüntü blob'undan belirtilen dizinde bir Inline oluşturur ve ekler. |
insert | Inline | Belirtilen dizine verilen Inline öğesini ekler. |
insert | List | Belirtilen dizine verilen List öğesini ekler. |
insert | List | Belirtilen dizinde, belirtilen metin içeriğini içeren yeni bir List oluşturup ekler. |
insert | Page | Belirtilen dizinde yeni bir Page oluşturur ve ekler. |
insert | Page | Belirtilen dizine verilen Page öğesini ekler. |
insert | Paragraph | Belirtilen dizine verilen Paragraph öğesini ekler. |
insert | Paragraph | Belirtilen dizinde, belirtilen metin içeriğini içeren yeni bir Paragraph oluşturup ekler. |
insert | Table | Belirtilen dizinde yeni bir Table oluşturur ve ekler. |
insert | Table | Belirtilen hücreleri içeren yeni bir Table oluşturup belirtilen dizine ekler. |
insert | Table | Belirtilen dizine verilen Table öğesini ekler. |
remove | Body | Belirtilen alt öğeyi kaldırır. |
replace | Element | Normal ifadeleri kullanarak belirli bir metin kalıbının tüm örneklerini belirli bir yeni dizeyle değiştirir. |
set | Body | Öğenin özelliklerini ayarlar. |
set | Body | Sağlanan Paragraph için özellikleri ayarlar. |
set | Body | Alt kenar boşluğunu punto cinsinden ayarlar. |
set | Body | Sol kenar boşluğunu punto cinsinden ayarlar. |
set | Body | Sağ kenar boşluğunu puan cinsinden ayarlar. |
set | Body | Üst kenar boşluğunu ayarlar. |
set | Body | Sayfa yüksekliğini punto cinsinden ayarlar. |
set | Body | Sayfa genişliğini punto cinsinden ayarlar. |
set | Body | İçeriği düz metin olarak ayarlar. |
set | Body | Metin hizalamasını ayarlar. |
Ayrıntılı belgeler
appendHorizontalRule()
Yeni bir HorizontalRule oluşturur ve ekler.
HorizontalRule, yeni bir Paragraph içinde yer alır.
Return
HorizontalRule — Yeni yatay kural.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
appendImage(image)
Belirtilen resim blob'undan yeni bir InlineImage oluşturur ve ekler.
Resim, yeni bir Paragraph içinde yer alır.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
image | Blob | Resim verileri. |
Return
InlineImage: Eklenen resim.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
appendImage(image)
Belirtilen InlineImage eklenir.
InlineImage, yeni bir Paragraph içinde yer alır.
Mevcut bir InlineImage kopyasını eklerken appendImage'nın bu sürümünü kullanın.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
image | Inline | Resim verileri. |
Return
InlineImage: Eklenen resim.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
appendListItem(listItem)
Belirtilen ListItem eklenir.
Mevcut bir ListItem kopyasını eklerken appendListItem'nın bu sürümünü kullanın.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
list | List | Eklenecek liste öğesi. |
Return
ListItem: Eklenen liste öğesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
appendListItem(text)
Belirtilen metin içeriklerini içeren yeni bir ListItem oluşturur ve ekler.
Ardışık liste öğeleri aynı listenin parçası olarak eklenir.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
text | String | Liste öğesinin metin içerikleri. |
Return
ListItem: Yeni liste öğesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
appendPageBreak()
Yeni bir PageBreak oluşturur ve ekler.
PageBreak, yeni bir Paragraph içinde yer alır.
Return
PageBreak: Yeni sayfa sonu.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
appendPageBreak(pageBreak)
Belirtilen PageBreak eklenir.
PageBreak, yeni bir Paragraph içinde yer alır.
Mevcut bir PageBreak kopyasını eklerken appendPageBreak'nın bu sürümünü kullanın.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
page | Page | Eklenecek sayfa sonu. |
Return
PageBreak: Eklenen sayfa sonu.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
appendParagraph(paragraph)
Belirtilen Paragraph eklenir.
Mevcut bir Paragraph kopyasını eklerken appendParagraph'nın bu sürümünü kullanın.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
paragraph | Paragraph | Eklenecek paragraf. |
Return
Paragraph: Eklenen paragraf.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
appendParagraph(text)
Belirtilen metin içeriklerini içeren yeni bir Paragraph oluşturur ve ekler.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
text | String | Paragrafın metin içerikleri. |
Return
Paragraph: Yeni paragraf.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
appendTable()
Yeni bir Table oluşturur ve ekler.
Google Dokümanlar belgeleri tabloyla bitirilemediğinden bu yöntem, tablonun sonuna boş bir paragraf da ekler.
Return
Table: Yeni tablo.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
appendTable(cells)
Belirtilen her dize değeri için TableCell içeren yeni bir Table ekler.
Google Dokümanlar belgeleri tabloyla bitirilemediğinden bu yöntem, tablonun sonuna boş bir paragraf da ekler.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
cells | String[][] | Yeni tabloya eklenecek tablo hücrelerinin metin içerikleri. |
Return
Table: Eklenen tablo.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
appendTable(table)
Belirtilen Table eklenir.
Mevcut bir Table kopyasını eklerken appendTable'nın bu sürümünü kullanın.
Google Dokümanlar belgeleri tabloyla bitirilemediğinden bu yöntem, tablonun sonuna boş bir paragraf da ekler.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
table | Table | Eklenecek tablo. |
Return
Table: Eklenen tablo.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
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
Body: Yeni kopya.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
editAsText()
Düzenlemek için mevcut öğenin Text sürümünü alır.
Öğelerin içeriğini zengin metin olarak değiştirmek için editAsText kullanın. editAsText modu, metin olmayan öğeleri (ör. InlineImage ve HorizontalRule) yoksayar.
Silinen metin aralığında tamamen yer alan 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: Geçerli öğenin metin sürümü
findElement(elementType)
Öğenin içeriğinde, belirtilen türde bir alt öğe arar.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
element | Element | Aranacak öğe türü. |
Return
RangeElement|null: Arama öğesinin konumunu gösteren bir arama sonucu.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
findElement(elementType, from)
Belirtilen RangeElement ile başlayarak, belirtilen türde bir alt öğe için öğenin içeriğini 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
RangeElement|null: Arama öğesinin sonraki konumunu gösteren bir arama sonucu.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
findText(searchPattern)
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ı, mevcut öğede bulunan her metin bloğuyla bağımsız olarak eşleştirilir.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
search | String | Aranacak desen |
Return
RangeElement|null — arama metninin konumunu gösteren bir arama sonucu veya eşleşme yoksa null
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
findText(searchPattern, from)
Belirtilen metin kalıbını, belirli bir arama sonucundan başlayarak öğenin içeriğinde 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ı, mevcut öğede bulunan her metin bloğuyla bağımsız olarak eşleştirilir.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
search | String | Aranacak desen |
from | Range | Arama yapılacak arama sonucu |
Return
RangeElement|null: Arama metninin bir sonraki konumunu gösteren bir arama sonucu veya eşleşme yoksa null
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
getAttributes()
Öğenin özelliklerini alır.
Sonuç, her geçerli öğe özelliği için bir özellik içeren bir nesnedir. Her özellik adı, DocumentApp.Attribute numaralandırmasındaki 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ı, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
getChild(childIndex)
Belirtilen alt dizindeki 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ı, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
getChildIndex(child)
Belirtilen alt öğenin alt dizinini alır.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
child | Element | Dizinin alınacağı alt öğe. |
Return
Integer: Çocuk dizini.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
getHeadingAttributes(paragraphHeading)
Belirtilen ParagraphHeading için özellikler grubunu alır.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
paragraph | Paragraph | Özellikleri alınacak başlık. |
Return
Object: Özelliklerin ve mevcut değerlerinin haritası.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
getImages()
Bölümde bulunan tüm InlineImages öğelerini alır.
Return
InlineImage[]|null: Bölüm resimleri.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
getListItems()
Bölümde bulunan tüm ListItems öğelerini alır.
Return
ListItem[]|null: Bölüm listesi öğeleri.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
getMarginBottom()
Alt kenar boşluğunu puan cinsinden alır.
Return
Number|null: Alt kenar boşluğu (punto cinsinden).
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
getMarginLeft()
Sol kenar boşluğunu puan cinsinden alır.
Return
Number|null: Sol kenar boşluğu (punto cinsinden).
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
getMarginRight()
Sağ kenar boşluğunu alır.
Return
Number|null: Sağ kenar boşluğu (nokta cinsinden).
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
getMarginTop()
Üst kenar boşluğunu alır.
Return
Number|null: Üst kenar boşluğu (puan cinsinden).
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
getNumChildren()
Ç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ı, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
getPageHeight()
Sayfa yüksekliğini (puan cinsinden) alır.
Return
Number|null: Sayfa yüksekliği (nokta cinsinden).
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
getPageWidth()
Sayfa genişliğini puan cinsinden alır.
Return
Number|null: Sayfa genişliği (punto cinsinden).
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
getParagraphs()
Bölümde bulunan tüm Paragraphs öğelerini (ListItems dahil) alır.
Return
Paragraph[]|null: Bölüm paragrafları.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
getParent()
Öğenin üst öğesini alır.
Üst öğe, geçerli öğeyi içerir.
Return
ContainerElement|null: Üst öğe.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
getTables()
Bölümde bulunan tüm Tables öğelerini alır.
Return
Table[]|null: Bölüm tabloları.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
getText()
Öğ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ı, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
getTextAlignment()
Metin hizalamasını alır. Kullanılabilir hizalama türleri DocumentApp.TextAlignment.NORMAL, DocumentApp.TextAlignment.SUBSCRIPT ve DocumentApp.TextAlignment.SUPERSCRIPT'dir.
Return
TextAlignment|null: Metin hizalama türü veya metin birden fazla metin hizalama türü içeriyorsa ya da metin hizalama hiç ayarlanmamışsa null
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
getType()
Öğenin ElementType değerini alır.
Belirli bir öğenin tam türünü belirlemek için getType() 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
ElementType: Öğe türü.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
insertHorizontalRule(childIndex)
Belirtilen dizinde yeni bir HorizontalRule oluşturur ve ekler.
HorizontalRule, yeni bir Paragraph içinde yer alır.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
child | Integer | Öğenin ekleneceği dizin. |
Return
HorizontalRule — Yeni yatay kural.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
insertImage(childIndex, image)
Belirtilen görüntü blob'undan belirtilen dizinde bir InlineImage oluşturur ve ekler.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
child | Integer | Öğenin ekleneceği dizin. |
image | Blob | Resim verileri. |
Return
InlineImage: Eklenen satır içi resim.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
insertImage(childIndex, image)
Belirtilen dizine verilen InlineImage öğesini ekler.
Resim, yeni bir Paragraph içinde yer alır.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
child | Integer | Öğenin ekleneceği dizin. |
image | Inline | Eklenecek resim. |
Return
InlineImage: Eklenen satır içi resim.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
insertListItem(childIndex, listItem)
Belirtilen dizine verilen ListItem öğesini ekler.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
child | Integer | Ekleme yapılacak dizin. |
list | List | Eklenecek liste öğesi. |
Return
ListItem: Eklenen liste öğesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
insertListItem(childIndex, text)
Belirtilen dizinde, belirtilen metin içeriğini içeren yeni bir ListItem oluşturup ekler.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
child | Integer | Ekleme yapılacak dizin. |
text | String | Liste öğesinin metin içerikleri. |
Return
ListItem: Yeni liste öğesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
insertPageBreak(childIndex)
Belirtilen dizinde yeni bir PageBreak oluşturur ve ekler.
PageBreak, yeni bir Paragraph içinde yer alır.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
child | Integer | Öğenin ekleneceği dizin. |
Return
PageBreak: Yeni sayfa sonu.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
insertPageBreak(childIndex, pageBreak)
Belirtilen dizine verilen PageBreak öğesini ekler.
PageBreak, yeni bir Paragraph içinde yer alır.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
child | Integer | Öğenin ekleneceği dizin. |
page | Page | Eklenecek sayfa sonu. |
Return
PageBreak: Eklenen sayfa sonu.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
insertParagraph(childIndex, paragraph)
Belirtilen dizine verilen Paragraph öğesini ekler.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
child | Integer | Ekleme yapılacak dizin. |
paragraph | Paragraph | Eklenecek paragraf. |
Return
Paragraph: Eklenen paragraf.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
insertParagraph(childIndex, text)
Belirtilen dizinde, belirtilen metin içeriğini içeren yeni bir Paragraph oluşturup ekler.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
child | Integer | Ekleme yapılacak dizin. |
text | String | Paragrafın metin içerikleri. |
Return
Paragraph: Yeni paragraf.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
insertTable(childIndex)
Belirtilen dizinde yeni bir Table oluşturur ve ekler.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
child | Integer | Ekleme yapılacak dizin. |
Return
Table: Yeni tablo.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
insertTable(childIndex, cells)
Belirtilen hücreleri içeren yeni bir Table oluşturup belirtilen dizine ekler.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
child | Integer | Ekleme yapılacak dizin. |
cells | String[][] | Yeni tabloya eklenecek tablo hücrelerinin metin içerikleri. |
Return
Table: Yeni tablo.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
insertTable(childIndex, table)
Belirtilen dizine verilen Table öğesini ekler.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
child | Integer | Ekleme yapılacak dizin. |
table | Table | Eklenecek tablo. |
Return
Table: Eklenen tablo.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
removeChild(child)
Belirtilen alt öğeyi kaldırır.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
child | Element | Kaldırılacak alt öğe. |
Return
Body: Geçerli öğe.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
replaceText(searchPattern, replacement)
Normal ifadeleri kullanarak belirli bir metin kalıbının tüm örneklerini belirli bir yeni dizeyle değiştirir.
Arama kalıbı, JavaScript normal ifade nesnesi olarak değil, dize olarak iletilir. Bu nedenle, desendeki tüm ters eğik çizgileri çıkış karakteriyle belirtmeniz 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ı, mevcut öğ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ştirme için kullanılacak metin |
Return
Element: Geçerli öğe
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
setAttributes(attributes)
Öğenin özelliklerini ayarlar.
Belirtilen özellikler parametresi, her özellik adının DocumentApp.Attribute numaralandırmasındaki bir öğe ve her ö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
Body: Geçerli öğe.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
setHeadingAttributes(paragraphHeading, attributes)
Sağlanan ParagraphHeading için özellikleri ayarlar.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
paragraph | Paragraph | Özellikleri ayarlanacak başlık. |
attributes | Object | Özelliklerin ve ayarlanacak değerlerin haritası. |
Return
Body: Geçerli öğe.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
setMarginBottom(marginBottom)
Alt kenar boşluğunu punto cinsinden ayarlar.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
margin | Number | Alt kenar boşluğu (nokta cinsinden). |
Return
Body: Geçerli öğe.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
setMarginLeft(marginLeft)
Sol kenar boşluğunu punto cinsinden ayarlar.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
margin | Number | Sol kenar boşluğu (nokta cinsinden). |
Return
Body: Geçerli öğe.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
setMarginRight(marginRight)
Sağ kenar boşluğunu puan cinsinden ayarlar.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
margin | Number | Sağ kenar boşluğu. |
Return
Body: Geçerli öğe.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
setMarginTop(marginTop)
Üst kenar boşluğunu ayarlar.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
margin | Number | Üst kenar boşluğu (nokta cinsinden). |
Return
Body: Geçerli öğe.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
setPageHeight(pageHeight)
Sayfa yüksekliğini punto cinsinden ayarlar.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
page | Number | Sayfa yüksekliği (nokta cinsinden). |
Return
Body: Geçerli öğe.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
setPageWidth(pageWidth)
Sayfa genişliğini punto cinsinden ayarlar.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
page | Number | Sayfa genişliği (nokta cinsinden). |
Return
Body: Geçerli öğe.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
setText(text)
İçeriği düz metin olarak ayarlar.
Not: Mevcut içerikler temizlenir.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
text | String | Yeni metin içerikleri. |
Return
Body: Geçerli öğe.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
setTextAlignment(textAlignment)
Metin hizalamasını ayarlar. Kullanılabilir hizalama türleri DocumentApp.TextAlignment.NORMAL, DocumentApp.TextAlignment.SUBSCRIPT ve DocumentApp.TextAlignment.SUPERSCRIPT'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 hizalama türü |
Return
Body: Geçerli öğe
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents