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