Di chuyển sang Chế độ hộp cát IFRAME

Google Apps Script sử dụng hộp cát bảo mật để cung cấp khả năng cách ly bảo vệ cho các ứng dụng Google Workspace trong một số trường hợp. Tất cả các chế độ hộp cát hiện đều không còn được dùng nữa, ngoại trừ IFRAME. Các ứng dụng sử dụng chế độ hộp cát cũ hiện tự động sử dụng chế độ IFRAME mới hơn.

Các ứng dụng trước đây sử dụng các chế độ cũ này với Dịch vụ HTML có thể cần thực hiện các thay đổi cho chế độ IFRAME để giải quyết những điểm khác biệt sau:

  • Giờ đây, bạn phải ghi đè thuộc tính target của đường liên kết bằng cách sử dụng target="_top" hoặc target="_blank"
  • Các tệp HTML do Dịch vụ HTML phân phát phải bao gồm thẻ <!DOCTYPE html>, <html> và <body>
  • Thư viện trình tải gapi (api.js) không tự động tải ở chế độ IFRAME
  • Người dùng bộ chọn cần gọi setOrigin vì nội dung được phân phát từ một miền mới
  • Một số trình duyệt cũ, bao gồm cả IE9, không được hỗ trợ
  • Giờ đây, các tài nguyên đã nhập phải sử dụng HTTPS
  • Theo mặc định, việc gửi biểu mẫu không còn bị ngăn chặn nữa

Những điểm khác biệt này được trình bày chi tiết trong các phần sau.

Ở chế độ IFRAME, bạn cần đặt thuộc tính mục tiêu liên kết thành _top hoặc _blank:

Code.js

function doGet() {
  var template = HtmlService.createTemplateFromFile('top');
  return template.evaluate();
}

top.html

<!DOCTYPE html>
<html>
 <body>
   <div>
     <a href="http://google.com" target="_top">Click Me!</a>
   </div>
 </body>
</html>

Bạn cũng có thể ghi đè thuộc tính này bằng thẻ <base> trong phần đầu của trang web bao quanh:

<!DOCTYPE html>
<html>
  <head>
    <base target="_top">
  </head>
  <body>
   <div>
     <a href="http://google.com">Click Me!</a>
   </div>
 </body>
</html>

Thẻ HTML cấp cao nhất

Ở chế độ hộp cát NATIVE (và EMULATED), một số thẻ HTML sẽ tự động được thêm vào tệp .html của Apps Script, nhưng điều này không xảy ra khi sử dụng chế độ IFRAME.

Để đảm bảo các trang dự án của bạn được phân phát đúng cách bằng IFRAME, hãy gói nội dung trang trong các thẻ cấp cao nhất sau:

<!DOCTYPE html>
<html>
  <body>
    <!-- Add your HTML content here -->
  </body>
</html>

Phải tải rõ ràng thư viện trình tải gapi

Các tập lệnh dựa vào việc tự động tải thư viện trình tải gapi (