Google 문서(Google Docs) , Google 스프레드시트(Google Sheets) , Google 애널리틱스(Google Analytics) , Gmail 등과 같은 Google 서비스를 사용하는 경우 Google Apps Script 를 사용하여 이러한 서비스를 연결하고 자동화할 수 있습니다 .
Google Apps Script 는 Microsoft VBA 스크립트의(Microsoft’s VBA script) Google 버전과 비슷 합니다. VBA를 사용하여 Microsoft Word(Microsoft Word) 및 Excel(Excel with VBA) 에서 작업 및 작업을 자동화하거나 매크로를 사용자 지정할 수 있는 것처럼 Google 서비스 전반에서 작업 및 작업을 자동화할 수 있습니다 . 스프레드시트 및 문서(Docs) 와 같은 서비스 에서 나만의 맞춤 메뉴를 작성할 수도 있습니다.
이 문서에서는 다양한 Google 서비스(various Google services) 에서 Apps Script 에 액세스하고 활성화 하는 방법, Apps Script 편집기(Apps Script Editor) 를 탐색하는 방법 및 서비스를 연결하는 방법을 배웁니다. 특정 스크립트 기능을 배우지(learn specific script functions) 는 않겠지만 Google 에는 (Google)Apps Script 작성 방법을 배울 수 있는 훌륭한 문서와 앱 스크립트 자습서가 있습니다 .
Google Apps 스크립트 편집기(Access Google Apps Script Editor) 에 액세스하는 방법
여러 Google(Google) 서비스 내에서 Google Apps Script 코드 편집기를 열 수 있습니다 . 예를 들어 Google 스프레드시트 의 확장 프로그램 메뉴에서 (Extensions)Apps Script 를 찾을 수 있습니다.
다른 서비스에서는 다음과 같은 방법으로 Google Apps Script(Google Apps Script) 편집기를 열 수 있습니다 .
- Google 문서도구(Google Docs) : 도구(Tools) 메뉴 에서 스크립트 편집기 를 선택합니다.(Script editor)
- Google 프레젠테이션(Google Slides) : 도구(Tools) 메뉴 에서 스크립트 편집기 를 선택합니다.(Script editor)
- Google 설문지(Google Forms) : 점 3개로 된 메뉴에서 스크립트 편집기(Script editor) 를 선택 합니다.
- Google 드라이브(Google Drive) : 빈 공간을 마우스 오른쪽 버튼으로 클릭하고 더보기(More) 를 선택한 다음 Google Apps Script 를 선택 합니다.
이러한 방법을 사용하면 새 탭에서 Apps Script 코드 편집기가 열리는 것을 볼 수 있습니다. 이것은 전체 스크립트를 구성하는 각 기능을 작성하는 창입니다. 기본적으로 코드 작성을 시작할 준비가 된 myFunction()이라는 빈 함수가 표시됩니다.
참고(Note) : 오류를 방지하려면 코드 형식을 지정하는 것이 매우 중요합니다. 다음 코드와 같이 주석을 사용하여 코드 섹션 내에서 무엇을 하려고 했는지 스스로에게 상기시키십시오. 이것은 웹 프로그래밍을 사용 하여 HTML 코드에서 주석이 작동하는 방식과 매우 유사합니다.(HTML)
코드 편집기를 탐색할 때 편집기(Editor) 창의 왼쪽 탐색 창에서 Code.gs 를 선택하여 이 섹션으로 돌아갈 수 있습니다 . 사용 가능한 다른 창을 보려면 맨 왼쪽 창의 아이콘 위로 마우스를 가져가면 기본 탐색 창이 열립니다.
개요(Overview) 섹션 에서는 발생한 오류 수, 실행 횟수 등과 같은 스크립트에 대한 통계를 찾을 수 있습니다.
아래의 각 섹션에서 Google Apps Script(Google Apps Script) 편집기 의 다른 각 섹션을 다룹니다.
Google Apps 스크립트 편집기(Google Apps Script Editor) 탐색
편집기에서 코드를 편집할 때 작업 내용을 잃지 않도록 디스크( 저장(Save) ) 아이콘을 자주 선택하는 것이 좋습니다 .
저장되면 다른 메뉴 옵션이 켜진 것을 볼 수 있습니다.
여기에는 다음이 포함됩니다.
- 실행(Run) : 전체 스크립트를 처음부터 끝까지 실행해 봅니다.
- 디버그(Debug) : 스크립트를 한 번에 한 줄씩 단계별로 실행합니다.
- 함수 드롭다운(Function dropdown) : 생성한 각 함수를 탐색하고 탐색합니다.
- 실행 로그(Execution log) : 스크립트를 실행하기 위해 시도한 각 시도의 상태 또는 오류 메시지를 확인합니다.
왼쪽 탐색 메뉴 의 라이브러리(Libraries) 옵션은 다른 사람들이 작성한(또는 다른 곳에 작성하여 저장한) 라이브러리에 액세스할 수 있는 곳입니다. 이 기능은 친구가 이미 Google 스프레드시트(Google Sheets) 나 Google 문서도구(Google Docs) 에서 사용하고 싶은 기능을 작성 했지만 그 위에 기능을 추가하고 싶은 경우에 유용합니다.
이러한 라이브러리를 프로젝트에 추가하는 데 필요한 것은 스크립트 ID 뿐입니다(Script ID) . 프로젝트 설정 섹션에서 찾을 수 있습니다. 이 섹션은 이 문서의 끝부분에서 찾는 방법을 보여줍니다.
Google Apps Script 서비스 부가기능
서비스(Services) 섹션 이 가장 유용합니다. 여기에서 현재 스크립트를 사용할 수 있는 다른 Google 서비스와 통합할 수 있습니다.
선택하면 서비스 추가(Add a service) 창이 열립니다. 기존 프로젝트의 추가 기능으로 사용하려는 서비스까지 아래로 스크롤 합니다.(Scroll)
예를 들어 Google Analytics 계정의 데이터를 이 스크립트로 가져오려면 Google Analytics API 를 선택하고 추가(Add) 를 선택하면 됩니다.
해당 새 추가 기능 서비스에 사용할 수 있는 기능과 사용 방법에 대한 세부 정보를 찾으려면 API 오른쪽에 있는 세 개의 점을 선택하고 (API)문서 보기(See documentation) 를 선택 하십시오 .
그러면 새 탭에서 Google Apps Script 문서가 열리고 해당 (Google Apps Script)Google 서비스에 대한 섹션이 자동으로 열립니다.
자체 스크립트에서 사용할 수 있는 함수 구문, 자습서 및 코드 예제에 대한 설명서를 살펴보십시오.
또한 문서의 다른 섹션으로 이동하여 원래 Apps Script(Apps Script) 코드 편집기 를 열 때 사용하던 서비스를 기반으로 스크립트에서 사용할 수 있는 일반 기능을 확인할 수 있습니다 .
예를 들어 Google 스프레드시트에서 편집기를 연 경우 스크립트(Google Sheets) 에서 사용할 수 있는 Google 스프레드시트(Google Sheets) 기능 에 대한 문서 메뉴 의 스프레드시트(Sheets) 섹션을 확인 하세요.
Apps Script 트리거(Using Apps Script Triggers) 설정 및 사용
Google Apps Script 의 또 다른 유용한 기능은 여러 이벤트 또는 일정에 따라 트리거를 설정하는 기능입니다.
스크립트에 대한 새 트리거를 구성하려면 맨 왼쪽 탐색 메뉴에서 트리거 를 선택합니다. (Triggers)열리는 새 트리거 창에서 (Triggers)트리거 추가(Add Trigger) 버튼을 선택합니다.
트리거 추가(Add Trigger) 창에는 스크립트를 실행하려는 방법과 시기를 정확하게 사용자 지정하는 데 도움이 되는 긴 옵션 목록이 있습니다 .
참고(Note) : 이러한 옵션 중 대부분은 스크립트를 작성하는 서비스 또는 추가한 API(the APIs that you’ve added) 에 따라 다릅니다 .
트리거를 설정하려면 다음을 선택해야 합니다.
- 처음 시작할 기능
- 특정 시간, 날짜 또는 Google(Google) 스프레드시트 셀이 변경되거나 문서가 처음 열릴 때와 같은 서비스의 이벤트와 같은 이벤트 소스
- Google 스프레드시트 또는 문서의 항목을 열거나 수정 하는 경우와 같은 이벤트 유형 또는 날짜 또는 시간에 대한 특정 설정
- 스크립트가 실패했을 때 업데이트를 받고자 하는 빈도에 대한 알림 빈도
저장(Save) 을 선택 하면 새 트리거를 처음으로 저장한 경우 " 스크립트 인증 실패" 메시지가 표시될 수 있습니다.(Script)
이것은 일반적으로 브라우저에서 팝업 차단기가 활성화된 경우 트리거됩니다. Google 크롬(Google Chrome) 을 사용 하는 경우 빨간색 'X'가 표시된 작은 창 아이콘을 선택하면 됩니다. 설정을 항상 팝업 허용 으로 변경하고 (Always allow pop-ups)완료(Done) 를 선택 합니다.
다시 저장(Save) 을 선택하면 작성한 스크립트가 Google 계정 또는 Google Workspace 에서 실행되도록 승인하는 절차를 거쳐야 합니다 .
먼저 스크립트를 실행할 Google 계정을 선택합니다.(Google)
작성한 사용자 정의 함수 또는 스크립트가 Google(Google) 에서 "확인"되지 않았다는 경고가 표시 됩니다 . 스크립트를 작성한 사람이라면 이는 중요하지 않으며 자신의 Google 계정(Google Account) 또는 Google Workspace 로 실행하는 것이 안전합니다 .
이 경고를 무시하려면 고급(Advanced) 을 선택한 다음 Go to <project> (unsafe) 링크를 선택하면 됩니다.
마지막으로 권한 창에서 허용(Allow) 을 선택하여 사용자 정의 함수 및 스크립트가 Google 계정 또는 Google Workspace 에서 실행되도록 허용합니다 .
사용자 정의 Google Apps(Google Apps) 스크립트 프로젝트 를 처음 저장하거나 실행할 때만 이 프로세스를 다시 반복할 필요가 없습니다 .
Google 스크립트 ID에 액세스
마지막 참고 사항 - 친구나 동료에게 스크립트를 제공하여 그들이 스크립트를 사용하거나 자신의 스크립트에 라이브러리로 추가할 수 있도록 할 수 있습니다.
맨 왼쪽 탐색 창의 설정(Settings) 아이콘 아래에서 스크립트 ID(Script ID) 를 찾을 수 있습니다 .
스크립트 ID(Script ID) 는 스크립트 ID(Script ID) 오른쪽의 ID(IDs) 섹션 에서 찾을 수 있습니다 .
보시다시피 Google Apps Script 편집기는 사용하려는 각 기능으로 이동하는 방법을 안다면 매우 간단합니다. 스크립트 작성 방법과 사용 가능한 모든 기능을 배울 수 있도록 Google의 Apps Script 문서 를 잘 공부하십시오.(Just)
Google Apps Script Editor: Everything You Need to Know to Get Started
If you usе Google serviсes like Google Docs, Google Sheets, Google Analytics, Gmail, and оthers, you could connect and automatе those services using Google Apps Script.
Think of Google Apps Script like Google’s version of Microsoft’s VBA script. Just like you can automate actions and tasks or customize macros in Microsoft Word and Excel with VBA, you can automate tasks and actions across Google services. In services like Sheets and Docs, you can even write your own custom menus.
In this article you will learn how to access and enable Apps Script in your various Google services, how to navigate the Apps Script Editor, and how to connect services. You won’t learn specific script functions, but Google has excellent documentation and apps script tutorials available to learn how to write Apps Script.
How to Access Google Apps Script Editor
You can open the Google Apps Script code editor from within a number of Google services. For example, you’ll find Apps Script in the Extensions menu inside Google Sheets.
In other services, you can open the Google Apps Script editor in the following ways:
- Google Docs: Select Script editor in the Tools menu.
- Google Slides: Select Script editor in the Tools menu.
- Google Forms: Select Script editor in the three-dot menu.
- Google Drive: Right-click any blank space, select More, and select Google Apps Script.
Using any of these methods, you’ll see the Apps Script code editor open in a new tab. This is the window where you’ll write each of the functions that make up your entire script. By default, you’ll see an empty function named myFunction() that’s ready for you to start filling in your code.
Note: Code formatting is very important in order to avoid errors. Use commenting as shown in the following code to remind yourself what you were trying to do inside sections of code. This is very similar to how commenting works in HTML code with web programming.
As you navigate the code editor, you can return to this section by selecting Code.gs in the left navigation pane in the Editor window. To see other available windows, hover over the icons in the far left pane and the main navigation pane will open.
The Overview section is where you can find statistics about your script like how many errors have occurred, how many times it’s executed, and more.
We’ll cover each of the other sections of the Google Apps Script editor in each section below.
Navigating the Google Apps Script Editor
As you edit your code in the editor, it’s a good idea to select the disk (Save) icon often so that you don’t lose your work.
Once saved, you’ll see the other menu options light up.
These include:
- Run: Attempt to run your entire script from beginning to end.
- Debug: Step through your script one line at a time.
- Function dropdown: Browse through and navigate to each of the functions you’ve created.
- Execution log: See any status or error messages from each attempt you’ve made to run your script.
The Libraries option in the left navigation menu is where you can access libraries that other people have written (or you’ve written and saved elsewhere). This is useful if you have a friend who already wrote a feature you’d like to use in Google Sheets or Google Docs but you’d like to add additional features on top of that.
All you need to add those libraries into your project is the Script ID. You can find this in the project settings section, which we’ll show you how to find toward the end of this article.
Google Apps Script Services Add-Ons
The Services section is the most useful. It’s where you can integrate your current script with other Google services you may use.
When you select it, you’ll see the Add a service window open. Scroll down to the service you want to use as an add-on to your existing project.
For example, if you’d like to pull data from your Google Analytics account into this script, you can select the Google Analytics API, and select Add.
If you want to find details about what functions are available to use for that new add-on service and how to use them, select the three dots to the right of the API and select See documentation.
This will open the Google Apps Script documentation in a new tab, opened automatically to the section for that Google service.
Explore the documentation for function syntax, tutorials, and code examples that you can use in your own script.
Also, note that you can navigate to other sections of the documentation to see what general functions are available in your script based on the service you were using when you originally opened the Apps Script code editor.
For example, if you opened the editor in Google Sheets, check the Sheets section in the documentation menu for Google Sheets functions you’re able to use in your script.
Setting Up and Using Apps Script Triggers
Another useful feature in Google Apps Script is the ability to set triggers based on a number of events or schedules.
To configure a new trigger for your script, select Triggers from the far left navigation menu. In the new Triggers window that opens, select the Add Trigger button.
The Add Trigger window has a long list of options that help you customize exactly how and when you want your script to run.
Note: Many of these options depend on the service you’re writing your script for or the APIs that you’ve added.
To set up your trigger, you’ll need to choose:
- Which function to initially launch
- The event source such as a specific time, date, or an event in your service like when a Google spreadsheet cell changes or a document is initially opened
- The event type such as when something in your Google spreadsheet or document is opened or edited, or the specific setting for date or time
- Notification frequency for how often you want to get updates about when your scripts have failed
Once you select Save, you may see a “Script authorization failed” message if it’s the first time you’ve saved a new trigger.
This is usually triggered if you have a pop-up blocker enabled in your browser. If you’re using Google Chrome, just select the small window icon with a red “X” over it. Change the setting to Always allow pop-ups and select Done.
When you select Save again, you’ll need to step through the process to authorize the script you’ve written to run under your Google account or Google Workspace.
First, select the Google account that you want to allow your script to run under.
You’ll see a warning that the custom function or script you wrote isn’t “verified” by Google. If you’re the person who wrote the script, then this doesn’t matter and it’s safe to run under your own Google Account or Google Workspace.
To bypass this warning, just select Advanced and then select the Go to <project> (unsafe) link at the bottom.
Finally, in the permissions window, select Allow to allow your custom functions and script to run under your Google account or Google Workspace.
You won’t have to repeat this process again, only the first time you save or run your custom Google Apps script projects.
Accessing Your Google Script ID
One final note – you may want to provide your script to friends or colleagues so they can either use your script or add it as a library to their own script.
You can find your Script ID under the Settings icon in the far left navigation pane.
The Script ID can be found under the IDs section, to the right of Script ID.
As you can see, the Google Apps Script editor is fairly straightforward if you know how to navigate to each feature you want to use. Just make sure to study Google’s Apps Script documentation well so that you can start learning how to write your scripts and all functions that are available to use.