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ı. |
ElementType | ElementType | ElementType numaralandırması. |
FontFamily |
| numaralandırması. |
GlyphType | GlyphType | GlyphType numaralandırması. |
HorizontalAlignment | HorizontalAlignment | HorizontalAlignment numaralandırması. |
ParagraphHeading | ParagraphHeading | ParagraphHeading numaralandırması. |
PositionedLayout | PositionedLayout | PositionedLayout numaralandırması. |
TextAlignment | TextAlignment | TextAlignment numaralandırması. |
VerticalAlignment | VerticalAlignment | VerticalAlignment 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. |
getActiveDocument() | Document | Komut dosyasının kapsayıcıya bağlı olduğu dokümanı döndürür. |
getUi() | 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. |
openById(id) | Document | Belirtilen kimliğe sahip dokümanı döndürür. |
openByUrl(url) | 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
getActiveDocument()
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 openById(id)
veya openByUrl(url)
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
getUi()
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
openById(id)
Belirtilen kimliğe sahip dokümanı döndürür. Komut dosyası, dokümana kapsayıcı bağlıysa bunun yerine getActiveDocument()
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
openByUrl(url)
Belirtilen URL'ye sahip dokümanı açar ve döndürür. Komut dosyası belgeye kapsayıcı bağlıysa bunun yerine getActiveDocument()
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