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

Class DocumentApp

Doküman hizmeti, düzenleyebileceğiniz Documents dosyası oluşturur ve açar.

// Open a document by ID.
var doc = DocumentApp.openById('DOCUMENT_ID_GOES_HERE');

// Create and open a document.
doc = DocumentApp.create('Document Name');

Özellikler

Özellik	Tür	Açıklama
`Attribute`	`Attribute`	`Attribute` sıralaması.
`ElementType`	`ElementType`	`ElementType` sıralaması.
`FontFamily`	`FontFamily`	`FontFamily` sıralaması.
`GlyphType`	`GlyphType`	`GlyphType` sıralaması.
`HorizontalAlignment`	`HorizontalAlignment`	`HorizontalAlignment` sıralaması.
`ParagraphHeading`	`ParagraphHeading`	`ParagraphHeading` sıralaması.
`PositionedLayout`	`PositionedLayout`	`PositionedLayout` sıralaması.
`TextAlignment`	`TextAlignment`	`TextAlignment` sıralaması.
`VerticalAlignment`	`VerticalAlignment`	`VerticalAlignment` sıralaması.

Yöntemler

Yöntem	Dönüş türü	Kısa açıklama
`create(name)`	`Document`	Yeni bir doküman oluşturur ve 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, belgenin 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`	Dokümanı belirtilen URL ile açar ve döndürür.

Ayrıntılı belgeler

`create(name)`

Yeni bir doküman oluşturur ve döndürür.

// Create and open a new document.
var 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ı, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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ığı belgeyle etkileşim kurmak için bunun yerine openById(id) veya openByUrl(url) kullanın.

// Get the document to which this script is bound.
var doc = DocumentApp.getActiveDocument();

Return

Document - doküman örneği

Yetkilendirme

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

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, belgenin kullanıcı arayüzü ortamının bir örneğini döndürür. Bir komut dosyası yalnızca açık bir dokümanın geçerli örneği için kullanıcı arayüzüyle ve sadece komut dosyası dokümana bağlı olduğunda etkileşimde bulunabilir. Daha fazla bilgi için menü kılavuzları ile iletişim kutuları ve kenar çubukları kılavuzlarına bakın.

// 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ıya bağlıysa bunun yerine getActiveDocument() politikasını kullanın.

// Open a document by ID.
var doc = DocumentApp.openById('DOCUMENT_ID_GOES_HERE');

Parametreler

Ad	Tür	Açıklama
`id`	`String`	açılacak belgenin kimliği

Return

Document - doküman örneği

Yetkilendirme

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

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

`openByUrl(url)`

Dokümanı belirtilen URL ile açar ve döndürür. Komut dosyası dokümana kapsayıcıya bağlıysa bunun yerine getActiveDocument() kullanın.

// Open a document by URL.
var 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ı, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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