Panduan memulai Google Apps Script

Buat Google Apps Script yang membuat permintaan ke Directory API.

Panduan memulai cepat menjelaskan cara menyiapkan dan menjalankan aplikasi yang memanggil Google Workspace API. Panduan memulai cepat ini menggunakan pendekatan autentikasi yang disederhanakan dan sesuai untuk lingkungan pengujian. Untuk lingkungan produksi, sebaiknya pelajari autentikasi dan otorisasi sebelum memilih kredensial akses yang sesuai untuk aplikasi Anda.

Di Apps Script, panduan memulai cepat Google Workspace menggunakan Layanan Google lanjutan untuk memanggil Google Workspace API dan menangani beberapa detail alur autentikasi dan otorisasi.

Tujuan

  • Mengonfigurasi lingkungan.
  • Membuat dan mengonfigurasi skrip.
  • Menjalankan skrip.

Prasyarat

  • Domain Google Workspace dengan akses API diaktifkan.
  • Akun Google di domain tersebut dengan hak istimewa administrator.

  • Akses ke Google Drive

Membuat skrip

  1. Buat skrip baru di editor skrip Apps Script dengan membuka script.google.com/create.
  2. Ganti konten editor skrip dengan kode berikut:

adminSDK/directory/quickstart.gs
/**
 * Lists users in a Google Workspace domain.
 * @see https://developers.google.com/admin-sdk/directory/reference/rest/v1/users/list
 */
function listUsers() {
  const optionalArgs = {
    customer: "my_customer",
    maxResults: 10,
    orderBy: "email",
  };
  if (!AdminDirectory || !AdminDirectory.Users) {
    throw new Error("Enable the AdminDirectory Advanced Service.");
  }
  const response = AdminDirectory.Users.list(optionalArgs);
  const users = response.users;
  if (!users || users.length === 0) {
    console.log("No users found.");
    return;
  }
  // Print the list of user's full name and email
  console.log("Users:");
  for (const user of users) {
    if (user.primaryEmail) {
      if (user.name?.fullName) {
        console.log("%s (%s)", user.primaryEmail, user.name.fullName);
      } else {
        console.log("%s", user.primaryEmail);
      }
    }
  }
}

  1. Klik Simpan .
  2. Klik Project tanpa judul, ketik Quickstart, lalu klik Ganti nama.

Mengonfigurasi skrip

Mengaktifkan Directory API

Buka project Apps Script.

  1. Klik Editor .
  2. Di samping Layanan, klik Tambahkan layanan .
  3. Pilih Admin Directory API , lalu klik Tambahkan.

Menjalankan contoh

Di editor Apps Script, klik Jalankan.

Saat pertama kali dijalankan, contoh aplikasi meminta Anda untuk mengotorisasi akses:

  1. Klik Tinjau izin.
  2. Pilih akun.
  3. Klik Izinkan.

Log eksekusi skrip akan muncul di bagian bawah jendela.

Langkah berikutnya