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

Class HeaderSection

Başlık bölümünü temsil eden bir öğe. Document genellikle en fazla bir HeaderSection içerir. HeaderSection, ListItem, Paragraph ve Table öğeleri içerebilir. Belge yapısı hakkında daha fazla bilgi için Google Dokümanlar'ı 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şturup ekler.
`appendImage(image)`	`InlineImage`	Belirtilen `InlineImage` değerini ekler.
`appendListItem(listItem)`	`ListItem`	Belirtilen `ListItem` değerini ekler.
`appendListItem(text)`	`ListItem`	Belirtilen metin içeriklerini içeren yeni bir `ListItem` oluşturur ve ekler.
`appendParagraph(paragraph)`	`Paragraph`	Belirtilen `Paragraph` değerini 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 dize değeri için `TableCell` içeren yeni bir `Table` ekler.
`appendTable(table)`	`Table`	Belirtilen `Table` değerini ekler.
`clear()`	`HeaderSection`	Öğenin içeriğini temizler.
`copy()`	`HeaderSection`	Geçerli öğenin ayrılmış, derin bir kopyasını döndürür.
`editAsText()`	`Text`	Düzenlemek için mevcut öğenin `Text` sürümünü alır.
`findElement(elementType)`	`RangeElement`	Öğenin içeriğini, belirtilen türün bir alt öğesi için arar.
`findElement(elementType, from)`	`RangeElement`	Belirtilen `RangeElement` öğesinden başlayarak öğenin içeriğini, belirtilen türün bir alt öğesi için arar.
`findText(searchPattern)`	`RangeElement`	Normal ifadeleri kullanarak öğenin içeriğinde belirtilen metin kalıbını arar.
`findText(searchPattern, from)`	`RangeElement`	Belirli bir arama sonucundan başlayarak öğenin içeriğini belirtilen metin kalıbıyla arar.
`getAttributes()`	`Object`	Öğenin özelliklerini alır.
`getChild(childIndex)`	`Element`	Belirtilen alt öğe dizininde alt öğeyi alır.
`getChildIndex(child)`	`Integer`	Belirtilen alt öğenin alt öğe dizini döndürülür.
`getImages()`	`InlineImage[]`	Bölümdeki tüm `InlineImages` öğelerini alır.
`getListItems()`	`ListItem[]`	Bölümdeki tüm `ListItems` öğelerini alır.
`getNumChildren()`	`Integer`	Çocuk sayısını alır.
`getParagraphs()`	`Paragraph[]`	Bölümde bulunan tüm `Paragraphs` öğelerini (`ListItems` dahil) alır.
`getParent()`	`ContainerElement`	Öğenin üst öğesini alır.
`getTables()`	`Table[]`	Bölümdeki tüm `Tables` öğelerini alır.
`getText()`	`String`	Öğenin içeriğini metin dizesi olarak alır.
`getTextAlignment()`	`TextAlignment`	Metin hizalamasını alır.
`getType()`	`ElementType`	Öğenin `ElementType` değerini alır.
`insertHorizontalRule(childIndex)`	`HorizontalRule`	Belirtilen dizinde yeni bir `HorizontalRule` oluşturup ekler.
`insertImage(childIndex, image)`	`InlineImage`	Belirtilen resim blob'undan, belirtilen dizinde bir `InlineImage` oluşturup ekler.
`insertImage(childIndex, image)`	`InlineImage`	Belirtilen `InlineImage` öğesini belirtilen dizin içine ekler.
`insertListItem(childIndex, listItem)`	`ListItem`	Belirtilen `ListItem` öğesini belirtilen dizin içine ekler.
`insertListItem(childIndex, text)`	`ListItem`	Belirtilen dizinde, belirtilen metin içeriklerini içeren yeni bir `ListItem` oluşturup ekler.
`insertParagraph(childIndex, paragraph)`	`Paragraph`	Belirtilen `Paragraph` öğesini belirtilen dizin içine ekler.
`insertParagraph(childIndex, text)`	`Paragraph`	Belirtilen dizinde, belirtilen metin içeriklerini içeren yeni bir `Paragraph` oluşturup ekler.
`insertTable(childIndex)`	`Table`	Belirtilen dizinde yeni bir `Table` oluşturup ekler.
`insertTable(childIndex, cells)`	`Table`	Belirtilen dizinde, belirtilen hücreleri içeren yeni bir `Table` oluşturup ekler.
`insertTable(childIndex, table)`	`Table`	Belirtilen `Table` öğesini belirtilen dizin içine ekler.
`removeChild(child)`	`HeaderSection`	Belirtilen alt öğeyi kaldırır.
`removeFromParent()`	`HeaderSection`	Öğeyi üst öğesinden kaldırır.
`replaceText(searchPattern, replacement)`	`Element`	Normal ifadeler kullanılarak belirli bir metin kalıbının tüm örnekleri belirli bir değiştirme dizesiyle değiştirilir.
`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 alır.
`getLinkUrl()`	`String`	Bağlantı URL'sini alır.
`getNextSibling()`	`Element`	Öğenin sonraki kardeş öğesini alır.
`getPreviousSibling()`	`Element`	Öğenin önceki kardeş öğesini alır.
`isAtDocumentEnd()`	`Boolean`	Öğenin `Document`'ün sonunda olup olmadığını belirler.
`setLinkUrl(url)`	`HeaderSection`	Bağlantı URL'sini ayarlar.

Ayrıntılı dokümanlar

`appendHorizontalRule()`

Yeni bir HorizontalRule oluşturup ekler.

HorizontalRule, yeni bir Paragraph içinde yer alır.

Return

HorizontalRule: Yeni yatay kural.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`appendImage(image)`

Belirtilen resim blob'undan yeni bir InlineImage oluşturup ekler.

Resim yeni bir Paragraph içinde yer alır.

Parametreler

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

Return

InlineImage: Eklenmiş resim.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`appendImage(image)`

Belirtilen InlineImage değerini ekler.

InlineImage, yeni bir Paragraph içinde yer alır.

Mevcut bir InlineImage öğesinin kopyasını eklerken appendImage öğesinin bu sürümünü kullanın.

Parametreler

Ad	Tür	Açıklama
`image`	`InlineImage`	Resim verileri.

Return

InlineImage: Eklenmiş resim.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`appendListItem(listItem)`

Belirtilen ListItem değerini ekler.

Mevcut bir ListItem öğesinin kopyasını eklerken appendListItem öğesinin bu 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`appendListItem(text)`

Belirtilen metin içeriklerini içeren yeni bir 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`appendParagraph(paragraph)`

Belirtilen Paragraph değerini ekler.

Mevcut bir Paragraph öğesinin kopyasını eklerken appendParagraph öğesinin bu sürümünü kullanın.

Parametreler

Ad	Tür	Açıklama
`paragraph`	`Paragraph`	Eklenecek paragraf.

Return

Paragraph: Eklenen paragraf.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`appendParagraph(text)`

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

Parametreler

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

Return

Paragraph: Yeni paragraf.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`appendTable()`

Yeni bir Table oluşturup ekler.

Google Dokümanlar dokümanları tabloyla sonlanamayacağından bu yöntem, tablodan sonra boş bir paragraf da ekler.

Return

Table: Yeni tablo.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`appendTable(cells)`

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

Google Dokümanlar dokümanları tabloyla sonlanamayacağından bu yöntem, tablodan sonra boş bir paragraf da ekler.

Parametreler

Ad	Tür	Açıklama
`cells`	`String[][]`	Yeni tabloya eklenecek tablo hücrelerinin metin içerikleri.

Return

Table: Eklenen tablo.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`appendTable(table)`

Belirtilen Table değerini ekler.

Mevcut bir Table öğesinin kopyasını eklerken appendTable öğesinin bu sürümünü kullanın. Google Dokümanlar dokümanları tabloyla sonlanamayacağından bu yöntem, tablodan sonra boş bir paragraf da ekler.

Parametreler

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

Return

Table: Eklenen tablo.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`clear()`

Öğenin içeriğini temizler.

Return

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

HeaderSection: Yeni kopya.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`editAsText()`

Düzenlemek için mevcut öğenin Text sürümünü alır.

Öğe içeriklerini zengin metin olarak değiştirmek için editAsText öğesini kullanın. editAsText modu, metin olmayan öğeleri (InlineImage ve HorizontalRule gibi) yoksayar.

Silinen bir metin aralığının tamamına sahip alt öğeler öğeden kaldırılır.

const body =
    DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody();

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

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

Return

Text: Mevcut öğenin metin sürümü

`findElement(elementType)`

Öğenin içeriğini, belirtilen türün bir alt öğesi için arar.

Parametreler

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

Return

RangeElement: Arama öğesinin konumunu belirten bir arama sonucu.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`findElement(elementType, from)`

Belirtilen RangeElement öğesinden başlayarak öğenin içeriğini, belirtilen türün bir alt öğesi için arar.

const body =
    DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody();

// Define the search parameters.

let searchResult = null;

// Search until the paragraph is found.
while (
    (searchResult = body.findElement(
         DocumentApp.ElementType.PARAGRAPH,
         searchResult,
         ))) {
  const par = searchResult.getElement().asParagraph();
  if (par.getHeading() === DocumentApp.ParagraphHeading.HEADING1) {
    // Found one, update and stop.
    par.setText('This is the first header.');
    break;
  }
}

Parametreler

Ad	Tür	Açıklama
`elementType`	`ElementType`	Aranacak öğe türü.
`from`	`RangeElement`	Arama yapılacak arama sonucu.

Return

RangeElement: Arama öğesinin sonraki konumunu gösteren bir arama sonucu.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`findText(searchPattern)`

Normal ifadeleri kullanarak öğenin içeriğinde belirtilen metin kalıbını arar.

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

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

Parametreler

Ad	Tür	Açıklama
`searchPattern`	`String`	aranacak kalıp

Return

RangeElement: Arama metninin konumunu gösteren bir arama sonucudur veya eşleşme yoksa null değerini alır.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`findText(searchPattern, from)`

Belirli bir arama sonucundan başlayarak öğenin içeriğini belirtilen metin kalıbıyla arar.

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

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

Parametreler

Ad	Tür	Açıklama
`searchPattern`	`String`	aranacak kalıp
`from`	`RangeElement`	Arama yapılacak arama sonucu

Return

RangeElement: Arama metninin sonraki konumunu gösteren bir arama sonucudur veya eşleşme yoksa null değerini alır.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`getAttributes()`

Öğenin özelliklerini alır.

Sonuç, her geçerli öğe özelliği için bir özellik içeren bir nesnedir. Bu nesnedeki her özellik adı, DocumentApp.Attribute dizininde bir öğeye karşılık gelir.

const doc = DocumentApp.getActiveDocument();
const documentTab = doc.getActiveTab().asDocumentTab();
const body = documentTab.getBody();

// Append a styled paragraph.
const par = body.appendParagraph('A bold, italicized paragraph.');
par.setBold(true);
par.setItalic(true);

// Retrieve the paragraph's attributes.
const atts = par.getAttributes();

// Log the paragraph attributes.
for (const att in atts) {
  Logger.log(`${att}:${atts[att]}`);
}

Return

Object: Öğenin özellikleri.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`getChild(childIndex)`

Belirtilen alt öğe dizininde alt öğeyi alır.

const body =
    DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody();

// Obtain the first element in the tab.
const firstChild = body.getChild(0);

// If it's a paragraph, set its contents.
if (firstChild.getType() === DocumentApp.ElementType.PARAGRAPH) {
  firstChild.asParagraph().setText('This is the first paragraph.');
}

Parametreler

Ad	Tür	Açıklama
`childIndex`	`Integer`	Alınacak alt öğenin dizini.

Return

Element: Belirtilen dizindeki alt öğe.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`getChildIndex(child)`

Belirtilen alt öğenin alt öğe dizini döndürülür.

Parametreler

Ad	Tür	Açıklama
`child`	`Element`	Dizininin alınacağı alt öğe.

Return

Integer: Alt dizin.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`getImages()`

Bölümdeki tüm InlineImages öğelerini alır.

Return

InlineImage[]: Bölüm resimleri.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`getListItems()`

Bölümdeki tüm ListItems öğelerini alır.

Return

ListItem[]: Bölüm listesi öğeleri.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`getNumChildren()`

Çocuk sayısını alır.

const body =
    DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody();

// Log the number of elements in the tab.
Logger.log(`There are ${body.getNumChildren()} elements in the tab's body.`);

Return

Integer: Çocuk sayısı.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`getParagraphs()`

Bölümde bulunan tüm Paragraphs öğelerini (ListItems dahil) alır.

Return

Paragraph[]: Bölüm paragrafları.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`getParent()`

Öğenin üst öğesini alır.

Üst öğe, geçerli öğeyi içerir.

Return

ContainerElement: Üst öğe.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`getTables()`

Bölümdeki tüm Tables öğelerini alır.

Return

Table[]: Bölüm tabloları.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`getText()`

Öğenin içeriğini metin dizesi olarak alır.

Return

String: Öğenin metin dizesi olarak içeriği

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`getTextAlignment()`

Metin hizalamasını alır. Kullanılabilir hizalama türleri DocumentApp.TextAlignment.NORMAL, DocumentApp.TextAlignment.SUBSCRIPT ve DocumentApp.TextAlignment.SUPERSCRIPT'dir.

Return

TextAlignment: Metin hizalamasının türü veya metin birden fazla metin hizası türü içeriyorsa ya da metin hizası hiç ayarlanmadıysa null

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`getType()`

Öğenin ElementType değerini alır.

Belirli bir öğenin tam türünü belirlemek için getType() öğesini kullanın.

const doc = DocumentApp.getActiveDocument();
const documentTab = doc.getActiveTab().asDocumentTab();
const body = documentTab.getBody();

// Obtain the first element in the active tab's body.

const firstChild = body.getChild(0);

// Use getType() to determine the element's type.
if (firstChild.getType() === DocumentApp.ElementType.PARAGRAPH) {
  Logger.log('The first element is a paragraph.');
} else {
  Logger.log('The first element is not a paragraph.');
}

Return

ElementType: Öğe türü.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`insertHorizontalRule(childIndex)`

Belirtilen dizinde yeni bir HorizontalRule oluşturup ekler.

HorizontalRule, yeni bir Paragraph içinde yer alır.

Parametreler

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

Return

HorizontalRule: Yeni yatay kural.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`insertImage(childIndex, image)`

Belirtilen resim blob'undan, belirtilen dizinde bir InlineImage oluşturup 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`insertImage(childIndex, image)`

Belirtilen InlineImage öğesini belirtilen dizin içine ekler.

Resim yeni bir Paragraph içinde yer alır.

Parametreler

Ad	Tür	Açıklama
`childIndex`	`Integer`	Öğenin ekleneceği dizin.
`image`	`InlineImage`	Eklenecek resim.

Return

InlineImage: Eklenen satır içi resim.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`insertListItem(childIndex, listItem)`

Belirtilen ListItem öğesini belirtilen dizin içine ekler.

Parametreler

Ad	Tür	Açıklama
`childIndex`	`Integer`	Eklemenin yapılacağı dizin.
`listItem`	`ListItem`	Eklenecek liste öğesi.

Return

ListItem: Eklenen liste öğesi.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`insertListItem(childIndex, text)`

Belirtilen dizinde, belirtilen metin içeriklerini içeren yeni bir ListItem oluşturup ekler.

Parametreler

Ad	Tür	Açıklama
`childIndex`	`Integer`	Eklemenin yapılacağı dizin.
`text`	`String`	Liste öğesinin metin içeriği.

Return

ListItem: Yeni liste öğesi.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`insertParagraph(childIndex, paragraph)`

Belirtilen Paragraph öğesini belirtilen dizin içine ekler.

Parametreler

Ad	Tür	Açıklama
`childIndex`	`Integer`	Eklemenin yapılacağı dizin.
`paragraph`	`Paragraph`	Eklenecek paragraf.

Return

Paragraph: Eklenen paragraf.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`insertParagraph(childIndex, text)`

Belirtilen dizinde, belirtilen metin içeriklerini içeren yeni bir Paragraph oluşturup ekler.

Parametreler

Ad	Tür	Açıklama
`childIndex`	`Integer`	Eklemenin yapılacağı dizin.
`text`	`String`	Paragrafın metin içeriği.

Return

Paragraph: Yeni paragraf.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`insertTable(childIndex)`

Belirtilen dizinde yeni bir Table oluşturup ekler.

Parametreler

Ad	Tür	Açıklama
`childIndex`	`Integer`	Eklemenin yapılacağı dizin.

Return

Table: Yeni tablo.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`insertTable(childIndex, cells)`

Belirtilen dizinde, belirtilen hücreleri içeren yeni bir Table oluşturup ekler.

Parametreler

Ad	Tür	Açıklama
`childIndex`	`Integer`	Eklemenin yapılacağı dizin.
`cells`	`String[][]`	Yeni tabloya eklenecek tablo hücrelerinin metin içerikleri.

Return

Table: Yeni tablo.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`insertTable(childIndex, table)`

Belirtilen Table öğesini belirtilen dizin içine ekler.

Parametreler

Ad	Tür	Açıklama
`childIndex`	`Integer`	Eklemenin yapılacağı dizin.
`table`	`Table`	Eklenecek tablo.

Return

Table: Eklenen tablo.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`removeChild(child)`

Belirtilen alt öğeyi kaldırır.

Parametreler

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

Return

HeaderSection: Geçerli öğe.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`removeFromParent()`

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

const doc = DocumentApp.getActiveDocument();
const documentTab = doc.getActiveTab().asDocumentTab();
const body = documentTab.getBody();

// Remove all images in the active tab's body.
const imgs = body.getImages();
for (let i = 0; i < imgs.length; i++) {
  imgs[i].removeFromParent();
}

Return

HeaderSection: Kaldırılan öğe.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`replaceText(searchPattern, replacement)`

Normal ifadeler kullanılarak belirli bir metin kalıbının tüm örnekleri belirli bir değiştirme dizesiyle değiştirilir.

Arama kalıbı, JavaScript normal ifade nesnesi değil, dize olarak iletilir. Bu nedenle, kalıptaki tüm ters eğik çizgileri koddan çıkarmanız gerekir.

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

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

const body =
    DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody();

// Clear the text surrounding "Apps Script", with or without text.
body.replaceText('^.*Apps ?Script.*$', 'Apps Script');

Parametreler

Ad	Tür	Açıklama
`searchPattern`	`String`	Aranacak normal ifade kalıbı
`replacement`	`String`	Değişim olarak kullanılacak metin

Return

Element: Geçerli öğe

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`setAttributes(attributes)`

Öğenin özelliklerini ayarlar.

Belirtilen attributes parametresi, her bir özellik adının DocumentApp.Attribute numaralandırmasında bir öğe olduğu ve her bir özellik değerinin uygulanacak yeni değer olduğu bir nesne olmalıdır.

const doc = DocumentApp.getActiveDocument();
const documentTab = doc.getActiveTab().asDocumentTab();
const body = documentTab.getBody();

// Define a custom paragraph style.
const style = {};
style[DocumentApp.Attribute.HORIZONTAL_ALIGNMENT] =
    DocumentApp.HorizontalAlignment.RIGHT;
style[DocumentApp.Attribute.FONT_FAMILY] = 'Calibri';
style[DocumentApp.Attribute.FONT_SIZE] = 18;
style[DocumentApp.Attribute.BOLD] = true;

// Append a plain paragraph.
const par = body.appendParagraph('A paragraph with custom style.');

// Apply the custom style.
par.setAttributes(style);

Parametreler

Ad	Tür	Açıklama
`attributes`	`Object`	Öğenin özellikleri.

Return

HeaderSection: Geçerli öğe.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`setText(text)`

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

Not: Mevcut içerikler silinir.

Parametreler

Ad	Tür	Açıklama
`text`	`String`	Yeni metin içerikleri.

Return

HeaderSection: Geçerli öğe.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`setTextAlignment(textAlignment)`

Metin hizalamasını ayarlar. Kullanılabilir hizalama türleri 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

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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

Kullanımdan kaldırılan yöntemler

`getFootnotes()`

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

Bölümdeki tüm Footnotes öğelerini alır.

Return

Footnote[]: Bölüm dipnotları.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`getLinkUrl()`

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

Bağlantı URL'sini alır.

Return

String: Bağlantı URL'si veya öğe bu özellik için birden fazla değer içeriyorsa null

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`getNextSibling()`

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

Öğenin sonraki kardeş öğesini alır.

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

Return

Element: Sonraki kardeş öğe.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`getPreviousSibling()`

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

Öğenin önceki kardeş öğesini alır.

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

Return

Element: Önceki kardeş öğe.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`isAtDocumentEnd()`

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

Öğenin Document'ün sonunda olup olmadığını belirler.

Return

Boolean: Öğenin sekmenin sonunda olup olmadığı.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`setLinkUrl(url)`

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

Bağlantı URL'sini ayarlar.

Parametreler

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

Return

HeaderSection: Geçerli öğe

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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