Aplikasi Web

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

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.

Skrip mandiri dan skrip yang terikat dengan 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 mengunjungi aplikasi atau program mengirimkan permintaan HTTP GET kepada aplikasi, Apps Script akan menjalankan fungsi doGet(e). Saat program mengirimkan permintaan POST HTTP kepada 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 ditampilkan dalam tabel di bawah:

Kolom
e.queryString

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

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

Objek key-value pair 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 di /exec/hello, info jalurnya adalah hello.

e.contextPath Tidak digunakan, selalu berupa string kosong.
e.contentLength

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

332
e.postData.length

Sama dengan e.contentLength

332
e.postData.type

Jenis MIME dari isi POST

text/csv
e.postData.contents

Teks konten dari 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:

function doGet(e) {
  var params = JSON.stringify(e);
  return HtmlService.createHtmlOutput(params);
}

Pada 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 > Deployment baru.
  2. Di samping "Pilih jenis," klik Aktifkan jenis deployment > Aplikasi web.
  3. Masukkan informasi tentang aplikasi web Anda di kolom pada "Konfigurasi deployment."
  4. Klik Deploy.

Anda dapat membagikan URL aplikasi web kepada orang yang ingin menggunakan aplikasi Anda, jika Anda telah memberi mereka akses.

Menguji deployment aplikasi web

Untuk menguji skrip 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. Tempelkan URL di browser dan uji aplikasi web Anda.

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

Izin

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

  • Eksekusi aplikasi sebagai saya—Dalam hal ini, skrip selalu dijalankan sebagai Anda, pemilik skrip, apa pun pengguna yang mengakses aplikasi web.
  • Menjalankan aplikasi sebagai pengguna yang mengakses aplikasi web—Dalam hal ini, skrip berjalan di bawah identitas pengguna aktif menggunakan aplikasi web. Pendekatan izin ini menyebabkan aplikasi web menampilkan email pemilik skrip saat pengguna memberi otorisasi akses.

Menyematkan aplikasi web Anda di Google Sites

Anda juga dapat menyematkan aplikasi web di Google Sites klasik dan versi baru.

Menyematkan aplikasi web di Sites baru

Untuk menyematkan aplikasi web, aplikasi tersebut harus di-deploy terlebih dahulu. Anda juga memerlukan URL yang Di-deploy dari dialog Deploy.

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

  1. Buka halaman Sites tempat Anda ingin menambahkan aplikasi web.
  2. Pilih Sisipkan > Sematkan URL.
  3. Tempelkan URL aplikasi web, lalu klik TAMBAHKAN.

Aplikasi web akan muncul dalam bingkai di pratinjau halaman. Saat Anda memublikasikan halaman, audiens situs mungkin perlu mengotorisasi aplikasi web sebelum melakukan eksekusi secara normal. Aplikasi web yang tidak diizinkan memberikan perintah otorisasi kepada pengguna.

Menyematkan aplikasi web di Sites klasik

Anda dapat mengikat skrip ke Situs Google klasik dengan cara yang sama seperti Anda mengikat skrip ke Google Dokumen atau Spreadsheet. Untuk membuat skrip terikat, buka situs Anda, klik ikon roda gigi Setelan, lalu pilih Kelola situs. Di halaman Kelola Situs, klik Skrip Aplikasi di navigasi sebelah kiri, lalu tombol Tambahkan skrip baru. Tindakan ini akan membuka skrip baru di editor Apps Script, tempat Anda dapat menulis kode dan men-deploy aplikasi web.

Anda juga dapat menyematkan aplikasi web Anda di halaman. Anda dapat mengikat aplikasi web ke Situs atau menggunakan aplikasi web yang URL-nya Anda miliki. Untuk menyematkan aplikasi web ke halaman Google Sites, ikuti langkah-langkah berikut:

  1. Buka Situs yang sudah ada dan akses editnya Anda buat, atau buat Situs baru.
  2. Buka halaman di Situs tempat Anda ingin menyematkan aplikasi web.
  3. Klik ikon edit, lalu Sisipkan > Skrip Google Apps.
  4. Pilih skrip dari daftar yang mewakili aplikasi web Anda. Jika aplikasi web Anda tidak terikat ke Situs ini, Anda dapat menempelkan URL aplikasi web.
  5. Klik tombol Select, pilih opsi yang diinginkan dari dialog berikutnya, lalu klik Save.
  6. Simpan perubahan pada halaman tersebut, lalu Anda akan melihat aplikasi web disematkan di halaman Sites Anda.

Aplikasi Web dan Histori Browser

Mungkin lebih baik jika aplikasi web Apps Script menyimulasikan aplikasi multi-halaman, atau yang memiliki 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 membuat aplikasi secara dinamis mem-build UI-nya berdasarkan parameter tersebut, sehingga memungkinkan pengguna memulai aplikasi dalam status tertentu.

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

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

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

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