Panduan memulai Google Apps Script

Panduan memulai menjelaskan cara menyiapkan dan menjalankan aplikasi yang memanggil Google Workspace API.

Panduan memulai Google Workspace menggunakan library klien API untuk menangani beberapa detail alur autentikasi dan otorisasi. Sebaiknya gunakan library klien untuk aplikasi Anda sendiri. Panduan memulai ini menggunakan pendekatan autentikasi sederhana yang sesuai untuk lingkungan pengujian. Untuk lingkungan produksi, sebaiknya pelajari autentikasi dan otorisasi sebelum memilih kredensial akses yang sesuai untuk aplikasi Anda.

Buat Google Apps Script yang membuat permintaan ke People API.

Tujuan

  • Buat skrip.
  • Mengaktifkan People API.
  • Jalankan contoh.

Prasyarat

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

  • Akses ke Google Drive

Membuat skrip

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

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. Klik Simpan .
  2. Klik Project tanpa judul, ketik Quickstart, lalu klik Rename.

Mengaktifkan People API

  1. Buka project Apps Script.
  2. Klik Editor .
  3. Di samping Layanan, klik Tambahkan layanan .
  4. Pilih People API, lalu klik Add.

Menjalankan contoh

Di editor Apps Script, klik Run.

Saat pertama kali menjalankan contoh, Anda akan diminta untuk memberikan otorisasi akses:

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

Log eksekusi skrip akan muncul di bagian bawah jendela.

Langkah berikutnya