Google Dokümanlar dokümanında bir sekmenin içeriği. Body
, List
, Paragraph
, Table
ve Table
öğeleri içerebilir. Doküman yapısı hakkında daha fazla bilgi için Google Dokümanlar'ı genişletme kılavuzuna bakın.
Body
, genellikle Header
, Footer
ve Footnote
öğeleri hariç sekmenin tüm içeriğini içerir.
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şturup ekler. |
append | Inline | Belirtilen resim blob'undan yeni bir Inline oluşturup ekler. |
append | Inline | Belirtilen Inline değerini ekler. |
append | List | Belirtilen List değerini ekler. |
append | List | Belirtilen metin içeriklerini içeren yeni bir List oluşturur ve ekler. |
append | Page | Yeni bir Page oluşturup ekler. |
append | Page | Belirtilen Page değerini ekler. |
append | Paragraph | Belirtilen Paragraph değerini ekler. |
append | Paragraph | Belirtilen metin içeriklerini içeren yeni bir Paragraph oluşturur ve ekler. |
append | Table | Yeni bir Table oluşturup ekler. |
append | Table | Belirtilen her dize değeri için Table içeren yeni bir Table ekler. |
append | Table | Belirtilen Table değerini ekler. |
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ğ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 | 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 | Object | Sağlanan Paragraph için özellik grubunu alır. |
get | Inline | Bölümdeki tüm Inline öğelerini alır. |
get | List | Bölümdeki tüm List öğelerini alır. |
get | Number | Alt kenar boşluğunu nokta cinsinden alır. |
get | Number | Sol kenar boşluğunu nokta cinsinden alır. |
get | Number | Doğru kenar boşluğunu alır. |
get | Number | Üst kenar boşluğunu alır. |
get | Integer | Çocuk sayısını alır. |
get | Number | Sayfanın yüksekliğini puan cinsinden alır. |
get | Number | Sayfa genişliğini puan cinsinden alır. |
get | Paragraph[] | Bölümde bulunan tüm Paragraphs öğelerini (List dahil) alır. |
get | Container | Öğenin üst öğesini alır. |
get | Table[] | Bölümdeki 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şturup ekler. |
insert | Inline | Belirtilen resim blob'undan, belirtilen dizinde bir Inline oluşturup ekler. |
insert | Inline | Belirtilen Inline öğesini belirtilen dizin içine ekler. |
insert | List | Belirtilen List öğesini belirtilen dizin içine ekler. |
insert | List | Belirtilen dizinde, belirtilen metin içeriklerini içeren yeni bir List oluşturup ekler. |
insert | Page | Belirtilen dizinde yeni bir Page oluşturup ekler. |
insert | Page | Belirtilen Page öğesini belirtilen dizin içine ekler. |
insert | Paragraph | Belirtilen Paragraph öğesini belirtilen dizin içine ekler. |
insert | Paragraph | Belirtilen dizinde, belirtilen metin içeriklerini içeren yeni bir Paragraph oluşturup ekler. |
insert | Table | Belirtilen dizinde yeni bir Table oluşturup ekler. |
insert | Table | Belirtilen dizinde, belirtilen hücreleri içeren yeni bir Table oluşturup ekler. |
insert | Table | Belirtilen Table öğesini belirtilen dizin içine ekler. |
remove | Body | Belirtilen alt öğeyi kaldı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 | 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 nokta 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. |
Kullanımdan kaldırılan yöntemler
Yöntem | Dönüş türü | Kısa açıklama |
---|---|---|
| Footnote[] | Bölümdeki tüm Footnotes öğelerini alır. |
| String | Bağlantı URL'sini alır. |
| Element | Öğenin sonraki kardeş öğesini alır. |
| Element | Öğenin önceki kardeş öğesini alır. |
| Boolean | Öğenin Document 'ün sonunda olup olmadığını belirler. |
| Body | Bağlantı URL'sini ayarlar. |
Ayrıntılı dokümanlar
appendHorizontalRule()
Yeni bir Horizontal
oluşturup ekler.
Horizontal
, yeni bir Paragraph
içinde yer alır.
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
appendImage(image)
Belirtilen resim blob'undan yeni bir Inline
oluşturup ekler.
Resim yeni bir Paragraph
içinde yer alır.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
image | Blob | Resim verileri. |
Return
Inline
: Eklenmiş 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
appendImage(image)
Belirtilen Inline
değerini ekler.
Inline
, yeni bir Paragraph
içinde yer alır.
Mevcut bir Inline
öğesinin kopyasını eklerken append
öğesinin bu sürümünü kullanın.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
image | Inline | Resim verileri. |
Return
Inline
: Eklenmiş 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
appendListItem(listItem)
Belirtilen List
değerini ekler.
Mevcut bir List
öğesinin kopyasını eklerken append
öğesinin bu sürümünü kullanın.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
list | List | Eklenecek liste öğesi. |
Return
List
: Eklenen liste öğ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
appendListItem(text)
Belirtilen metin içeriklerini içeren yeni bir List
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çeriği. |
Return
List
: Yeni liste öğ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
appendPageBreak()
Yeni bir Page
oluşturup ekler.
Page
, yeni bir Paragraph
içinde yer alır.
Return
Page
: Yeni sayfa sonu.
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
appendPageBreak(pageBreak)
Belirtilen Page
değerini ekler.
Page
, yeni bir Paragraph
içinde yer alır.
Mevcut bir Page
öğesinin kopyasını eklerken append
öğesinin bu sürümünü kullanın.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
page | Page | Eklenecek sayfa sonu. |
Return
Page
: Eklenen sayfa sonu.
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
appendParagraph(paragraph)
Belirtilen Paragraph
değerini ekler.
Mevcut bir Paragraph
öğesinin kopyasını eklerken append
öğesinin 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ı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
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çeriği. |
Return
Paragraph
: Yeni paragraf.
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
appendTable()
Yeni bir Table
oluşturup ekler.
Google Dokümanlar dokümanları tabloyla sonlanamayacağından bu yöntem, tablodan sonra boş bir paragraf da ekler.
Return
Table
: Yeni tablo.
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
appendTable(cells)
Belirtilen her dize değeri için Table
içeren yeni bir Table
ekler.
Google Dokümanlar dokümanları tabloyla sonlanamayacağından bu yöntem, tablodan sonra 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ı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
appendTable(table)
Belirtilen Table
değerini ekler.
Mevcut bir Table
öğesinin kopyasını eklerken append
öğesinin bu sürümünü kullanın.
Google Dokümanlar dokümanları tabloyla sonlanamayacağından bu yöntem, tablodan sonra 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ı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
Body
: 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
editAsText()
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ü
findElement(elementType)
Öğ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
findElement(elementType, from)
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
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ı, 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
findText(searchPattern, from)
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
getAttributes()
Öğ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
getChild(childIndex)
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
getChildIndex(child)
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
getHeadingAttributes(paragraphHeading)
Sağlanan Paragraph
için özellik grubunu alır.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
paragraph | Paragraph | Özellikleri alınması gereken başlık. |
Return
Object
: Özelliklerin ve mevcut değerlerinin haritası.
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
getImages()
Bölümdeki tüm Inline
öğelerini alır.
Return
Inline
: Bölüm resimleri.
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
getListItems()
Bölümdeki tüm List
öğelerini alır.
Return
List
: Bölüm listesi öğeleri.
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
getMarginBottom()
Alt kenar boşluğunu nokta cinsinden alır.
Return
Number
: Alt kenar boşluğu (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
getMarginLeft()
Sol kenar boşluğunu nokta cinsinden alır.
Return
Number
: Sol kenar boşluğu, 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
getMarginRight()
Doğru kenar boşluğunu alır.
Return
Number
: Sağ kenar boşluğu, 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
getMarginTop()
Üst kenar boşluğunu alır.
Return
Number
: Üst kenar boşluğu (noktada).
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
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ı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
getPageHeight()
Sayfanın yüksekliğini puan cinsinden alır.
Return
Number
: Sayfa yüksekliği (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
getPageWidth()
Sayfa genişliğini puan cinsinden alır.
Return
Number
: Sayfa genişliği (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
getParagraphs()
Bölümde bulunan tüm Paragraphs
öğelerini (List
dahil) alır.
Return
Paragraph[]
: Bölüm paragrafları.
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
getParent()
Öğ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
getTables()
Bölümdeki tüm Tables
öğelerini alır.
Return
Table[]
: Bölüm tabloları.
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
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ı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
getTextAlignment()
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
getType()
Öğ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
insertHorizontalRule(childIndex)
Belirtilen dizinde yeni bir Horizontal
oluşturup ekler.
Horizontal
, yeni bir Paragraph
içinde yer alır.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
child | Integer | Öğenin ekleneceği dizin. |
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
insertImage(childIndex, image)
Belirtilen resim blob'undan, belirtilen dizinde bir Inline
oluşturup 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.
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
insertImage(childIndex, image)
Belirtilen Inline
öğesini belirtilen dizin içine 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
Inline
: Eklenen satır içi 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
insertListItem(childIndex, listItem)
Belirtilen List
öğesini belirtilen dizin içine ekler.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
child | Integer | Eklemenin yapılacağı dizin. |
list | List | Eklenecek liste öğesi. |
Return
List
: Eklenen liste öğ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
insertListItem(childIndex, text)
Belirtilen dizinde, belirtilen metin içeriklerini içeren yeni bir List
oluşturup ekler.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
child | Integer | Eklemenin yapılacağı dizin. |
text | String | Liste öğesinin metin içeriği. |
Return
List
: Yeni liste öğ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
insertPageBreak(childIndex)
Belirtilen dizinde yeni bir Page
oluşturup ekler.
Page
, yeni bir Paragraph
içinde yer alır.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
child | Integer | Öğenin ekleneceği dizin. |
Return
Page
: Yeni sayfa sonu.
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
insertPageBreak(childIndex, pageBreak)
Belirtilen Page
öğesini belirtilen dizin içine ekler.
Page
, 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
Page
: Eklenen sayfa sonu.
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
insertParagraph(childIndex, paragraph)
Belirtilen Paragraph
öğesini belirtilen dizin içine ekler.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
child | Integer | Eklemenin yapılacağı dizin. |
paragraph | Paragraph | Eklenecek paragraf. |
Return
Paragraph
: Eklenen paragraf.
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
insertParagraph(childIndex, text)
Belirtilen dizinde, belirtilen metin içeriklerini içeren yeni bir Paragraph
oluşturup ekler.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
child | Integer | Eklemenin yapılacağı dizin. |
text | String | Paragrafın metin içeriği. |
Return
Paragraph
: Yeni paragraf.
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
insertTable(childIndex)
Belirtilen dizinde yeni bir Table
oluşturup ekler.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
child | Integer | Eklemenin yapılacağı dizin. |
Return
Table
: Yeni tablo.
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
insertTable(childIndex, cells)
Belirtilen dizinde, belirtilen hücreleri içeren yeni bir Table
oluşturup ekler.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
child | Integer | Eklemenin yapılacağı dizin. |
cells | String[][] | Yeni tabloya eklenecek tablo hücrelerinin metin içerikleri. |
Return
Table
: Yeni tablo.
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
insertTable(childIndex, table)
Belirtilen Table
öğesini belirtilen dizin içine ekler.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
child | Integer | Eklemenin yapılacağı dizin. |
table | Table | Eklenecek tablo. |
Return
Table
: Eklenen tablo.
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
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ı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
replaceText(searchPattern, replacement)
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
setAttributes(attributes)
Öğ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
Body
: 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
setHeadingAttributes(paragraphHeading, attributes)
Sağlanan Paragraph
için özellikleri ayarlar.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
paragraph | Paragraph | Özellikleri ayarlanması gereken başlık. |
attributes | Object | Özelliklerin ve ayarlanacağı değerlerin haritası. |
Return
Body
: 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
setMarginBottom(marginBottom)
Alt kenar boşluğunu punto cinsinden ayarlar.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
margin | Number | Alt kenar boşluğu (noktada). |
Return
Body
: 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
setMarginLeft(marginLeft)
Sol kenar boşluğunu punto cinsinden ayarlar.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
margin | Number | Sol kenar boşluğu (punto cinsinden). |
Return
Body
: 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
setMarginRight(marginRight)
Sağ kenar boşluğunu nokta 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ı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
setMarginTop(marginTop)
Üst kenar boşluğunu ayarlar.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
margin | Number | Üst kenar boşluğu (noktada). |
Return
Body
: 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
setPageHeight(pageHeight)
Sayfa yüksekliğini punto cinsinden ayarlar.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
page | Number | Sayfa yüksekliği (noktalar cinsinden). |
Return
Body
: 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
setPageWidth(pageWidth)
Sayfa genişliğini punto cinsinden ayarlar.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
page | Number | Sayfa genişliği (noktalar cinsinden). |
Return
Body
: 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
setText(text)
İçeriği düz metin olarak ayarlar.
Not: Mevcut içerikler silinir.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
text | String | Yeni metin içerikleri. |
Return
Body
: 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
setTextAlignment(textAlignment)
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
Body
: 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
Kullanımdan kaldırılan yöntemler
getFootnotes()
getFootnotes()
Kullanımdan kaldırıldı. Bu öğe Footnote
içeremez.
Bölümdeki tüm Footnotes
öğelerini alır.
Return
Footnote[]
: Bölüm dipnotları.
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
getLinkUrl()
getLinkUrl()
Kullanımdan kaldırıldı. Bağlantıyı bölümün tamamına uygulamak yerine bölümdeki bir öğeye uygulayın.
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
getNextSibling()
getNextSibling()
Kullanımdan kaldırıldı. Bu öğenin kardeşi yok.
Öğ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
getPreviousSibling()
getPreviousSibling()
Kullanımdan kaldırıldı. Bu öğenin kardeşi yok.
Öğ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
isAtDocumentEnd()
isAtDocumentEnd()
Kullanımdan kaldırıldı. Bu yöntem, Header
için güvenilir değildir.
Öğ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
setLinkUrl(url)
setLinkUrl(url)
Kullanımdan kaldırıldı. Bağlantıyı bölümün tamamına uygulamak yerine bölümdeki bir öğeye uygulayın.
Bağlantı URL'sini ayarlar.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
url | String | bağlantı URL'si |
Return
Body
: 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