Class DocumentApp

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스크립트가 컨테이너에 바인딩된 문서를 반환합니다.
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새 문서의 이름

리턴

Document - 새 문서 인스턴스

승인

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

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

getActiveDocument()

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

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

리턴

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

리턴

Ui — 이 문서의 사용자 인터페이스 환경 인스턴스


openById(id)

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

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

매개변수

이름유형설명
idString열 문서의 ID

리턴

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

리턴

Document: 문서 인스턴스

승인

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

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