คู่มือเริ่มใช้งาน Google Apps Script ฉบับย่อ

การเริ่มต้นอย่างรวดเร็วอธิบายวิธีตั้งค่าและเรียกใช้แอปที่เรียกใช้ Google Workspace API

การเริ่มต้น Google Workspace อย่างรวดเร็วจะใช้ไลบรารีของไคลเอ็นต์ API ในการจัดการรายละเอียดบางอย่างของขั้นตอนการตรวจสอบสิทธิ์และการให้สิทธิ์ เราขอแนะนำให้คุณใช้ไลบรารีของไคลเอ็นต์สำหรับแอปของคุณเอง การเริ่มต้นอย่างรวดเร็วนี้ใช้วิธีการตรวจสอบสิทธิ์แบบง่ายที่เหมาะสำหรับสภาพแวดล้อมการทดสอบ สำหรับสภาพแวดล้อมของเวอร์ชันที่ใช้งานจริง เราขอแนะนำให้เรียนรู้เกี่ยวกับการตรวจสอบสิทธิ์และการให้สิทธิ์ก่อนที่จะเลือกข้อมูลเข้าสู่ระบบที่เหมาะสำหรับแอปของคุณ

สร้าง Google Apps Script ที่ส่งคำขอไปยัง Google Classroom API

วัตถุประสงค์

  • เขียนสคริปต์
  • เปิดใช้ Google Classroom API
  • เรียกใช้ตัวอย่าง

ข้อกำหนดเบื้องต้น

  • บัญชี Google for Education ที่เปิดใช้ Google Classroom

  • การเข้าถึง Google ไดรฟ์

สร้างสคริปต์

  1. สร้างสคริปต์ใหม่โดยไปที่ script.google.com/create
  2. แทนที่เนื้อหาของโปรแกรมแก้ไขสคริปต์ด้วยโค้ดต่อไปนี้

classroom/quickstart/quickstart.gs
/**
 * Lists 10 course names and ids.
 */
function listCourses() {
  /**  here pass pageSize Query parameter as argument to get maximum number of result
   * @see https://developers.google.com/classroom/reference/rest/v1/courses/list
   */
  const optionalArgs = {
    pageSize: 10
    // Use other parameter here if needed
  };
  try {
    // call courses.list() method to list the courses in classroom
    const response = Classroom.Courses.list(optionalArgs);
    const courses = response.courses;
    if (!courses || courses.length === 0) {
      console.log('No courses found.');
      return;
    }
    // Print the course names and IDs of the courses
    for (const course of courses) {
      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_FOUND
    console.log('Failed with error %s', err.message);
  }
}

  1. คลิกบันทึก
  2. คลิกโปรเจ็กต์ที่ไม่มีชื่อ พิมพ์ Quickstart แล้วคลิกเปลี่ยนชื่อ

เปิดใช้ Google Classroom API

  1. เปิดโปรเจ็กต์ Apps Script
  2. คลิกตัดต่อวิดีโอ
  3. ถัดจากบริการ ให้คลิกเพิ่มบริการ
  4. เลือก Google Classroom API แล้วคลิกเพิ่ม

เรียกใช้ตัวอย่าง

คลิกเรียกใช้ในเครื่องมือแก้ไข Apps Script

ครั้งแรกที่เรียกใช้ตัวอย่าง ระบบจะเตือนให้คุณอนุญาตการเข้าถึง

  1. คลิกตรวจสอบสิทธิ์
  2. เลือกบัญชี
  3. คลิกอนุญาต

บันทึกการดำเนินการของสคริปต์จะปรากฏที่ด้านล่างของหน้าต่าง

ขั้นตอนถัดไป