Class Text

Text

Zengin metin bölgesini temsil eden bir öğe. Bir Document içindeki tüm metinler Text öğelerinin içinde bulunur. Text öğesi Equation, EquationFunction, ListItem veya Paragraph içinde bulunabilir ancak başka herhangi bir öğe içeremez. Doküman yapısı hakkında daha fazla bilgi edinmek için Google Dokümanlar'ı genişletme kılavuzuna bakın.

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

// Use editAsText to obtain a single text element containing
// all the characters in the document.
var text = body.editAsText();

// Insert text at the beginning of the document.
text.insertText(0, 'Inserted text.\n');

// Insert text at the end of the document.
text.appendText('\nAppended text.');

// Make the first half of the document blue.
text.setForegroundColor(0, text.getText().length / 2, '#00FFFF');

Yöntemler

YöntemDönüş türüKısa açıklama
appendText(text)TextBelirtilen metni bu metin bölgesinin sonuna ekler.
copy()TextGeçerli öğenin ayrı ve derin bir kopyasını döndürür.
deleteText(startOffset, endOffsetInclusive)TextMetin aralığını siler.
editAsText()TextDüzenlemek için geçerli öğenin Text sürümünü alır.
findText(searchPattern)RangeElementNormal ifadeler kullanarak belirtilen metin kalıbı için öğenin içeriğinde arama yapar.
findText(searchPattern, from)RangeElementBelirli bir arama sonucundan itibaren öğenin içeriğini belirtilen metin kalıbı için arar.
getAttributes()ObjectÖğenin özelliklerini alır.
getAttributes(offset)ObjectBelirtilen karakter farkındaki özellikleri getirir.
getBackgroundColor()StringArka plan renk ayarını alır.
getBackgroundColor(offset)StringBelirtilen karakter ofsetinde arka plan rengini alır.
getFontFamily()StringYazı tipi ailesi ayarını alır.
getFontFamily(offset)StringBelirtilen karakter farkında yazı tipi ailesini getirir.
getFontSize()NumberYazı tipi boyutu ayarını alır.
getFontSize(offset)NumberBelirtilen karakter farkındaki yazı tipi boyutunu alır.
getForegroundColor()StringÖn plan renk ayarını alır.
getForegroundColor(offset)StringBelirtilen karakter ofsetinde ön plan rengini alır.
getLinkUrl()StringBağlantı URL'sini alır.
getLinkUrl(offset)StringBelirtilen karakter farkında bağlantı URL'sini alır.
getNextSibling()ElementÖğenin sonraki kardeş öğesini alır.
getParent()ContainerElementÖğenin üst öğesini alır.
getPreviousSibling()ElementÖğenin önceki kardeş öğesini alır.
getText()StringÖğenin içeriğini metin dizesi olarak alır.
getTextAlignment()TextAlignmentMetin hizalamasını alır.
getTextAlignment(offset)TextAlignmentTek bir karakterin metin hizalamasını alır.
getTextAttributeIndices()Integer[]Ayrı metin biçimlendirme çalıştırmalarının başlangıcına karşılık gelen metin dizini grubunu alır.
getType()ElementTypeÖğenin ElementType değerini alır.
insertText(offset, text)TextBelirtilen metni belirtilen karakter farkına ekler.
isAtDocumentEnd()BooleanÖğenin, Document öğesinin sonunda olup olmadığını belirler.
isBold()BooleanKalın ayarını alır.
isBold(offset)BooleanBelirtilen karakter farkında kalın ayarı alır.
isItalic()Booleanİtalik ayarını getirir.
isItalic(offset)BooleanBelirtilen karakter farkı karşısında italik ayarını getirir.
isStrikethrough()BooleanÜstü çizili ayarını getirir.
isStrikethrough(offset)BooleanBelirtilen karakter ofsetinde üstü çizili ayarı alır.
isUnderline()BooleanAltı çizili ayarını alır.
isUnderline(offset)BooleanBelirtilen karakter ofsetinde altı çizili ayarını getirir.
merge()TextÖğeyi, aynı türden önceki kardeş öğeyle birleştirir.
removeFromParent()TextÖğeyi üst öğesinden kaldırır.
replaceText(searchPattern, replacement)ElementNormal ifadeler kullanarak, belirli bir metin kalıbının tüm tekrarlarını belirli bir değiştirme dizesiyle değiştirir.
setAttributes(startOffset, endOffsetInclusive, attributes)TextBelirtilen özellikleri belirtilen karakter aralığına uygular.
setAttributes(attributes)TextÖğenin özelliklerini ayarlar.
setBackgroundColor(startOffset, endOffsetInclusive, color)TextBelirtilen karakter aralığının arka plan rengini ayarlar.
setBackgroundColor(color)TextArka plan rengini ayarlar.
setBold(bold)TextKalın ayarını yapar.
setBold(startOffset, endOffsetInclusive, bold)TextBelirtilen karakter aralığı için kalın ayarı yapar.
setFontFamily(startOffset, endOffsetInclusive, fontFamilyName)TextBelirtilen karakter aralığının yazı tipi ailesini ayarlar.
setFontFamily(fontFamilyName)TextYazı tipi ailesini ayarlar.
setFontSize(startOffset, endOffsetInclusive, size)TextBelirtilen karakter aralığının yazı tipi boyutunu ayarlar.
setFontSize(size)TextYazı tipi boyutunu ayarlar.
setForegroundColor(startOffset, endOffsetInclusive, color)TextBelirtilen karakter aralığının ön plan rengini ayarlar.
setForegroundColor(color)TextÖn plan rengini ayarlar.
setItalic(italic)Textİtalik ayarını yapar.
setItalic(startOffset, endOffsetInclusive, italic)TextBelirtilen karakter aralığı için italik ayarını yapar.
setLinkUrl(startOffset, endOffsetInclusive, url)TextBelirtilen karakter aralığının bağlantı URL'sini ayarlar.
setLinkUrl(url)TextBağlantı URL'sini ayarlar.
setStrikethrough(strikethrough)TextÜstü çizili ayarını belirtir.
setStrikethrough(startOffset, endOffsetInclusive, strikethrough)TextBelirtilen karakter aralığı için üstü çizilir ayarı yapar.
setText(text)TextMetin içeriğini ayarlar.
setTextAlignment(startOffset, endOffsetInclusive, textAlignment)TextBelirli bir karakter aralığı için metin hizalamasını ayarlar.
setTextAlignment(textAlignment)TextMetin hizalamasını ayarlar.
setUnderline(underline)TextAltı çizili ayarını ayarlar.
setUnderline(startOffset, endOffsetInclusive, underline)TextBelirtilen karakter aralığı için altı çizili ayarı yapar.

Ayrıntılı belgeler

appendText(text)

Belirtilen metni bu metin bölgesinin sonuna ekler.

// Opens the Docs file by its URL. If you created your script from within a
// Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the URL with your own.
const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/abc123456/edit');

// Gets the document body.
const body = doc.getBody();

// Adds the text, 'Sample body text,' to the end of the document body.
const text = body.editAsText().appendText('Sample body text');

Parametreler

AdTürAçıklama
textStringEklenecek metin.

Return

Text: Geçerli öğe.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları için aşağıdaki kapsamlardan en az birinin yetkilendirilmesi gerekir:

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

copy()

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

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

Return

Text - Yeni kopya.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları için aşağıdaki kapsamlardan en az birinin yetkilendirilmesi gerekir:

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

deleteText(startOffset, endOffsetInclusive)

Metin aralığını siler.

// Opens the Docs file by its URL. If you created your script from within a
// Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the URL with your own.
 const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/abc123456/edit');

// Gets the document body.
const body = doc.getBody();

// Deletes the first 10 characters in the body.
 const text = body.editAsText().deleteText(0, 9);

Parametreler

AdTürAçıklama
startOffsetIntegerSilinecek ilk karakterin karakter göreli konumu.
endOffsetInclusiveIntegerSilinecek son karakterin karakter göreli konumu.

Return

Text: Geçerli öğe.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları için aşağıdaki kapsamlardan en az birinin yetkilendirilmesi gerekir:

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

editAsText()

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

Öğe içeriğini zengin metin olarak değiştirmek için editAsText kullanın. editAsText modu, metin olmayan öğeleri (ör. InlineImage ve HorizontalRule) yok sayar.

Tamamen silinmiş bir metin aralığında bulunan 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 bir metin sürümü


findText(searchPattern)

Normal ifadeler kullanarak belirtilen metin kalıbı için öğenin içeriğinde arama yapar.

Yakalama grupları ve mod değiştiriciler gibi JavaScript normal ifade özelliklerinin bir alt kümesi tam olarak desteklenmez.

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

Parametreler

AdTürAçıklama
searchPatternStringaranacak kalıp

Return

RangeElement: Arama metninin konumunu belirten bir arama sonucudur veya eşleşme yoksa boştur

Yetkilendirme

Bu yöntemi kullanan komut dosyaları için aşağıdaki kapsamlardan en az birinin yetkilendirilmesi gerekir:

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

findText(searchPattern, from)

Belirli bir arama sonucundan itibaren öğenin içeriğini belirtilen metin kalıbı için arar.

Yakalama grupları ve mod değiştiriciler gibi JavaScript normal ifade özelliklerinin bir alt kümesi tam olarak desteklenmez.

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

Parametreler

AdTürAçıklama
searchPatternStringaranacak kalıp
fromRangeElementarama yapılacak arama sonucu

Return

RangeElement: Arama metninin sonraki konumunu belirten bir arama sonucudur veya eşleşme yoksa boştur

Yetkilendirme

Bu yöntemi kullanan komut dosyaları için aşağıdaki kapsamlardan en az birinin yetkilendirilmesi gerekir:

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

getAttributes()

Öğenin özelliklerini alır.

Sonuç olarak, geçerli her öğe özelliği için bir özellik içeren ve her mülk adının DocumentApp.Attribute sıralamasındaki bir öğeye karşılık geldiği bir nesne elde edilir.

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 özellikleri.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları için aşağıdaki kapsamlardan en az birinin yetkilendirilmesi gerekir:

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

getAttributes(offset)

Belirtilen karakter farkındaki özellikleri getirir.

Sonuç olarak, her özellik adının DocumentApp.Attribute sıralamasındaki bir öğeye karşılık geldiği geçerli her metin özelliği için bir özellik içeren bir nesne elde edilir.

// Opens the Docs file by its URL. If you created your script from within a
// Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the URL with your own.
const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/abc123456/edit');

// Gets the document body.
const body = doc.getBody();

// Declares style attributes.
const style = {}
style[DocumentApp.Attribute.BOLD] = true;
style[DocumentApp.Attribute.ITALIC] = true;
style[DocumentApp.Attribute.FONT_SIZE] = 29;

// Sets the style attributes to the document body.
const text = body.editAsText();
text.setAttributes(style);

// Gets the style attributes applied to the eleventh character in the
// body and logs them to the console.
const attributes = text.getAttributes(10);
console.log(attributes);

Parametreler

AdTürAçıklama
offsetIntegerKarakter göreli konumu.

Return

Object: Öğenin özellikleri.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları için aşağıdaki kapsamlardan en az birinin yetkilendirilmesi gerekir:

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

getBackgroundColor()

Arka plan renk ayarını alır.

Return

String: CSS gösterimi biçiminde biçimlendirilmiş arka plan rengi ('#ffffff' gibi) veya öğe bu özellik için birden çok değer içeriyorsa boştur

Yetkilendirme

Bu yöntemi kullanan komut dosyaları için aşağıdaki kapsamlardan en az birinin yetkilendirilmesi gerekir:

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

getBackgroundColor(offset)

Belirtilen karakter ofsetinde arka plan rengini alır.

// Opens the Docs file by its URL. If you created your script from within a
// Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the URL with your own.
const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/abc123456');

// Gets the document body.
const body = doc.getBody();

// Sets the background color of the first 3 characters in the body.
const text = body.editAsText().setBackgroundColor(0, 2, '#FFC0CB');

// Gets the background color of the first character in the body.
const backgroundColor = text.getBackgroundColor(0);

// Logs the background color to the console.
console.log(backgroundColor);

Parametreler

AdTürAçıklama
offsetIntegerKarakter göreli konumu.

Return

String - CSS notasyonunda biçimlendirilmiş ('#ffffff' gibi) arka plan rengi.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları için aşağıdaki kapsamlardan en az birinin yetkilendirilmesi gerekir:

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

getFontFamily()

Yazı tipi ailesi ayarını alır. Ad, Dokümanlar'daki veya Google Fonts'taki Yazı tipi menüsünden herhangi bir yazı tipi olabilir ve büyük/küçük harfe duyarlıdır. getFontFamily() ve setFontFamily(fontFamilyName) yöntemleri artık FontFamily sıralama yerine yazı tipleri için dize adlarını kullanıyor. Bu sıralama kullanımdan kaldırılmış olsa da eski komut dosyalarıyla uyumlu olmaya devam edecektir.

Return

String: Yazı tipi ailesi veya öğe bu özellik için birden fazla değer içeriyorsa boş

Yetkilendirme

Bu yöntemi kullanan komut dosyaları için aşağıdaki kapsamlardan en az birinin yetkilendirilmesi gerekir:

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

getFontFamily(offset)

Belirtilen karakter farkında yazı tipi ailesini getirir. Ad, Dokümanlar veya Google Fonts'taki Yazı tipi menüsünden herhangi bir yazı tipi olabilir ve büyük/küçük harfe duyarlıdır. getFontFamily() ve setFontFamily(fontFamilyName) yöntemlerinde artık yazı tipleri için FontFamily sıralama yerine dize adları kullanılıyor. Bu sıralama kullanımdan kaldırılmış olsa da eski komut dosyalarıyla uyumlu olmaya devam edecektir.

// Opens the Docs file by its URL. If you created your script from within a
// Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the URL with your own.
const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/abc123456/edit');

// Gets the document body.
const body = doc.getBody();

// Sets the font of the first 16 characters to Impact.
const text = body.editAsText().setFontFamily(0, 15, 'Impact');

// Gets the font family of the 16th character in the document body.
const fontFamily = text.getFontFamily(15);

// Logs the font family to the console.
console.log(fontFamily);

Parametreler

AdTürAçıklama
offsetIntegerKarakter göreli konumu.

Return

String - Yazı tipi ailesi.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları için aşağıdaki kapsamlardan en az birinin yetkilendirilmesi gerekir:

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

getFontSize()

Yazı tipi boyutu ayarını alır.

Return

Number: Yazı tipi boyutu veya öğe bu özellik için birden fazla değer içeriyorsa boş

Yetkilendirme

Bu yöntemi kullanan komut dosyaları için aşağıdaki kapsamlardan en az birinin yetkilendirilmesi gerekir:

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

getFontSize(offset)

Belirtilen karakter farkındaki yazı tipi boyutunu alır.

// Opens the Docs file by its URL. If you created your script from within a
// Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the URL with your own.
const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/abc123456/edit');

// Gets the document body.
const body = doc.getBody();

// Sets the font size of the first 13 characters to 15.
const text = body.editAsText().setFontSize(0, 12, 15);

// Gets the font size of the first character.
const fontSize = text.getFontSize(0);

// Logs the font size to the console.
console.log(fontSize);

Parametreler

AdTürAçıklama
offsetIntegerKarakter göreli konumu.

Return

Number: Yazı tipi boyutu.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları için aşağıdaki kapsamlardan en az birinin yetkilendirilmesi gerekir:

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

getForegroundColor()

Ön plan renk ayarını alır.

Return

String: CSS notasyonunda biçimlendirilmiş ('#ffffff' gibi) ön plan rengi veya öğe, bu özellik için birden çok değer içeriyorsa boştur

Yetkilendirme

Bu yöntemi kullanan komut dosyaları için aşağıdaki kapsamlardan en az birinin yetkilendirilmesi gerekir:

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

getForegroundColor(offset)

Belirtilen karakter ofsetinde ön plan rengini alır.

// Opens the Docs file by its URL. If you created your script from within a
// Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the URL with your own.
const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/abc123456/edit');

// Gets the document body.
const body = doc.getBody();

// Sets the foreground color of the first 3 characters in the document body.
const text = body.editAsText().setForegroundColor(0, 2, '#0000FF');

// Gets the foreground color of the first character in the document body.
const foregroundColor = text.getForegroundColor(0);

// Logs the foreground color to the console.
console.log(foregroundcolor);

Parametreler

AdTürAçıklama
offsetIntegerKarakter göreli konumu.

Return

String - CSS gösterimi biçiminde biçimlendirilmiş ön plan rengi ('#ffffff' gibi).

Yetkilendirme

Bu yöntemi kullanan komut dosyaları için aşağıdaki kapsamlardan en az birinin yetkilendirilmesi gerekir:

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

getLinkUrl()

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ı için aşağıdaki kapsamlardan en az birinin yetkilendirilmesi gerekir:

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

getLinkUrl(offset)

Belirtilen karakter farkında bağlantı URL'sini alır.

// Opens the Docs file by its URL. If you created your script from within a
// Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the URL with your own.
const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/abc123456/edit');

// Gets the document body.
const body = doc.getBody();

// Applies a link to the first 10 characters in the body.
const text = body.editAsText().setLinkUrl(0, 9, 'https://www.example.com/');

// Gets the URL of the link from the first character.
const link = text.getLinkUrl(0);

// Logs the link URL to the console.
console.log(link);

Parametreler

AdTürAçıklama
offsetIntegerKarakter göreli konumu.

Return

String - Bağlantı URL'si.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları için aşağıdaki kapsamlardan en az birinin yetkilendirilmesi gerekir:

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

getNextSibling()

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

Sonraki kardeş aynı üst öğeye sahip ve geçerli öğeyi takip ediyor.

Return

Element - Sonraki kardeş öğe.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları için aşağıdaki kapsamlardan en az birinin 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 öğedir.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları için aşağıdaki kapsamlardan en az birinin yetkilendirilmesi gerekir:

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

getPreviousSibling()

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

Önceki kardeş aynı üst öğeye sahip ve geçerli öğeden önce.

Return

Element - Önceki kardeş öğesi.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları için aşağıdaki kapsamlardan en az birinin 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ı için aşağıdaki kapsamlardan en az birinin 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 hizalama türü veya metin birden fazla metin hizalama türü içeriyorsa veya metin hizalama hiç ayarlanmamışsa null

Yetkilendirme

Bu yöntemi kullanan komut dosyaları için aşağıdaki kapsamlardan en az birinin yetkilendirilmesi gerekir:

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

getTextAlignment(offset)

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

// Opens the Docs file by its URL. If you created your script from within a
// Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the URL with your own.
const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/abc123456/edit');

// Gets the document body.
const body = doc.getBody();

// Sets the text alignment of the document body to NORMAL.
const text = body.editAsText().setTextAlignment(DocumentApp.TextAlignment.NORMAL);

// Gets the text alignment of the ninth character.
const alignment = text.getTextAlignment(8);

// Logs the text alignment to the console.
console.log(alignment.toString());

Parametreler

AdTürAçıklama
offsetIntegerKarakterin ofseti.

Return

TextAlignment: Metin hizalama türü veya metin hizalaması daha önce hiç ayarlanmamışsa null.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları için aşağıdaki kapsamlardan en az birinin yetkilendirilmesi gerekir:

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

getTextAttributeIndices()

Ayrı metin biçimlendirme çalıştırmalarının başlangıcına karşılık gelen metin dizini grubunu alır.

// Opens the Docs file by its URL. If you created your script from within a
// Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the URL with your own.
const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/abc123456/edit');

// Gets the document body.
const body = doc.getBody();

// Gets the text indices at which text formatting changes.
const indices = body.editAsText().getTextAttributeIndices();

// Logs the indices to the console.
console.log(indices.toString());

Return

Integer[] - Metin biçimlendirmesinin değiştiği metin dizinleri.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları için aşağıdaki kapsamlardan en az birinin 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() işlevini 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ı için aşağıdaki kapsamlardan en az birinin yetkilendirilmesi gerekir:

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

insertText(offset, text)

Belirtilen metni belirtilen karakter farkına ekler.

// Opens the Docs file by its URL. If you created your script from within a
// Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the URL with your own.
const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/abc123456/edit');

// Gets the document body.
const body = doc.getBody();

// Inserts the text, 'Sample inserted text', at the start of the body content.
const text = body.editAsText().insertText(0, 'Sample inserted text');

Parametreler

AdTürAçıklama
offsetIntegerMetnin ekleneceği karakter ofseti.
textStringEklenecek metin.

Return

Text: Geçerli öğe.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları için aşağıdaki kapsamlardan en az birinin yetkilendirilmesi gerekir:

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

isAtDocumentEnd()

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

Return

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

Yetkilendirme

Bu yöntemi kullanan komut dosyaları için aşağıdaki kapsamlardan en az birinin yetkilendirilmesi gerekir:

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

isBold()

Kalın ayarını alır.

Return

Boolean: metnin kalın olup olmadığı veya öğe bu özellik için birden çok değer içeriyorsa null

Yetkilendirme

Bu yöntemi kullanan komut dosyaları için aşağıdaki kapsamlardan en az birinin yetkilendirilmesi gerekir:

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

isBold(offset)

Belirtilen karakter farkında kalın ayarı alır.

// Opens the Docs file by its URL. If you created your script from within a
// Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the URL with your own.
const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/abc123456/edit');

// Gets the document body.
const body = doc.getBody();

// Bolds the first 4 characters in the document body.
const text = body.editAsText().setBold(0, 3, true);

// Gets whether or not the text is bold.
const bold = text.editAsText().isBold(0);

// Logs the text's bold setting to the console
console.log(bold);

Parametreler

AdTürAçıklama
offsetIntegerKarakter göreli konumu.

Return

Boolean - Kalın ayar.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları için aşağıdaki kapsamlardan en az birinin yetkilendirilmesi gerekir:

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

isItalic()

İtalik ayarını getirir.

Return

Boolean: Metnin italik olup olmadığı veya öğe bu özellik için birden fazla değer içeriyorsa null

Yetkilendirme

Bu yöntemi kullanan komut dosyaları için aşağıdaki kapsamlardan en az birinin yetkilendirilmesi gerekir:

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

isItalic(offset)

Belirtilen karakter farkı karşısında italik ayarını getirir.

// Opens the Docs file by its URL. If you created your script from within a
// Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the URL with your own.
const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/abc123456/edit');

// Gets the document body.
const body = doc.getBody();

// Sets the first 13 characters of the document body to italic.
const text = body.editAsText().setItalic(0, 12, true);

// Gets whether the fifth character in the document body is set to
// italic and logs it to the console.
const italic = text.isItalic(4);
console.log(italic);

Parametreler

AdTürAçıklama
offsetIntegerKarakter göreli konumu.

Return

Boolean: İtalik ayarı.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları için aşağıdaki kapsamlardan en az birinin yetkilendirilmesi gerekir:

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

isStrikethrough()

Üstü çizili ayarını getirir.

Return

Boolean: Metnin üstü çizilir veya öğe bu özellik için birden fazla değer içeriyorsa null (boş değer)

Yetkilendirme

Bu yöntemi kullanan komut dosyaları için aşağıdaki kapsamlardan en az birinin yetkilendirilmesi gerekir:

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

isStrikethrough(offset)

Belirtilen karakter ofsetinde üstü çizili ayarı alır.

// Opens the Docs file by its URL. If you created your script from within a
// Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the URL with your own.
const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/abc123456/edit');

// Gets the document body.
const body = doc.getBody();

// Sets the first 17 characters of the document body to strikethrough.
const text = body.editAsText().setStrikethrough(0, 16, true);

// Gets whether the first character in the document body is set to
// strikethrough and logs it to the console.
const strikethrough = text.isStrikethrough(0);
console.log(strikethrough);

Parametreler

AdTürAçıklama
offsetIntegerKarakter göreli konumu.

Return

Boolean: Üstü çizili ayar.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları için aşağıdaki kapsamlardan en az birinin yetkilendirilmesi gerekir:

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

isUnderline()

Altı çizili ayarını alır.

Return

Boolean: Metnin altı çizili olup olmadığı veya öğe bu özellik için birden fazla değer içeriyorsa null

Yetkilendirme

Bu yöntemi kullanan komut dosyaları için aşağıdaki kapsamlardan en az birinin yetkilendirilmesi gerekir:

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

isUnderline(offset)

Belirtilen karakter ofsetinde altı çizili ayarını getirir.

// Opens the Docs file by its URL. If you created your script from within a
// Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the URL with your own.
const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/abc123456/edit');

// Gets the document body.
const body = doc.getBody();

// Sets the first 13 characters of the document body to underline.
const text = body.editAsText().setUnderline(0, 12, false);

// Gets whether the first character in the document body is set to
// underline and logs it to the console
const underline = text.editAsText().isUnderline(0);
console.log(underline);

Parametreler

AdTürAçıklama
offsetIntegerKarakter göreli konumu.

Return

Boolean: Altı çizili ayar.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları için aşağıdaki kapsamlardan en az birinin yetkilendirilmesi gerekir:

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

merge()

Öğeyi, aynı türden önceki kardeş öğeyle birleştirir.

Yalnızca aynı ElementType öğesinin öğeleri birleştirilebilir. Geçerli öğede bulunan tüm alt öğeler önceki kardeş öğeye taşınır.

Geçerli öğe dokümandan kaldırıldı.

var body = DocumentApp.getActiveDocument().getBody();
// Example 1: Merge paragraphs
// Append two paragraphs to the document.
var par1 = body.appendParagraph('Paragraph 1.');
var par2 = body.appendParagraph('Paragraph 2.');
// Merge the newly added paragraphs into a single paragraph.
par2.merge();

// Example 2: Merge table cells
// Create a two-dimensional array containing the table's cell contents.
var cells = [
['Row 1, Cell 1', 'Row 1, Cell 2'],
['Row 2, Cell 1', 'Row 2, Cell 2']
];
// Build a table from the array.
var table = body.appendTable(cells);
// Get the first row in the table.
 var row = table.getRow(0);
// Get the two cells in this row.
var cell1 = row.getCell(0);
var cell2 = row.getCell(1);
// Merge the current cell into its preceding sibling element.
var merged = cell2.merge();

Return

Text - Birleştirilen öğe.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları için aşağıdaki kapsamlardan en az birinin yetkilendirilmesi gerekir:

  • 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

Text - Kaldırılan öğe.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları için aşağıdaki kapsamlardan en az birinin yetkilendirilmesi gerekir:

  • 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ı belirli bir değiştirme dizesiyle değiştirir.

Arama modeli, JavaScript normal ifade nesnesi olarak değil dize olarak iletilir. Bu nedenle, desendeki ters eğik çizgilerden kaçınmanız gerekir.

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

Sağlanan normal ifade kalıbı, geçerli öğede yer alan her bir 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

AdTürAçıklama
searchPatternStringiçin normal ifade kalıbı
replacementStringbunun yerine kullanılan metin

Return

Element - geçerli öğe

Yetkilendirme

Bu yöntemi kullanan komut dosyaları için aşağıdaki kapsamlardan en az birinin yetkilendirilmesi gerekir:

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

setAttributes(startOffset, endOffsetInclusive, attributes)

Belirtilen özellikleri belirtilen karakter aralığına uygular.

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

// Opens the Docs file by its URL. If you created your script from within a
// Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the URL with your own.
const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/abc123456/edit');

// Gets the document body and edits as text.
const body = doc.getBody().editAsText();

// Declares style attributes for font size and font family.
const style = {}
style[DocumentApp.Attribute.FONT_SIZE] = 20 ;
style[DocumentApp.Attribute.FONT_FAMILY] = 'Impact';

// Sets the style attributes to the first 9 characters in the document body.
const text = body.setAttributes(0, 8, style);

Parametreler

AdTürAçıklama
startOffsetIntegerMetin aralığının başlangıç ofseti.
endOffsetInclusiveIntegerMetin aralığının bitiş ofseti.
attributesObjectÖğenin özellikleri.

Return

Text: Geçerli öğe.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları için aşağıdaki kapsamlardan en az birinin yetkilendirilmesi gerekir:

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

setAttributes(attributes)

Öğenin özelliklerini ayarlar.

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

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

AdTürAçıklama
attributesObjectÖğenin özellikleri.

Return

Text: Geçerli öğe.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları için aşağıdaki kapsamlardan en az birinin yetkilendirilmesi gerekir:

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

setBackgroundColor(startOffset, endOffsetInclusive, color)

Belirtilen karakter aralığının arka plan rengini ayarlar.

// Opens the Docs file by its URL. If you created your script from within a
// Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the URL with your own.
const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/abc123456/edit');

// Gets the document body.
const body = doc.getBody();

// Sets the background color of the first 3 characters in the
// document body to hex color #0000FF.
const text = body.editAsText().setBackgroundColor(0, 2, '#0000FF');

Parametreler

AdTürAçıklama
startOffsetIntegerMetin aralığının başlangıç ofseti.
endOffsetInclusiveIntegerMetin aralığının bitiş ofseti.
colorStringCSS notasyonunda ('#ffffff' gibi) biçimlendirilmiş arka plan rengi.

Return

Text: Geçerli öğe.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları için aşağıdaki kapsamlardan en az birinin yetkilendirilmesi gerekir:

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

setBackgroundColor(color)

Arka plan rengini ayarlar.

Parametreler

AdTürAçıklama
colorStringCSS gösterimi biçiminde biçimlendirilmiş arka plan rengi ('#ffffff' gibi)

Return

Text - geçerli öğe

Yetkilendirme

Bu yöntemi kullanan komut dosyaları için aşağıdaki kapsamlardan en az birinin yetkilendirilmesi gerekir:

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

setBold(bold)

Kalın ayarını yapar.

Parametreler

AdTürAçıklama
boldBooleankalın ayarı

Return

Text - geçerli öğe

Yetkilendirme

Bu yöntemi kullanan komut dosyaları için aşağıdaki kapsamlardan en az birinin yetkilendirilmesi gerekir:

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

setBold(startOffset, endOffsetInclusive, bold)

Belirtilen karakter aralığı için kalın ayarı yapar.

// Opens the Docs file by its URL. If you created your script from within a
// Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the URL with your own.
const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/abc123456/edit');

// Gets the document body.
const body = doc.getBody();

// Sets the first 11 characters in the document body to bold.
const text = body.editAsText().setBold(0, 10, true);

Parametreler

AdTürAçıklama
startOffsetIntegerMetin aralığının başlangıç ofseti.
endOffsetInclusiveIntegerMetin aralığının bitiş ofseti.
boldBooleanKalın ayar.

Return

Text: Geçerli öğe.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları için aşağıdaki kapsamlardan en az birinin yetkilendirilmesi gerekir:

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

setFontFamily(startOffset, endOffsetInclusive, fontFamilyName)

Belirtilen karakter aralığının yazı tipi ailesini ayarlar. Ad, Dokümanlar veya Google Fonts'taki Yazı tipi menüsünden herhangi bir yazı tipi olabilir ve büyük/küçük harfe duyarlıdır. Tanınmayan yazı tipi adları LTI olarak oluşturulur. getFontFamily(offset) ve setFontFamily(fontFamilyName) yöntemleri artık yazı tipleri için FontFamily sıralama yerine dize adlarını kullanıyor. Bu sıralama kullanımdan kaldırılmış olsa da eski komut dosyalarıyla uyumlu olmaya devam edecektir.

// Opens the Docs file by its URL. If you created your script from within a
// Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the URL with your own.
const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/abc123456/edit');

// Gets body of the document.
const body = doc.getBody();

// Sets the font of the first 4 characters in the document body to Roboto.
const text = body.editAsText().setFontFamily(0, 3, 'Roboto');

Parametreler

AdTürAçıklama
startOffsetIntegerMetin aralığının başlangıç ofseti.
endOffsetInclusiveIntegerMetin aralığının bitiş ofseti.
fontFamilyNameStringDokümanlar veya Google Fonts'taki Yazı tipi menüsünden yazı tipi ailesinin adı.

Return

Text: Geçerli öğe.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları için aşağıdaki kapsamlardan en az birinin yetkilendirilmesi gerekir:

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

setFontFamily(fontFamilyName)

Yazı tipi ailesini ayarlar. Ad, Dokümanlar'daki veya Google Fonts'taki Yazı tipi menüsünden herhangi bir yazı tipi olabilir ve büyük/küçük harfe duyarlıdır. Tanınmayan yazı tipi adları sıfır olarak oluşturulur. getFontFamily() ve setFontFamily(fontFamilyName) yöntemleri artık yazı tipleri için FontFamily sıralama yerine dize adlarını kullanıyor. Bu sıralama kullanımdan kaldırılmış olsa da eski komut dosyalarıyla uyumlu olmaya devam edecektir.

Parametreler

AdTürAçıklama
fontFamilyNameStringDokümanlar veya Google Fonts'taki Yazı tipi menüsünden yazı tipi ailesinin adı

Return

Text - geçerli öğe

Yetkilendirme

Bu yöntemi kullanan komut dosyaları için aşağıdaki kapsamlardan en az birinin yetkilendirilmesi gerekir:

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

setFontSize(startOffset, endOffsetInclusive, size)

Belirtilen karakter aralığının yazı tipi boyutunu ayarlar.

// Opens the Docs file by its URL. If you created your script from within a
// Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the URL with your own.
const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/abc123456/edit');

// Gets the document body.
const body = doc.getBody();

// Sets the size of the first 11 characters in the document body to 12.
const text = body.editAsText().setFontSize(0, 10, 12);

Parametreler

AdTürAçıklama
startOffsetIntegerMetin aralığının başlangıç ofseti.
endOffsetInclusiveIntegerMetin aralığının bitiş ofseti.
sizeNumberYazı tipi boyutu.

Return

Text: Geçerli öğe.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları için aşağıdaki kapsamlardan en az birinin yetkilendirilmesi gerekir:

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

setFontSize(size)

Yazı tipi boyutunu ayarlar.

Parametreler

AdTürAçıklama
sizeNumberyazı tipi boyutu

Return

Text - geçerli öğe

Yetkilendirme

Bu yöntemi kullanan komut dosyaları için aşağıdaki kapsamlardan en az birinin yetkilendirilmesi gerekir:

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

setForegroundColor(startOffset, endOffsetInclusive, color)

Belirtilen karakter aralığının ön plan rengini ayarlar.

// Opens the Docs file by its URL. If you created your script from within a
// Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the URL with your own.
const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/abc123456/edit');

// Gets the document body.
const body = doc.getBody();

// Sets the foreground color of the first 2 characters in the
// document body to hex color #FF0000.
const text = body.editAsText().setForegroundColor(0, 1, '#FF0000');

// Gets the foreground color for the second character in the document body.
const foregroundColor = text.getForegroundColor(1);

//  Logs the foreground color to the console.
console.log(foregroundColor);

Parametreler

AdTürAçıklama
startOffsetIntegerMetin aralığının başlangıç ofseti.
endOffsetInclusiveIntegerMetin aralığının bitiş ofseti.
colorStringCSS gösterimi biçiminde biçimlendirilmiş ön plan rengi ('#ffffff' gibi).

Return

Text: Geçerli öğe.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları için aşağıdaki kapsamlardan en az birinin yetkilendirilmesi gerekir:

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

setForegroundColor(color)

Ön plan rengini ayarlar.

Parametreler

AdTürAçıklama
colorStringCSS gösterimi biçiminde biçimlendirilmiş ön plan rengi ('#ffffff' gibi)

Return

Text - geçerli öğe

Yetkilendirme

Bu yöntemi kullanan komut dosyaları için aşağıdaki kapsamlardan en az birinin yetkilendirilmesi gerekir:

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

setItalic(italic)

İtalik ayarını yapar.

Parametreler

AdTürAçıklama
italicBooleanitalik ayarı

Return

Text - geçerli öğe

Yetkilendirme

Bu yöntemi kullanan komut dosyaları için aşağıdaki kapsamlardan en az birinin yetkilendirilmesi gerekir:

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

setItalic(startOffset, endOffsetInclusive, italic)

Belirtilen karakter aralığı için italik ayarını yapar.

// Opens the Docs file by its URL. If you created your script from within a
// Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the URL with your own.
const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/abc123456/edit');

// Gets the document body.
const body = doc.getBody();

// Sets the first 11 characters in the document body to italic.
const text = body.editAsText().setItalic(0, 10, true);

Parametreler

AdTürAçıklama
startOffsetIntegerMetin aralığının başlangıç ofseti.
endOffsetInclusiveIntegerMetin aralığının bitiş ofseti.
italicBooleanİtalik ayarı.

Return

Text: Geçerli öğe.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları için aşağıdaki kapsamlardan en az birinin yetkilendirilmesi gerekir:

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

setLinkUrl(startOffset, endOffsetInclusive, url)

Belirtilen karakter aralığının bağlantı URL'sini ayarlar.

// Opens the Docs file by its URL. If you created your script from within a
// Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the URL with your own.
const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/abc123456/edit');

// Gets the document body.
const body = doc.getBody();

// Applies a link to the first 11 characters in the body.
const text = body.editAsText().setLinkUrl(0, 10, 'https://example.com');

Parametreler

AdTürAçıklama
startOffsetIntegerMetin aralığının başlangıç ofseti.
endOffsetInclusiveIntegerMetin aralığının bitiş ofseti.
urlStringBağlantı URL'si.

Return

Text: Geçerli öğe.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları için aşağıdaki kapsamlardan en az birinin yetkilendirilmesi gerekir:

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

setLinkUrl(url)

Bağlantı URL'sini ayarlar.

Parametreler

AdTürAçıklama
urlStringbağlantı URL'si

Return

Text - geçerli öğe

Yetkilendirme

Bu yöntemi kullanan komut dosyaları için aşağıdaki kapsamlardan en az birinin yetkilendirilmesi gerekir:

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

setStrikethrough(strikethrough)

Üstü çizili ayarını belirtir.

Parametreler

AdTürAçıklama
strikethroughBooleanüstü çizili ayarı

Return

Text - geçerli öğe

Yetkilendirme

Bu yöntemi kullanan komut dosyaları için aşağıdaki kapsamlardan en az birinin yetkilendirilmesi gerekir:

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

setStrikethrough(startOffset, endOffsetInclusive, strikethrough)

Belirtilen karakter aralığı için üstü çizilir ayarı yapar.

// Opens the Docs file by its URL. If you created your script from within a
// Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the URL with your own.
const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/abc123456/edit');

// Gets the document body.
const body = doc.getBody();

// Sets the first 11 characters in the document body to strikethrough.
const text = body.editAsText().setStrikethrough(0, 10, true);

Parametreler

AdTürAçıklama
startOffsetIntegerMetin aralığının başlangıç ofseti.
endOffsetInclusiveIntegerMetin aralığının bitiş ofseti.
strikethroughBooleanÜstü çizili ayar.

Return

Text: Geçerli öğe.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları için aşağıdaki kapsamlardan en az birinin yetkilendirilmesi gerekir:

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

setText(text)

Metin içeriğini ayarlar.

// Opens the Docs file by its URL. If you created your script from within a
// Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the URL with your own.
const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/abc123456/edit');

// Gets the document body.
const body = doc.getBody();

// Replaces the contents of the body with the text, 'New body text.'
const text = body.editAsText().setText('New body text.');

Parametreler

AdTürAçıklama
textStringYeni metin içerikleri.

Return

Text: Geçerli öğe.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları için aşağıdaki kapsamlardan en az birinin yetkilendirilmesi gerekir:

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

setTextAlignment(startOffset, endOffsetInclusive, textAlignment)

Belirli bir karakter aralığı için metin hizalamasını ayarlar. Kullanılabilir hizalama türleri DocumentApp.TextAlignment.NORMAL, DocumentApp.TextAlignment.SUBSCRIPT ve DocumentApp.TextAlignment.SUPERSCRIPT'dir.

// Make the first character in the first paragraph be superscript.
var text = DocumentApp.getActiveDocument().getBody().getParagraphs()[0].editAsText();
text.setTextAlignment(0, 0, DocumentApp.TextAlignment.SUPERSCRIPT);

Parametreler

AdTürAçıklama
startOffsetIntegerKarakter aralığının başlangıç ofseti.
endOffsetInclusiveIntegerKarakter aralığının bitiş ofseti (dahil).
textAlignmentTextAlignmentUygulanacak metin hizalama türü.

Return

Text: Geçerli öğe.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları için aşağıdaki kapsamlardan en az birinin 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 be superscript.
var text = DocumentApp.getActiveDocument().getBody().getParagraphs()[0].editAsText();
text.setTextAlignment(DocumentApp.TextAlignment.SUPERSCRIPT);

Parametreler

AdTürAçıklama
textAlignmentTextAlignmentuygulanacak metin hizalama türü

Return

Text - geçerli öğe

Yetkilendirme

Bu yöntemi kullanan komut dosyaları için aşağıdaki kapsamlardan en az birinin yetkilendirilmesi gerekir:

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

setUnderline(underline)

Altı çizili ayarını ayarlar.

Parametreler

AdTürAçıklama
underlineBooleanaltı çizili ayarı

Return

Text - geçerli öğe

Yetkilendirme

Bu yöntemi kullanan komut dosyaları için aşağıdaki kapsamlardan en az birinin yetkilendirilmesi gerekir:

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

setUnderline(startOffset, endOffsetInclusive, underline)

Belirtilen karakter aralığı için altı çizili ayarı yapar.

// Opens the Docs file by its URL. If you created your script from within a
// Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the URL with your own.
const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/abc123456/edit');

// Gets the document body.
const body = doc.getBody();

// Sets the first 11 characters in the document body to underline.
const text = body.editAsText().setUnderline(0, 10, true);

Parametreler

AdTürAçıklama
startOffsetIntegerMetin aralığının başlangıç ofseti.
endOffsetInclusiveIntegerMetin aralığının bitiş ofseti.
underlineBooleanAltı çizili metin ayarı.

Return

Text: Geçerli öğe.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları için aşağıdaki kapsamlardan en az birinin yetkilendirilmesi gerekir:

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