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 tentang alur otentikasi dan otorisasi. Sebaiknya Anda menggunakan library klien untuk aplikasi Anda sendiri. Panduan memulai ini menggunakan pendekatan otentikasi yang disederhanakan yang sesuai untuk pengujian lingkungan fleksibel App Engine. Untuk lingkungan produksi, sebaiknya pelajari tentang autentikasi dan otorisasi sebelum memilih kredensial akses yang sesuai untuk aplikasi Anda.

Buat Skrip Google Apps yang membuat permintaan ke Google Chat API.

Tujuan

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

Prasyarat

Mengonfigurasi project Cloud

Jika menggunakan project Google Cloud baru untuk menyelesaikan panduan memulai ini, Anda harus mengkonfigurasinya dan menambahkan Anda sebagai pengguna uji coba. Jika Anda sudah menyelesaikan langkah-langkah ini untuk project Cloud Anda, 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 > API & Layanan > Layar izin OAuth.

    Buka layar izin OAuth

  2. Untuk Jenis pengguna, pilih Internal, lalu klik Buat.
  3. Lengkapi formulir pendaftaran aplikasi, lalu klik Simpan dan Lanjutkan.

  4. Untuk saat ini, Anda dapat melewati penambahan cakupan, lalu mengklik Simpan dan Lanjutkan. Pada masa mendatang, jika Anda membuat aplikasi untuk digunakan di luar organisasi Google Workspace, Anda harus mengubah Jenis pengguna menjadi Eksternal, lalu menambahkan cakupan otorisasi yang dibutuhkan aplikasi Anda.

  5. Tinjau ringkasan pendaftaran aplikasi Anda. Untuk melakukan perubahan, klik Edit. Jika aplikasi pendaftaran tampak tidak bermasalah, klik Kembali ke Dasbor.

Mengonfigurasi aplikasi Google Chat

Untuk memanggil Google Chat API, Anda harus mengonfigurasi Aplikasi Google Chat. Untuk permintaan tulis apa pun, 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 Application info, masukkan informasi berikut:

    1. Di kolom App name, 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 Interactive Features, klik Enable interaktif feature alihkan ke posisi nonaktif untuk menonaktifkan fitur interaktif bagi Aplikasi Chat.

  4. Klik Simpan.

Membuat skrip

  1. Buat skrip baru 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 Panduan memulai, lalu klik Ganti nama.

Mengonfigurasi skrip

Salin nomor project Cloud

  1. Di konsol Google Cloud, buka Menu > IAM & Admin > Setelan.

    Buka IAM & Setelan Admin

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

Mengaktifkan Google Chat API

  1. Buka project Apps Script.
  1. Klik Project Settings .
  2. Di bagian Setelan umum, aktifkan Tampilkan "appsscript.json" file manifes di editor.
  3. Klik Editor , pilih file appscript.json, dan ganti konten 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 menjalankan contoh, Anda akan diminta untuk mengizinkan akses:

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

Log eksekusi skrip akan muncul di bagian bawah jendela.

Langkah berikutnya