Google Dokümanlar dokümanındaki bir sekmenin içeriği. Body
, ListItem
,
Paragraph
, Table
ve TableOfContents
öğeleri. Daha fazla bilgi için
hakkında daha fazla bilgi edinmek için
Dokümanlar'ın kapsamını genişletme.
Body
genellikle HeaderSection
, FooterSection
ve FootnoteSection
öğeleri dışında sekmenin tüm içeriğini içerir.
var 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 |
---|---|---|
appendHorizontalRule() | HorizontalRule | Yeni bir HorizontalRule oluşturur ve ekler. |
appendImage(image) | InlineImage | Belirtilen görüntü blobundan yeni bir InlineImage oluşturur ve ekler. |
appendImage(image) | InlineImage | Belirtilen InlineImage öğesini ekler. |
appendListItem(listItem) | ListItem | Belirtilen ListItem öğesini ekler. |
appendListItem(text) | ListItem | Belirtilen metin içeriğini içeren yeni bir ListItem oluşturur ve ekler. |
appendPageBreak() | PageBreak | Yeni bir PageBreak oluşturur ve ekler. |
appendPageBreak(pageBreak) | PageBreak | Belirtilen PageBreak öğesini ekler. |
appendParagraph(paragraph) | Paragraph | Belirtilen Paragraph öğesini ekler. |
appendParagraph(text) | Paragraph | Belirtilen metin içeriğini içeren yeni bir Paragraph oluşturur ve ekler. |
appendTable() | Table | Yeni bir Table oluşturur ve ekler. |
appendTable(cells) | Table | Belirtilen her dize değeri için TableCell içeren yeni bir Table ekler. |
appendTable(table) | Table | Belirtilen Table öğesini ekler. |
clear() | Body | Öğenin içeriğini temizler. |
copy() | Body | Geçerli öğenin ayrılmış, derin bir kopyasını döndürür. |
editAsText() | Text | Düzenleme için geçerli öğenin Text sürümünü alır. |
findElement(elementType) | RangeElement | Öğenin içeriğinde, belirtilen türün bir alt öğesini arar. |
findElement(elementType, from) | RangeElement | Öğenin içeriğinde,
belirtilen RangeElement . |
findText(searchPattern) | RangeElement | Normal ifadeler kullanarak belirtilen metin kalıbı için öğenin içeriğinde arama yapar. |
findText(searchPattern, from) | RangeElement | Belirli bir değerden başlayarak belirtilen metin kalıbı için öğenin içeriğinde arama yapar emin olun. |
getAttributes() | Object | Öğenin özelliklerini alır. |
getChild(childIndex) | Element | Belirtilen alt dizindeki alt öğeyi alır. |
getChildIndex(child) | Integer | Belirtilen alt öğe için alt dizini alır. |
getHeadingAttributes(paragraphHeading) | Object | Sağlanan ParagraphHeading için özellik grubunu alır. |
getImages() | InlineImage[] | Bölümde yer alan tüm InlineImages öğelerini alır. |
getListItems() | ListItem[] | Bölümde yer alan tüm ListItems öğelerini alır. |
getMarginBottom() | Number | Nokta cinsinden alt kenar boşluğunu alır. |
getMarginLeft() | Number | Sol kenar boşluğunu punto olarak alır. |
getMarginRight() | Number | Sağ kenar boşluğunu alır. |
getMarginTop() | Number | Üst kenar boşluğunu alır. |
getNumChildren() | Integer | Alt öğelerin sayısını alır. |
getPageHeight() | Number | Sayfa yüksekliğini punto cinsinden alır. |
getPageWidth() | Number | Nokta cinsinden sayfa genişliğini alır. |
getParagraphs() | Paragraph[] | Bölümde yer alan tüm Paragraphs öğelerini (ListItems dahil) alır. |
getParent() | ContainerElement | Öğenin üst öğesini alır. |
getTables() | Table[] | Bölümde yer alan tüm Tables öğelerini alır. |
getText() | String | Öğenin içeriğini bir metin dizesi olarak alır. |
getTextAlignment() | TextAlignment | Metin hizalamasını getirir. |
getType() | ElementType | Öğenin ElementType değerini alır. |
insertHorizontalRule(childIndex) | HorizontalRule | Yeni bir HorizontalRule oluşturur ve belirtilen dizine ekler. |
insertImage(childIndex, image) | InlineImage | Belirtilen konumda, belirtilen görüntü blobundan bir InlineImage oluşturur ve ekler
dizin. |
insertImage(childIndex, image) | InlineImage | Verilen InlineImage öğesini belirtilen dizine ekler. |
insertListItem(childIndex, listItem) | ListItem | Verilen ListItem öğesini belirtilen dizine ekler. |
insertListItem(childIndex, text) | ListItem | Belirtilen dizinde, belirtilen dizini içeren yeni bir ListItem oluşturur ve ekler
metin içeriği. |
insertPageBreak(childIndex) | PageBreak | Yeni bir PageBreak oluşturur ve belirtilen dizine ekler. |
insertPageBreak(childIndex, pageBreak) | PageBreak | Verilen PageBreak öğesini belirtilen dizine ekler. |
insertParagraph(childIndex, paragraph) | Paragraph | Verilen Paragraph öğesini belirtilen dizine ekler. |
insertParagraph(childIndex, text) | Paragraph | Belirtilen dizinde, belirtilen dizini içeren yeni bir Paragraph oluşturur ve ekler
metin içeriği. |
insertTable(childIndex) | Table | Yeni bir Table oluşturur ve belirtilen dizine ekler. |
insertTable(childIndex, cells) | Table | Belirtilen hücreleri içeren yeni bir Table oluşturur ve belirtilen dizine ekler. |
insertTable(childIndex, table) | Table | Verilen Table öğesini belirtilen dizine ekler. |
removeChild(child) | Body | Belirtilen alt öğeyi kaldırır. |
replaceText(searchPattern, replacement) | Element | Belirli bir metin kalıbının tüm tekrarlarını, normal değer kullanarak belirli bir değiştirme dizesiyle değiştirir ifade eder. |
setAttributes(attributes) | Body | Öğenin özelliklerini ayarlar. |
setHeadingAttributes(paragraphHeading, attributes) | Body | Sağlanan ParagraphHeading için özellikleri ayarlar. |
setMarginBottom(marginBottom) | Body | Alt kenar boşluğunu punto olarak ayarlar. |
setMarginLeft(marginLeft) | Body | Sol kenar boşluğunu punto olarak ayarlar. |
setMarginRight(marginRight) | Body | Puan olarak sağ kenar boşluğunu ayarlar. |
setMarginTop(marginTop) | Body | Üst kenar boşluğunu ayarlar. |
setPageHeight(pageHeight) | Body | Sayfa yüksekliğini punto olarak ayarlar. |
setPageWidth(pageWidth) | Body | Sayfa genişliğini punto olarak ayarlar. |
setText(text) | Body | İçeriği düz metin olarak ayarlar. |
setTextAlignment(textAlignment) | Body | Metin hizalamasını ayarlar. |
Ayrıntılı belgeler
appendHorizontalRule()
Yeni bir HorizontalRule
oluşturur ve ekler.
HorizontalRule
, yeni bir Paragraph
içinde yer alacak.
Return
HorizontalRule
— Yeni yatay kural.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
appendImage(image)
Belirtilen görüntü blobundan yeni bir InlineImage
oluşturur ve ekler.
Resim, yeni bir Paragraph
klasöründe yer alacaktır.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
image | BlobSource | Resim verileri. |
Return
InlineImage
— Eklenen resim.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
appendImage(image)
Belirtilen InlineImage
öğesini ekler.
InlineImage
, yeni bir Paragraph
içinde yer alacak.
Mevcut bir InlineImage
kopyasını eklerken bu appendImage
sürümünü kullanın.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
image | InlineImage | Resim verileri. |
Return
InlineImage
— Eklenen resim.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
appendListItem(listItem)
Belirtilen ListItem
öğesini ekler.
Mevcut bir ListItem
kopyasını eklerken bu appendListItem
sürümünü kullanın.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
listItem | ListItem | Eklenecek liste öğesi. |
Return
ListItem
— Eklenen liste öğesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
appendListItem(text)
Belirtilen metin içeriğini 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çeriği. |
Return
ListItem
— Yeni liste öğesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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 alacak.
Return
PageBreak
— Yeni sayfa sonu.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
appendPageBreak(pageBreak)
Belirtilen PageBreak
öğesini ekler.
PageBreak
, yeni bir Paragraph
içinde yer alacak.
Mevcut bir PageBreak
kopyasını eklerken bu appendPageBreak
sürümünü kullanın.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
pageBreak | PageBreak | Eklenecek sayfa sonu. |
Return
PageBreak
: Eklenen sayfa sonu.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
appendParagraph(paragraph)
Belirtilen Paragraph
öğesini ekler.
Mevcut bir Paragraph
kopyasını eklerken bu appendParagraph
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 bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
appendParagraph(text)
Belirtilen metin içeriğini 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ı, aşağıdaki kapsamlardan bir 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.
Bu yöntem ayrıca tablonun arkasına boş bir paragraf ekler çünkü Google Dokümanlar bir tabloyla bitemez.
Return
Table
: Yeni tablo.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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.
Bu yöntem ayrıca tablonun arkasına boş bir paragraf ekler çünkü Google Dokümanlar bir tabloyla bitemez.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
cells | String[][] | Yeni tabloya eklenecek tablo hücrelerinin metin içeriği. |
Return
Table
: Eklenen tablo.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
appendTable(table)
Belirtilen Table
öğesini ekler.
Mevcut bir Table
kopyasını eklerken bu appendTable
sürümünü kullanın.
Bu yöntem ayrıca tablonun arkasına boş bir paragraf ekler çünkü Google Dokümanlar
bir tabloyla bitemez.
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 bir 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 öğede üst öğesidir.
Return
Body
— Yeni kopya.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
editAsText()
Düzenleme için geçerli öğenin Text
sürümünü alır.
Öğe içeriklerini zengin metin olarak değiştirmek için editAsText
kullanın. editAsText
modu, metin olmayan öğeleri (InlineImage
ve HorizontalRule
gibi) yoksayar.
Silinmiş bir metin aralığında tamamen yer alan alt öğeler öğeden kaldırılır.
var 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ürün bir alt öğesini arar.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
elementType | ElementType | Aranacak öğenin türü. |
Return
RangeElement
: Arama öğesinin konumunu gösteren bir arama sonucu.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
findElement(elementType, from)
Öğenin içeriğinde,
belirtilen RangeElement
.
var body = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody(); // Define the search parameters. var searchType = DocumentApp.ElementType.PARAGRAPH; var searchHeading = DocumentApp.ParagraphHeading.HEADING1; var searchResult = null; // Search until the paragraph is found. while (searchResult = body.findElement(searchType, searchResult)) { var par = searchResult.getElement().asParagraph(); if (par.getHeading() == searchHeading) { // Found one, update and stop. par.setText('This is the first header.'); return; } }
Parametreler
Ad | Tür | Açıklama |
---|---|---|
elementType | ElementType | Aranacak öğenin türü. |
from | RangeElement | Arama yapılacak arama sonucu. |
Return
RangeElement
: Arama öğesinin sonraki konumunu gösteren arama sonucu.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
findText(searchPattern)
Normal ifadeler kullanarak belirtilen metin kalıbı için öğenin içeriğinde arama yapar.
JavaScript normal ifade özelliklerinin bir alt kümesi tam olarak desteklenmiyor; örneğin, ve mod değiştiricileri yakalayabilirsiniz.
Sağlanan normal ifade kalıbı her metin bloğuyla bağımsız olarak eşleştirilir öğedir.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
searchPattern | String | aranacak kalıp |
Return
RangeElement
— arama metninin konumunu veya konumunu gösteren bir arama sonucu yoksa null
denk gelmek
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
findText(searchPattern, from)
Belirli bir değerden başlayarak belirtilen metin kalıbı için öğenin içeriğinde arama yapar emin olun.
JavaScript normal ifade özelliklerinin bir alt kümesi tam olarak desteklenmiyor; örneğin, ve mod değiştiricileri yakalayabilirsiniz.
Sağlanan normal ifade kalıbı her metin bloğuyla bağımsız olarak eşleştirilir öğedir.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
searchPattern | String | aranacak kalıp |
from | RangeElement | arama sonuçlarında |
Return
RangeElement
— arama metninin sonraki konumunu gösteren bir arama sonucu veya
denk gelmek
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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 bir geçerli öğe özelliği için bir özellik içeren
özellik adı, DocumentApp.Attribute
numaralandırmasındaki bir öğeye karşılık gelir.
var doc = DocumentApp.getActiveDocument(); var documentTab = doc.getActiveTab().asDocumentTab(); var body = documentTab.getBody(); // Append a styled paragraph. var par = body.appendParagraph('A bold, italicized paragraph.'); par.setBold(true); par.setItalic(true); // Retrieve the paragraph's attributes. var atts = par.getAttributes(); // Log the paragraph attributes. for (var att in atts) { Logger.log(att + ":" + atts[att]); }
Return
Object
: Öğenin özellikleri.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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.
var body = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody(); // Obtain the first element in the tab. var 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 |
---|---|---|
childIndex | Integer | Alınacak alt öğenin dizini. |
Return
Element
: Belirtilen dizindeki alt öğe.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getChildIndex(child)
Belirtilen alt öğe için alt dizini alır.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
child | Element | Dizinin alınacağı alt öğe. |
Return
Integer
— Alt dizin.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getHeadingAttributes(paragraphHeading)
Sağlanan ParagraphHeading
için özellik grubunu alır.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
paragraphHeading | ParagraphHeading | Özelliklerinin alınması gereken başlık. |
Return
Object
— Özelliklerin ve geçerli değerlerinin haritası.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getImages()
Bölümde yer alan tüm InlineImages
öğelerini alır.
Return
InlineImage[]
— Bölüm resimleri.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getListItems()
Bölümde yer alan tüm ListItems
öğelerini alır.
Return
ListItem[]
— Bölüm listesi öğeleri.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getMarginBottom()
Nokta cinsinden alt kenar boşluğunu alır.
Return
Number
: Puan cinsinden alt kenar boşluğu.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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 punto olarak alır.
Return
Number
: Puan cinsinden sol kenar boşluğu.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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
: Puan cinsinden sağ kenar boşluğu.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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
: Puan cinsinden üst kenar boşluğu.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getNumChildren()
Alt öğelerin sayısını alır.
var 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
— Alt öğelerin sayısı.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getPageHeight()
Sayfa yüksekliğini punto cinsinden alır.
Return
Number
— Puan cinsinden sayfa yüksekliği.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getPageWidth()
Nokta cinsinden sayfa genişliğini alır.
Return
Number
— Nokta cinsinden sayfa genişliği.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getParagraphs()
Bölümde yer alan tüm Paragraphs
öğelerini (ListItems
dahil) alır.
Return
Paragraph[]
— Bölüm paragrafları.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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çeriyor.
Return
ContainerElement
: Üst öğe.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getTables()
Bölümde yer alan tüm Tables
öğelerini alır.
Return
Table[]
: Bölüm tabloları.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getText()
Öğenin içeriğini bir metin dizesi olarak alır.
Return
String
: Metin dizesi olarak öğenin içeriği
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getTextAlignment()
Metin hizalamasını getirir. Kullanılabilir hizalama türleri şunlardır: DocumentApp.TextAlignment.NORMAL
, DocumentApp.TextAlignment.SUBSCRIPT
ve DocumentApp.TextAlignment.SUPERSCRIPT
.
Return
TextAlignment
: Metin hizalamasının türü veya metin birden fazla metin türü içeriyorsa null
veya metin hizalaması hiç ayarlanmamışsa
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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()
işlevini kullanın.
var doc = DocumentApp.getActiveDocument(); var documentTab = doc.getActiveTab().asDocumentTab(); var body = documentTab.getBody(); // Obtain the first element in the active tab's body. var 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 bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
insertHorizontalRule(childIndex)
Yeni bir HorizontalRule
oluşturur ve belirtilen dizine ekler.
HorizontalRule
, yeni bir Paragraph
içinde yer alacak.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
childIndex | Integer | Öğenin ekleneceği dizin. |
Return
HorizontalRule
— Yeni yatay kural.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
insertImage(childIndex, image)
Belirtilen konumda, belirtilen görüntü blobundan bir InlineImage
oluşturur ve ekler
dizin.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
childIndex | Integer | Öğenin ekleneceği dizin. |
image | BlobSource | Resim verileri. |
Return
InlineImage
— Eklenen satır içi resim.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
insertImage(childIndex, image)
Verilen InlineImage
öğesini belirtilen dizine ekler.
Resim, yeni bir Paragraph
klasöründe yer alacaktır.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
childIndex | Integer | Öğenin ekleneceği dizin. |
image | InlineImage | Eklenecek resim. |
Return
InlineImage
— Eklenen satır içi resim.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
insertListItem(childIndex, listItem)
Verilen ListItem
öğesini belirtilen dizine ekler.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
childIndex | Integer | Eklenecek dizin. |
listItem | ListItem | Eklenecek liste öğesi. |
Return
ListItem
— Eklenen liste öğesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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 dizini içeren yeni bir ListItem
oluşturur ve ekler
metin içeriği.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
childIndex | Integer | Eklenecek dizin. |
text | String | Liste öğesinin metin içeriği. |
Return
ListItem
— Yeni liste öğesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
insertPageBreak(childIndex)
Yeni bir PageBreak
oluşturur ve belirtilen dizine ekler.
PageBreak
, yeni bir Paragraph
içinde yer alacak.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
childIndex | Integer | Öğenin ekleneceği dizin. |
Return
PageBreak
— Yeni sayfa sonu.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
insertPageBreak(childIndex, pageBreak)
Verilen PageBreak
öğesini belirtilen dizine ekler.
PageBreak
, yeni bir Paragraph
içinde yer alacak.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
childIndex | Integer | Öğenin ekleneceği dizin. |
pageBreak | PageBreak | Eklenecek sayfa sonu. |
Return
PageBreak
— Eklenen sayfa sonu.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
insertParagraph(childIndex, paragraph)
Verilen Paragraph
öğesini belirtilen dizine ekler.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
childIndex | Integer | Eklenecek dizin. |
paragraph | Paragraph | Eklenecek paragraf. |
Return
Paragraph
— Eklenen paragraf.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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 dizini içeren yeni bir Paragraph
oluşturur ve ekler
metin içeriği.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
childIndex | Integer | Eklenecek dizin. |
text | String | Paragrafın metin içeriği. |
Return
Paragraph
: Yeni paragraf.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
insertTable(childIndex)
Yeni bir Table
oluşturur ve belirtilen dizine ekler.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
childIndex | Integer | Eklenecek dizin. |
Return
Table
: Yeni tablo.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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şturur ve belirtilen dizine ekler.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
childIndex | Integer | Eklenecek dizin. |
cells | String[][] | Yeni tabloya eklenecek tablo hücrelerinin metin içeriği. |
Return
Table
: Yeni tablo.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
insertTable(childIndex, table)
Verilen Table
öğesini belirtilen dizine ekler.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
childIndex | Integer | Eklenecek dizin. |
table | Table | Eklenecek tablo. |
Return
Table
: Eklenen tablo.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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 bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
replaceText(searchPattern, replacement)
Belirli bir metin kalıbının tüm tekrarlarını, normal değer kullanarak belirli bir değiştirme dizesiyle değiştirir ifade eder.
Arama kalıbı, JavaScript normal ifade nesnesi değil, dize olarak iletilir. Bu nedenle, kalıptaki ters eğik çizgilerden kaçınmanız gerekir.
Bu yöntemler, Google'ın normal RE2 desteklenen söz dizimini sınırlayan ifade kitaplığı için kullanılır.
Sağlanan normal ifade kalıbı her metin bloğuyla bağımsız olarak eşleştirilir öğedir.
var 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 |
---|---|---|
searchPattern | String | aranacak normal ifade kalıbı |
replacement | String | yerine kullanılacak metin |
Return
Element
- geçerli öğe
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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
sıralaması ve her özellik değeri,
geçerlidir.
var doc = DocumentApp.getActiveDocument(); var documentTab = doc.getActiveTab().asDocumentTab(); var body = documentTab.getBody(); // Define a custom paragraph style. var 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. var 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 bir 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 |
---|---|---|
paragraphHeading | ParagraphHeading | Özelliklerinin ayarlanması gereken başlık. |
attributes | Object | Özelliklerin ve bunların ayarlanacağı değerlerin haritası. |
Return
Body
: Geçerli öğe.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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 olarak ayarlar.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
marginBottom | Number | Puan cinsinden alt kenar boşluğu. |
Return
Body
: Geçerli öğe.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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 olarak ayarlar.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
marginLeft | Number | Puan cinsinden sol kenar boşluğu. |
Return
Body
: Geçerli öğe.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setMarginRight(marginRight)
Puan olarak sağ kenar boşluğunu ayarlar.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
marginRight | Number | Sağ kenar boşluğu. |
Return
Body
: Geçerli öğe.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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 |
---|---|---|
marginTop | Number | Puan cinsinden üst kenar boşluğu. |
Return
Body
: Geçerli öğe.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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 olarak ayarlar.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
pageHeight | Number | Puan cinsinden sayfa yüksekliği. |
Return
Body
: Geçerli öğe.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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 olarak ayarlar.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
pageWidth | Number | Nokta cinsinden sayfa genişliği. |
Return
Body
: Geçerli öğe.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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 bir 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 şunlardır: DocumentApp.TextAlignment.NORMAL
, DocumentApp.TextAlignment.SUBSCRIPT
ve DocumentApp.TextAlignment.SUPERSCRIPT
.
// Make the entire first paragraph in the active tab be superscript. var documentTab = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab(); var text = documentTab.getBody().getParagraphs()[0].editAsText(); text.setTextAlignment(DocumentApp.TextAlignment.SUPERSCRIPT);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
textAlignment | TextAlignment | uygulanacak metin hizalamasının türü |
Return
Body
- geçerli öğe
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents