Nếu bạn tạo giao diện người dùng cho tập lệnh, bạn có thể xuất bản 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ợ tốt nhất nên được trình bày dưới dạng ứng dụng web để người dùng có thể truy cập 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 các ứng dụng Google Workspace đều có thể được chuyển thành ứng dụng web, miễn là chúng đá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 đáp ứng các yêu cầu này
- Nó chứa hàm
{"name": "alice", "n": "1"}
1 hoặc{"name": "alice", "n": "1"}
2 - Hàm trả về một đối tượng dịch vụ HTML
{"name": "alice", "n": "1"}
3 hoặc một đối tượng Dịch vụ nội dung{"name": "alice", "n": "1"}
4
Yêu cầu thông số
Khi người dùng truy cập 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
{"name": "alice", "n": "1"}5, Apps Script sẽ chạy chức năng
{"name": "alice", "n": "1"}1. Khi một chương trình gửi cho ứng dụng một yêu cầu HTTP
{"name": "alice", "n": "1"}7, Apps Script sẽ chạy
{"name": "alice", "n": "1"}2 để thay thế. Trong cả hai trường hợp, đối số
{"name": "alice", "n": "1"}9 đại diện cho một tham số sự kiện có thể chứa thông tin về bất kỳ tham 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 bên dướiTrường
{"name": ["alice"], "n": ["1", "2"]}0
Giá trị của phần chuỗi truy vấn của URL hoặc
{"name": ["alice"], "n": ["1", "2"]}1 nếu không có chuỗi truy vấn nào được chỉ định
{"name": "alice", "n": "1"}1
{"name": ["alice"], "n": ["1", "2"]}2
Một đối tượng của các cặp khóa/giá trị tương ứng với các tham số yêu cầu. Chỉ giá trị đầu tiên được trả về cho các tham số có nhiều giá trị
{"name": "alice", "n": "1"}
{"name": ["alice"], "n": ["1", "2"]}3
Một đối tượng tương tự như
{"name": ["alice"], "n": ["1", "2"]}2, nhưng với một mảng giá trị cho mỗi khóa
{"name": ["alice"], "n": ["1", "2"]}
{"name": ["alice"], "n": ["1", "2"]}5
Đường dẫn URL sau
{"name": ["alice"], "n": ["1", "2"]}6 hoặc
{"name": ["alice"], "n": ["1", "2"]}7. Ví dụ: nếu đường dẫn URL kết thúc bằng
{"name": ["alice"], "n": ["1", "2"]}8 thì thông tin đường dẫn là
{"name": ["alice"], "n": ["1", "2"]}9
{"name": "alice", "n": "1"}20 Không được sử dụng, luôn là chuỗi rỗng.
{"name": "alice", "n": "1"}21
Độ dài của nội dung yêu cầu đối với yêu cầu POST hoặc
{"name": "alice", "n": "1"}22 đối với yêu cầu GET
{"name": "alice", "n": "1"}2
{"name": "alice", "n": "1"}23
Giống như
{"name": "alice", "n": "1"}21
{"name": "alice", "n": "1"}2
{"name": "alice", "n": "1"}25
Loại MIME của nội dung POST
{"name": "alice", "n": "1"}0
{"name": "alice", "n": "1"}26
Văn bản nội dung của nội dung POST
{"name": "alice", "n": "1"}2
{"name": "alice", "n": "1"}27
Luôn là giá trị "postData"
{"name": "alice", "n": "1"}4
Chẳng hạn, bạn có thể chuyển các tham số như
{"name": "alice", "n": "1"}28 và
{"name": "alice", "n": "1"}29 tới một URL như hình bên dưới
{"name": "alice", "n": "1"}7
Sau đó, bạn có thể hiển thị các thông số như vậy
{"name": "alice", "n": "1"}8
Trong ví dụ trên,
{"name": "alice", "n": "1"}1 trả về đầu ra sau
{"name": "alice", "n": "1"}0Cảnh báo. Các tên tham số sau được hệ thống dành riêng và không được sử dụng trong các tham số URL hoặc nội dung POST
{"name": "alice", "n": "1"}
21{"name": "alice", "n": "1"}
22
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 ứ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 "Chọn loại", nhấp vào Bật loại triển khai cài đặt > Ứng dụng web.
- Nhập thông tin về ứng dụng web của bạn vào các trường bên dưới "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 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
Ghi chú. Các ứng dụng web được triển khai trong một miền sẽ ngừng hoạt động nếu quyền sở hữu của chúng thay đổi thành một bộ nhớ dùng chung hoặc tài khoản ở một miền khác. Điều này có thể được khắc phục bằng cách yêu cầu chủ sở hữu hoặc cộng tác viên mới triển khai lại ứng dụng web trong miền mới. Ngoài ra, nếu ứng dụng web được chuyển trở lại miền ban đầu, ứng dụng web sẽ bắt đầu hoạt động lại cho miền đó mà không cần triển khai lạiKiểm tra triển khai ứng dụng web
Để kiểm tra tập lệnh của bạn dưới dạng ứng dụng web, hãy làm 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 Triển khai > Thử nghiệm triển khai
- Bên cạnh "Chọn loại", nhấp vào Bật loại triển khai cài đặt > Ứng dụng web.
- Bên dưới URL ứng dụng web, nhấp vào Sao chép
Dán URL vào trình duyệt của bạn và kiểm tra ứng dụng web của bạn
URL này kết thúc bằng
{"name": ["alice"], "n": ["1", "2"]}
7 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 được. Phiên bản 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 thử nghiệm trong quá trình phát triển
Quyền
Các quyền đối với ứng dụng web khác nhau tùy 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 luôn thực thi với tư cách là bạn, chủ sở hữu của tập lệnh, bất kể ai truy cập ứng dụng web
- Thực thi ứng dụng khi người dùng truy cập ứng dụng web—Trong trường hợp này, tập lệnh chạy dưới danh tính của người dùng đang hoạt động bằng ứng dụng web. Cách tiếp cận 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 cấp quyền truy cập
Nhúng ứng dụng web của bạn vào Google Sites
Bạn cũng có thể nhúng các ứng dụng web vào cả phiên bản cũ và mới của Google Sites
Cảnh báo. Các ứng dụng web nhúng vẫn phải có quyền truy cập để ngăn việc sử dụng có mục đích xấu. Nếu ứng dụng web nhúng của bạn dường như không hoạt động, hãy kiểm tra xem các quyền do chủ sở hữu ứng dụng web và quản trị viên miền đặt có cho phép sử dụng ứng dụng đó khôngNhúng ứng dụng web vào Trang web mới
Để nhúng một ứng dụng web, trước tiên nó phải được triển khai. Bạn cũng cần có Deployed URL từ hộp thoại
{"name": "alice", "n": "1"}24
Để nhúng ứng dụng web vào trang Trang web mới, hãy làm theo các bước sau
- Mở trang Trang web nơi bạn muốn thêm ứng dụng web
- Chọn Chèn > Nhúng URL
- Dán URL ứng dụng web rồi nhấp vào THÊM
Ứng dụng web xuất hiện trong một khung trong bản xem trước của trang. Khi bạn xuất bản trang, người xem trang web của bạn có thể cần cấp quyền cho ứng dụng web trước khi ứng dụng này hoạt động bình thường. Ứng dụng web trái phép hiển thị lời nhắc ủy quyền cho người dùng
Nhúng ứng dụng web vào Sites cổ điển
Bạn có thể liên kết tập lệnh với Trang web Google cổ điển giống như cách bạn có thể liên kết tập lệnh với Google Tài liệu hoặc Trang tính. Để tạo tập lệnh liên kết, hãy truy cập trang web của bạn, nhấp vào biểu tượng bánh răng
Bạn cũng có thể nhúng ứng dụng web của mình vào một trang. Bạn có thể liên kết ứng dụng web với Trang web hoặc bạn có thể sử dụng bất kỳ ứng dụng web nào mà bạn có URL cho. Để nhúng ứng dụng web vào trang Google Sites, hãy làm theo các bước bên dưới
- Mở một Trang hiện có mà bạn có quyền chỉnh sửa hoặc tạo một Trang mới
- Điều hướng đến trang trong Trang web của bạn nơi bạn muốn nhúng ứng dụng web
- Nhấp vào biểu tượng chỉnh sửa rồi nhấp vào Chèn > Google Apps Script
- Chọn tập lệnh từ danh sách đại diện cho ứng dụng web của bạn. Nếu ứng dụng web của bạn không bị ràng buộc với Trang web này, thay vào đó, bạn có thể dán URL ứng dụng web vào
- Nhấp vào nút Chọn, chọn các tùy chọn mong muốn từ hộp thoại tiếp theo và nhấp vào Lưu
- Lưu các thay đổi của bạn vào trang và sau đó bạn sẽ thấy ứng dụng web của mình được nhúng trong trang Trang web của bạn
Lịch sử trình duyệt và ứng dụng web
Có thể mong muốn có ứng dụng web Apps Script mô phỏng ứng dụng nhiều trang hoặc ứng dụng có giao diện người dùng động được điều khiển thông qua tham số URL. Để làm tốt điều này, bạn có thể xác định một đối tượng trạng thái để đại diện cho trang hoặc giao diện người dùng của ứng dụng và đẩy trạng thái vào lịch sử trình duyệt khi người dùng điều hướng ứng dụng của bạn. Bạn cũng có thể lắng nghe các sự kiện lịch sử để ứng dụng web của bạn hiển thị đúng giao diện người dùng khi người dùng điều hướng qua lại bằng các nút của 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ể yêu cầu ứ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 hai API JavaScript phía máy khách không đồng bộ để hỗ trợ tạo các ứng dụng web được liên kết với lịch sử trình duyệt
{"name": "alice", "n": "1"}
25 cung cấp các phương thức cho phép phản hồi động đối với những thay đổi trong lịch sử trình duyệt. Điêu nay bao gôm. đẩy các trạng thái [Đối tượng đơn giản mà bạn có thể xác định] vào lịch sử trình duyệt, thay thế trạng thái trên cùng trong ngăn xếp lịch sử và đặt chức năng gọi lại trình nghe để phản hồi các thay đổi trong lịch sử{"name": "alice", "n": "1"}
26 cung cấp phương tiện để truy xuất các tham số URL và đoạn URL của trang hiện tại, nếu chúng có mặt
Các API lịch sử này chỉ khả dụng cho các ứ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. Chức năng này cũng không được khuyến nghị sử dụng trong các ứng dụng web được nhúng trong Google Sites