Ta strona została przetłumaczona przez Cloud Translation API.

Class DocumentApp

Usługa dokumentów tworzy i otwiera plik Documents, który można edytować.

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

// 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`	`FontFamily`	Wyliczenie `FontFamily`.
`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, do którego skrypt jest powiązany z kontenerem container-bound.
`getUi()`	`Ui`	Zwraca wystąpienie środowiska interfejsu użytkownika dokumentu, które umożliwia skryptowi dodawanie funkcji takich jak menu, okna i paski boczne.
`openById(id)`	`Document`	Zwraca dokument o określonym identyfikatorze.
`openByUrl(url)`	`Document`	Otwiera i zwraca dokument z określonym adresem 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;

Powroty

Document – nowe wystąpienie dokumentu.

Upoważnienie

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, do którego skrypt jest powiązany z kontenerem container-bound. Aby wejść w interakcję z dokumentem, z którym 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();

Powroty

Document – wystąpienie dokumentu,

Upoważnienie

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 funkcji takich 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 jest z nim powiązany. Więcej informacji znajdziesz w przewodnikach po menu oraz oknach dialogowych i paskach 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();
}

Powroty

Ui – wystąpienie środowiska interfejsu użytkownika tego dokumentu

`openById(id)`

Zwraca dokument o określonym identyfikatorze. Jeśli skrypt jest powiązany z kontenerem, użyj elementu getActiveDocument().

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

Parametry

Nazwa	Typ	Opis
`id`	`String`	identyfikator dokumentu, który ma zostać otwarty;

Powroty

Document – wystąpienie dokumentu,

Upoważnienie

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 z określonym adresem URL. Jeśli skrypt jest powiązany z kontenerem, użyj atrybutu 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 do otwarcia;

Powroty

Document – wystąpienie dokumentu,

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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