Nhúng html vào gmail

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ưới

Trườ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
Using these parameters may result in an HTTP 405 response with the error message "Sorry, the file you have requested does not exist." If possible, update your script to use different parameter names.

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

  1. Ở 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
  2. 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.
  3. 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. "
  4. 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ại

Kiể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

  1. Ở 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
  2. 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.
  3. Bên dưới URL ứng dụng web, nhấp vào Sao chép
  4. 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

Cảnh báo. Khi triển khai ứng dụng web để chạy với tư cách là nhà phát triển, bạn nên hết sức cẩn thận khi xử lý mã thông báo OAuth có được thông qua ScriptApp. getOAuthToken[]. Các mã thông báo này có thể cấp cho các ứng dụng khác quyền truy cập vào dữ liệu của bạn — không bao giờ truyền chúng tới ứng dụng khách

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
Cảnh báo. Để ngăn chặn lạm dụng, Apps Script áp đặt các giới hạn đối với tốc độ mà người dùng mới có thể ủy quyền cho một ứng dụng web thực thi với tư cách là người dùng. Ngoài các yếu tố khác, các giới hạn này phụ thuộc vào việc tài khoản xuất bản có thuộc miền Google Workspace hay không. Ghi chú. Bạn có thể cộng tác trên các ứng dụng web bằng bộ nhớ dùng chung. Khi một ứng dụng web trong một chia sẻ được triển khai, việc chọn "thực thi với tư cách là bạn" sẽ khiến ứng dụng web thực thi dưới quyền của người dùng đã triển khai ứng dụng đó [vì không có chủ sở hữu tập lệnh]

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ông

Nhú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

  1. Mở trang Trang web nơi bạn muốn thêm ứng dụng web
  2. Chọn Chèn > Nhúng URL
  3. 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

, sau đó chọn Quản lý trang web. Trên trang Quản lý trang web, nhấp vào Tập lệnh ứng dụng ở điều hướng bên trái, sau đó nhấp vào nút Thêm tập lệnh mới. Thao tác này sẽ mở một tập lệnh mới trong trình chỉnh sửa Apps Script, nơi bạn có thể viết mã và triển khai ứng dụng web của mình.

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

  1. 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
  2. Đ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
  3. Nhấp vào biểu tượng chỉnh sửa rồi nhấp vào Chèn > Google Apps Script
  4. 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
  5. 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
  6. 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

Chủ Đề