Apps Script 샘플 웹 앱

이 페이지에서는 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 액세스를 설정하세요.

  1. 범위가 지정되고 인증된 OAuth 액세스 토큰을 가져옵니다.

    ScriptApp.getOAuthToken();

  2. API에 대한 REST 호출에 제공되는 options 인수에 OAuth 토큰을 포함합니다.

    UrlFetchApp.fetch(Url, options);

실제 예를 보려면 Apps Script 프로젝트 설정을 참조하세요. 설정 가이드에서는 API 호출에 필요한 기본 배관 방법을 자세히 설명합니다. 하지만 최종 사용자가 API에 직관적으로 액세스할 수 있도록 샘플 웹 앱을 사용해 보고 수정할 수도 있습니다.

웹 앱 사용 예

모든 Forms API 메서드를 직접 호출하는 웹 앱의 전체 예는 데모용으로 GitHub에서 확인할 수 있습니다.

웹 앱 실행

프로젝트를 설정하고 웹 앱으로 배포한 후에는 몇 가지 기본 작업을 시도할 수 있습니다.

  1. 양식 만들기 버튼을 클릭하여 새 양식을 만듭니다.

    이제 새 양식이 Form id: 필드에 표시되며 Form in Forms를 클릭하여 열 수 있습니다.

  2. 별도의 창에서 새 양식을 연 후 몇 가지 질문을 수동으로 추가한 다음 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로 프로젝트를 설정하고 시계 기능을 사용하여 퀴즈 결과를 표시할 실시간 학생 리더보드를 생성합니다.