Class PropertiesService

Dịch vụTài sản

Cho phép tập lệnh lưu trữ dữ liệu đơn giản theo cặp khoá-giá trị trong phạm vi một tập lệnh, một người dùng tập lệnh hoặc một tài liệu mà tiện ích bổ sung được dùng. Bạn không thể chia sẻ các thuộc tính giữa các tập lệnh. Để biết thêm thông tin về thời điểm sử dụng từng loại thuộc tính, hãy xem hướng dẫn về dịch vụ Thuộc tính.

// Sets three properties of different types.
const documentProperties = PropertiesService.getDocumentProperties();
const scriptProperties = PropertiesService.getScriptProperties();
const userProperties = PropertiesService.getUserProperties();

documentProperties.setProperty('DAYS_TO_FETCH', '5');
scriptProperties.setProperty(
    'SERVER_URL',
    'http://www.example.com/MyWeatherService/',
);
userProperties.setProperty('DISPLAY_UNITS', 'metric');

Phương thức

Phương thứcKiểu dữ liệu trả vềMô tả ngắn
getDocumentProperties()PropertiesLấy một kho lưu trữ thuộc tính (chỉ dành cho tập lệnh này) mà tất cả người dùng có thể truy cập trong tài liệu, bảng tính hoặc biểu mẫu đang mở.
getScriptProperties()PropertiesLấy một kho lưu trữ thuộc tính mà tất cả người dùng đều có thể truy cập, nhưng chỉ trong tập lệnh này.
getUserProperties()PropertiesLấy một kho lưu trữ thuộc tính mà chỉ người dùng hiện tại hoặc người dùng có hiệu lực mới có thể truy cập và chỉ trong tập lệnh này.

Tài liệu chi tiết

getDocumentProperties()

Lấy một kho lưu trữ thuộc tính (chỉ dành cho tập lệnh này) mà tất cả người dùng có thể truy cập trong tài liệu, bảng tính hoặc biểu mẫu đang mở. Bạn chỉ có thể sử dụng tính năng này nếu tập lệnh được xuất bản và thực thi dưới dạng một tiện ích bổ sung hoặc nếu tập lệnh đó được liên kết với một loại tệp Google. Khi không có sẵn các thuộc tính của tài liệu, phương thức này sẽ trả về null. Các thuộc tính của tài liệu do một tập lệnh tạo sẽ không thể truy cập được bên ngoài tập lệnh đó, ngay cả khi các tập lệnh khác truy cập vào cùng một tài liệu.

Cầu thủ trả bóng

Properties – Chỉ có kho lưu trữ tài sản cho tập lệnh này mà tất cả người dùng của tài liệu hiện tại đều có thể truy cập, hoặc null nếu tập lệnh không phải là một tiện ích bổ sung hoặc được liên kết với một tệp Google Workspace.


getScriptProperties()

Lấy một kho lưu trữ thuộc tính mà tất cả người dùng đều có thể truy cập, nhưng chỉ trong tập lệnh này.

Cầu thủ trả bóng

Properties – Một kho thuộc tính mà tất cả người dùng tập lệnh đều có thể truy cập.


getUserProperties()

Lấy một kho lưu trữ thuộc tính mà chỉ người dùng hiện tại hoặc người dùng có hiệu lực mới có thể truy cập và chỉ trong tập lệnh này.

Cầu thủ trả bóng

Properties – Một kho lưu trữ thuộc tính mà chỉ người dùng hiện tại hoặc người dùng có hiệu lực của tập lệnh mới có thể truy cập.