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

Tạo một Google Apps Script đưa ra các yêu cầu đến People 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 một 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 trong miền đó có đặc quyền quản trị viê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 mã sau:

people/quickstart/quickstart.gs
/**
 * Print the display name if available for 10 connections.
 */
function listConnectionNames() {
  try {
    /**
     * List the 10 connections/contacts of user
     * @see https://developers.google.com/people/api/rest/v1/people.connections/list
     */
    const connections = People.People.Connections.list('people/me', {
      pageSize: 10,
      personFields: 'names,emailAddresses'
      // use other query parameter here if needed.
    });
    connections.connections.forEach((person) => {
      // if contacts/connections is available, print the name of person.
      if (person.names && person.names.length === 0) {
        console.log('No display name found for connection.');
        return;
      }
      console.log(person.names[0].displayName);
    });
  } catch (err) {
    // TODO (developer) - Handle exception from People 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 Quickstart (Bắt đầu nhanh) rồi nhấp vào Đổi tên.

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

Bật People API

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 People 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 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