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 프로젝트 함수의 개별 실행을 보고 관리할 수 있습니다. 왼쪽 탐색 메뉴에서 My Executions(내 실행) 항목을 선택하면 최근 실행의 전체 로그를 확인할 수 있습니다.
내 실행 패널에는 기본적으로 내가 소유자, 편집자 또는 보기 권한 사용자인 프로젝트의 이전 실행 및 현재 실행 중인 모든 실행의 로그가 표시됩니다. 이 목록에는 나를 대신하여 실행되는 경우 액세스할 수 없는 프로젝트의 함수 실행도 포함될 수 있습니다 (예: 내가 설치하고 실행한 부가기능). 실행 목록에는 실행을 시작하기 위해 호출되는 초기 함수만 표시됩니다. 실행 중에 호출된 모든 함수가 표시되지는 않습니다.
뷰 상단의 필터를 사용하여 로그에 보고되는 실행 유형을 제어할 수 있습니다. 로그의 각 행은 단일 실행을 나타냅니다. 시작 시간, 시간, 상태 열에는 해당 실행에 관한 상응하는 정보가 표시됩니다.
Function 열에는 실행을 시작한 함수의 이름이 표시됩니다. 실행의 해당 스크립트 프로젝트에 액세스할 수 없지만 대신 실행된 경우 이 열에 이름이 표시되지 않습니다.
유형 열에는 실행을 시작한 항목이 표시됩니다. 여기에 표시되는 값은 다음과 같습니다.
- 부가기능을 클릭합니다. 부가기능에서 실행되었습니다.
- Execution API 실행은 Apps Script API 호출에서 시작되었습니다.
- 시간 기반. 시간 이벤트로 인해 실행되었습니다.
- 트리거. 실행이 트리거 소스에서 시작되었습니다.
- Webapp 배포된 웹 앱에서 실행이 시작되었습니다.
- 편집자. Apps Script 편집기에서 실행된 실행입니다.
실행 종료
현재 진행 중인 장기 실행 실행은 상태가 '실행 중'으로 표시됩니다. 이러한 실행을 중지하려면 프로젝트 행 오른쪽에서 더보기 > 종료를 클릭합니다.
설정
왼쪽 탐색 메뉴에서 설정을 선택하여 대시보드 설정을 조정할 수 있습니다.
설정 패널에는 Apps Script API 전환 버튼이 있습니다. 이렇게 하면 API에 스크립트 프로젝트에 대한 액세스 권한을 부여할 수 있습니다.
이 전환 버튼을 사용하려면 설정 패널에서 Google Apps Script API 라벨을 클릭하세요. 그러면 경고 텍스트와 전환 스위치가 있는 새 패널이 열립니다. 스크립트 프로젝트에 대한 액세스는 보안 예방 조치로 기본적으로 사용 중지되어 있습니다. 액세스 권한을 부여하면 승인한 서드 파티 애플리케이션에서 API를 사용하여 스크립트와 배포를 수정할 수 있습니다. 언제든지 설정 패널에서 이 액세스를 취소할 수 있습니다.
Apps Script API 액세스 가이드에서 자세히 알아보세요.