Bắt đầu nhanh Google Apps Script

Hướng dẫ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.

Trình bắt đầu nhanh của Google Workspace sử dụng thư viện ứng dụng API để xử lý một số chi tiết của 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. Hướng dẫn bắt đầu nhanh này sử dụng phương pháp xác thực được đơn giản hoá, phù hợp với môi trường kiểm thử. Đối với môi trường phát hành chính thức, bạn nên tìm hiểu về phương thức 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 Google Apps Script để gửi yêu cầu đến API Lịch Google.

Mục tiêu

  • Tạo tập lệnh.
  • Bật API Lịch Google.
  • Chạy mẫu.

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

  • Có một Tài khoản Google đã bật Lịch Google.

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

Tạo tập lệnh

  1. Tạo 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:

calendar/quickstart/quickstart.gs
/**
 * Lists 10 upcoming events in the user's calendar.
 * @see https://developers.google.com/calendar/api/v3/reference/events/list
 */
function listUpcomingEvents() {
  const calendarId = 'primary';
  // Add query parameters in optionalArgs
  const optionalArgs = {
    timeMin: (new Date()).toISOString(),
    showDeleted: false,
    singleEvents: true,
    maxResults: 10,
    orderBy: 'startTime'
    // use other optional query parameter here as needed.
  };
  try {
    // call Events.list method to list the calendar events using calendarId optional query parameter
    const response = Calendar.Events.list(calendarId, optionalArgs);
    const events = response.items;
    if (events.length === 0) {
      console.log('No upcoming events found');
      return;
    }
    // Print the calendar events
    for (const event of events) {
      let when = event.start.dateTime;
      if (!when) {
        when = event.start.date;
      }
      console.log('%s (%s)', event.summary, when);
    }
  } catch (err) {
    // TODO (developer) - Handle exception from Calendar API
    console.log('Failed with error %s', err.message);
  }
}

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

Bật API Lịch Google

  1. Mở dự án Apps Script.
  2. Nhấp vào biểu tượng Trình chỉnh sửa .
  3. Bên cạnh phần Dịch vụ, hãy nhấp vào biểu tượng Thêm dịch vụ .
  4. Chọn API Lịch 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).

Khi chạy mẫu lần đầu tiên, bạn sẽ được nhắc cấp 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