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 yang disederhanakan 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, panduan memulai Google Workspace menggunakan Layanan Google lanjutan untuk memanggil Google Workspace API dan menangani beberapa detail autentikasi dan alur 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 Apps Script 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 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