Apps Script 대시보드를 사용하면 Apps Script 프로젝트를 관리하고 모니터링할 수 있습니다. 대시보드를 사용하여 다음 작업을 할 수 있습니다.
- Google Workspace 문서에 첨부된 바인딩된 스크립트를 비롯한 기존 Apps Script 프로젝트를 보고 검색합니다.
- 새 프로젝트를 만듭니다.
- 사용하는 OAuth 범위와 같은 프로젝트 세부정보를 확인합니다.
- 스크립트 프로젝트의 상태와 사용량을 모니터링합니다.
- 내 계정의 사용자 인증 정보를 사용하여 실행되는 프로젝트 및 기타 프로젝트의 실행 로그를 확인합니다.
- Apps Script API를 사용 설정 또는 중지하여 앱이 API를 사용하여 스크립트 프로젝트와 상호작용하도록 허용하거나 차단합니다.
프로젝트 보기 및 검색
Apps Script 대시보드에는 보기 또는 수정할 수 있는 모든 스크립트 프로젝트가 표시됩니다. 대시보드의 왼쪽 탐색 메뉴는 이러한 프로젝트를 다음 카테고리로 나눕니다.
- 별표표시된 프로젝트. 모니터링 중인 프로젝트
- 내 프로젝트. 내가 소유자인 프로젝트
- 모든 프로젝트. 내가 소유하거나 보기 또는 수정 권한이 있는 프로젝트
- 공유 문서함 내가 소유하지는 않지만 나와 공유된 프로젝트
- 휴지통 Google Drive에서 삭제한 프로젝트
프로젝트 목록에는 프로젝트 이름, 소유자, 최종 수정 날짜가 표시됩니다. 프로젝트 이름 옆에 있는 아이콘은 프로젝트가 독립형 프로젝트인지 바인드된 프로젝트인지를 나타냅니다.
프로젝트 세부정보 보기
각 프로젝트에는 프로젝트에 관한 개발자 세부정보를 볼 수 있는 보기가 포함됩니다. 프로젝트에 관한 세부정보를 보려면 프로젝트 목록에서 행을 클릭합니다.
프로젝트 세부정보 뷰에는 프로젝트에 관한 오류율, 실행, 사용자 데이터와 그래프는 물론 프로젝트를 사용하는 최종 사용자에게 요청된 OAuth 범위도 표시됩니다. 데이터 측정항목은 다음과 같이 정의됩니다.
- 오류율 포착되지 않은 예외로 인해 실행되지 않은 실행의 비율입니다. 정의된 기간 동안의 실패한 실행 수를 총 실행 수로 나눈 값으로 계산됩니다.
- 실행 프로젝트가 '실행'된 횟수입니다. 프로젝트를 실행하는 방법에 관한 자세한 내용은 실행 유형을 참고하세요.
- 사용자 지정된 기간 동안 프로젝트를 한 번 이상 실행한 순 사용자 (계정) 수입니다. 익명 사용자는 추적되지 않으므로 사용자 수 또는 그래프에 반영되지 않습니다.
프로젝트의 각 배포는 데이터 및 그래프 위의 프로젝트 세부정보 페이지에 탭으로 표시됩니다. 탭을 선택하여 해당 배포와 연결된 데이터를 확인할 수 있습니다. 모두를 선택하면 모든 프로젝트 배포의 집계 데이터와 개발자가 Apps Script 코드 편집기 내에서 프로젝트를 실행하여 발생한 실행이 표시됩니다.
프로젝트 모니터링
정기적으로 사용하거나 관리하는 것보다 훨씬 많은 Apps Script 프로젝트에 액세스할 수 있습니다. 쉽게 액세스할 수 있도록 프로젝트를 북마크하려면 별표표시하면 됩니다. 프로젝트에 별표를 표시하면 해당 프로젝트의 집계 사용량 및 오류율 통계와 그래프를 모니터링할 수도 있습니다.
프로젝트에 별표를 표시하려면 프로젝트 행 오른쪽에서 더보기 > 별표 추가를 클릭합니다. 프로젝트 세부정보를 보는 동안 더보기 를 클릭하여 프로젝트에 별표를 표시할 수도 있습니다.
왼쪽 탐색에서 별표표시된 프로젝트를 선택하여 북마크한 프로젝트를 볼 수 있습니다. 페이지 상단의 오류율, 실행 또는 사용자 스코어카드를 클릭하여 지난 7일 동안 별표 표시된 모든 프로젝트의 관련 그래프를 확인합니다.
프로젝트 행에서 더보기 를 클릭하고 별표 삭제를 선택하여 프로젝트에서 별표를 삭제할 수 있습니다.
실행 관리
Apps Script 대시보드를 사용하여 Apps Script 프로젝트 함수의 개별 실행을 보고 관리할 수 있습니다. 왼쪽 탐색에서 내 실행 항목을 선택하면 최근 실행의 전체 로그를 확인할 수 있습니다.
내 실행 패널에는 기본적으로 내가 소유자, 편집자 또는 뷰어인 프로젝트의 이전 실행과 현재 실행 중인 모든 실행의 로그가 표시됩니다. 이 목록에는 내가 액세스할 수 없는 프로젝트의 함수 실행도 포함될 수 있습니다 (예: 내가 설치하고 실행한 부가기능). 실행 목록에는 실행을 시작하기 위해 호출되는 초기 함수만 표시됩니다. 이 도구는 실행 중에 호출된 모든 함수를 표시하지는 않습니다.
뷰 상단의 필터를 사용하여 로그에 보고되는 실행 유형을 제어할 수 있습니다. 로그의 각 행은 단일 실행을 나타냅니다. 시작 시간, 기간, 상태 열에는 해당 실행에 관한 정보가 표시됩니다.
함수 열에는 실행을 시작한 함수의 이름이 표시됩니다. 실행에 해당하는 스크립트 프로젝트에 액세스할 수 없지만 대신 실행된 경우 이 열에 이름이 표시되지 않습니다.
유형 열에는 실행을 시작한 항목이 표시됩니다. 여기에 표시되는 값은 다음과 같습니다.
- 추가 기능 실행이 부가기능에서 시작되었습니다.
- Execution API 실행이 Apps Script API 호출에서 시작되었습니다.
- 시간 기반 실행이 시간 이벤트로 인해 발생했습니다.
- 트리거. 실행이 트리거 소스에서 시작되었습니다.
- Webapp. 실행이 배포된 웹 앱에서 시작되었습니다.
- 편집자 실행이 Apps Script 편집기에서 시작되었습니다.
실행 종료
현재 진행 중인 장기 실행은 상태가 'Running'으로 표시됩니다. 이러한 실행을 중지하려면 프로젝트 행의 오른쪽에서 더보기 > 종료를 클릭합니다.
설정
왼쪽 탐색 메뉴에서 설정을 선택하여 대시보드 설정을 조정할 수 있습니다.
설정 패널에는 Apps Script API 전환 버튼이 있습니다. 이를 통해 API에 스크립트 프로젝트 액세스 권한을 부여할 수 있습니다.
이 전환 버튼에 액세스하려면 설정 패널에서 Google Apps Script API 라벨을 클릭합니다. 그러면 경고 텍스트와 전환 스위치가 있는 새 패널이 열립니다. 보안 예방 조치로 스크립트 프로젝트에 대한 액세스는 기본적으로 사용 중지되어 있습니다. 액세스 권한을 부여하면 승인한 모든 서드 파티 애플리케이션이 API를 사용하여 스크립트와 배포를 수정할 수 있습니다. 언제든지 설정 패널에서 이 액세스 권한을 취소할 수 있습니다.
자세한 내용은 Apps Script API 액세스 가이드를 참고하세요.