Doküman hizmeti, düzenlenebilir Documents
oluşturur ve açar.
// Open a document by ID. // TODO(developer): Replace the ID with your own. let doc = DocumentApp.openById('DOCUMENT_ID'); // Create and open a document. doc = DocumentApp.create('Document Name');
Özellikler
Mülk | Tür | Açıklama |
---|---|---|
Attribute | Attribute | Attribute numaralandırması. |
Element | Element | Element numaralandırması. |
Font |
| numaralandırması. |
Glyph | Glyph | Glyph numaralandırması. |
Horizontal | Horizontal | Horizontal numaralandırması. |
Paragraph | Paragraph | Paragraph numaralandırması. |
Positioned | Positioned | Positioned numaralandırması. |
Text | Text | Text numaralandırması. |
Vertical | Vertical | Vertical numaralandırması. |
Yöntemler
Yöntem | Dönüş türü | Kısa açıklama |
---|---|---|
create(name) | Document | Yeni bir doküman oluşturup döndürür. |
get | Document | Komut dosyasının kapsayıcıya bağlı olduğu dokümanı döndürür. |
get | Ui | Komut dosyasının menü, iletişim kutusu ve kenar çubuğu gibi özellikler eklemesine olanak tanıyan, dokümanın kullanıcı arayüzü ortamının bir örneğini döndürür. |
open | Document | Belirtilen kimliğe sahip dokümanı döndürür. |
open | Document | Belirtilen URL'ye sahip dokümanı açar ve döndürür. |
Ayrıntılı dokümanlar
create(name)
Yeni bir doküman oluşturup döndürür.
// Create and open a new document. const doc = DocumentApp.create('Document Name');
Parametreler
Ad | Tür | Açıklama |
---|---|---|
name | String | Yeni dokümanın adı. |
Return
Document
: Yeni doküman örneğ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
get Active Document()
Komut dosyasının kapsayıcıya bağlı olduğu dokümanı döndürür. Komut dosyasının kapsayıcıya bağlı olmadığı dokümanla etkileşim kurmak için bunun yerine open
veya open
işlevini kullanın.
// Get the document to which this script is bound. const doc = DocumentApp.getActiveDocument();
Return
Document
: doküman örneğ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
get Ui()
Komut dosyasının menü, iletişim kutusu ve kenar çubuğu gibi özellikler eklemesine olanak tanıyan, dokümanın kullanıcı arayüzü ortamının bir örneğini döndürür. Komut dosyaları yalnızca açık bir dokümanın mevcut örneğinin kullanıcı arayüzüyle etkileşime geçebilir ve bu da yalnızca komut dosyası dokümana bağlıysa geçerli olur. Daha fazla bilgi için menüler ve iletişim kutuları ve kenar çubukları ile ilgili kılavuzları inceleyin.
// Add a custom menu to the active document, including a separator and a // sub-menu. function onOpen(e) { DocumentApp.getUi() .createMenu('My Menu') .addItem('My menu item', 'myFunction') .addSeparator() .addSubMenu( DocumentApp.getUi() .createMenu('My sub-menu') .addItem('One sub-menu item', 'mySecondFunction') .addItem('Another sub-menu item', 'myThirdFunction'), ) .addToUi(); }
Return
Ui
: Bu belgenin kullanıcı arayüzü ortamının bir örneği
open By Id(id)
Belirtilen kimliğe sahip dokümanı döndürür. Komut dosyası, dokümana kapsayıcı bağlıysa bunun yerine get
işlevini kullanın.
// Open a document by ID. // TODO(developer): Replace the ID with your own. const doc = DocumentApp.openById('DOCUMENT_ID');
Parametreler
Ad | Tür | Açıklama |
---|---|---|
id | String | Açılacak dokümanın kimliği. |
Return
Document
: Belge örneğ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
open By Url(url)
Belirtilen URL'ye sahip dokümanı açar ve döndürür. Komut dosyası belgeye kapsayıcı bağlıysa bunun yerine get
kullanın.
// Open a document by URL. const doc = DocumentApp.openByUrl( 'https://docs.google.com/document/d/1234567890abcdefghijklmnopqrstuvwxyz_a1b2c3/edit', );
Parametreler
Ad | Tür | Açıklama |
---|---|---|
url | String | açılacak dokümanın URL'si |
Return
Document
: doküman örneğ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