Google Docs 확장

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

Google Apps Script를 사용하면 프로그래매틱 방식으로 Google Docs를 만들고 수정할 수 있을 뿐만 아니라 새로운 메뉴, 대화상자 및 사이드바로 사용자 인터페이스를 맞춤설정할 수 있습니다.

기본사항

Apps Script는 다음 두 가지 방법으로 Google Docs와 상호작용할 수 있습니다. 스크립트의 사용자가 문서에 대해 적절한 권한을 갖는 경우 스크립트를 통해 문서를 만들거나 수정할 수 있으며, 스크립트를 문서에 결합하여 스크립트를 사용하면 사용자 인터페이스를 변경하거나 문서를 열 때 응답할 수 있습니다. Google Docs 내에서 컨테이너 바인딩 스크립트를 만들려면 확장 프로그램 > Apps Script를 클릭합니다.

두 경우 모두 다음 예에서 보듯이 Apps Script의 문서 서비스를 통해 Google 문서와 간편하게 상호작용할 수 있습니다.

function createDoc() {
  var doc = DocumentApp.create('Sample Document');
  var body = doc.getBody();
  var rowsData = [['Plants', 'Animals'], ['Ficus', 'Goat'], ['Basil', 'Cat'], ['Moss', 'Frog']];
  body.insertParagraph(0, doc.getName())
      .setHeading(DocumentApp.ParagraphHeading.HEADING1);
  table = body.appendTable(rowsData);
  table.getRow(0).editAsText().setBold(true);
}

위의 스크립트는 사용자의 Google Drive에 새 문서를 만든 후 문서의 이름과 동일한 텍스트가 포함된 단락을 삽입하고 해당 단락을 제목으로 스타일을 지정하고 2차원 배열의 값을 기반으로 표를 추가합니다. 이 스크립트는 DocumentApp.create() 호출을 DocumentApp.openById() 또는 openByUrl()로 대체하여 기존 문서를 쉽게 변경할 수도 있습니다. 문서 (컨테이너에 바인딩됨) 안에 생성된 스크립트에는 DocumentApp.getActiveDocument()를 사용합니다.

문서 구조

Apps Script의 관점에서 Google 문서는 HTML 문서처럼 구조화되어 있습니다. 즉, Google 문서는 다른 요소가 종종 포함된 요소 (예: Paragraph 또는 Table)로 구성됩니다. Google 문서를 수정하는 대부분의 스크립트는 getBody() 호출로 시작합니다. BodyHeaderSection, FooterSectionFootnotes를 제외한 다른 모든 요소를 포함하는 마스터 요소이기 때문입니다.

그러나 어떤 유형이 다른 유형을 포함할 수 있는지에 대한 규칙이 있습니다. 또한 Apps Script의 문서 서비스는 특정 유형의 요소만 삽입할 수 있습니다. 아래 트리는 특정 유형의 요소에 포함될 수 있는 요소를 보여줍니다.

굵게 표시된 요소는 삽입할 수 있으며 굵게 표시되지 않은 요소는 해당 위치에서만 조작할 수 있습니다.

텍스트 바꾸기

Apps Script는 Google Docs에서 텍스트를 대체하는 데 자주 사용됩니다. 스프레드시트에 고객 정보가 가득하고 각 클라이언트에 맞춤설정된 Google 문서를 생성하려고 한다고 가정해 보겠습니다. (이러한 유형의 작업을 메일 병합이라고 합니다.)

텍스트를 교체하는 방법에는 여러 가지가 있지만 가장 간단한 방법은 아래 예에 표시된 replaceText() 메서드입니다. replaceText는 자바스크립트의 대부분의 정규 표현식 기능을 지원합니다. 아래의 첫 번째 함수는 Google 문서에 자리표시자 텍스트 여러 줄을 추가합니다. 실제 환경에서는 자리표시자를 문서에 직접 입력할 가능성이 더 높습니다. 두 번째 함수는 자리표시자를 client 객체에 정의된 속성으로 교체합니다.

두 함수 모두 Google 문서 내에서 생성된 스크립트에만 적용되는 getActiveDocument() 메서드를 사용합니다. 독립형 스크립트에서는 대신 DocumentApp.create(), openById() 또는 openByUrl()를 사용합니다.

일부 자리표시자 추가

function createPlaceholders() {
  var body = DocumentApp.getActiveDocument().getBody();
  body.appendParagraph('{name}');
  body.appendParagraph('{address}');
  body.appendParagraph('{city} {state} {zip}');
}

자리표시자 대체하기

function searchAndReplace() {
  var body = DocumentApp.getActiveDocument()
      .getBody();
  var client = {
    name: 'Joe Script-Guru',
    address: '100 Script Rd',
    city: 'Scriptville',
    state: 'GA',
    zip: 94043
  };

  body.replaceText('{name}', client.name);
  body.replaceText('{address}', client.address);
  body.replaceText('{city}', client.city);
  body.replaceText('{state}', client.state);
  body.replaceText('{zip}', client.zip);
}

맞춤 메뉴 및 사용자 인터페이스

메뉴, 대화상자 및 사이드바를 추가하여 Google Docs를 맞춤설정할 수 있습니다. 하지만 스크립트는 열려 있는 문서의 현재 인스턴스에 대해서만 UI와 상호작용할 수 있으며, 스크립트가 문서에 결합된 경우에만 가능합니다.

Google Docs에 맞춤 메뉴대화상자를 추가하는 방법을 알아보세요. 대화상자 또는 사이드바의 맞춤 인터페이스를 만드는 방법에 관한 자세한 내용은 HTML 서비스 가이드를 참고하세요. 부가기능의 일부로 맞춤 인터페이스를 게시할 계획이라면 스타일 가이드를 따라 Google Docs 편집기의 스타일과 레이아웃의 일관성을 유지하세요.

Google Docs용 부가기능

부가기능은 Google Docs 내에서 실행되며 Google Docs 부가기능 스토어에서 설치할 수 있습니다. Google Docs용 스크립트를 개발하여 전 세계에 공유하려는 경우 Apps Script를 사용하여 스크립트를 부가기능으로 게시하여 다른 사용자가 부가기능 스토어에서 스크립트를 설치할 수 있습니다.

Google Docs용 부가기능을 만드는 방법을 알아보려면 Docs 부가기능 빌드 빠른 시작을 참고하세요.

트리거

Google 문서에 결합된 스크립트는 간단한 트리거를 사용하여 문서의 onOpen 이벤트에 응답할 수 있습니다. 이 트리거는 문서에 대한 수정 액세스 권한이 있는 사용자가 Google Docs에서 문서를 열 때마다 발생합니다.

트리거를 설정하려면 onOpen()라는 함수를 작성하기만 하면 됩니다. 이 트리거의 예는 Google Workspace의 맞춤 메뉴를 참고하세요. 간단한 트리거는 메뉴 추가에는 유용하지만 승인이 필요한 Apps Script 서비스는 사용할 수 없습니다.