Class Document

Dodaje znak Bookmark w podanym Position na pierwszej karcie lub, w przypadku skryptów powiązanych z dokumentem, na aktywnej karcie. Aby dodać zakładkę do dowolnej karty, użyj metody DocumentTab.addBookmark(position).

// Opens the Docs file by its ID. If you created your script from within
// a Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the ID with your own.
const doc = DocumentApp.openById('123abc');

// Gets the active or first tab's body and adds a paragraph.
const paragraph = doc.getBody().appendParagraph('My new paragraph.');

// Creates a position at the first character of the paragraph text.
const position = doc.newPosition(paragraph.getChild(0), 0);

// Adds a bookmark at the first character of the paragraph text.
const bookmark = doc.addBookmark(position);

// Logs the bookmark ID to the console.
console.log(bookmark.getId());

Parametry

Powrót

Bookmark – nowa zakładka.

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

Dodaje podanego użytkownika do listy edytujących Document. Jeśli użytkownik był już na liście widzów, ta metoda usuwa go z tej listy.

Parametry

Powrót

Document – ten Document do tworzenia łańcuszków.

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

Dodaje podanego użytkownika do listy edytujących Document. Jeśli użytkownik był już na liście widzów, ta metoda usuwa go z tej listy.

Parametry

Powrót

Document – ten Document do tworzenia łańcuszków.

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

Dodaje podaną tablicę użytkowników do listy edytujących Document. Jeśli któryś z użytkowników był już na liście widzów, ta metoda usuwa go z tej listy.

Parametry

Powrót

Document – ten Document do tworzenia łańcuszków.

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

Dodaje sekcję stopki (jeśli nie istnieje) do pierwszej karty lub, w przypadku skryptów powiązanych z dokumentem, do aktywnej karty. Aby dodać sekcję stopki do dowolnej karty, użyj metody DocumentTab.addFooter().

// Opens the Docs file by its ID. If you created your script from within
// a Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the ID with your own.
const doc = DocumentApp.openById('123abc');

// Adds a footer to the document's active or first tab.
const footer = doc.addFooter();

// Sets the footer text to 'This is a footer.'
footer.setText('This is a footer');

Powrót

FooterSection – stopka karty.

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

Dodaje sekcję nagłówka (jeśli nie istnieje) do pierwszej karty lub, w przypadku skryptów powiązanych z dokumentem, do aktywnej karty. Aby dodać sekcję nagłówka do dowolnej karty, użyj metody DocumentTab.addHeader().

// Opens the Docs file by its ID. If you created your script from within
// a Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the ID with your own.
const doc = DocumentApp.openById('123abc');

// Adds a header to the document's active or first tab.
const header = doc.addHeader();

// Sets the header text to 'This is a header.'
header.setText('This is a header');

Powrót

HeaderSection – nagłówek karty.

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

Dodaje NamedRange, czyli Range z nazwą i identyfikatorem, który można później wykorzystać do pobierania danych, na pierwszej karcie lub, w przypadku skryptów powiązanych z dokumentem, na aktywnej karcie. Aby dodać NamedRange na dowolnej karcie, użyj metody DocumentTab.addNamedRange(name, range). Nazwy nie muszą być unikalne. Kilka różnych zakresów w tym samym dokumencie może mieć tę samą nazwę, podobnie jak klasa w HTML. Identyfikatory są natomiast unikalne w obrębie dokumentu, tak jak identyfikator w HTML-u. Po dodaniu NamedRange do dokumentu nie możesz go zmodyfikować, możesz go tylko usunąć.

Każdy skrypt, który ma dostęp do dokumentu, może uzyskać dostęp do NamedRange. Aby uniknąć niezamierzonych konfliktów między skryptami, rozważ dodanie do nazw zakresów unikalnego ciągu znaków.

// Creates a named range that includes every table in the active tab.
const doc = DocumentApp.getActiveDocument();
const rangeBuilder = doc.newRange();
const tables = doc.getBody().getTables();
for (let i = 0; i < tables.length; i++) {
  rangeBuilder.addElement(tables[i]);
}
// Adds the named range to the document's active tab.
doc.addNamedRange('Document tables', rangeBuilder.build());

Parametry

Powrót

NamedRange – NamedRange.

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

Dodaje podanego użytkownika do listy osób, które mogą wyświetlać Document. Jeśli użytkownik był już na liście edytujących, ta metoda nie ma wpływu.

Parametry

Powrót

Document – ten Document do tworzenia łańcuszków.

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

Dodaje podanego użytkownika do listy osób, które mogą wyświetlać Document. Jeśli użytkownik był już na liście edytujących, ta metoda nie ma wpływu.

Parametry

Powrót

Document – ten Document do tworzenia łańcuszków.

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

Dodaje podaną tablicę użytkowników do listy widzów Document. Jeśli któryś z użytkowników był już na liście edytujących, ta metoda nie będzie miała na niego wpływu.

Parametry

Powrót

Document – ten Document do tworzenia łańcuszków.

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

Pobiera aktualnie aktywny Tab użytkownika w dokumencie. Skrypt może uzyskać dostęp tylko do aktywnej karty użytkownika, który go uruchamia, i tylko wtedy, gdy jest powiązany z dokumentem.

// Display a dialog box that shows the title of the tab that the
// user is currently viewing.
const tab = DocumentApp.getActiveDocument().getActiveTab();
DocumentApp.getUi().alert(`ID of selected tab: ${tab.getTitle()}`);

Powrót

Tab – aktualnie aktywny Tab użytkownika lub null, jeśli skrypt nie jest powiązany z dokumentem.

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

Pobiera bieżącą zawartość Document jako obiekt blob określonego typu.

// Opens the Docs file by its ID. If you created your script from within
// a Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the ID with your own.
const doc = DocumentApp.openById('123abc');

// Gets the document as a PDF.
const pdf = doc.getAs('application/pdf');

// Logs the name of the PDF to the console.
console.log(pdf.getName());

Parametry

Powrót

Blob – bieżący dokument jako obiekt blob.

Pobiera bieżącą zawartość Document jako obiekt blob.

// Opens the Docs file by its ID. If you created your script from within
// a Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the ID with your own.
const doc = DocumentApp.openById('123abc');

// Retrieves the current document's contents as a blob and logs it to the
// console.
console.log(doc.getBlob().getContentType());

Powrót

Blob – bieżący dokument jako obiekt blob.

Pobiera Body pierwszej karty lub, w przypadku skryptów powiązanych z dokumentem, DocumentBodySection aktywnej karty. Aby uzyskać DocumentBodySection dowolnej karty, użyj metody DocumentTab.getBody().

Karty mogą zawierać różne typy sekcji (np. HeaderSection, FooterSection). Aktywna sekcja karty to Body.

Metody elementów w Document delegują do aktywnego elementu Body.

// Opens the Docs file by its ID. If you created your script from within
// a Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the ID with your own.
const doc = DocumentApp.openById('123abc');

// Gets the active or first tab's body.
const body = doc.getBody();

// Gets the body text and logs it to the console.
console.log(body.getText());

Powrót

Body – sekcja treści karty.

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

Pobiera Bookmark o podanym identyfikatorze z pierwszej karty lub, w przypadku skryptów powiązanych z dokumentem, z aktywnej karty. Aby dodać zakładkę na dowolnej karcie, użyj metody DocumentTab.getBookmark(id). Jeśli w karcie nie ma takiego elementu Bookmark, ta metoda zwraca wartość null.

// Opens the Docs file by its ID. If you created your script from within
// a Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the ID with your own.
const doc = DocumentApp.openById('123abc');

// Gets the bookmark by its ID in the document's active or first tab.
const bookmark = doc.getBookmark('id.xyz654321');

// If the bookmark exists, logs the character offset of its position to the
// console. otherwise, logs 'No bookmark exists with the given ID.' to the
// console.
if (bookmark) {
  console.log(bookmark.getPosition().getOffset());
} else {
  console.log('No bookmark exists with the given ID.');
}

Parametry

Powrót

Bookmark|null – Bookmark o podanym identyfikatorze lub null, jeśli na karcie nie ma takiego elementu Bookmark.

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

Pobiera wszystkie obiekty Bookmark z pierwszej karty lub, w przypadku skryptów powiązanych z dokumentem, z aktywnej karty. Aby uzyskać wszystkie zakładki na dowolnej karcie, użyj metody DocumentTab.getBookmarks().

// Opens the Docs file by its ID. If you created your script from within
// a Google Docs file, you can use DocumentApp.getActiveDocument() instead.
const doc = DocumentApp.openById('123abc');

// Gets all of the bookmarks in the document's active or first tab.
const bookmarks = doc.getBookmarks();

// Logs the number of bookmarks in the tab to the console.
console.log(bookmarks.length);

Powrót

Bookmark[] – tablica obiektów Bookmark na karcie.

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

Pobiera kursor użytkownika na aktywnej karcie. Skrypt może uzyskać dostęp do kursora tylko użytkownika, który go uruchamia, i tylko wtedy, gdy jest powiązany z dokumentem.

// Insert some text at the cursor position and make it bold.
const cursor = DocumentApp.getActiveDocument().getCursor();
if (cursor) {
  // Attempt to insert text at the cursor position. If the insertion returns
  // null, the cursor's containing element doesn't allow insertions, so show the
  // user an error message.
  const element = cursor.insertText('ಠ‿ಠ');
  if (element) {
    element.setBold(true);
  } else {
    DocumentApp.getUi().alert('Cannot insert text here.');
  }
} else {
  DocumentApp.getUi().alert('Cannot find a cursor.');
}

Powrót

Position|null – reprezentacja kursora użytkownika lub null, jeśli użytkownik nie umieścił kursora na karcie lub jeśli skrypt nie jest powiązany z dokumentem.

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

Pobiera listę edytorów tego Document.

Powrót

User[] – tablica użytkowników z uprawnieniami do edycji.

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

Pobiera sekcję stopki pierwszej karty lub, w przypadku skryptów powiązanych z dokumentem, sekcję stopki aktywnej karty. Aby przejść do sekcji stopki na dowolnej karcie, użyj metody DocumentTab.getFooter().

// Opens the Docs file by its ID. If you created your script from within
// a Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the ID with your own.
const doc = DocumentApp.openById('123abc');

// Gets the text of the active or first tab's footer and logs it to the console.
console.log(doc.getFooter().getText());

Powrót

FooterSection|null – stopka karty.

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

Pobiera wszystkie elementy Footnote w treści pierwszej karty lub, w przypadku skryptów powiązanych z dokumentem, w treści aktywnej karty. Aby uzyskać wszystkie przypisy w dowolnej karcie, użyj metody DocumentTab.getFootnotes().

Wywołania funkcji getFootnotes powodują iterację po elementach karty. W przypadku dużych kart unikaj niepotrzebnych wywołań tej metody.

// Opens the Docs file by its ID. If you created your script from within
// a Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the ID with your own.
const doc = DocumentApp.openById('123abc');

// Gets the first footnote in the active or first tab's body.
const footnote = doc.getFootnotes()[0];

// Logs footnote contents to the console.
console.log(footnote.getFootnoteContents().getText());

Powrót

Footnote[]|null – przypisy na karcie.

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

Pobiera sekcję nagłówka pierwszej karty lub, w przypadku skryptów powiązanych z dokumentem, sekcję nagłówka aktywnej karty. Aby uzyskać sekcję nagłówka dowolnej karty, użyj metody DocumentTab.getHeader().

// Opens the Docs file by its ID. If you created your script from within
// a Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the ID with your own.
const doc = DocumentApp.openById('123abc');

// Gets the text of the active or first tab's header and logs it to the console.
console.log(doc.getHeader().getText());

Powrót

HeaderSection|null – nagłówek karty.

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

Pobiera unikalny identyfikator dokumentu. Identyfikator dokumentu jest używany z parametrem DocumentApp.openById() do otwierania konkretnej wersji dokumentu.

Powrót

String – identyfikator 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

Pobiera kod języka dokumentu. Jest to język wyświetlany w edytorze dokumentów w sekcji Plik > Język, który może nie być rzeczywistym językiem dokumentu.

Powrót

String – język dokumentu lub null, jeśli nie jest zdefiniowany.

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

Pobiera tytuł dokumentu.

Powrót

String – tytuł 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

Pobiera NamedRange o podanym identyfikatorze z pierwszej karty lub, w przypadku skryptów powiązanych z dokumentem, z aktywnej karty. Aby pobrać element NamedRange o podanym identyfikatorze na dowolnej karcie, użyj metody DocumentTab.getNamedRangeById(id). Jeśli na karcie nie ma takiego elementu NamedRange, ta metoda zwraca wartość null. Nazwy nie muszą być niepowtarzalne, nawet w obrębie kart. Kilka różnych zakresów na tej samej karcie może mieć tę samą nazwę, podobnie jak klasa w HTML. Identyfikatory są natomiast unikalne w obrębie karty, podobnie jak identyfikator w HTML-u.

Parametry

Powrót

NamedRange|null – NamedRange o podanym identyfikatorze lub null, jeśli w karcie nie ma takiego zakresu.

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

Pobiera wszystkie obiekty NamedRange z pierwszej karty lub, w przypadku skryptów powiązanych z dokumentem, z aktywnej karty. Aby pobrać wszystkie obiekty NamedRange na dowolnej karcie, użyj metody DocumentTab.getNamedRanges().

Do NamedRange może uzyskać dostęp każdy skrypt, który ma dostęp do karty. Aby uniknąć niepożądanych konfliktów między skryptami, rozważ dodanie do nazw zakresów unikalnego ciągu znaków.

Powrót

NamedRange[] – tablica obiektów NamedRange na karcie, która może zawierać wiele zakresów o tej samej nazwie.

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

Pobiera wszystkie obiekty NamedRange o podanej nazwie na pierwszej karcie lub, w przypadku skryptów powiązanych z dokumentem, na aktywnej karcie. Aby pobrać wszystkie obiekty NamedRange na dowolnej karcie, użyj metody DocumentTab.getNamedRanges(name). Nazwy nie muszą być unikalne, nawet w obrębie kart. Kilka różnych zakresów na tej samej karcie może mieć tę samą nazwę, podobnie jak klasa w HTML. Identyfikatory są natomiast unikalne w obrębie karty, podobnie jak identyfikator w HTML-u.

Do NamedRange może uzyskać dostęp każdy skrypt, który ma dostęp do dokumentu. Aby uniknąć niepożądanych konfliktów między skryptami, rozważ dodanie do nazw zakresów unikalnego ciągu znaków.

Parametry

Powrót

NamedRange[] – tablica obiektów NamedRange na karcie o podanej nazwie.

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

Pobiera wybór użytkownika na aktywnej karcie. Skrypt może uzyskać dostęp do zaznaczenia użytkownika, który go uruchamia, tylko wtedy, gdy jest powiązany z dokumentem.

// Display a dialog box that tells the user how many elements are included in
// the selection.
const selection = DocumentApp.getActiveDocument().getSelection();
if (selection) {
  const elements = selection.getRangeElements();
  DocumentApp.getUi().alert(`Number of selected elements: ${elements.length}`);
} else {
  DocumentApp.getUi().alert('Nothing is selected.');
}

Powrót

Range|null – reprezentacja wyboru użytkownika lub null, jeśli użytkownik nie ma niczego wybranego na karcie, jeśli wybrany jest tylko koniec akapitu, jeśli wybrany jest tylko koniec akapitu i nowy wiersz lub jeśli skrypt nie jest powiązany z dokumentem.

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

Pobiera wszystkie kody języków obsługiwane w plikach Dokumentów Google.

Powrót

String[] – tablica kodów języków.

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

Pobiera Tab o określonym identyfikatorze. Jeśli nie ma takiego elementu Tab, ta metoda zwraca wartość null. ma dostęp do kart na dowolnym poziomie zagnieżdżenia.

Parametry

Powrót

Tab – element Tab o podanym identyfikatorze lub null, jeśli taki element Tab nie istnieje.

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

Pobiera wszystkie niezagłębione elementy Tab, które są częścią dokumentu.

Karty mogą zawierać karty podrzędne, czyli karty zagnieżdżone w innych kartach. Karty podrzędne są dostępne za pomocą klawisza Tab.getChildTabs().

Powrót

Tab[] – lista wszystkich Tab, które są częścią 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

Pobiera adres URL dostępu do bieżącego dokumentu.

const doc = DocumentApp.getActiveDocument();

// Send out the link to open the document.
MailApp.sendEmail('<email-address>', doc.getName(), doc.getUrl());

Powrót

String – adres URL, pod którym można uzyskać dostęp do bieżącego 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

Pobiera listę przeglądających i komentujących dla tego Document.

Powrót

User[] – tablica użytkowników z uprawnieniami do wyświetlania lub komentowania.

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

Tworzy nowy Position, który jest odwołaniem do lokalizacji na karcie względem określonego elementu na pierwszej karcie lub, w przypadku skryptów powiązanych z dokumentem, aktywnej karty. Aby utworzyć Position względem lokalizacji na dowolnej karcie, użyj metody DocumentTab.newPosition(element, offset). Kursor użytkownika jest reprezentowany przez symbol Position.

// Append a paragraph to the active tab, then place the user's cursor after the
// first word of the new paragraph.
const doc = DocumentApp.getActiveDocument();
const paragraph = doc.getBody().appendParagraph('My new paragraph.');
const position = doc.newPosition(paragraph.getChild(0), 2);
doc.setCursor(position);

Parametry

Powrót

Position – Nowy Position.

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

Tworzy narzędzie do tworzenia obiektów Range z elementów karty na pierwszej karcie lub, w przypadku skryptów powiązanych z dokumentem, na aktywnej karcie. Aby utworzyć narzędzie do tworzenia obiektów DocumentRange z elementów kart na dowolnej karcie, użyj metody DocumentTab.newRange().

// Change the user's selection to a range that includes every table in the
// active tab.
const doc = DocumentApp.getActiveDocument();
const rangeBuilder = doc.newRange();
const tables = doc.getBody().getTables();
for (let i = 0; i < tables.length; i++) {
  rangeBuilder.addElement(tables[i]);
}
doc.setSelection(rangeBuilder.build());

Powrót

RangeBuilder – nowy kreator.

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

Usuwa danego użytkownika z listy osób edytujących Document. Ta metoda nie blokuje użytkownikom dostępu do Document, jeśli należą oni do klasy użytkowników, którzy mają ogólny dostęp, np. jeśli Document jest udostępniony całej domenie użytkownika lub jeśli Document znajduje się na dysku współdzielonym, do którego użytkownik ma dostęp.

W przypadku plików na Dysku spowoduje to również usunięcie użytkownika z listy osób, które mogą je wyświetlać.

Parametry

Powrót

Document – ten Document do tworzenia łańcuszków.

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

Usuwa danego użytkownika z listy osób edytujących Document. Ta metoda nie blokuje użytkownikom dostępu do Document, jeśli należą oni do klasy użytkowników, którzy mają ogólny dostęp, np. jeśli Document jest udostępniony całej domenie użytkownika lub jeśli Document znajduje się na dysku współdzielonym, do którego użytkownik ma dostęp.

W przypadku plików na Dysku spowoduje to również usunięcie użytkownika z listy osób, które mogą je wyświetlać.

Parametry

Powrót

Document – ten Document do tworzenia łańcuszków.

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

Usuwa danego użytkownika z listy przeglądających i komentujących Document. Ta metoda nie ma wpływu, jeśli użytkownik jest edytującym, a nie przeglądającym lub komentującym. Ta metoda nie blokuje też dostępu do Document użytkownikom, którzy należą do grupy użytkowników mających ogólny dostęp, np. jeśli Document jest udostępniony całej domenie użytkownika lub jeśli Document znajduje się na dysku współdzielonym, do którego użytkownik ma dostęp.

W przypadku plików na Dysku spowoduje to również usunięcie użytkownika z listy edytujących.

Parametry

Powrót

Document – ten znak Document służy do łączenia.

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

Usuwa danego użytkownika z listy przeglądających i komentujących Document. Ta metoda nie ma wpływu, jeśli użytkownik jest edytującym, a nie przeglądającym. Ta metoda nie blokuje też dostępu do Document użytkownikom, którzy należą do klasy użytkowników mających ogólny dostęp, np. jeśli Document jest udostępniony całej domenie użytkownika lub jeśli Document znajduje się na dysku współdzielonym, do którego użytkownik ma dostęp.

W przypadku plików na Dysku spowoduje to również usunięcie użytkownika z listy edytujących.

Parametry

Powrót

Document – ten znak Document służy do łączenia.

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

Zapisuje bieżący Document. Powoduje opróżnienie i zastosowanie oczekujących aktualizacji.

Metoda saveAndClose() jest automatycznie wywoływana na końcu wykonywania skryptu dla każdego otwartego edytowalnego Document.

Zamkniętego Document nie można edytować. Użyj DocumentApp.openById(), aby ponownie otworzyć dany dokument do edycji.

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

Ustawia wybraną przez użytkownika Tab w bieżącym dokumencie na kartę o określonym identyfikatorze.

const doc = DocumentApp.getActiveDocument();

// Sets the user's selected tab by its ID.
// TODO(developer): Replace the ID with your own.
const tab = doc.setActiveTab('123abc');

Parametry

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

Ustawia kursor użytkownika na podstawie wartości Position. Skrypt może uzyskać dostęp do kursora użytkownika, który go uruchamia, tylko wtedy, gdy jest powiązany z dokumentem.

Wysłanie Position z nieaktywnego Tab powoduje przełączenie aktywnej karty użytkownika.

const doc = DocumentApp.getActiveDocument();
const documentTab = doc.getActiveTab().asDocumentTab();

// Append a paragraph, then place the user's cursor after the first word of the
// new paragraph.
const paragraph = documentTab.getBody().appendParagraph('My new paragraph.');
const position = documentTab.newPosition(paragraph.getChild(0), 2);
doc.setCursor(position);

Parametry

Powrót

Document – ten Document do tworzenia łańcuszków.

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

Ustawia kod języka dokumentu. Jest to język wyświetlany w edytorze dokumentów w sekcji Plik > Język, który może nie być rzeczywistym językiem dokumentu. Użyj getSupportedLanguageCodes(), aby uzyskać wszystkie prawidłowe kody języka.

Parametry

Powrót

Document – ten Document do tworzenia łańcuszków.

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

Ustawia tytuł dokumentu.

Parametry

Powrót

Document – bieżący dokument.

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

Ustawia wybór użytkownika na aktywnej karcie, biorąc pod uwagę Range. Skrypt może uzyskać dostęp do zaznaczenia użytkownika, który go uruchamia, tylko wtedy, gdy jest powiązany z dokumentem.

const doc = DocumentApp.getActiveDocument();
const documentTab = doc.getActiveTab().asDocumentTab();

// Change the user's selection to a range that includes every table in the
// document.
const rangeBuilder = documentTab.newRange();
const tables = documentTab.getBody().getTables();
for (let i = 0; i < tables.length; i++) {
  rangeBuilder.addElement(tables[i]);
}
doc.setSelection(rangeBuilder.build());

Parametry

Powrót

Document – ten Document do tworzenia łańcuszków.

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