Hướng dẫn nhanh về Google Apps Script

Tạo một Google Apps Script đưa ra các yêu cầu đối với Admin SDK API.

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 một API Google Workspace. Hướng dẫ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 kiểm thử. Đối với môi trường phát hành công khai, bạn nên tìm hiểu về xác thực và uỷ quyền trước khi chọn thông tin đăng nhập để truy cập phù hợp với ứng dụng của bạn.

Trong Apps Script, các hướng dẫn nhanh về Google Workspace sử dụng Dịch vụ nâng cao của Google để gọi API Google Workspace và xử lý một số thông tin chi tiết về quy trình xác thực và uỷ quyền.

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

  • Miền Google Workspace có quyền truy cập API.
  • Một Tài khoản Google có đặc quyền quản trị viên trong miền đó.

  • 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 đoạn mã sau:

adminSDK/reports/quickstart.gs
/**
 * List login events for a Google Workspace domain.
 * @see https://developers.google.com/admin-sdk/reports/reference/rest/v1/activities/list
 */
function listLogins() {
  const userKey = 'all';
  const applicationName = 'login';
  const optionalArgs = {
    maxResults: 10
  };
  try {
    const response = AdminReports.Activities.list(userKey, applicationName, optionalArgs);
    const activities = response.items;
    if (!activities || activities.length === 0) {
      console.log('No logins found.');
      return;
    }
    // Print login events
    console.log('Logins:');
    for (const activity of activities) {
      console.log('%s: %s (%s)', activity.id.time, activity.actor.email,
          activity.events[0].name);
    }
  } catch (err) {
    // TODO (developer)- Handle exception from the Report  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 Dự án chưa có tên, nhập Bắt đầu nhanh rồi nhấp vào Đổi tên.

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

Bật API Admin SDK

Mở dự án Apps Script.

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

Chạy mẫu

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

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

  1. Nhấp vào Xem xét 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