Panduan memulai Google Apps Script

Panduan memulai menjelaskan cara menyiapkan dan menjalankan aplikasi yang memanggil Google Workspace API.

Panduan memulai Google Workspace menggunakan library klien API untuk menangani beberapa detail tentang alur otentikasi dan otorisasi. Sebaiknya Anda menggunakan library klien untuk aplikasi Anda sendiri. Panduan memulai ini menggunakan pendekatan otentikasi yang disederhanakan yang sesuai untuk pengujian lingkungan fleksibel App Engine. Untuk lingkungan produksi, sebaiknya pelajari tentang autentikasi dan otorisasi sebelum memilih kredensial akses yang sesuai untuk aplikasi Anda.

Buat Skrip Google Apps yang membuat permintaan ke Google Classroom API.

Tujuan

  • Konfigurasi lingkungan.
  • Buat dan konfigurasi skrip.
  • Jalankan skrip.

Prasyarat

  • Akun Google for Education dengan Google Classroom yang diaktifkan.

  • Akses ke Google Drive

Membuat skrip

  1. Buat skrip baru dengan membuka script.google.com/create.
  2. Ganti konten editor skrip dengan kode berikut:

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. Klik Simpan .
  2. Klik Project tanpa judul, ketik Panduan memulai, lalu klik Ganti nama.

Mengonfigurasi skrip

Mengaktifkan Google Classroom API

  1. Buka project Apps Script.
  1. Klik Editor .
  2. Di samping Layanan, klik Tambahkan layanan .
  3. Pilih API Google Classroom lalu klik Add.

Menjalankan contoh

Di editor Apps Script, klik Run.

Saat pertama kali menjalankan contoh, Anda akan diminta untuk mengizinkan akses:

  1. Klik Tinjau izin.
  2. Pilih akun.
  3. Klik Izinkan.

Log eksekusi skrip akan muncul di bagian bawah jendela.

Langkah berikutnya