이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Class Document

서식 있는 텍스트와 표, 목록 등의 요소가 포함된 문서

DocumentApp을 사용하여 문서를 열거나 만들 수 있습니다.

// Open a document by ID.
var doc = DocumentApp.openById("<my-id>");

// Create and open a document.
doc = DocumentApp.create("Document Title");

방법

메서드	반환 유형	간략한 설명
`addBookmark(position)`	`Bookmark`	지정된 `Position`에 `Bookmark`를 추가합니다.
`addEditor(emailAddress)`	`Document`	지정된 사용자를 `Document`의 편집자 목록에 추가합니다.
`addEditor(user)`	`Document`	지정된 사용자를 `Document`의 편집자 목록에 추가합니다.
`addEditors(emailAddresses)`	`Document`	지정된 사용자 배열을 `Document`의 편집기 목록에 추가합니다.
`addFooter()`	`FooterSection`	문서 바닥글 섹션이 없는 경우 추가합니다.
`addHeader()`	`HeaderSection`	문서 헤더 섹션이 없는 경우 추가합니다.
`addNamedRange(name, range)`	`NamedRange`	나중에 검색에 사용할 이름과 ID가 있는 `Range`인 `NamedRange`를 추가합니다.
`addViewer(emailAddress)`	`Document`	지정된 사용자를 `Document`의 뷰어 목록에 추가합니다.
`addViewer(user)`	`Document`	지정된 사용자를 `Document`의 뷰어 목록에 추가합니다.
`addViewers(emailAddresses)`	`Document`	지정된 사용자 배열을 `Document`의 뷰어 목록에 추가합니다.
`getAs(contentType)`	`Blob`	현재 `Document` 콘텐츠를 지정된 유형의 blob으로 검색합니다.
`getBlob()`	`Blob`	현재 `Document` 콘텐츠를 blob으로 검색합니다.
`getBody()`	`Body`	활성 문서의 `Body`를 검색합니다.
`getBookmark(id)`	`Bookmark`	지정된 ID가 있는 `Bookmark`를 가져옵니다.
`getBookmarks()`	`Bookmark[]`	문서의 모든 `Bookmark` 객체를 가져옵니다.
`getCursor()`	`Position`	활성 문서에서 사용자의 커서를 가져옵니다.
`getEditors()`	`User[]`	이 `Document`의 편집자 목록을 가져옵니다.
`getFooter()`	`FooterSection`	문서의 바닥글 섹션이 있는 경우 검색합니다.
`getFootnotes()`	`Footnote[]`	문서 본문의 모든 `Footnote` 요소를 검색합니다.
`getHeader()`	`HeaderSection`	문서의 헤더 섹션이 있는 경우 검색합니다.
`getId()`	`String`	문서의 고유 식별자를 검색합니다.
`getLanguage()`	`String`	문서의 언어 코드를 가져옵니다.
`getName()`	`String`	문서의 제목을 검색합니다.
`getNamedRangeById(id)`	`NamedRange`	지정된 ID가 있는 `NamedRange`를 가져옵니다.
`getNamedRanges()`	`NamedRange[]`	문서의 모든 `NamedRange` 객체를 가져옵니다.
`getNamedRanges(name)`	`NamedRange[]`	지정된 이름을 가진 문서의 모든 `NamedRange` 객체를 가져옵니다.
`getSelection()`	`Range`	활성 문서에서 사용자의 선택 항목을 가져옵니다.
`getSupportedLanguageCodes()`	`String[]`	Google Docs 파일에서 지원되는 모든 언어 코드를 가져옵니다.
`getUrl()`	`String`	현재 문서에 액세스할 URL을 검색합니다.
`getViewers()`	`User[]`	이 `Document`의 뷰어 및 댓글 작성자 목록을 가져옵니다.
`newPosition(element, offset)`	`Position`	특정 요소를 기준으로 문서의 위치를 가리키는 새 `Position`를 만듭니다.
`newRange()`	`RangeBuilder`	문서 요소에서 `Range` 객체를 구성하는 데 사용되는 빌더를 만듭니다.
`removeEditor(emailAddress)`	`Document`	`Document`의 편집자 목록에서 지정된 사용자를 삭제합니다.
`removeEditor(user)`	`Document`	`Document`의 편집자 목록에서 지정된 사용자를 삭제합니다.
`removeViewer(emailAddress)`	`Document`	`Document`의 뷰어 및 댓글 작성자 목록에서 특정 사용자를 삭제합니다.
`removeViewer(user)`	`Document`	`Document`의 뷰어 및 댓글 작성자 목록에서 특정 사용자를 삭제합니다.
`saveAndClose()`	`void`	현재 `Document`를 저장합니다.
`setCursor(position)`	`Document`	`Position`가 지정된 경우 활성 문서에서 사용자의 커서를 설정합니다.
`setLanguage(languageCode)`	`Document`	문서의 언어 코드를 설정합니다.
`setName(name)`	`Document`	문서 제목을 설정합니다.
`setSelection(range)`	`Document`	`Range`가 지정된 경우 활성 문서에서 사용자의 선택을 설정합니다.

자세한 문서

`addBookmark(position)`

지정된 Position에 Bookmark를 추가합니다.

매개변수

이름	유형	설명
`position`	`Position`	새 북마크의 위치

Return 키

Bookmark: 새 북마크

승인

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

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

`addEditor(emailAddress)`

지정된 사용자를 Document의 편집자 목록에 추가합니다. 사용자가 이미 뷰어 목록에 있는 경우 이 메서드는 뷰어 목록에서 사용자를 승격합니다.

매개변수

이름	유형	설명
`emailAddress`	`String`	추가할 사용자의 이메일 주소입니다.

Return 키

Document: 이 Document를 체인 연결용으로 사용합니다.

승인

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

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

`addEditor(user)`

지정된 사용자를 Document의 편집자 목록에 추가합니다. 사용자가 이미 뷰어 목록에 있는 경우 이 메서드는 뷰어 목록에서 사용자를 승격합니다.

매개변수

이름	유형	설명
`user`	`User`	추가할 사용자의 표현입니다.

Return 키

Document: 이 Document를 체인 연결용으로 사용합니다.

승인

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

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

`addEditors(emailAddresses)`

지정된 사용자 배열을 Document의 편집기 목록에 추가합니다. 이미 뷰어 목록에 있는 사용자가 있는 경우 이 메서드는 뷰어 목록에서 승격합니다.

매개변수

이름	유형	설명
`emailAddresses`	`String[]`	추가할 사용자의 이메일 주소 배열입니다.

Return 키

Document: 이 Document를 체인 연결용으로 사용합니다.

승인

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

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

`addFooter()`

문서 바닥글 섹션이 없는 경우 추가합니다.

Return 키

FooterSection — 문서 바닥글

승인

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

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

`addHeader()`

문서 헤더 섹션이 없는 경우 추가합니다.

Return 키

HeaderSection: 문서 헤더입니다.

승인

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

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

`addNamedRange(name, range)`

나중에 검색에 사용할 이름과 ID가 있는 Range인 NamedRange를 추가합니다. 이름은 고유하지 않을 수도 있습니다. HTML의 클래스와 마찬가지로 동일한 문서의 여러 범위가 동일한 이름을 공유할 수 있습니다. 반대로 ID는 HTML의 ID와 같이 문서 내에서 고유합니다. NamedRange를 문서에 추가한 후에는 수정할 수 없으며 삭제만 할 수 있습니다.

문서에 액세스하는 모든 스크립트는 NamedRange에 액세스할 수 있습니다. 스크립트 간에 의도치 않은 충돌을 방지하려면 고유한 이름에 범위 이름을 프리픽스로 붙이는 것이 좋습니다.

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

매개변수

이름	유형	설명
`name`	`String`	범위 이름입니다(고유하지 않아도 됨). 범위 이름은 1~256자(영문 기준)여야 합니다.
`range`	`Range`	이름과 연결할 요소의 범위입니다. 범위는 활성 선택 또는 검색결과이거나 `newRange()`로 직접 구성할 수 있습니다.

Return 키

NamedRange: NamedRange입니다.

승인

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

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

`addViewer(emailAddress)`

지정된 사용자를 Document의 뷰어 목록에 추가합니다. 사용자가 이미 편집자 목록에 있는 경우 이 메서드는 영향을 미치지 않습니다.

매개변수

이름	유형	설명
`emailAddress`	`String`	추가할 사용자의 이메일 주소입니다.

Return 키

Document: 이 Document를 체인 연결용으로 사용합니다.

승인

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

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

`addViewer(user)`

지정된 사용자를 Document의 뷰어 목록에 추가합니다. 사용자가 이미 편집자 목록에 있는 경우 이 메서드는 영향을 미치지 않습니다.

매개변수

이름	유형	설명
`user`	`User`	추가할 사용자의 표현입니다.

Return 키

Document: 이 Document를 체인 연결용으로 사용합니다.

승인

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

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

`addViewers(emailAddresses)`

지정된 사용자 배열을 Document의 뷰어 목록에 추가합니다. 이미 편집자 목록에 있는 사용자가 있는 경우 이 메서드는 영향을 미치지 않습니다.

매개변수

이름	유형	설명
`emailAddresses`	`String[]`	추가할 사용자의 이메일 주소 배열입니다.

Return 키

Document: 이 Document를 체인 연결용으로 사용합니다.

승인

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

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

`getAs(contentType)`

현재 Document 콘텐츠를 지정된 유형의 blob으로 검색합니다.

매개변수

이름	유형	설명
`contentType`	`String`	변환할 MIME 유형입니다. 현재는 `'application/pdf'`만 지원됩니다.

Return 키

Blob — blob으로 사용되는 현재 문서

`getBlob()`

현재 Document 콘텐츠를 blob으로 검색합니다.

Return 키

Blob — blob으로 사용되는 현재 문서

`getBody()`

활성 문서의 Body를 검색합니다.

문서에 다른 유형의 섹션 (예: HeaderSection, FooterSection)이 포함될 수 있습니다. 문서의 활성 섹션은 Body입니다.

Document의 요소 메서드가 활성 Body에 위임됩니다.

Return 키

Body: 활성 문서 본문 섹션

승인

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

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

`getBookmark(id)`

지정된 ID가 있는 Bookmark를 가져옵니다. 이러한 Bookmark가 존재하지 않으면 이 메서드는 null를 반환합니다.

매개변수

이름	유형	설명
`id`	`String`	`Bookmark`의 ID

Return 키

Bookmark: 지정된 ID가 있는 Bookmark, 또는 Bookmark가 존재하지 않는 경우 null

승인

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

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

`getBookmarks()`

문서의 모든 Bookmark 객체를 가져옵니다.

Return 키

Bookmark[]: 문서에 있는 Bookmark 객체의 배열

승인

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

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

`getCursor()`

활성 문서에서 사용자의 커서를 가져옵니다. 스크립트는 스크립트를 문서에 바인딩한 경우에만 스크립트를 실행하는 사용자의 커서에 액세스할 수 있습니다.

// Insert some text at the cursor position and make it bold.
var 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.
  var element = cursor.insertText('ಠ‿ಠ');
  if (element) {
    element.setBold(true);
  } else {
    DocumentApp.getUi().alert('Cannot insert text here.');
  }
} else {
  DocumentApp.getUi().alert('Cannot find a cursor.');
}

Return 키

Position - 사용자의 커서를 나타냅니다. 또는 사용자가 문서에 커서를 두지 않았거나 스크립트가 문서에 바인딩되지 않은 경우 null입니다.

승인

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

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

`getEditors()`

이 Document의 편집자 목록을 가져옵니다.

Return 키

User[]: 수정 권한이 있는 사용자의 배열입니다.

승인

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

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

`getFooter()`

문서의 바닥글 섹션이 있는 경우 검색합니다.

Return 키

FooterSection — 문서 바닥글

승인

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

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

`getFootnotes()`

문서 본문의 모든 Footnote 요소를 검색합니다.

getFootnotes를 호출하면 문서 요소가 반복됩니다. 대용량 문서의 경우 이 메서드를 불필요하게 호출하지 마세요.

Return 키

Footnote[]: 문서 각주

승인

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

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

`getHeader()`

문서의 헤더 섹션이 있는 경우 검색합니다.

Return 키

HeaderSection: 문서 헤더입니다.

승인

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

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

`getId()`

문서의 고유 식별자를 검색합니다. 문서 ID는 DocumentApp.openById()와 함께 특정 문서 인스턴스를 여는 데 사용됩니다.

Return 키

String: 문서의 ID입니다.

승인

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

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

`getLanguage()`

문서의 언어 코드를 가져옵니다. 이는 문서 편집기의 파일 > 언어에 표시되는 언어이며, 문서에 포함된 실제 언어가 아닐 수도 있습니다.

Return 키

String: 문서 언어 또는 정의되지 않은 경우 null입니다.

승인

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

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

`getName()`

문서의 제목을 검색합니다.

Return 키

String — 문서 제목입니다.

승인

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

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

`getNamedRangeById(id)`

지정된 ID가 있는 NamedRange를 가져옵니다. 이 NamedRange가 없으면 이 메서드는 null를 반환합니다. 이름은 고유하지 않을 수 있습니다. HTML의 클래스와 마찬가지로 동일한 문서의 여러 다른 범위가 동일한 이름을 공유할 수 있습니다. 반대로 ID는 HTML의 ID와 같이 문서 내에서 고유합니다.

매개변수

이름	유형	설명
`id`	`String`	문서 내에서 고유한 범위의 ID입니다.

Return 키

NamedRange: 지정된 ID가 있는 NamedRange 또는 이러한 범위가 없는 경우 null입니다.

승인

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

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

`getNamedRanges()`

문서의 모든 NamedRange 객체를 가져옵니다.

NamedRange는 문서에 액세스하는 모든 스크립트에서 액세스할 수 있습니다. 스크립트 간에 의도치 않은 충돌을 피하려면 범위 이름에 고유한 문자열을 접두사로 사용하는 것이 좋습니다.

Return 키

NamedRange[] - 문서에 있는 NamedRange 객체의 배열로, 이름이 같은 여러 범위가 포함될 수 있습니다.

승인

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

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

`getNamedRanges(name)`

지정된 이름을 가진 문서의 모든 NamedRange 객체를 가져옵니다. 이름은 고유하지 않아도 됩니다. HTML의 클래스와 마찬가지로 같은 문서의 여러 범위가 동일한 이름을 공유할 수도 있습니다. 반대로 ID는 HTML의 ID와 같이 문서 내에서 고유합니다.

매개변수

이름	유형	설명
`name`	`String`	범위 이름(반드시 고유하지는 않음)

Return 키

NamedRange[]: 지정된 이름의 문서에 있는 NamedRange 객체의 배열

승인

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

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

`getSelection()`

활성 문서에서 사용자의 선택 항목을 가져옵니다. 스크립트는 스크립트를 문서에 결합한 경우에만 스크립트를 실행하는 사용자의 선택에 액세스할 수 있습니다.

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

Return 키

Range — 사용자가 선택한 항목이 없는 경우, 사용자가 선택한 항목이 없는 경우 null를, 단락의 끝과 새 줄만 선택한 경우 또는 스크립트가 문서에 바인딩되지 않은 경우 사용자의 선택을 나타냅니다.

승인

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

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

`getSupportedLanguageCodes()`

Google Docs 파일에서 지원되는 모든 언어 코드를 가져옵니다.

Return 키

String[] - 언어 코드 배열입니다.

승인

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

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

`getUrl()`

현재 문서에 액세스할 URL을 검색합니다.

var doc = DocumentApp.getActiveDocument();

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

Return 키

String: 현재 문서에 액세스할 수 있는 URL입니다.

승인

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

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

`getViewers()`

이 Document의 뷰어 및 댓글 작성자 목록을 가져옵니다.

Return 키

User[] - 보기 또는 댓글 권한이 있는 사용자의 배열

승인

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

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

`newPosition(element, offset)`

특정 요소를 기준으로 문서의 위치를 가리키는 새 Position를 만듭니다. 사용자의 커서는 무엇보다도 Position로 표현됩니다.

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

매개변수

이름	유형	설명
`element`	`Element`	새 `Position`를 포함할 요소. `Text` 요소이거나 `Paragraph`와 같은 컨테이너 요소여야 합니다.
`offset`	`Integer`	`Text` 요소의 경우 `Position` 이전의 문자 수, 다른 요소의 경우 같은 컨테이너 요소 내의 `Position` 이전의 하위 요소 수

Return 키

Position: 새로운 Position

승인

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

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

`newRange()`

문서 요소에서 Range 객체를 구성하는 데 사용되는 빌더를 만듭니다.

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

Return 키

RangeBuilder — 새 빌더

승인

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

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

`removeEditor(emailAddress)`

Document의 편집자 목록에서 지정된 사용자를 삭제합니다. 이 메서드는 사용자가 일반 액세스 권한을 가진 사용자 클래스에 속해 있다면(예: Document이 사용자의 전체 도메인과 공유되었거나 Document가 사용자가 액세스할 수 있는 공유 드라이브에 있는 경우) 사용자가 Document에 액세스하는 것을 차단하지 않습니다.

Drive 파일의 경우 이렇게 하면 뷰어 목록에서 사용자가 삭제됩니다.

매개변수

이름	유형	설명
`emailAddress`	`String`	삭제할 사용자의 이메일 주소입니다.

Return 키

Document: 이 Document를 체인 연결용으로 사용합니다.

승인

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

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

`removeEditor(user)`

Drive 파일의 경우 이렇게 하면 뷰어 목록에서 사용자가 삭제됩니다.

매개변수

이름	유형	설명
`user`	`User`	삭제할 사용자의 표현입니다.

Return 키

Document: 이 Document를 체인 연결용으로 사용합니다.

승인

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

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

`removeViewer(emailAddress)`

Document의 뷰어 및 댓글 작성자 목록에서 특정 사용자를 삭제합니다. 이 메서드는 사용자가 뷰어나 댓글 작성자가 아닌 편집자인 경우 영향을 미치지 않습니다. 또한 이 메서드는 사용자가 일반 액세스 권한이 있는 사용자 클래스에 속해 있다면(예: Document이 사용자의 전체 도메인과 공유되었거나 Document가 사용자가 액세스할 수 있는 공유 드라이브에 있는 경우) 사용자가 Document에 액세스하는 것을 차단하지 않습니다.

Drive 파일의 경우 편집자 목록에서도 사용자가 삭제됩니다.

매개변수

이름	유형	설명
`emailAddress`	`String`	삭제할 사용자의 이메일 주소입니다.

Return 키

Document: 체이닝용 Document입니다.

승인

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

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

`removeViewer(user)`

Document의 뷰어 및 댓글 작성자 목록에서 특정 사용자를 삭제합니다. 이 메서드는 사용자가 뷰어가 아닌 편집자인 경우 아무런 영향을 미치지 않습니다. 또한 이 메서드는 사용자가 일반 액세스 권한이 있는 사용자 클래스에 속해 있다면(예: Document이 사용자의 전체 도메인과 공유되었거나 Document가 사용자가 액세스할 수 있는 공유 드라이브에 있는 경우) 사용자가 Document에 액세스하는 것을 차단하지 않습니다.

Drive 파일의 경우 편집자 목록에서도 사용자가 삭제됩니다.

매개변수

이름	유형	설명
`user`	`User`	삭제할 사용자의 표현입니다.

Return 키

Document: 체이닝용 Document입니다.

승인

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

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

`saveAndClose()`

현재 Document를 저장합니다. 대기 중인 업데이트가 플러시되고 적용되도록 합니다.

수정 가능한 각 Document의 스크립트 실행 종료 시 saveAndClose() 메서드가 자동으로 호출됩니다.

Document을(를) 수정할 수 없습니다. DocumentApp.openById()를 사용하여 수정을 위해 지정된 문서를 다시 엽니다.

승인

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

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

`setCursor(position)`

Position가 지정된 경우 활성 문서에서 사용자의 커서를 설정합니다. 스크립트는 스크립트를 문서에 바인딩한 경우에만 스크립트를 실행하는 사용자의 커서에 액세스할 수 있습니다.

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

매개변수

이름	유형	설명
`position`	`Position`	새 커서 위치

Return 키

Document: 이 Document를 체인 연결용으로 사용하는 경우

승인

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

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

`setLanguage(languageCode)`

문서의 언어 코드를 설정합니다. 이는 문서 편집기의 파일 > 언어에 표시되는 언어이며, 문서에 포함된 실제 언어가 아닐 수도 있습니다. getSupportedLanguageCodes()를 사용하여 유효한 모든 언어 코드를 가져옵니다.

매개변수

이름	유형	설명
`languageCode`	`String`	언어 코드입니다.

Return 키

Document: 이 Document를 체인 연결용으로 사용합니다.

승인

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

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

`setName(name)`

문서 제목을 설정합니다.

매개변수

이름	유형	설명
`name`	`String`	새 문서 제목

Return 키

Document: 현재 문서입니다.

승인

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

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

`setSelection(range)`

Range가 지정된 경우 활성 문서에서 사용자의 선택을 설정합니다. 스크립트는 스크립트를 문서에 결합한 경우에만 스크립트를 실행하는 사용자의 선택에 액세스할 수 있습니다.

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

매개변수

이름	유형	설명
`range`	`Range`	선택할 새 요소 범위

Return 키

Document: 이 Document를 체인 연결용으로 사용하는 경우

승인

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

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