Mengeksekusi Fungsi Apps Script

Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Apps Script API (dan sebelumnya Apps Script Execution API) memungkinkan Anda untuk menjalankan fungsi dari jarak jauh dalam project skrip yang aksesnya Anda miliki. Aplikasi Anda dapat memanggil fungsi Apps Script tertentu, memberinya parameter input jika diperlukan, dan menerima respons yang ditampilkan.

Contoh di halaman ini akan mengilustrasikan bagaimana beberapa operasi eksekusi umum dapat dilakukan dengan API. Untuk informasi selengkapnya termasuk persyaratan otorisasi khusus, lihat panduan Mengeksekusi fungsi.

Dalam contoh ini, placeholder scriptId digunakan untuk menunjukkan tempat Anda akan memberikan project ID skrip. Ikuti langkah-langkah di bawah ini untuk menemukan ID skrip:

  1. Di project Apps Script, di kiri atas, klik Setelan Project .
  2. Di samping "ID Skrip," klik Salin.

Jalankan fungsi

Permintaan scripts.run berikut memanggil fungsi Apps Script bernama listFolderContent, meneruskan folderId Drive dan bilangan bulat MAX_SIZE sebagai argumen. Fungsi ini dijalankan dalam mode pengembangan. Artinya, versi fungsi yang paling baru disimpan akan dijalankan, terlepas dari versi yang di-deploy sebagai file yang dapat dieksekusi.

Protokol permintaan ditampilkan di bawah ini. Panduan Menjalankan fungsi menunjukkan cara menerapkan permintaan eksekusi dalam bahasa yang berbeda menggunakan library klien Google API.

POST https://script.googleapis.com/v1/scripts/scriptId:run
{
  "function": "listFolderContent",
  "parameters": [
    folderId,
    MAX_SIZE
  ],
  "devMode": true
}

Respons terhadap permintaan ini, setelah fungsi Apps Script yang dipanggil selesai, berisi hasil eksekusi atau respons error. Dalam contoh ini, fungsi berhasil menampilkan array nama file:

{
  "response": {
    "result": [
      "fileTitle1",
      "fileTitle2",
      "fileTitle3"
    ]
  },
}

Jika fungsi mengalami error selama eksekusi Apps Script, responsnya akan terlihat seperti ini:

{
  "response": {
    "error": {
      "code": 3,
      "message": "ScriptError",
      "details": [{
        "@type": "type.googleapis.com/google.apps.script.v1.ExecutionError",
        "errorMessage": "The script enountered an exeception it could not resolve.",
        "errorType": "ScriptError",
        "scriptStackTraceElements": [{
          "function": "listFolderContent",
          "lineNumber": 14
        }]
      }]
    }
  }
}