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

Class Person

Kişi bağlantısını temsil eden öğe. Kişi bağlantısı bir e-posta adresini belirtir ve isteğe bağlı olarak adresle ilişkilendirilmiş bir ada sahip olabilir. Ad belirlenirse, adı doküman gövdesinde gösterilir.

Yöntemler

Yöntem	Dönüş türü	Kısa açıklama
`copy()`	`Person`	Geçerli öğenin ayrılmış, derin bir kopyasını döndürür.
`getAttributes()`	`Object`	Öğenin özelliklerini alır.
`getEmail()`	`String`	Kişinin e-posta adresini döndürür.
`getName()`	`String`	Ayarlanmışsa kişinin görünen adını döndürür.
`getNextSibling()`	`Element`	Öğenin sonraki eşdüzey öğeyi alır.
`getParent()`	`ContainerElement`	Öğenin üst öğesini alır.
`getPreviousSibling()`	`Element`	Öğenin önceki eşdüzey öğesini alır.
`getType()`	`ElementType`	Öğenin `ElementType` değerini alır.
`isAtDocumentEnd()`	`Boolean`	Öğenin, `Document` öğesinin sonunda olup olmadığını belirler.
`merge()`	`Person`	Öğeyi, aynı türden bir önceki kardeş öğeyle birleştirir.
`removeFromParent()`	`Person`	Öğeyi üst öğesinden kaldırır.
`setAttributes(attributes)`	`Person`	Öğenin özelliklerini ayarlar.

Ayrıntılı belgeler

`copy()`

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

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

Return

Person — Yeni kopya.

Yetkilendirme

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

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

`getAttributes()`

Öğenin özelliklerini alır.

Sonuç, her bir geçerli öğe özelliği için bir özellik içeren özellik adı, DocumentApp.Attribute numaralandırmasındaki bir öğeye karşılık gelir.

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

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

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

// Log the paragraph attributes.
for (var att in atts) {
  Logger.log(att + ":" + atts[att]);
}

Return

Object: Öğenin özellikleri.

Yetkilendirme

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

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

`getEmail()`

Kişinin e-posta adresini döndürür.

Return

String: Kullanıcının e-posta adresi.

Yetkilendirme

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

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

`getName()`

Ayarlanmışsa kişinin görünen adını döndürür.

Return

String — Kişi bağlantısının görünen adı veya öğe e-postayı görüntülüyorsa null adresini kullanın.

Yetkilendirme

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

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

`getNextSibling()`

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

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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

`getParent()`

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

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

Return

ContainerElement: Üst öğe.

Yetkilendirme

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

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

`getPreviousSibling()`

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

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

Return

Element: Önceki kardeş öğe.

Yetkilendirme

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

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

`getType()`

Öğenin ElementType değerini alır.

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

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

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

var firstChild = body.getChild(0);

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

Return

ElementType: Öğe türü.

Yetkilendirme

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

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

`isAtDocumentEnd()`

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

Return

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

Yetkilendirme

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

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

`merge()`

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

Yalnızca aynı ElementType öğesine ait öğeler birleştirilebilir. Şunda bulunan tüm alt öğeler: geçerli öğe önceki eşdüzey öğeye taşınır.

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

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

// Example 1: Merge paragraphs
// Append two paragraphs to the document's active tab.
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

Person: Birleştirilmiş öğe.

Yetkilendirme

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

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

`removeFromParent()`

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

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

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

Return

Person: Kaldırılan öğe.

Yetkilendirme

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

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

`setAttributes(attributes)`

Öğenin özelliklerini ayarlar.

Belirtilen özellikler parametresi, her özellik adının DocumentApp.Attribute sıralaması ve her özellik değeri, geçerlidir.

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

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

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

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

Parametreler

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

Return

Person: Geçerli öğe.

Yetkilendirme

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

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