이 페이지에서는 Google Forms API용 Apps Script 웹 앱 예시를 간략히 설명합니다.
기본 요건
- Google Cloud 프로젝트에서 Forms API를 사용 설정합니다.
- 샘플 웹 앱의 GitHub README 파일에 설명된 대로 새 Apps Script 프로젝트를 설정합니다.
개요
Forms API를 사용하면 인증된 클라이언트가 REST를 사용하여 API에 직접 액세스할 수 있습니다.
Apps Script는 유효한 OAuth 액세스 토큰을 획득하고 REST 호출을 실행하는 방법을 제공하므로 Apps Script를 Forms API와 직접 통합할 수 있습니다. Apps Script는 이미 스크립트가 Forms를 만들고, 액세스하고, 수정할 수 있도록 하는 기존 Forms 서비스를 제공합니다. 하지만 Apps Script에서 직접 Forms API를 사용하려면 다음과 같이 OAuth 액세스를 설정하세요.
범위가 지정되고 인증된 OAuth 액세스 토큰을 가져옵니다.
ScriptApp.getOAuthToken();API에 대한 REST 호출에 제공된 options 인수에 OAuth 토큰을 포함합니다.
UrlFetchApp.fetch(Url, options);
실제 사용 예는 Apps Script 프로젝트 설정을 참고하세요. 설정 가이드에서는 API를 호출하는 데 필요한 인프라를 자세히 설명합니다. 하지만 사용자에게 API에 대한 직관적인 액세스를 제공하려면 샘플 웹 앱을 사용해 보고 수정할 수도 있습니다.
웹 앱 사용 예시
모든 Forms API 메서드를 직접 호출하는 완전한 예시 웹 앱은 apps-script-samples GitHub 저장소에서 확인할 수 있습니다.
웹 앱 실행
프로젝트를 설정하고 웹 앱으로 배포한 후에는 몇 가지 작업을 시도해 볼 수 있습니다.
양식 만들기 버튼을 클릭하여 새 양식을 만듭니다.
이제 새 양식이 양식 ID: 필드에 표시되며 Forms에서 열기를 클릭하여 열 수 있습니다.
별도의 창에서 새 양식을 연 후 질문을 몇 개 수동으로 추가한 다음 Get Form by Id를 클릭하면 오른쪽의 JSON 출력에 새 질문이 표시됩니다.
앱에서 사용할 수 있는 다른 메서드를 살펴보고 각 작업의 출력을 오른쪽에서 확인합니다.
Forms 시계 사용
시계 양식의 버튼도 확인하세요. 이러한 기능은 Forms API 감시 기능을 사용하며 감시를 만들고, 나열하고, 삭제하고, 갱신하는 작업을 실행합니다. Cloud Pub/Sub 주제를 사용하여 프로젝트를 설정해야 합니다.
Forms API 감시 및 Cloud Pub/Sub에 대한 자세한 내용은 푸시 알림 설정 및 수신을 참고하세요.
다음 단계
필요에 맞게 예시 앱을 맞춤설정해 보세요. 예를 들면 다음과 같습니다.
- Google 시트에서 문제 은행을 만든 다음 Apps Script SpreadsheetApp 서비스를 사용하여 시트에서 질문을 가져와 새 양식을 채웁니다.
- 또는 질문 은행이 SQL 데이터베이스에 있을 수 있으며, 여기에서 Apps Script JDBC 서비스를 사용하여 데이터베이스의 질문으로 양식을 채울 수 있습니다.
- 퀴즈를 생성하고 Google 시트 성적표에 점수를 저장합니다.
- Cloud Pub/Sub로 프로젝트를 설정하고 watches 기능을 사용하여 퀴즈 결과를 표시하는 실시간 학생 리더보드를 생성합니다.