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 액세스 가이드를 참조하세요.
지원
오류가 발생하거나 Apps Script 대시보드 사용과 관련해 도움이 필요한 경우 먼저 Stack Overflow에서 검색하거나 질문을 올려보세요.
버그
대시보드 자체의 버그로 인해 문제의 원인이 확인되면 문제 추적기를 검색하여 알려진 문제인지 확인할 수 있습니다. 문제가 있는 경우 문제 번호 옆에 있는 별표를 클릭하여 별표표시할 수 있습니다. 별표가 더 많이 접수된 버그는 우선적으로 표시됩니다. 기존 문제에 댓글을 달 수도 있지만, 문제가 발생한 상황이나 관련 정보를 추가할 수 있는 경우에만 댓글을 다시기 바랍니다.
완전히 새로운 문제라면 문제 추적기에서 신고할 수 있습니다. 이러한 경우 버그 설명에 다음 정보를 포함해야 합니다.
- 문제에 대한 설명 및 정상일 때의 작동 방식
- 문제를 재현하는 데 사용할 수 있는 단계의 목록입니다.
- 기대한 출력 및 실제로 발생한 출력에 대한 설명. 발생한 오류 메시지를 모두 포함하세요.
- 개발 환경에 대한 정보(프로그래밍 언어, 라이브러리 버전 등)
문제를 신고해도 얼마 동안은 조치가 없는 것처럼 보일 수 있습니다. 그렇더라도 문제를 해결하지 않는 것은 아니며, 당장은 관련된 소식이 없다는 의미일 뿐입니다.
누락된 기능
대시보드에 필요한 기능이 있는 경우 Issue Tracker를 검색하여 다른 사람이 요청한 기능이 맞는지 확인할 수 있습니다. 이미 요청되었다면 문제 번호 옆에 있는 별표를 클릭하여 별점을 부여하세요. 별점이 높은 버그부터 우선적으로 처리됩니다. 기존 문제에 댓글을 달 수도 있지만, 문제가 발생한 상황이나 관련 정보를 추가할 수 있는 경우에만 댓글을 다시기 바랍니다.
아직 요청되지 않은 기능이라면 문제 추적기에서 기능 요청을 제출할 수 있습니다. 추가되었으면 하는 구체적인 기능과 그 이유를 설명하세요. 가능하다면 사용 사례 및 해당 기능이 가져올 이점을 자세히 서술하시기 바랍니다.