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