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.
var doc = DocumentApp.openById('DOCUMENT_ID');

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

Właściwości

WłaściwośćTypOpis
AttributeAttributeWyliczenie Attribute.
ElementTypeElementTypeWyliczenie ElementType.
FontFamilyFontFamilyWyliczenie FontFamily.
GlyphTypeGlyphTypeWyliczenie GlyphType.
HorizontalAlignmentHorizontalAlignmentWyliczenie HorizontalAlignment.
ParagraphHeadingParagraphHeadingWyliczenie ParagraphHeading.
PositionedLayoutPositionedLayoutWyliczenie PositionedLayout.
TextAlignmentTextAlignmentWyliczenie TextAlignment.
VerticalAlignmentVerticalAlignmentWyliczenie VerticalAlignment.

Metody

MetodaZwracany typKrótki opis
create(name)DocumentTworzy i zwraca nowy dokument.
getActiveDocument()DocumentZwraca dokument, z którym skrypt jest powiązany z kontenerem.
getUi()UiZwraca wystąpienie środowiska interfejsu użytkownika dokumentu, które umożliwia skryptowi dodawanie takie jak menu, okna i paski boczne.
openById(id)DocumentZwraca dokument o określonym identyfikatorze.
openByUrl(url)DocumentOtwiera 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

NazwaTypOpis
nameStringNazwa 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

NazwaTypOpis
idStringIdentyfikator 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

NazwaTypOpis
urlStringadres 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