Hướng dẫn bắt đầu nhanh về 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.

Tính năng 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 trong quy trình xác thực và uỷ quyền. Bạn nên sử dụng các thư viện ứng dụng cho ứng dụng của mình. Bước 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 chính thức, 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 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 SDK dành cho quản trị viên.

Mục tiêu

  • Tạo tập lệnh.
  • Bật API SDK dành cho quản trị viên.
  • Chạy mẫu.

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

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

  • 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:

adminSDK/báo cáo/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 không có tiêu đề, nhập Bắt đầu nhanh rồi nhấp vào Đổi tên.

Bật API SDK dành cho quản trị viên

  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 Thêm dịch vụ .
  4. Chọn API Báo cáo quản trị 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).

Lần đầu tiên bạn chạy mẫu, mẫu sẽ nhắc bạn cấp quyền truy cập:

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