Nếu tạo giao diện người dùng cho một tập lệnh, bạn có thể phát hành tập lệnh đó dưới dạng ứng dụng web. Ví dụ: tập lệnh cho phép người dùng lên lịch cuộc hẹn với các thành viên của nhóm hỗ trợ nên được trình bày dưới dạng một ứng dụng web để người dùng có thể truy cập tập lệnh đó trực tiếp từ trình duyệt của họ.
Cả tập lệnh độc lập và tập lệnh liên kết với Google Workspace ứng dụng đều có thể được chuyển thành ứng dụng web, miễn là các tập lệnh đó đáp ứng các yêu cầu bên dưới.
Yêu cầu đối với ứng dụng web
Tập lệnh có thể được xuất bản dưới dạng ứng dụng web nếu tập lệnh đó đáp ứng các yêu cầu sau:
- Tệp này chứa hàm
doGet(e)
hoặcdoPost(e)
. - Hàm này trả về một đối tượng Dịch vụ HTML
HtmlOutput
hoặc một đối tượng Dịch vụ nội dungTextOutput
.
Thông số yêu cầu
Khi người dùng truy cập vào một ứng dụng hoặc một chương trình gửi cho ứng dụng một yêu cầu HTTP GET
, Apps Script sẽ chạy hàm doGet(e)
. Khi một chương trình gửi cho ứng dụng yêu cầu HTTP POST
, Apps Script sẽ chạy doPost(e)
. Trong cả hai trường hợp, đối số e
biểu thị một thông số sự kiện có thể chứa thông tin về
bất kỳ thông số yêu cầu nào. Cấu trúc của đối tượng sự kiện được hiển thị trong bảng dưới đây:
Các trường | |
---|---|
e.queryString |
Giá trị của phần chuỗi truy vấn trong URL hoặc name=alice&n=1&n=2 |
e.parameter |
Một đối tượng của các cặp khoá/giá trị tương ứng với các tham số yêu cầu. Chỉ giá trị đầu tiên được trả về đối với các thông số có nhiều giá trị. {"name": "alice", "n": "1"} |
e.parameters |
Một đối tượng tương tự như {"name": ["alice"], "n": ["1", "2"]} |
e.pathInfo |
Đường dẫn URL sau |
e.contextPath |
Không được sử dụng, luôn là chuỗi trống. |
e.contentLength |
Độ dài của nội dung yêu cầu cho các yêu cầu POST hoặc 332 |
e.postData.length |
Giống như 332 |
e.postData.type |
Loại MIME của nội dung POST text/csv |
e.postData.contents |
Văn bản nội dung của phần nội dung POST Alice,21 |
e.postData.name |
Luôn là giá trị "postData" postData |
Ví dụ: bạn có thể chuyển các tham số như username
và age
đến một URL như sau:
https://script.google.com/.../exec?username=jsmith&age=21
Sau đó, bạn có thể hiển thị các tham số như sau:
function doGet(e) {
var params = JSON.stringify(e);
return ContentService.createTextOutput(params).setMimeType(ContentService.MimeType.JSON);
}
Trong ví dụ trên, doGet(e)
trả về kết quả sau:
{
"queryString": "username=jsmith&age=21",
"parameter": {
"username": "jsmith",
"age": "21"
},
"contextPath": "",
"parameters": {
"username": [
"jsmith"
],
"age": [
"21"
]
},
"contentLength": -1
}
Triển khai tập lệnh dưới dạng ứng dụng web
Để triển khai tập lệnh dưới dạng một ứng dụng web, hãy làm theo các bước sau:
- Ở trên cùng bên phải của dự án tập lệnh, hãy nhấp vào Triển khai > Triển khai mới.
- Bên cạnh phần "Chọn loại", hãy nhấp vào Bật các loại triển khai > Ứng dụng web.
- Nhập thông tin về ứng dụng web của bạn vào các trường trong phần "Cấu hình triển khai".
- Nhấp vào Triển khai.
Bạn có thể chia sẻ URL ứng dụng web với những người mà bạn muốn sử dụng ứng dụng của mình, miễn là bạn đã cấp cho họ quyền truy cập.
Kiểm thử quá trình triển khai ứng dụng web
Để kiểm tra tập lệnh của bạn dưới dạng một ứng dụng web, hãy thực hiện theo các bước bên dưới:
- Ở trên cùng bên phải của dự án tập lệnh, hãy nhấp vào Deploy > Test Implementation (Triển khai > Kiểm thử sự triển khai).
- Bên cạnh phần "Chọn loại", hãy nhấp vào Bật các loại triển khai > Ứng dụng web.
- Trong URL của ứng dụng web, hãy nhấp vào Sao chép.
Dán URL vào trình duyệt rồi kiểm tra ứng dụng web.
URL này kết thúc bằng
/dev
và chỉ những người dùng có quyền chỉnh sửa tập lệnh mới có thể truy cập. Thực thể này của ứng dụng luôn chạy mã được lưu gần đây nhất và chỉ nhằm mục đích kiểm thử trong quá trình phát triển.
Quyền
Các quyền cho một ứng dụng web sẽ khác nhau tuỳ thuộc vào cách bạn chọn thực thi ứng dụng đó:
- Thực thi ứng dụng với tư cách là tôi – Trong trường hợp này, tập lệnh sẽ luôn thực thi với tư cách là chủ sở hữu tập lệnh, bất kể ai truy cập vào ứng dụng web.
- Thực thi ứng dụng khi người dùng truy cập vào ứng dụng web – Trong trường hợp này, tập lệnh sẽ chạy theo danh tính của người dùng đang hoạt động đang sử dụng ứng dụng web. Phương pháp cấp quyền này khiến ứng dụng web hiển thị email của chủ sở hữu tập lệnh khi người dùng cho phép quyền truy cập.
Nhúng ứng dụng web trong Google Sites
Để nhúng một ứng dụng web vào Google Sites, trước tiên, bạn phải triển khai ứng dụng đó. Bạn cũng cần
URL đã triển khai từ hộp thoại Deploy
.
Để nhúng một ứng dụng web vào trang Sites, hãy làm theo các bước sau:
- Mở trang Sites mà bạn muốn thêm ứng dụng web.
- Chọn Chèn > Nhúng URL.
- Dán URL của ứng dụng web rồi nhấp vào THÊM.
Ứng dụng web xuất hiện trong một khung ở bản xem trước trang. Khi bạn xuất bản trang, người xem trang web của bạn có thể cần phải cho phép ứng dụng web trước khi ứng dụng thực thi bình thường. Các ứng dụng web trái phép sẽ hiển thị lời nhắc uỷ quyền cho người dùng.
Nhật ký duyệt web và ứng dụng web
Bạn nên tạo một ứng dụng web Apps Script mô phỏng một ứng dụng nhiều trang hoặc một ứng dụng có giao diện người dùng động được kiểm soát thông qua các tham số URL. Để làm tốt việc này, bạn có thể xác định một đối tượng trạng thái để đại diện cho giao diện người dùng hoặc trang của ứng dụng, đồng thời đẩy trạng thái đó vào nhật ký duyệt web khi người dùng thao tác trong ứng dụng. Bạn cũng có thể theo dõi các sự kiện trong nhật ký để ứng dụng web hiển thị đúng giao diện người dùng khi người dùng di chuyển qua lại bằng các nút trình duyệt. Bằng cách truy vấn các tham số URL tại thời điểm tải, bạn có thể để ứng dụng của mình tự động tạo giao diện người dùng dựa trên các tham số đó, cho phép người dùng khởi động ứng dụng ở một trạng thái cụ thể.
Apps Script cung cấp 2 API JavaScript phía máy khách không đồng bộ để hỗ trợ tạo ứng dụng web được liên kết với nhật ký duyệt web:
google.script.history
cung cấp các phương thức cho phép phản hồi động đối với các thay đổi về nhật ký duyệt web. Điều này bao gồm: đẩy trạng thái (Đối tượng đơn giản mà bạn có thể xác định) vào nhật ký duyệt web, thay thế trạng thái trên cùng trong ngăn xếp nhật ký và thiết lập hàm gọi lại trình nghe để phản hồi các thay đổi về nhật ký.google.script.url
cung cấp phương thức để truy xuất tham số URL và mảnh URL của trang hiện tại, nếu có.
Các API lịch sử này chỉ dành cho ứng dụng web. Chúng không được hỗ trợ cho thanh bên, hộp thoại hoặc tiện ích bổ sung. Bạn cũng không nên dùng chức năng này trong các ứng dụng web được nhúng trong Google Sites.