Bu sayfa, Cloud Translation API ile çevrilmiştir.

Class HeaderSection

Başlık bölümünü temsil eden bir öğe. Bir Document genellikle en fazla bir HeaderSection içerir. HeaderSection; ListItem, Paragraph ve Table öğelerini içerebilir. Doküman yapısı hakkında daha fazla bilgi edinmek için Google Dokümanlar'ın kapsamını genişletme kılavuzuna bakın.

Yöntemler

Yöntem	Dönüş türü	Kısa açıklama
`appendHorizontalRule()`	`HorizontalRule`	Yeni bir `HorizontalRule` oluşturup ekler.
`appendImage(image)`	`InlineImage`	Belirtilen resim blob'undan yeni bir `InlineImage` oluşturur ve ekler.
`appendImage(image)`	`InlineImage`	Belirtilen `InlineImage` dizesini ekler.
`appendListItem(listItem)`	`ListItem`	Belirtilen `ListItem` dizesini ekler.
`appendListItem(text)`	`ListItem`	Belirtilen metin içeriklerini içeren yeni bir `ListItem` oluşturur ve ekler.
`appendParagraph(paragraph)`	`Paragraph`	Belirtilen `Paragraph` dizesini ekler.
`appendParagraph(text)`	`Paragraph`	Belirtilen metin içeriklerini içeren yeni bir `Paragraph` oluşturur ve ekler.
`appendTable()`	`Table`	Yeni bir `Table` oluşturup ekler.
`appendTable(cells)`	`Table`	Belirtilen her bir dize değeri için `TableCell` içeren yeni bir `Table` ekler.
`appendTable(table)`	`Table`	Belirtilen `Table` dizesini ekler.
`clear()`	`HeaderSection`	Öğenin içeriğini temizler.
`copy()`	`HeaderSection`	Geçerli öğenin ayrı, 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ürde bir alt öğe arar.
`findElement(elementType, from)`	`RangeElement`	Belirtilen `RangeElement` öğesinden başlayarak, öğenin içeriğinde belirtilen türde bir alt öğe arar.
`findText(searchPattern)`	`RangeElement`	Normal ifadeler kullanarak, belirtilen metin kalıbı için öğenin içeriğinde arama yapar.
`findText(searchPattern, from)`	`RangeElement`	Belirli bir arama sonucundan başlayarak, belirtilen metin kalıbı için öğenin içeriğinde arama yapar.
`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.
`getImages()`	`InlineImage[]`	Bölümdeki tüm `InlineImages` öğelerini getirir.
`getListItems()`	`ListItem[]`	Bölümdeki tüm `ListItems` öğelerini getirir.
`getNumChildren()`	`Integer`	Alt öğe sayısını alır.
`getParagraphs()`	`Paragraph[]`	Bölümde yer alan tüm `Paragraphs` öğelerini alır (`ListItems` dahil).
`getParent()`	`ContainerElement`	Öğenin üst öğesini alır.
`getTables()`	`Table[]`	Bölümdeki tüm `Tables` öğelerini getirir.
`getText()`	`String`	Öğenin içeriğini metin dizesi olarak alır.
`getTextAlignment()`	`TextAlignment`	Metin hizalamasını sağlar.
`getType()`	`ElementType`	Öğenin `ElementType` değerini alır.
`insertHorizontalRule(childIndex)`	`HorizontalRule`	Belirtilen dizinde yeni bir `HorizontalRule` oluşturur ve ekler.
`insertImage(childIndex, image)`	`InlineImage`	Belirtilen resim blob'undan, belirtilen dizinde bir `InlineImage` oluşturur ve ekler.
`insertImage(childIndex, image)`	`InlineImage`	Belirtilen `InlineImage` öğesini belirtilen dizine ekler.
`insertListItem(childIndex, listItem)`	`ListItem`	Belirtilen `ListItem` öğesini belirtilen dizine ekler.
`insertListItem(childIndex, text)`	`ListItem`	Belirtilen dizinde, belirtilen metin içeriklerini içeren yeni bir `ListItem` oluşturur ve ekler.
`insertParagraph(childIndex, paragraph)`	`Paragraph`	Belirtilen `Paragraph` öğesini belirtilen dizine ekler.
`insertParagraph(childIndex, text)`	`Paragraph`	Belirtilen dizinde, belirtilen metin içeriklerini içeren yeni bir `Paragraph` oluşturur ve ekler.
`insertTable(childIndex)`	`Table`	Belirtilen dizinde yeni bir `Table` oluşturur ve ekler.
`insertTable(childIndex, cells)`	`Table`	Belirtilen hücreleri içeren, belirtilen dizinde yeni bir `Table` oluşturur ve ekler.
`insertTable(childIndex, table)`	`Table`	Belirtilen `Table` öğesini belirtilen dizine ekler.
`removeChild(child)`	`HeaderSection`	Belirtilen alt öğeyi kaldırır.
`removeFromParent()`	`HeaderSection`	Öğeyi üst öğesinden kaldırır.
`replaceText(searchPattern, replacement)`	`Element`	Normal ifadeler kullanarak belirli bir metin kalıbının tüm tekrarlarını verilen bir yeni dizeyle değiştirir.
`setAttributes(attributes)`	`HeaderSection`	Öğenin özelliklerini ayarlar.
`setText(text)`	`HeaderSection`	İçeriği düz metin olarak ayarlar.
`setTextAlignment(textAlignment)`	`HeaderSection`	Metin hizalamasını ayarlar.

Kullanımdan kaldırılan yöntemler

Yöntem	Dönüş türü	Kısa açıklama
`getFootnotes()`	`Footnote[]`	Bölümdeki tüm `Footnotes` öğelerini getirir.
`getLinkUrl()`	`String`	Bağlantı URL'sini alır.
`getNextSibling()`	`Element`	Öğenin sonraki eşdüzey öğesini alır.
`getPreviousSibling()`	`Element`	Öğenin önceki eşdüzey öğesini alır.
`isAtDocumentEnd()`	`Boolean`	Öğenin, `Document` öğesinin sonunda olup olmadığını belirler.
`setLinkUrl(url)`	`HeaderSection`	Bağlantı URL'sini ayarlar.

Ayrıntılı belgeler

`appendHorizontalRule()`

Yeni bir HorizontalRule oluşturup ekler.

HorizontalRule, yeni bir Paragraph içinde yer alacak.

Return

HorizontalRule - yeni yatay kural

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların 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.

Bu resim, yeni bir Paragraph öğesi içinde yer alacak.

Parametreler

Ad	Tür	Açıklama
`image`	`BlobSource`	resim verileri

Return

InlineImage - eklenen resim

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`appendImage(image)`

Belirtilen InlineImage dizesini 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 kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`appendListItem(listItem)`

Belirtilen ListItem dizesini 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 kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`appendListItem(text)`

Belirtilen metin içeriklerini içeren yeni bir ListItem oluşturur ve ekler.

Ardışık liste öğeleri aynı listenin parçası olarak eklenir.

Parametreler

Ad	Tür	Açıklama
`text`	`String`	liste öğesinin metin içeriği

Return

ListItem - yeni liste öğesi

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`appendParagraph(paragraph)`

Belirtilen Paragraph dizesini 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 kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`appendParagraph(text)`

Belirtilen metin içeriklerini içeren yeni bir Paragraph oluşturur ve ekler.

Parametreler

Ad	Tür	Açıklama
`text`	`String`	paragrafın metin içeriği

Return

Paragraph — yeni paragraf

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların 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şturup ekler.

Google Dokümanlar dokümanları bir tabloyla bitemeyeceği için bu yöntem tablodan sonra boş bir paragraf da ekler.

Return

Table - yeni tablo

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`appendTable(cells)`

Belirtilen her bir dize değeri için TableCell içeren yeni bir Table ekler.

Google Dokümanlar dokümanları bir tabloyla bitemeyeceği için bu yöntem tablodan sonra boş bir paragraf da ekler.

Parametreler

Ad	Tür	Açıklama
`cells`	`String[][]`	yeni tabloya eklenecek tablo hücrelerinin metin içeriği

Return

Table - eklenen tablo

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`appendTable(table)`

Belirtilen Table dizesini ekler.

Mevcut bir Table kopyasını eklerken bu appendTable sürümünü kullanın. Google Dokümanlar dokümanları bir tabloyla bitemeyeceği için bu yöntem tablodan sonra boş bir paragraf da ekler.

Parametreler

Ad	Tür	Açıklama
`table`	`Table`	eklenecek tablo

Return

Table - eklenen tablo

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların 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

HeaderSection - geçerli öğe

`copy()`

Geçerli öğenin ayrı, derin bir kopyasını döndürür.

Öğede bulunan alt öğeler de kopyalanır. Yeni öğenin bir üst öğesi yoktur.

Return

HeaderSection: Yeni kopya.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri 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.

Tamamen silinmiş bir metin aralığı içinde yer alan alt öğeler öğeden kaldırılır.

var body = DocumentApp.getActiveDocument().getBody();

// Insert two paragraphs separated by a paragraph containing an
// horizontal rule.
body.insertParagraph(0, "An editAsText sample.");
body.insertHorizontalRule(0);
body.insertParagraph(0, "An example.");

// Delete " sample.\n\n An" removing the horizontal rule in the process.
body.editAsText().deleteText(14, 25);

Return

Text: Geçerli öğenin metin sürümü

`findElement(elementType)`

Öğenin içeriğinde, belirtilen türde bir alt öğe arar.

Parametreler

Ad	Tür	Açıklama
`elementType`	`ElementType`	aranacak öğe türü

Return

RangeElement: Arama öğesinin konumunu belirten arama sonucu

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların 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 öğesinden başlayarak, öğenin içeriğinde belirtilen türde bir alt öğe arar.

// Get the body section of the active document.
var body = DocumentApp.getActiveDocument().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 öğe türü
`from`	`RangeElement`	arama yapılacak arama sonucunu

Return

RangeElement: Arama öğesinin sonraki konumunu belirten arama sonucu

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri 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 (ör. yakalama grupları ve mod değiştiricileri) tam olarak desteklenmez.

Sağlanan normal ifade kalıbı, geçerli öğede bulunan her metin bloğuyla bağımsız olarak eşleştirilir.

Parametreler

Ad	Tür	Açıklama
`searchPattern`	`String`	mola vermek için

Return

RangeElement: Arama metninin konumunu gösteren arama sonucu veya eşleşme yoksa null

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`findText(searchPattern, from)`

Belirli bir arama sonucundan başlayarak, belirtilen metin kalıbı için öğenin içeriğinde arama yapar.

JavaScript normal ifade özelliklerinin bir alt kümesi (ör. yakalama grupları ve mod değiştiricileri) tam olarak desteklenmez.

Sağlanan normal ifade kalıbı, geçerli öğede bulunan her metin bloğuyla bağımsız olarak eşleştirilir.

Parametreler

Ad	Tür	Açıklama
`searchPattern`	`String`	mola vermek için
`from`	`RangeElement`	arama yapılacak arama sonucunu

Return

RangeElement: Arama metninin sonraki konumunu veya eşleşme yoksa null değerini gösteren arama sonucu

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların 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ç, geçerli her öğe özelliği için bir özellik içeren bir nesnedir. Burada her özellik adı, DocumentApp.Attribute numaralandırmasındaki bir öğeye karşılık gelir.

var body = DocumentApp.getActiveDocument().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 özellikleridir.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların 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.

// Get the body section of the active document.
var body = DocumentApp.getActiveDocument().getBody();

// Obtain the first element in the document.
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`	alt öğenin dizini

Return

Element - belirtilen dizindeki alt öğe

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri 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`	dizini alınacak alt öğe

Return

Integer - alt dizin

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getImages()`

Bölümdeki tüm InlineImages öğelerini getirir.

Return

InlineImage[] — bölüm resimleri

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getListItems()`

Bölümdeki tüm ListItems öğelerini getirir.

Return

ListItem[] - bölüm listesi öğeleri

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getNumChildren()`

Alt öğe sayısını alır.

// Get the body section of the active document.
var body = DocumentApp.getActiveDocument().getBody();

// Log the number of elements in the document.
Logger.log("There are " + body.getNumChildren() +
    " elements in the document body.");

Return

Integer - çocuk sayısı

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri 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 alır (ListItems dahil).

Return

Paragraph[] — bölüm paragrafları

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların 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: Üst öğe.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getTables()`

Bölümdeki tüm Tables öğelerini getirir.

Return

Table[]: bölüm tabloları

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların 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: Metin dizesi olarak öğenin içeriği

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getTextAlignment()`

Metin hizalamasını sağlar. 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 çok türde metin hizalaması içeriyorsa ya da metin hizalaması hiç ayarlanmadıysa null

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların 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.

var body = DocumentApp.getActiveDocument().getBody();

// Obtain the first element in the document 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 kapsamların 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 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 kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`insertImage(childIndex, image)`

Belirtilen resim blob'undan, belirtilen dizinde bir InlineImage oluşturur ve ekler.

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 kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`insertImage(childIndex, image)`

Belirtilen InlineImage öğesini belirtilen dizine ekler.

Bu resim, yeni bir Paragraph öğesi içinde yer alacak.

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 kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`insertListItem(childIndex, listItem)`

Belirtilen ListItem öğesini belirtilen dizine ekler.

Parametreler

Ad	Tür	Açıklama
`childIndex`	`Integer`	ekleneceği dizin
`listItem`	`ListItem`	eklenecek liste öğesi

Return

ListItem - eklenen liste öğesi

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların 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çeriklerini içeren yeni bir ListItem oluşturur ve ekler.

Parametreler

Ad	Tür	Açıklama
`childIndex`	`Integer`	ekleneceği dizin
`text`	`String`	liste öğesinin metin içeriği

Return

ListItem - yeni liste öğesi

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`insertParagraph(childIndex, paragraph)`

Belirtilen Paragraph öğesini belirtilen dizine ekler.

Parametreler

Ad	Tür	Açıklama
`childIndex`	`Integer`	ekleneceği dizin
`paragraph`	`Paragraph`	eklenecek paragraf

Return

Paragraph — eklenen paragraf

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların 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çeriklerini içeren yeni bir Paragraph oluşturur ve ekler.

Parametreler

Ad	Tür	Açıklama
`childIndex`	`Integer`	ekleneceği dizin
`text`	`String`	paragrafın metin içeriği

Return

Paragraph — yeni paragraf

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`insertTable(childIndex)`

Belirtilen dizinde yeni bir Table oluşturur ve ekler.

Parametreler

Ad	Tür	Açıklama
`childIndex`	`Integer`	ekleneceği dizin

Return

Table - yeni tablo

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların 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, belirtilen dizinde yeni bir Table oluşturur ve ekler.

Parametreler

Ad	Tür	Açıklama
`childIndex`	`Integer`	ekleneceği 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 kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`insertTable(childIndex, table)`

Belirtilen Table öğesini belirtilen dizine ekler.

Parametreler

Ad	Tür	Açıklama
`childIndex`	`Integer`	ekleneceği dizin
`table`	`Table`	eklenecek tablo

Return

Table - eklenen tablo

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`removeChild(child)`

Belirtilen alt öğeyi kaldırır.

Parametreler

Ad	Tür	Açıklama
`child`	`Element`	kaldırılacak alt öğe

Return

HeaderSection - geçerli öğe

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`removeFromParent()`

Öğeyi üst öğesinden kaldırır.

var body = DocumentApp.getActiveDocument().getBody();

// Remove all images in the document body.
var imgs = body.getImages();
for (var i = 0; i < imgs.length; i++) {
  imgs[i].removeFromParent();
}

Return

HeaderSection: Kaldırılan öğe.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`replaceText(searchPattern, replacement)`

Normal ifadeler kullanarak belirli bir metin kalıbının tüm tekrarlarını verilen bir yeni dizeyle değiştirir.

Arama kalıbı bir JavaScript normal ifade nesnesi olarak değil, bir dize olarak iletilir. Bu nedenle, kalıptaki ters eğik çizgileri kod dışına almanız gerekir.

Bu yöntem, Google'ın RE2 normal ifade kitaplığını kullanır. Bu kitaplık, desteklenen söz dizimini sınırlar.

Sağlanan normal ifade kalıbı, geçerli öğede bulunan her metin bloğuyla bağımsız olarak eşleştirilir.

var body = DocumentApp.getActiveDocument().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`	normal ifade kalıbını
`replacement`	`String`	metin yerine

Return

Element - geçerli öğe

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların 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 özellik parametresi, her özellik adının DocumentApp.Attribute numaralandırmasındaki bir öğe ve her özellik değerinin ise uygulanacak yeni değer olduğu bir nesne olmalıdır.

var body = DocumentApp.getActiveDocument().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

HeaderSection: Geçerli öğe.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`setText(text)`

İçeriği düz metin olarak ayarlar.

Not: Mevcut içerikler temizlenir.

Parametreler

Ad	Tür	Açıklama
`text`	`String`	yeni metin içeriği

Return

HeaderSection - geçerli öğe

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların 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 şunlardır: DocumentApp.TextAlignment.NORMAL, DocumentApp.TextAlignment.SUBSCRIPT ve DocumentApp.TextAlignment.SUPERSCRIPT.

// Make the entire first paragraph be superscript.
var text = DocumentApp.getActiveDocument().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

HeaderSection - geçerli öğe

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların 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

`getFootnotes()`

Kullanımdan kaldırıldı. Bu öğe, Footnote içeremez.

Bölümdeki tüm Footnotes öğelerini getirir.

Return

Footnote[] — bölüm dipnotları

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getLinkUrl()`

Kullanımdan kaldırıldı. Bir bağlantıyı bölümün tamamına uygulamak yerine bağlantıyı bölümdeki bir öğeye uygulayın.

Bağlantı URL'sini alır.

Return

String: Bağlantı URL'si; öğe, bu özellik için birden fazla değer içeriyorsa null ifadesini içerir.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getNextSibling()`

Kullanımdan kaldırıldı. Bu öğenin herhangi bir kardeşi yok.

Öğenin sonraki eşdüzey öğesini alır.

Bir sonraki kardeş aynı üst öğeye sahiptir ve geçerli öğeyi takip eder.

Return

Element: Sonraki kardeş öğe.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getPreviousSibling()`

Kullanımdan kaldırıldı. Bu öğenin herhangi bir kardeşi yok.

Öğenin önceki eşdüzey öğesini alır.

Önceki eşdüzey öğe aynı üst öğeye sahiptir ve geçerli öğeden önce gelir.

Return

Element: Önceki kardeş öğe.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`isAtDocumentEnd()`

Kullanımdan kaldırıldı. Bu yöntem, HeaderSection için güvenilir değil.

Öğenin, Document öğesinin sonunda olup olmadığını belirler.

Return

Boolean: Öğenin dokümanın sonunda olup olmadığı.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`setLinkUrl(url)`

Kullanımdan kaldırıldı. Bir bağlantıyı bölümün tamamına uygulamak yerine bağlantıyı bölümdeki bir öğeye uygulayın.

Bağlantı URL'sini ayarlar.

Parametreler

Ad	Tür	Açıklama
`url`	`String`	bağlantı URL'si

Return

HeaderSection - geçerli öğe

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents