Panduan memulai Google Apps Script

Buat Google Apps Script yang membuat permintaan ke People API.

Panduan memulai menjelaskan cara menyiapkan dan menjalankan aplikasi yang memanggil Google Workspace API. 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.

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

Tujuan

  • Konfigurasi lingkungan.
  • Buat dan konfigurasikan skrip.
  • Jalankan 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 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 Ganti nama.

Mengonfigurasi skrip

Mengaktifkan People API

Buka project Apps Script.

  1. Klik Editor .
  2. Di samping Layanan, klik Tambahkan layanan .
  3. Pilih People API dan 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