Class DocumentApp

DocumentApp

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.
let 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	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, z którym skrypt jest powiązany.
getUi()	Ui	Zwraca instancję środowiska interfejsu użytkownika dokumentu, która 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 o określonym adresie URL.

Szczegółowa dokumentacja

create(name)

Tworzy i zwraca nowy dokument.

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

Parametry

Nazwa	Typ	Opis
name	String	Nazwa nowego dokumentu.

Powrót

Document – nowa instancja dokumentu.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

---

getActiveDocument()

Zwraca dokument, z którym skrypt jest powiązany. Aby wchodzić w interakcję z dokumentem, z którym skrypt nie jest powiązany, użyj openById(id) lub openByUrl(url).

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

Powrót

Document – instancja dokumentu.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

---

getUi()

Zwraca instancję środowiska interfejsu użytkownika dokumentu, która umożliwia skryptowi dodawanie funkcji takich jak menu, okna i paski boczne. Skrypt może wchodzić w interakcję z interfejsem tylko w przypadku bieżącej instancji otwartego dokumentu i tylko wtedy, gdy jest powiązany z dokumentem. 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();
}

Powrót

Ui – instancja środowiska interfejsu użytkownika tego dokumentu.

---

openById(id)

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

// Open a document by ID.
// TODO(developer): Replace the ID with your own.
const doc = DocumentApp.openById('DOCUMENT_ID');

Parametry

Nazwa	Typ	Opis
id	String	Identyfikator dokumentu do otwarcia.

Powrót

Document – instancja dokumentu.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 kontenerem dokumentu, użyj getActiveDocument().

// Open a document by URL.
const doc = DocumentApp.openByUrl(
    'https://docs.google.com/document/d/1234567890abcdefghijklmnopqrstuvwxyz_a1b2c3/edit',
);

Parametry

Nazwa	Typ	Opis
url	String	adres URL dokumentu do otwarcia,

Powrót

Document – instancja dokumentu.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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