Class Body

Body

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öntemDönüş türüKısa açıklama
appendHorizontalRule()HorizontalRuleYeni bir HorizontalRule oluşturur ve ekler.
appendImage(image)InlineImageBelirtilen resim blob'undan yeni bir InlineImage oluşturur ve ekler.
appendImage(image)InlineImageBelirtilen InlineImage eklenir.
appendListItem(listItem)ListItemBelirtilen ListItem eklenir.
appendListItem(text)ListItemBelirtilen metin içeriklerini içeren yeni bir ListItem oluşturur ve ekler.
appendPageBreak()PageBreakYeni bir PageBreak oluşturur ve ekler.
appendPageBreak(pageBreak)PageBreakBelirtilen PageBreak eklenir.
appendParagraph(paragraph)ParagraphBelirtilen Paragraph eklenir.
appendParagraph(text)ParagraphBelirtilen metin içeriklerini içeren yeni bir Paragraph oluşturur ve ekler.
appendTable()TableYeni bir Table oluşturur ve ekler.
appendTable(cells)TableBelirtilen her dize değeri için TableCell içeren yeni bir Table ekler.
appendTable(table)TableBelirtilen Table eklenir.
clear()BodyÖğenin içeriğini temizler.
copy()BodyGeçerli öğenin ayrılmış, derin bir kopyasını döndürür.
editAsText()TextDüzenlemek için mevcut öğenin Text sürümünü alır.
findElement(elementType)RangeElement|nullÖğenin içeriğinde, belirtilen türde bir alt öğe arar.
findElement(elementType, from)RangeElement|nullBelirtilen RangeElement ile başlayarak, belirtilen türde bir alt öğe için öğenin içeriğini arar.
findText(searchPattern)RangeElement|nullNormal ifadeleri kullanarak öğenin içeriğinde belirtilen metin kalıbını arar.
findText(searchPattern, from)RangeElement|nullBelirtilen metin kalıbını, belirli bir arama sonucundan başlayarak öğenin içeriğinde arar.
getAttributes()ObjectÖğenin özelliklerini alır.
getChild(childIndex)ElementBelirtilen alt dizindeki alt öğeyi alır.
getChildIndex(child)IntegerBelirtilen alt öğenin alt dizinini alır.
getHeadingAttributes(paragraphHeading)ObjectSağlanan ParagraphHeading için özellikler grubunu alır.
getImages()InlineImage[]|nullBölümde bulunan tüm InlineImages öğelerini alır.
getListItems()ListItem[]|nullBölümde bulunan tüm ListItems öğelerini alır.
getMarginBottom()Number|nullAlt kenar boşluğunu puan cinsinden alır.
getMarginLeft()Number|nullSol kenar boşluğunu puan cinsinden alır.
getMarginRight()Number|nullSağ kenar boşluğunu alır.
getMarginTop()Number|nullÜst kenar boşluğunu alır.
getNumChildren()IntegerÇocuk sayısını alır.
getPageHeight()Number|nullSayfa yüksekliğini (puan cinsinden) alır.
getPageWidth()Number|nullSayfa genişliğini puan cinsinden alır.
getParagraphs()Paragraph[]|nullBölümde bulunan tüm Paragraphs öğelerini (ListItems dahil) alır.
getParent()ContainerElement|nullÖğenin üst öğesini alır.
getTables()Table[]|nullBölümde bulunan tüm Tables öğelerini alır.
getText()StringÖğenin içeriğini metin dizesi olarak alır.
getTextAlignment()TextAlignment|nullMetin hizalamasını alır.
getType()ElementTypeÖğenin ElementType değerini alır.
insertHorizontalRule(childIndex)HorizontalRuleBelirtilen dizinde yeni bir HorizontalRule oluşturur ve ekler.
insertImage(childIndex, image)InlineImageBelirtilen görüntü blob'undan belirtilen dizinde bir InlineImage oluşturur ve ekler.
insertImage(childIndex, image)InlineImageBelirtilen dizine verilen InlineImage öğesini ekler.
insertListItem(childIndex, listItem)ListItemBelirtilen dizine verilen ListItem öğesini ekler.
insertListItem(childIndex, text)ListItemBelirtilen dizinde, belirtilen metin içeriğini içeren yeni bir ListItem oluşturup ekler.
insertPageBreak(childIndex)PageBreakBelirtilen dizinde yeni bir PageBreak oluşturur ve ekler.
insertPageBreak(childIndex, pageBreak)PageBreakBelirtilen dizine verilen PageBreak öğesini ekler.
insertParagraph(childIndex, paragraph)ParagraphBelirtilen dizine verilen Paragraph öğesini ekler.
insertParagraph(childIndex, text)ParagraphBelirtilen dizinde, belirtilen metin içeriğini içeren yeni bir Paragraph oluşturup ekler.
insertTable(childIndex)TableBelirtilen dizinde yeni bir Table oluşturur ve ekler.
insertTable(childIndex, cells)TableBelirtilen hücreleri içeren yeni bir Table oluşturup belirtilen dizine ekler.
insertTable(childIndex, table)TableBelirtilen dizine verilen Table öğesini ekler.
removeChild(child)BodyBelirtilen alt öğeyi kaldırır.
replaceText(searchPattern, replacement)ElementNormal ifadeleri kullanarak belirli bir metin kalıbının tüm örneklerini belirli bir yeni dizeyle değiştirir.
setAttributes(attributes)BodyÖğenin özelliklerini ayarlar.
setHeadingAttributes(paragraphHeading, attributes)BodySağlanan ParagraphHeading için özellikleri ayarlar.
setMarginBottom(marginBottom)BodyAlt kenar boşluğunu punto cinsinden ayarlar.
setMarginLeft(marginLeft)BodySol kenar boşluğunu punto cinsinden ayarlar.
setMarginRight(marginRight)BodySağ kenar boşluğunu puan cinsinden ayarlar.
setMarginTop(marginTop)BodyÜst kenar boşluğunu ayarlar.
setPageHeight(pageHeight)BodySayfa yüksekliğini punto cinsinden ayarlar.
setPageWidth(pageWidth)BodySayfa genişliğini punto cinsinden ayarlar.
setText(text)Bodyİçeriği düz metin olarak ayarlar.
setTextAlignment(textAlignment)BodyMetin 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

AdTürAçıklama
imageBlobSourceResim 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

AdTürAçıklama
imageInlineImageResim 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

AdTürAçıklama
listItemListItemEklenecek 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

AdTürAçıklama
textStringListe öğ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

AdTürAçıklama
pageBreakPageBreakEklenecek 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

AdTürAçıklama
paragraphParagraphEklenecek 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

AdTürAçıklama
textStringParagrafı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

AdTürAçıklama
cellsString[][]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

AdTürAçıklama
tableTableEklenecek 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()

Öğenin içeriğini temizler.

Return

Body: Geçerli öğe.


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 bir 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

AdTürAçıklama
elementTypeElementTypeAranacak öğ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

AdTürAçıklama
elementTypeElementTypeAranacak öğe türü.
fromRangeElementArama 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

AdTürAçıklama
searchPatternStringAranacak 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

AdTürAçıklama
searchPatternStringAranacak desen
fromRangeElementArama 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

AdTürAçıklama
childIndexIntegerAlı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

AdTürAçıklama
childElementDizinin 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)

Sağlanan ParagraphHeading için özellikler grubunu alır.

Parametreler

AdTürAçıklama
paragraphHeadingParagraphHeadingÖ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

AdTürAçıklama
childIndexIntegerÖğ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

AdTürAçıklama
childIndexIntegerÖğenin ekleneceği dizin.
imageBlobSourceResim 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

AdTürAçıklama
childIndexIntegerÖğenin ekleneceği dizin.
imageInlineImageEklenecek 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

AdTürAçıklama
childIndexIntegerEkleme yapılacak dizin.
listItemListItemEklenecek 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

AdTürAçıklama
childIndexIntegerEkleme yapılacak dizin.
textStringListe öğ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

AdTürAçıklama
childIndexIntegerÖğ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

AdTürAçıklama
childIndexIntegerÖğenin ekleneceği dizin.
pageBreakPageBreakEklenecek 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

AdTürAçıklama
childIndexIntegerEkleme yapılacak dizin.
paragraphParagraphEklenecek 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

AdTürAçıklama
childIndexIntegerEkleme yapılacak dizin.
textStringParagrafı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

AdTürAçıklama
childIndexIntegerEkleme 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

AdTürAçıklama
childIndexIntegerEkleme yapılacak dizin.
cellsString[][]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

AdTürAçıklama
childIndexIntegerEkleme yapılacak dizin.
tableTableEklenecek 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

AdTürAçıklama
childElementKaldı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

AdTürAçıklama
searchPatternStringAranacak normal ifade kalıbı
replacementStringDeğ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

AdTürAçıklama
attributesObjectÖğ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

AdTürAçıklama
paragraphHeadingParagraphHeadingÖzellikleri ayarlanacak başlık.
attributesObjectÖ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

AdTürAçıklama
marginBottomNumberAlt 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

AdTürAçıklama
marginLeftNumberSol 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

AdTürAçıklama
marginRightNumberSağ 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

AdTürAçıklama
marginTopNumberÜ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

AdTürAçıklama
pageHeightNumberSayfa 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

AdTürAçıklama
pageWidthNumberSayfa 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

AdTürAçıklama
textStringYeni 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

AdTürAçıklama
textAlignmentTextAlignmentUygulanacak 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

Kullanımdan kaldırılan yöntemler