Class DocumentApp

문서 앱

문서 서비스에서 수정 가능한 Documents을 만들어 엽니다.

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

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

속성

속성	유형	설명
Attribute	Attribute	Attribute 열거형입니다.
ElementType	ElementType	ElementType 열거형입니다.
FontFamily	FontFamily	FontFamily 열거형입니다.
GlyphType	GlyphType	GlyphType 열거형입니다.
HorizontalAlignment	HorizontalAlignment	HorizontalAlignment 열거형입니다.
ParagraphHeading	ParagraphHeading	ParagraphHeading 열거형입니다.
PositionedLayout	PositionedLayout	PositionedLayout 열거형입니다.
TextAlignment	TextAlignment	TextAlignment 열거형입니다.
VerticalAlignment	VerticalAlignment	VerticalAlignment 열거형입니다.

메서드

메서드	반환 유형	간략한 설명
create(name)	Document	새 문서를 만들고 반환합니다.
getActiveDocument()	Document	스크립트가 container-bound인 문서를 반환합니다.
getUi()	Ui	스크립트가 메뉴, 대화상자, 사이드바 같은 기능을 추가할 수 있게 하는 문서의 사용자 인터페이스 환경 인스턴스를 반환합니다.
openById(id)	Document	지정된 ID가 있는 문서를 반환합니다.
openByUrl(url)	Document	지정된 URL의 문서를 열고 반환합니다.

자세한 문서

create(name)

새 문서를 만들고 반환합니다.

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

매개변수

이름	유형	설명
name	String	새 문서 이름

Return

Document — 새 문서 인스턴스

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.

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

---

getActiveDocument()

스크립트가 container-bound인 문서를 반환합니다. 스크립트가 컨테이너에 종속되지 않은 문서와 상호작용하려면 openById(id) 또는 openByUrl(url)를 대신 사용하세요.

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

Return

Document — 문서 인스턴스

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.

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

---

getUi()

스크립트가 메뉴, 대화상자, 사이드바 같은 기능을 추가할 수 있게 하는 문서의 사용자 인터페이스 환경 인스턴스를 반환합니다. 스크립트는 열려 있는 문서의 현재 인스턴스에 대해서만 UI와 상호작용할 수 있으며, 스크립트가 문서에 결합된 경우에만 가능합니다. 자세한 내용은 메뉴, 대화상자 및 사이드바 가이드를 참고하세요.

// 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();
}

Return

Ui: 이 문서의 사용자 인터페이스 환경 인스턴스입니다.

---

openById(id)

지정된 ID가 있는 문서를 반환합니다. 스크립트가 문서에 바인딩된 경우 대신 getActiveDocument()를 사용합니다.

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

매개변수

이름	유형	설명
id	String	열려는 문서의 ID

Return

Document — 문서 인스턴스

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.

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

---

openByUrl(url)

지정된 URL의 문서를 열고 반환합니다. 스크립트가 문서에 바인딩된 경우 대신 getActiveDocument()를 사용합니다.

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

매개변수

이름	유형	설명
url	String	열려는 문서의 URL

Return

Document — 문서 인스턴스

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.

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