빠른 시작에서는 Google Workspace API를 호출하는 앱을 설정하고 실행하는 방법을 설명합니다. 이 빠른 시작에서는 테스트 환경에 적합한 간소화된 인증 방식을 사용합니다. 프로덕션 환경의 경우 앱에 적합한 액세스 사용자 인증 정보 선택 전에 인증 및 승인에 대해 알아보는 것이 좋습니다.
Apps Script에서 Google Workspace 빠른 시작은 고급 Google 서비스를 사용하여 Google Workspace API를 호출하고 인증 및 승인 흐름의 일부 세부정보를 처리합니다.
/** * Lists 10 course names and ids. */functionlistCourses(){/** here pass pageSize Query parameter as argument to get maximum number of result * @see https://developers.google.com/classroom/reference/rest/v1/courses/list */constoptionalArgs={pageSize:10// Use other parameter here if needed};try{// call courses.list() method to list the courses in classroomconstresponse=Classroom.Courses.list(optionalArgs);constcourses=response.courses;if(!courses||courses.length===0){console.log('No courses found.');return;}// Print the course names and IDs of the coursesfor(constcourseofcourses){console.log('%s (%s)',course.name,course.id);}}catch(err){// TODO (developer)- Handle Courses.list() exception from Classroom API// get errors like PERMISSION_DENIED/INVALID_ARGUMENT/NOT_FOUNDconsole.log('Failed with error %s',err.message);}}
[null,null,["최종 업데이트: 2025-08-28(UTC)"],[],[],null,["Create a\n[Google Apps Script](/apps-script/overview)\nthat makes requests to the Google Classroom API.\n\nQuickstarts explain how to set up and run an app that calls a\nGoogle Workspace API. This quickstart uses a\nsimplified authentication approach that is appropriate for a testing\nenvironment. For a production environment, we recommend learning about\n[authentication and authorization](/workspace/guides/auth-overview)\nbefore\n[choosing the access credentials](/workspace/guides/create-credentials#choose_the_access_credential_that_is_right_for_you)\nthat are appropriate for your app.\n\nIn Apps Script, Google Workspace\nquickstarts use\n[Advanced Google services](/apps-script/guides/services/advanced) to call\nGoogle Workspace APIs and handle some details of the authentication\nand authorization flow.\n\nObjectives\n\n- Configure the environment.\n- Create and configure the script.\n- Run the script.\n\nPrerequisites\n\n\u003cbr /\u003e\n\n- A Google for Education account with Google Classroom enabled.\n\n\u003cbr /\u003e\n\n- Access to Google Drive\n\nCreate the script\n\n1. Create a new script by going to [script.google.com/create](https://script.google.com/create).\n2. Replace the contents of the script editor with the following code:\n\n\nclassroom/quickstart/quickstart.gs \n[View on GitHub](https://github.com/googleworkspace/apps-script-samples/blob/main/classroom/quickstart/quickstart.gs) \n\n```javascript\n/**\n * Lists 10 course names and ids.\n */\nfunction listCourses() {\n /** here pass pageSize Query parameter as argument to get maximum number of result\n * @see https://developers.google.com/classroom/reference/rest/v1/courses/list\n */\n const optionalArgs = {\n pageSize: 10\n // Use other parameter here if needed\n };\n try {\n // call courses.list() method to list the courses in classroom\n const response = Classroom.Courses.list(optionalArgs);\n const courses = response.courses;\n if (!courses || courses.length === 0) {\n console.log('No courses found.');\n return;\n }\n // Print the course names and IDs of the courses\n for (const course of courses) {\n console.log('%s (%s)', course.name, course.id);\n }\n } catch (err) {\n // TODO (developer)- Handle Courses.list() exception from Classroom API\n // get errors like PERMISSION_DENIED/INVALID_ARGUMENT/NOT_FOUND\n console.log('Failed with error %s', err.message);\n }\n}\n```\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n3. Click Save .\n4. Click **Untitled project** , type **Quickstart** , and click **Rename**.\n\n\u003cbr /\u003e\n\nConfigure the script\n\nEnable the Google Classroom API\n\nOpen the Apps Script project.\n\n1. Click **Editor** code.\n2. Next to **Services** , click Add a service add .\n3. Select Google Classroom API and click **Add**.\n\nRun the sample\n\nIn the Apps Script editor, click **Run**.\n\nThe first time you run the sample, it prompts you to authorize access:\n\n1. Click **Review permissions**.\n2. Choose an account.\n3. Click **Allow**.\n\nThe script's execution log appears at the bottom of the window. \ndone It worked! **Great!** Check out the further reading section below to learn more.\nwarning There was a problem **Bummer** , [let us know what went wrong](#). Check out our [troubleshooting](#troubleshooting) section below for some common errors and solutions. If you have found a bug in the code, [report the issue on GitHub](https://github.com/googleworkspace/apps-script-samples/issues) or submit a pull request.\n\nNext steps\n\n- [Google Apps Script Advanced Services documentation](/apps-script/guides/services/advanced)\n- [Try the Google Workspace APIs in the APIs explorer](/workspace/explore)\n- [Troubleshoot authentication and authorization issues](/workspace/classroom/troubleshoot-authentication-authorization)\n- [Classroom API reference documentation](/workspace/classroom/reference)"]]
를 클릭합니다.