Bắt đầu nhanh Google Apps Script

Phần bắt đầu nhanh giải thích cách thiết lập và chạy một ứng dụng gọi API Google Workspace.

Các hướng dẫn nhanh về Google Workspace sử dụng thư viện ứng dụng API để xử lý một số thông tin chi tiết về quy trình xác thực và uỷ quyền. Bạn nên sử dụng thư viện ứng dụng cho các ứng dụng của riêng mình. Phần bắt đầu nhanh này sử dụng phương pháp xác thực đơn giản phù hợp với môi trường thử nghiệm. Đối với môi trường phát hành công khai, bạn nên tìm hiểu về quy trình xác thực và uỷ quyền trước khi chọn thông tin xác thực truy cập phù hợp với ứng dụng của mình.

Tạo một tập lệnh Google Apps để gửi yêu cầu đến API Google Lớp học.

Mục tiêu

• Định cấu hình môi trường.
• Tạo và định cấu hình tập lệnh.
• Chạy tập lệnh.

Điều kiện tiên quyết

• Tài khoản Google for Education đã bật Google Lớp học.

• Quyền truy cập vào Google Drive

Tạo tập lệnh

1. Tạo một tập lệnh mới bằng cách truy cập vào script.google.com/create.
2. Thay thế nội dung của trình chỉnh sửa tập lệnh bằng mã sau:

/**
 * 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);
  }
}

3. Nhấp vào biểu tượng Lưu .
4. Nhấp vào Untitled project (Dự án chưa có tên), nhập Quickstart (Bắt đầu nhanh) rồi nhấp vào Rename (Đổi tên).

Định cấu hình tập lệnh

Bật API Google Lớp học

1. Mở dự án Apps Script.

1. Nhấp vào biểu tượng Trình chỉnh sửa code.
2. Bên cạnh Dịch vụ, hãy nhấp vào biểu tượng Thêm dịch vụ add .
3. Chọn Google Classroom API rồi nhấp vào Thêm.

Chạy mẫu

Trong trình chỉnh sửa Apps Script, hãy nhấp vào Run (Chạy).

Trong lần đầu chạy mẫu, bạn sẽ được nhắc uỷ quyền truy cập:

1. Nhấp vào Xem lại quyền.
2. Chọn một tài khoản.
3. Nhấp vào Cho phép.

Nhật ký thực thi của tập lệnh sẽ xuất hiện ở cuối cửa sổ.

Các bước tiếp theo

• Tài liệu về Dịch vụ nâng cao của Google Apps Script
• Khắc phục sự cố xác thực và uỷ quyền
• Tài liệu tham khảo về API Lớp học