Aplikasi Web

Jika membuat antarmuka pengguna untuk skrip, Anda dapat memublikasikan skrip sebagai aplikasi web. Misalnya, skrip yang memungkinkan pengguna menjadwalkan janji temu dengan anggota tim dukungan sebaiknya ditampilkan sebagai aplikasi web sehingga pengguna dapat mengaksesnya langsung dari browser mereka.

Baik skrip mandiri dan skrip yang terikat ke Google Workspace aplikasi dapat diubah menjadi aplikasi web, selama memenuhi persyaratan di bawah ini.

Persyaratan untuk aplikasi web

Skrip dapat dipublikasikan sebagai aplikasi web jika memenuhi persyaratan berikut:

Parameter permintaan

Saat pengguna membuka aplikasi atau program, aplikasi atau program mengirimkan permintaan GET HTTP, Apps Script akan menjalankan fungsi doGet(e). Saat program mengirim permintaan POST HTTP ke aplikasi, Apps Script akan menjalankan doPost(e). Dalam kedua kasus tersebut, argumen e mewakili parameter peristiwa yang dapat berisi informasi tentang parameter permintaan apa pun. Struktur objek peristiwa ditunjukkan dalam tabel di bawah:

Kolom
e.queryString

Nilai dari bagian string kueri URL, atau null jika tidak ada string kueri yang ditentukan

name=alice&n=1&n=2
e.parameter

Objek pasangan kunci/nilai yang sesuai dengan parameter permintaan. Hanya nilai pertama yang ditampilkan untuk parameter yang memiliki beberapa nilai.

{"name": "alice", "n": "1"}
e.parameters

Objek yang mirip dengan e.parameter, tetapi dengan array nilai untuk setiap kunci

{"name": ["alice"], "n": ["1", "2"]}
e.pathInfo

Jalur URL setelah /exec atau /dev. Misalnya, jika jalur URL berakhir dengan /exec/hello, info jalurnya adalah hello.
e.contextPath Tidak digunakan, selalu string kosong.
e.contentLength

Panjang isi permintaan untuk permintaan POST, atau -1 untuk permintaan GET

332
e.postData.length

Sama seperti e.contentLength

332
e.postData.type

Jenis MIME isi POST

text/csv
e.postData.contents

Teks konten isi POST

Alice,21
e.postData.name

Selalu nilai "postData"

postData

Misalnya, Anda dapat meneruskan parameter seperti username dan age ke URL seperti yang ditunjukkan di bawah ini:

https://script.google.com/.../exec?username=jsmith&age=21

Kemudian, Anda dapat menampilkan parameter seperti berikut:

function doGet(e) {
  var params = JSON.stringify(e);
  return ContentService.createTextOutput(params).setMimeType(ContentService.MimeType.JSON);
}

Dalam contoh di atas, doGet(e) menampilkan output berikut:

{
  "queryString": "username=jsmith&age=21",
  "parameter": {
    "username": "jsmith",
    "age": "21"
  },
  "contextPath": "",
  "parameters": {
    "username": [
      "jsmith"
    ],
    "age": [
      "21"
    ]
  },
  "contentLength": -1
}

Men-deploy skrip sebagai aplikasi web

Untuk men-deploy skrip sebagai aplikasi web, ikuti langkah-langkah berikut:

  1. Di kanan atas project skrip, klik Deploy > New deployment.
  2. Di samping "Pilih jenis", klik Aktifkan jenis deployment > Aplikasi web.
  3. Masukkan informasi tentang aplikasi web Anda dalam kolom di bagian "Konfigurasi deployment".
  4. Klik Deploy.

Anda dapat membagikan URL aplikasi web kepada orang-orang yang akan menggunakan aplikasi Anda, selama Anda telah memberi mereka akses.

Menguji deployment aplikasi web

Untuk menguji skrip Anda sebagai aplikasi web, ikuti langkah-langkah di bawah:

  1. Di kanan atas project skrip, klik Deploy > Test deployment.
  2. Di samping "Pilih jenis", klik Aktifkan jenis deployment > Aplikasi web.
  3. Di bagian URL aplikasi web, klik Salin.

  4. Tempel URL di browser dan uji aplikasi web Anda.

    URL ini berakhiran /dev dan hanya dapat diakses oleh pengguna yang memiliki akses edit ke skrip. Instance aplikasi ini selalu menjalankan kode yang terakhir disimpan dan hanya ditujukan untuk pengujian selama pengembangan.

Izin

Izin untuk aplikasi web berbeda-beda bergantung pada cara Anda memilih untuk menjalankan aplikasi:

  • Jalankan aplikasi sebagai saya—Dalam hal ini, skrip selalu dijalankan sebagai Anda, sebagai pemilik skrip, siapa pun yang mengakses aplikasi web.
  • Jalankan aplikasi sebagai pengguna yang mengakses aplikasi web—Dalam hal ini, skrip berjalan dengan identitas pengguna aktif menggunakan aplikasi web. Pendekatan izin ini menyebabkan aplikasi web menampilkan email pemilik skrip ketika pengguna memberikan otorisasi akses.

Menyematkan aplikasi web Anda di Google Sites

Untuk menyematkan aplikasi web di Google Sites, aplikasi harus di-deploy terlebih dahulu. Anda juga memerlukan Deployed URL dari dialog Deploy.

Untuk menyematkan aplikasi web ke halaman Situs, ikuti langkah-langkah berikut:

  1. Buka halaman Sites tempat Anda ingin menambahkan aplikasi web.
  2. Pilih Sisipkan > URL Tersemat.
  3. Tempel URL aplikasi web, lalu klik ADD.

Aplikasi web akan muncul dalam bingkai di pratinjau halaman. Saat Anda memublikasikan halaman, pelihat situs mungkin perlu mengizinkan aplikasi web sebelum dijalankan secara normal. Aplikasi web yang tidak sah akan menampilkan perintah otorisasi kepada pengguna.

Aplikasi Web dan Histori Browser

Anda sebaiknya memiliki aplikasi web Apps Script yang menyimulasikan aplikasi multi-halaman, atau aplikasi dengan UI dinamis yang dikontrol melalui parameter URL. Untuk melakukannya dengan baik, Anda dapat menentukan objek status untuk mewakili UI atau halaman aplikasi, dan mengirim status ke histori browser saat pengguna membuka aplikasi Anda. Anda juga dapat memproses peristiwa histori sehingga aplikasi web Anda menampilkan UI yang benar saat pengguna menavigasi bolak-balik dengan tombol browser. Dengan membuat kueri parameter URL pada waktu pemuatan, Anda dapat meminta aplikasi mem-build UI-nya secara dinamis berdasarkan parameter tersebut, sehingga pengguna dapat memulai aplikasi dalam status tertentu.

Apps Script menyediakan dua API JavaScript sisi klien asinkron untuk membantu membuat aplikasi web yang ditautkan ke histori browser:

  • google.script.history menyediakan metode untuk memungkinkan respons dinamis terhadap perubahan histori browser. Hal ini mencakup: mendorong status (Objek sederhana yang dapat Anda tentukan) ke histori browser, mengganti status teratas dalam tumpukan histori, dan menetapkan fungsi callback pemroses untuk merespons perubahan histori.

  • google.script.url menyediakan cara untuk mengambil fragmen URL dan parameter URL halaman saat ini, jika ada.

API histori ini hanya tersedia untuk aplikasi web. Elemen tersebut tidak didukung untuk sidebar, dialog, atau add-on. Fungsi ini juga tidak direkomendasikan untuk digunakan di aplikasi web yang disematkan di Google Sites.