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');

속성

속성유형설명
AttributeAttributeAttribute 열거형입니다.
ElementTypeElementTypeElementType 열거형입니다.
FontFamilyFontFamilyFontFamily 열거형입니다.
GlyphTypeGlyphTypeGlyphType 열거형입니다.
HorizontalAlignmentHorizontalAlignmentHorizontalAlignment 열거형입니다.
ParagraphHeadingParagraphHeadingParagraphHeading 열거형입니다.
PositionedLayoutPositionedLayoutPositionedLayout 열거형입니다.
TextAlignmentTextAlignmentTextAlignment 열거형입니다.
VerticalAlignmentVerticalAlignmentVerticalAlignment 열거형입니다.

메서드

메서드반환 유형간략한 설명
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');

매개변수

이름유형설명
nameString새 문서 이름

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');

매개변수

이름유형설명
idString열려는 문서의 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');

매개변수

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

Return

Document — 문서 인스턴스

승인

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

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