Panduan memulai Google Apps Script

Buat Google Apps Script yang membuat permintaan ke Admin SDK API.

Panduan memulai menjelaskan cara menyiapkan dan menjalankan aplikasi yang memanggil Google Workspace API. Panduan memulai 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 Google Workspace menggunakan Layanan Google lanjutan untuk memanggil Google Workspace API dan menangani beberapa detail alur autentikasi dan otorisasi.

Tujuan

  • Konfigurasi lingkungan.
  • Buat dan konfigurasi skrip.
  • Jalankan skrip.

Prasyarat

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

  • Akses ke Google Drive

Buat 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/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,
  };
  if (!AdminReports || !AdminReports.Activities) {
    throw new Error("Enable the AdminReports Advanced Service.");
  }
  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) {
    if (
      activity.id?.time &&
      activity.actor?.email &&
      activity.events?.[0]?.name
    ) {
      console.log(
        "%s: %s (%s)",
        activity.id.time,
        activity.actor.email,
        activity.events[0].name,
      );
    }
  }
}

  1. Klik Simpan .
  2. Klik Untitled project, ketik Quickstart, lalu klik Rename.

Mengonfigurasi skrip

Aktifkan Admin SDK API

Buka project Apps Script.

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

Menjalankan contoh

Di editor Apps Script, klik Run.

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