Usługa dokumentów tworzy i otwiera plik Documents
, który można edytować.
// Open a document by ID. // TODO(developer): Replace the ID with your own. var doc = DocumentApp.openById('DOCUMENT_ID'); // Create and open a document. doc = DocumentApp.create('Document Name');
Właściwości
Właściwość | Typ | Opis |
---|---|---|
Attribute | Attribute | Wyliczenie Attribute . |
ElementType | ElementType | Wyliczenie ElementType . |
FontFamily |
| Wyliczenie . |
GlyphType | GlyphType | Wyliczenie GlyphType . |
HorizontalAlignment | HorizontalAlignment | Wyliczenie HorizontalAlignment . |
ParagraphHeading | ParagraphHeading | Wyliczenie ParagraphHeading . |
PositionedLayout | PositionedLayout | Wyliczenie PositionedLayout . |
TextAlignment | TextAlignment | Wyliczenie TextAlignment . |
VerticalAlignment | VerticalAlignment | Wyliczenie VerticalAlignment . |
Metody
Metoda | Zwracany typ | Krótki opis |
---|---|---|
create(name) | Document | Tworzy i zwraca nowy dokument. |
getActiveDocument() | Document | Zwraca dokument, z którym skrypt jest powiązany z kontenerem. |
getUi() | Ui | Zwraca wystąpienie środowiska interfejsu użytkownika dokumentu, które umożliwia skryptowi dodawanie takie jak menu, okna i paski boczne. |
openById(id) | Document | Zwraca dokument o określonym identyfikatorze. |
openByUrl(url) | Document | Otwiera i zwraca dokument o określonym adresie URL. |
Szczegółowa dokumentacja
create(name)
Tworzy i zwraca nowy dokument.
// Create and open a new document. var doc = DocumentApp.create('Document Name');
Parametry
Nazwa | Typ | Opis |
---|---|---|
name | String | Nazwa nowego dokumentu. |
Powrót
Document
– nowe wystąpienie dokumentu.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/documents
getActiveDocument()
Zwraca dokument, z którym skrypt jest powiązany z kontenerem. Aby wejść w interakcję z dokumentem, do którego
skrypt nie jest powiązany z kontenerem, użyj openById(id)
lub openByUrl(url)
.
// Get the document to which this script is bound. var doc = DocumentApp.getActiveDocument();
Powrót
Document
– wystąpienie dokumentu.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getUi()
Zwraca wystąpienie środowiska interfejsu użytkownika dokumentu, które umożliwia skryptowi dodawanie takie jak menu, okna i paski boczne. Skrypt może wchodzić w interakcje z interfejsem tylko w przypadku bieżącego wystąpienia otwartego dokumentu i tylko wtedy, gdy skrypt jest powiązany z dokumentem. Więcej informacji: i prowadzi do menu oraz okna i pasków bocznych.
// 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(); }
Powrót
Ui
– wystąpienie środowiska interfejsu użytkownika tego dokumentu
openById(id)
Zwraca dokument o określonym identyfikatorze. Jeśli skrypt jest powiązany z dokumentem w kontenerze,
użyj interfejsu getActiveDocument()
.
// Open a document by ID. // TODO(developer): Replace the ID with your own. var doc = DocumentApp.openById('DOCUMENT_ID');
Parametry
Nazwa | Typ | Opis |
---|---|---|
id | String | Identyfikator dokumentu do otworzenia. |
Powrót
Document
– wystąpienie dokumentu.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/documents
openByUrl(url)
Otwiera i zwraca dokument o określonym adresie URL. Jeśli skrypt jest powiązany z
dokument, użyj getActiveDocument()
.
// Open a document by URL. var doc = DocumentApp.openByUrl( 'https://docs.google.com/document/d/1234567890abcdefghijklmnopqrstuvwxyz_a1b2c3/edit');
Parametry
Nazwa | Typ | Opis |
---|---|---|
url | String | adres URL dokumentu, który chcesz otworzyć; |
Powrót
Document
– wystąpienie dokumentu.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/documents