Panduan memulai Google Apps Script

Buat Google Apps Script yang membuat permintaan ke Google Chat 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

Mengonfigurasi project Cloud Anda

Jika menggunakan project Google Cloud baru untuk menyelesaikan panduan memulai ini, Anda harus mengonfigurasinya dan menambahkan diri Anda sebagai pengguna pengujian. Jika Anda telah menyelesaikan langkah-langkah ini untuk project Cloud, lanjutkan ke bagian berikutnya.

Buka project Cloud Anda di konsol Google Cloud

Jika belum terbuka, buka project Cloud yang ingin Anda gunakan untuk contoh ini:

  1. Di konsol Google Cloud, buka halaman Select a project.

    Pilih project Cloud

  2. Pilih project Google Cloud yang ingin Anda gunakan. Atau, klik Buat project dan ikuti petunjuk di layar. Jika membuat project Google Cloud, Anda mungkin perlu mengaktifkan penagihan untuk project tersebut.

Mengaktifkan Chat API

Sebelum menggunakan Google API, Anda harus mengaktifkannya di project Google Cloud. Anda dapat mengaktifkan satu atau beberapa API dalam satu project Google Cloud.
  1. Di Konsol Google Cloud, buka Menu > Google Auth platform > Branding.

    Buka Branding

  2. Jika sudah mengonfigurasi Google Auth platform, Anda dapat mengonfigurasi setelan Layar Izin OAuth berikut di Branding, Audiens, dan Akses Data. Jika Anda melihat pesan yang menyatakan Google Auth platform belum dikonfigurasi, klik Mulai:
    1. Di bagian Informasi Aplikasi, di Nama aplikasi, masukkan nama untuk aplikasi.
    2. Di Email dukungan pengguna, pilih alamat email dukungan yang dapat dihubungi pengguna jika mereka memiliki pertanyaan tentang izin mereka.
    3. Klik Berikutnya.
    4. Di bagian Audiens, pilih Internal.
    5. Klik Berikutnya.
    6. Di bagian Informasi Kontak, masukkan Alamat email tempat Anda dapat menerima notifikasi tentang perubahan apa pun pada project Anda.
    7. Klik Berikutnya.
    8. Di bagian Selesai, tinjau Kebijakan Data Pengguna Layanan Google API dan jika Anda setuju, pilih Saya setuju dengan Google API Services: User Data Policy.
    9. Klik Lanjutkan.
    10. Klik Buat.
  3. Untuk saat ini, Anda dapat melewati penambahan cakupan. Pada masa mendatang, saat Anda membuat aplikasi untuk digunakan di luar organisasi Google Workspace, Anda harus mengubah Jenis pengguna menjadi Eksternal. Kemudian tambahkan cakupan otorisasi yang diperlukan aplikasi Anda. Untuk mempelajari lebih lanjut, lihat panduan Mengonfigurasi izin OAuth selengkapnya.

Mengonfigurasi aplikasi Google Chat

Untuk memanggil Google Chat API, Anda harus mengonfigurasi aplikasi Google Chat. Untuk setiap permintaan tulis, Google Chat mengatribusikan aplikasi Google Chat di UI menggunakan informasi berikut.

  1. Di konsol Google Cloud, buka halaman Configuration Chat API:

    Buka halaman Konfigurasi Chat API

  2. Di bagian Info aplikasi, masukkan informasi berikut:

    1. Di kolom Nama aplikasi, masukkan Chat API quickstart app.
    2. Di kolom Avatar URL, masukkan https://developers.google.com/chat/images/quickstart-app-avatar.png.
    3. Di kolom Description, masukkan Quickstart for calling the Chat API.

  3. Di bagian Fitur interaktif, klik tombol Aktifkan fitur interaktif ke posisi nonaktif untuk menonaktifkan fitur interaktif untuk aplikasi Chat.

  4. Klik Simpan.

Buat skrip

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

chat/quickstart/Code.gs
/**
 * This quickstart sample shows how to list spaces with user credential
 *
 * It relies on the OAuth2 scope 'https://www.googleapis.com/auth/chat.spaces.readonly'
 * referenced in the manifest file (appsscript.json).
 */
function listSpaces() {
  // Initialize request argument(s)
  // Filter spaces by space type (SPACE or GROUP_CHAT or DIRECT_MESSAGE)
  const filter = 'space_type = "SPACE"';

  // Iterate through the response pages using page tokens
  let responsePage;
  let pageToken = null;
  do {
    // Request response pages
    responsePage = Chat.Spaces.list({
      filter: filter,
      pageToken: pageToken
    });
    // Handle response pages
    if (responsePage.spaces) {
      responsePage.spaces.forEach((space) => console.log(space));
    }
    // Update the page token to the next one
    pageToken = responsePage.nextPageToken;
  } while (pageToken);
}

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

Mengonfigurasi skrip

Menyalin nomor project Cloud

  1. Di Konsol Google Cloud, buka Menu > IAM & Admin > Settings.

    Buka Setelan IAM & Admin

  2. Di kolom Project number, salin nilai.
  1. Buka project Apps Script.
  2. Klik Setelan Project .
  3. Pada Google Cloud Platform (GCP) Project, klik Change project.
  4. Di GCP project number, tempelkan nomor project Google Cloud.
  5. Klik Set project.

Mengaktifkan Google Chat API

Buka project Apps Script.

  1. Klik Setelan Project .
  2. Di bagian Setelan umum, aktifkan Tampilkan file manifes "appsscript.json" di editor.
  3. Klik Editor , pilih file appscript.json, dan ganti kontennya dengan kode berikut:

chat/quickstart/appsscript.json
{
  "timeZone": "America/New_York",
  "exceptionLogging": "STACKDRIVER",
  "runtimeVersion": "V8",
  "oauthScopes": [
    "https://www.googleapis.com/auth/chat.spaces.readonly"
  ],
  "chat": {},
  "dependencies": {
    "enabledAdvancedServices": [{
      "userSymbol": "Chat",
      "version": "v1",
      "serviceId": "chat"
    }]
  }
}

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