Class Body

Body

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öntemDönüş türüKısa açıklama
appendHorizontalRule()HorizontalRuleYeni bir HorizontalRule oluşturur ve ekler.
appendImage(image)InlineImageBelirtilen görüntü blobundan yeni bir InlineImage oluşturur ve ekler.
appendImage(image)InlineImageBelirtilen InlineImage öğesini ekler.
appendListItem(listItem)ListItemBelirtilen ListItem öğesini ekler.
appendListItem(text)ListItemBelirtilen metin içeriğini içeren yeni bir ListItem oluşturur ve ekler.
appendPageBreak()PageBreakYeni bir PageBreak oluşturur ve ekler.
appendPageBreak(pageBreak)PageBreakBelirtilen PageBreak öğesini ekler.
appendParagraph(paragraph)ParagraphBelirtilen Paragraph öğesini ekler.
appendParagraph(text)ParagraphBelirtilen metin içeriğini 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 öğesini ekler.
clear()BodyÖğenin içeriğini temizler.
copy()BodyGeçerli öğenin ayrılmış, derin bir kopyasını döndürür.
editAsText()TextDü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)RangeElementNormal ifadeler kullanarak belirtilen metin kalıbı için öğenin içeriğinde arama yapar.
findText(searchPattern, from)RangeElementBelirli 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)ElementBelirtilen alt dizindeki alt öğeyi alır.
getChildIndex(child)IntegerBelirtilen alt öğe için alt dizini alır.
getHeadingAttributes(paragraphHeading)ObjectSağ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()NumberNokta cinsinden alt kenar boşluğunu alır.
getMarginLeft()NumberSol kenar boşluğunu punto olarak alır.
getMarginRight()NumberSağ kenar boşluğunu alır.
getMarginTop()NumberÜst kenar boşluğunu alır.
getNumChildren()IntegerAlt öğelerin sayısını alır.
getPageHeight()NumberSayfa yüksekliğini punto cinsinden alır.
getPageWidth()NumberNokta 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()TextAlignmentMetin hizalamasını getirir.
getType()ElementTypeÖğenin ElementType değerini alır.
insertHorizontalRule(childIndex)HorizontalRuleYeni bir HorizontalRule oluşturur ve belirtilen dizine ekler.
insertImage(childIndex, image)InlineImageBelirtilen konumda, belirtilen görüntü blobundan bir InlineImage oluşturur ve ekler dizin.
insertImage(childIndex, image)InlineImageVerilen InlineImage öğesini belirtilen dizine ekler.
insertListItem(childIndex, listItem)ListItemVerilen ListItem öğesini belirtilen dizine ekler.
insertListItem(childIndex, text)ListItemBelirtilen dizinde, belirtilen dizini içeren yeni bir ListItem oluşturur ve ekler metin içeriği.
insertPageBreak(childIndex)PageBreakYeni bir PageBreak oluşturur ve belirtilen dizine ekler.
insertPageBreak(childIndex, pageBreak)PageBreakVerilen PageBreak öğesini belirtilen dizine ekler.
insertParagraph(childIndex, paragraph)ParagraphVerilen Paragraph öğesini belirtilen dizine ekler.
insertParagraph(childIndex, text)ParagraphBelirtilen dizinde, belirtilen dizini içeren yeni bir Paragraph oluşturur ve ekler metin içeriği.
insertTable(childIndex)TableYeni bir Table oluşturur ve belirtilen dizine ekler.
insertTable(childIndex, cells)TableBelirtilen hücreleri içeren yeni bir Table oluşturur ve belirtilen dizine ekler.
insertTable(childIndex, table)TableVerilen Table öğesini belirtilen dizine ekler.
removeChild(child)BodyBelirtilen alt öğeyi kaldırır.
replaceText(searchPattern, replacement)ElementBelirli 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)BodySağlanan ParagraphHeading için özellikleri ayarlar.
setMarginBottom(marginBottom)BodyAlt kenar boşluğunu punto olarak ayarlar.
setMarginLeft(marginLeft)BodySol kenar boşluğunu punto olarak ayarlar.
setMarginRight(marginRight)BodyPuan olarak sağ kenar boşluğunu ayarlar.
setMarginTop(marginTop)BodyÜst kenar boşluğunu ayarlar.
setPageHeight(pageHeight)BodySayfa yüksekliğini punto olarak ayarlar.
setPageWidth(pageWidth)BodySayfa genişliğini punto olarak 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 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

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

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

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

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

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

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

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

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

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

Öğ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 öğ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

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

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

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

AdTürAçıklama
searchPatternStringaranacak kalıp
fromRangeElementarama 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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

AdTürAçıklama
searchPatternStringaranacak normal ifade kalıbı
replacementStringyerine 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

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

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

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

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

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

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

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

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

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

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

Desteği sonlandırılan yöntemler