Genel bir öğe. Document içerikleri öğe olarak gösterilir. Örneğin, List, Paragraph ve Table öğelerdir ve Element tarafından tanımlanan tüm yöntemleri (ör. get) devralır.
Sınıfları uygulama
| Ad | Kısa açıklama |
|---|---|
Body | Google Dokümanlar belgesindeki bir sekmenin içeriği. |
Container | Diğer öğeleri içerebilen genel bir öğe. |
Date | Biçimlendirilmiş bir tarihi temsil eden öğe |
Equation | Matematiksel ifadeyi temsil eden bir öğe. |
Equation | Matematiksel bir Equation içindeki bir işlevi temsil eden öğe. |
Equation | Matematiksel bir Equation içinde işlev ayırıcıyı temsil eden bir öğe. |
Equation | Bir matematiksel Equation içindeki sembolü temsil eden bir öğe. |
Footer | Altbilgi bölümünü temsil eden bir öğe. |
Footnote | Dipnotu temsil eden bir öğe. |
Footnote | Bir dipnot bölümünü temsil eden öğe. |
Header | Bir başlık bölümünü temsil eden öğe. |
Horizontal | Yatay kuralı temsil eden bir öğe. |
Inline | Yerleştirilmiş bir çizimi temsil eden öğe. |
Inline | Yerleştirilmiş bir resmi temsil eden öğe. |
List | Liste öğesini temsil eden bir öğe. |
Page | Sayfa sonunu temsil eden bir öğe. |
Paragraph | Paragrafı temsil eden bir öğe. |
Person | Bir kişiye bağlantıyı temsil eden öğe. |
Rich | Drive dosyası veya YouTube videosu gibi bir Google kaynağına bağlantıyı temsil eden öğe. |
Table | Tabloyu temsil eden bir öğe. |
Table | Tablo hücresini temsil eden bir öğe. |
Table | İçindekiler tablosu içeren bir öğe. |
Table | Tablo satırını temsil eden bir öğe. |
Text | Zengin metin bölgesini temsil eden bir öğe. |
Unsupported | Bilinmeyen veya bir komut dosyasından etkilenemeyen bir bölgeyi temsil eden öğe (ör. sayfa numarası). |
Yöntemler
| Yöntem | Dönüş türü | Kısa açıklama |
|---|---|---|
as | Body | Geçerli öğeyi Body olarak döndürür. |
as | Date | Geçerli öğeyi Date olarak döndürür. |
as | Equation | Geçerli öğeyi Equation olarak döndürür. |
as | Equation | Geçerli öğeyi Equation olarak döndürür. |
as | Equation | Geçerli öğeyi Equation olarak döndürür. |
as | Equation | Geçerli öğeyi Equation olarak döndürür. |
as | Footer | Geçerli öğeyi Footer olarak döndürür. |
as | Footnote | Geçerli öğeyi Footnote olarak döndürür. |
as | Footnote | Geçerli öğeyi Footnote olarak döndürür. |
as | Header | Geçerli öğeyi Header olarak döndürür. |
as | Horizontal | Geçerli öğeyi Horizontal olarak döndürür. |
as | Inline | Geçerli öğeyi Inline olarak döndürür. |
as | Inline | Geçerli öğeyi Inline olarak döndürür. |
as | List | Geçerli öğeyi List olarak döndürür. |
as | Page | Geçerli öğeyi Page olarak döndürür. |
as | Paragraph | Geçerli öğeyi Paragraph olarak döndürür. |
as | Person | Geçerli öğeyi Person olarak döndürür. |
as | Rich | Mevcut öğeyi Rich olarak döndürür. Örneğin, Google E-Tablolar dosyasına bağlantı. |
as | Table | Geçerli öğeyi Table olarak döndürür. |
as | Table | Geçerli öğeyi Table olarak döndürür. |
as | Table | Geçerli öğeyi Table olarak döndürür. |
as | Table | Geçerli öğeyi Table olarak döndürür. |
as | Text | Geçerli öğeyi Text olarak döndürür. |
copy() | Element | Geçerli öğenin ayrılmış, derin bir kopyasını döndürür. |
get | Object | Öğenin özelliklerini alır. |
get | Element|null | Öğenin sonraki kardeş öğesini alır. |
get | Container | Öğenin üst öğesini alır. |
get | Element|null | Öğenin önceki kardeş öğesini alır. |
get | Element | Öğenin Element değerini alır. |
is | Boolean | Öğenin Document sonunda olup olmadığını belirler. |
merge() | Element|null | Öğeyi, aynı türdeki önceki kardeş öğeyle birleştirir. |
remove | Element|null | Öğeyi üst öğesinden kaldırır. |
set | Element | Öğenin özelliklerini ayarlar. |
Ayrıntılı belgeler
as Body()
Geçerli öğeyi Body olarak döndürür.
Belirli bir öğenin belirli bir türde olduğu bilindiğinde otomatik tamamlamaya yardımcı olmak için bu yöntemi kullanın.
Return
Body: Geçerli öğe.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
as Date()
Geçerli öğeyi Date olarak döndürür.
Bir öğenin Date olduğunu biliyorsanız türünü Date olarak ayarlamak için bu yöntemi kullanın. Bunu yaptığınızda Apps Komut Dosyası Düzenleyicisi'ndeki otomatik tamamlama özelliği, Date ile kullanabileceğiniz yöntemleri gösterir.
Return
Date: Türü Date olarak ayarlanmış geçerli öğe.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
as Equation()
Geçerli öğeyi Equation olarak döndürür.
Belirli bir öğenin belirli bir türde olduğu bilindiğinde otomatik tamamlamaya yardımcı olmak için bu yöntemi kullanın.
Return
Equation: Geçerli öğe.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
as Equation Function()
Geçerli öğeyi Equation olarak döndürür.
Belirli bir öğenin belirli bir türde olduğu bilindiğinde otomatik tamamlamaya yardımcı olmak için bu yöntemi kullanın.
Return
Equation: Geçerli öğe.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
as Equation Function Argument Separator()
Geçerli öğeyi Equation olarak döndürür.
Belirli bir öğenin belirli bir türde olduğu bilindiğinde otomatik tamamlamaya yardımcı olmak için bu yöntemi kullanın.
Return
Equation: Geçerli öğe.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
as Equation Symbol()
Geçerli öğeyi Equation olarak döndürür.
Belirli bir öğenin belirli bir türde olduğu bilindiğinde otomatik tamamlamaya yardımcı olmak için bu yöntemi kullanın.
Return
Equation: Geçerli öğe.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
as Footnote()
Geçerli öğeyi Footnote olarak döndürür.
Belirli bir öğenin belirli bir türde olduğu bilindiğinde otomatik tamamlamaya yardımcı olmak için bu yöntemi kullanın.
Return
Footnote: Geçerli öğe.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
as Footnote Section()
Geçerli öğeyi Footnote olarak döndürür.
Belirli bir öğenin belirli bir türde olduğu bilindiğinde otomatik tamamlamaya yardımcı olmak için bu yöntemi kullanın.
Return
Footnote: Geçerli öğe.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
as Header Section()
Geçerli öğeyi Header olarak döndürür.
Belirli bir öğenin belirli bir türde olduğu bilindiğinde otomatik tamamlamaya yardımcı olmak için bu yöntemi kullanın.
Return
Header: Geçerli öğe.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
as Horizontal Rule()
Geçerli öğeyi Horizontal olarak döndürür.
Belirli bir öğenin belirli bir türde olduğu bilindiğinde otomatik tamamlamaya yardımcı olmak için bu yöntemi kullanın.
Return
Horizontal: Geçerli öğe.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
as Inline Drawing()
Geçerli öğeyi Inline olarak döndürür.
Belirli bir öğenin belirli bir türde olduğu bilindiğinde otomatik tamamlamaya yardımcı olmak için bu yöntemi kullanın.
Return
Inline: Geçerli öğe.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
as Inline Image()
Geçerli öğeyi Inline olarak döndürür.
Belirli bir öğenin belirli bir türde olduğu bilindiğinde otomatik tamamlamaya yardımcı olmak için bu yöntemi kullanın.
Return
Inline: Geçerli öğe.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
as List Item()
Geçerli öğeyi List olarak döndürür.
Belirli bir öğenin belirli bir türde olduğu bilindiğinde otomatik tamamlamaya yardımcı olmak için bu yöntemi kullanın.
Return
List: Geçerli öğe.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
as Page Break()
Geçerli öğeyi Page olarak döndürür.
Belirli bir öğenin belirli bir türde olduğu bilindiğinde otomatik tamamlamaya yardımcı olmak için bu yöntemi kullanın.
Return
Page: Geçerli öğe.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
as Paragraph()
Geçerli öğeyi Paragraph olarak döndürür.
Belirli bir öğenin belirli bir türde olduğu bilindiğinde otomatik tamamlamaya yardımcı olmak için bu yöntemi kullanın.
Return
Paragraph: Geçerli öğe.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
as Person()
Geçerli öğeyi Person olarak döndürür.
Bir öğenin Person olduğunu biliyorsanız türünü kişi olarak ayarlamak için bu yöntemi kullanın.
Bu sayede, Apps Komut Dosyası Düzenleyici'deki otomatik tamamlama özelliği, kişi öğesiyle kullanabileceğiniz yöntemleri gösterir.
Return
Person: Türü Person olarak ayarlanmış geçerli öğe.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
as Rich Link()
Mevcut öğeyi Rich olarak döndürür. Örneğin, Google E-Tablolar dosyasına bağlantı.
Bir öğenin Rich olduğunu biliyorsanız türünü Rich olarak ayarlamak için bu yöntemi kullanın. Bu sayede, Apps Komut Dosyası Düzenleyicisi'ndeki otomatik tamamlama özelliği, Rich ile kullanabileceğiniz yöntemleri gösterir.
Return
Rich: Türü Rich olarak ayarlanmış geçerli öğe.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
as Table()
Geçerli öğeyi Table olarak döndürür.
Belirli bir öğenin belirli bir türde olduğu bilindiğinde otomatik tamamlamaya yardımcı olmak için bu yöntemi kullanın.
Return
Table: Geçerli öğe.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
as Table Cell()
Geçerli öğeyi Table olarak döndürür.
Belirli bir öğenin belirli bir türde olduğu bilindiğinde otomatik tamamlamaya yardımcı olmak için bu yöntemi kullanın.
Return
Table: Geçerli öğe.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
as Table Of Contents()
Geçerli öğeyi Table olarak döndürür.
Belirli bir öğenin belirli bir türde olduğu bilindiğinde otomatik tamamlamaya yardımcı olmak için bu yöntemi kullanın.
Return
Table: Geçerli öğe.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
as Table Row()
Geçerli öğeyi Table olarak döndürür.
Belirli bir öğenin belirli bir türde olduğu bilindiğinde otomatik tamamlamaya yardımcı olmak için bu yöntemi kullanın.
Return
Table: Geçerli öğe.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
as Text()
Geçerli öğeyi Text olarak döndürür.
Belirli bir öğenin belirli bir türde olduğu bilindiğinde otomatik tamamlamaya yardımcı olmak için bu yöntemi kullanın.
Return
Text: Geçerli öğe.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
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
Element: Yeni kopya.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
get Attributes()
Öğenin özelliklerini alır.
Sonuç, her geçerli öğe özelliği için bir özellik içeren bir nesnedir. Her özellik adı, Document numaralandırmasındaki 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ı, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
get Next Sibling()
Öğenin sonraki kardeş öğesini alır.
Bir sonraki kardeş öğe, aynı üst öğeye sahiptir ve geçerli öğeyi takip eder.
Return
Element|null: Sonraki kardeş öğe.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
get Parent()
Öğenin üst öğesini alır.
Üst öğe, geçerli öğeyi içerir.
Return
Container: Üst öğe.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
get Previous Sibling()
Öğenin önceki kardeş öğesini alır.
Önceki kardeş öğe, aynı üst öğeye sahiptir ve geçerli öğeden önce gelir.
Return
Element|null: Önceki kardeş öğe.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
get Type()
Öğenin Element değerini alır.
Belirli bir öğenin tam türünü belirlemek için get 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
Element: Öğe türü.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
is At Document End()
Öğenin Document sonunda olup olmadığını belirler.
Return
Boolean: Öğenin sekmenin sonunda olup olmadığı.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
merge()
Öğeyi, aynı türdeki önceki kardeş öğeyle birleştirir.
Yalnızca aynı Element öğeleri birleştirilebilir. Geçerli öğede bulunan tüm alt öğeler, önceki kardeş öğeye taşınır.
Mevcut öğe dokümandan kaldırılır.
const doc = DocumentApp.getActiveDocument(); const documentTab = doc.getActiveTab().asDocumentTab(); const body = documentTab.getBody(); // Example 1: Merge paragraphs // Append two paragraphs to the document's active tab. const par1 = body.appendParagraph('Paragraph 1.'); const 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. const cells = [ ['Row 1, Cell 1', 'Row 1, Cell 2'], ['Row 2, Cell 1', 'Row 2, Cell 2'], ]; // Build a table from the array. const table = body.appendTable(cells); // Get the first row in the table. const row = table.getRow(0); // Get the two cells in this row. const cell1 = row.getCell(0); const cell2 = row.getCell(1); // Merge the current cell into its preceding sibling element. const merged = cell2.merge();
Return
Element|null: Birleştirilmiş öğe.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
remove From Parent()
Öğ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
Element|null: Kaldırılan öğe.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
set Attributes(attributes)
Öğenin özelliklerini ayarlar.
Belirtilen özellikler parametresi, her özellik adının Document numaralandırmasındaki bir öğe ve her ö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
Element: Geçerli öğe.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents