Menjalankan fungsi Google Apps Script

Google Apps Script API memungkinkan Anda menjalankan fungsi dari jarak jauh dalam project skrip yang dapat Anda akses. Aplikasi Anda dapat memanggil fungsi Apps Script tertentu, memberikan parameter input jika diperlukan, dan menerima respons.

Contoh di halaman ini menggambarkan cara operasi eksekusi umum dapat dicapai dengan API. Untuk mengetahui informasi selengkapnya, termasuk persyaratan otorisasi khusus, lihat panduan Mengeksekusi fungsi.

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

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

Jalankan fungsi

Permintaan scripts.run berikut memanggil fungsi Apps Script bernama listFolderContent, dengan meneruskan folderId Google Drive dan bilangan bulat MAX_SIZE sebagai argumen. Fungsi dijalankan dalam mode pengembangan, yang berarti bahwa versi fungsi yang terakhir disimpan akan dijalankan, terlepas dari versi yang di-deploy sebagai yang dapat dieksekusi.

Protokol permintaan ditampilkan di bawah. Panduan Menjalankan fungsi menunjukkan cara menerapkan permintaan eksekusi dalam berbagai bahasa 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 dapat 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
        }]
      }]
    }
  }
}