Class Utilities

Phần mềm tiện ích

Dịch vụ này cung cấp các tiện ích để mã hoá/giải mã chuỗi, định dạng ngày, thao tác với JSON và các tác vụ khác.

Thuộc tính

Thuộc tính	Loại	Mô tả
Charset	Charset
DigestAlgorithm	DigestAlgorithm
MacAlgorithm	MacAlgorithm
RsaAlgorithm	RsaAlgorithm

Phương thức

Phương thức	Loại dữ liệu trả về	Mô tả ngắn
base64Decode(encoded)	Byte[]	Giải mã chuỗi được mã hoá base-64 thành mảng byte UTF-8.
base64Decode(encoded, charset)	Byte[]	Giải mã chuỗi được mã hoá base-64 thành một mảng byte trong một bộ ký tự cụ thể.
base64DecodeWebSafe(encoded)	Byte[]	Giải mã chuỗi được mã hoá base-64 an toàn cho web thành mảng byte UTF-8.
base64DecodeWebSafe(encoded, charset)	Byte[]	Giải mã chuỗi được mã hoá base-64 an toàn cho web thành một mảng byte trong một bộ ký tự cụ thể.
base64Encode(data)	String	Tạo một chuỗi được mã hoá base-64 từ mảng byte đã cho.
base64Encode(data)	String	Tạo một chuỗi được mã hoá base-64 từ chuỗi đã cho.
base64Encode(data, charset)	String	Tạo một chuỗi được mã hoá base-64 từ chuỗi đã cho trong một bộ ký tự cụ thể.
base64EncodeWebSafe(data)	String	Tạo một chuỗi được mã hoá base-64 an toàn cho web từ mảng byte đã cho.
base64EncodeWebSafe(data)	String	Tạo một chuỗi được mã hoá base-64 an toàn cho web từ chuỗi đã cho.
base64EncodeWebSafe(data, charset)	String	Tạo một chuỗi được mã hoá base-64 an toàn cho web từ chuỗi đã cho trong một bộ ký tự cụ thể.
computeDigest(algorithm, value)	Byte[]	Tính toán chuỗi đại diện bằng cách sử dụng thuật toán được chỉ định trên giá trị Byte[] được chỉ định.
computeDigest(algorithm, value)	Byte[]	Tính toán chuỗi đại diện bằng cách sử dụng thuật toán được chỉ định trên giá trị String được chỉ định.
computeDigest(algorithm, value, charset)	Byte[]	Tính toán chuỗi đại diện bằng cách sử dụng thuật toán đã chỉ định trên giá trị String đã chỉ định với bộ ký tự đã cho.
computeHmacSha256Signature(value, key)	Byte[]	Ký giá trị được cung cấp bằng HMAC-SHA256 với khoá đã cho.
computeHmacSha256Signature(value, key)	Byte[]	Ký giá trị được cung cấp bằng HMAC-SHA256 với khoá đã cho.
computeHmacSha256Signature(value, key, charset)	Byte[]	Ký giá trị được cung cấp bằng HMAC-SHA256 với khoá và bộ ký tự đã cho.
computeHmacSignature(algorithm, value, key)	Byte[]	Tính toán mã xác thực thông báo bằng thuật toán đã chỉ định trên khoá và giá trị đã chỉ định.
computeHmacSignature(algorithm, value, key)	Byte[]	Tính toán mã xác thực thông báo bằng thuật toán đã chỉ định trên khoá và giá trị đã chỉ định.
computeHmacSignature(algorithm, value, key, charset)	Byte[]	Tính toán mã xác thực thông báo bằng thuật toán đã chỉ định trên khoá và giá trị đã chỉ định.
computeRsaSha1Signature(value, key)	Byte[]	Ký giá trị được cung cấp bằng RSA-SHA1 với khoá đã cho.
computeRsaSha1Signature(value, key, charset)	Byte[]	Ký giá trị được cung cấp bằng RSA-SHA1 với khoá và bộ ký tự đã cho.
computeRsaSha256Signature(value, key)	Byte[]	Ký giá trị được cung cấp bằng RSA-SHA256 với khoá đã cho.
computeRsaSha256Signature(value, key, charset)	Byte[]	Ký giá trị được cung cấp bằng RSA-SHA256 với khoá đã cho.
computeRsaSignature(algorithm, value, key)	Byte[]	Ký giá trị được cung cấp bằng thuật toán RSA được chỉ định với khoá đã cho.
computeRsaSignature(algorithm, value, key, charset)	Byte[]	Ký giá trị được cung cấp bằng thuật toán RSA đã chỉ định với khoá và bộ ký tự đã cho.
formatDate(date, timeZone, format)	String	Định dạng ngày theo quy cách được mô tả trong lớp SimpleDateFormat của Java SE.
formatString(template, args)	String	Thực hiện định dạng chuỗi giống như sprintf bằng cách sử dụng chuỗi định dạng kiểu "%".
getUuid()	String	Lấy UUID dưới dạng chuỗi (tương đương với việc sử dụng phương thức java.util.UUID.randomUUID()).
gzip(blob)	Blob	gzip-nén dữ liệu Blob được cung cấp và trả về dữ liệu đó trong một đối tượng Blob mới.
gzip(blob, name)	Blob	gzip-nén dữ liệu Blob được cung cấp và trả về dữ liệu đó trong một đối tượng Blob mới.
newBlob(data)	Blob	Tạo một đối tượng Blob mới từ một mảng byte.
newBlob(data, contentType)	Blob	Tạo một đối tượng Blob mới từ một mảng byte và loại nội dung.
newBlob(data, contentType, name)	Blob	Tạo một đối tượng Blob mới từ một mảng byte, loại nội dung và tên.
newBlob(data)	Blob	Tạo một đối tượng Blob mới từ một chuỗi.
newBlob(data, contentType)	Blob	Tạo một đối tượng Blob mới từ một chuỗi và loại nội dung.
newBlob(data, contentType, name)	Blob	Tạo một đối tượng Blob mới từ một chuỗi, loại nội dung và tên.
parseCsv(csv)	String[][]	Trả về một mảng 2D dạng bảng biểu thị chuỗi CSV.
parseCsv(csv, delimiter)	String[][]	Trả về một mảng 2D dạng bảng đại diện cho một chuỗi CSV bằng cách sử dụng dấu phân cách tuỳ chỉnh.
parseDate(date, timeZone, format)	Date	Phân tích cú pháp ngày chuỗi được cung cấp theo thông số kỹ thuật được mô tả trong lớp SimpleDateFormat của Phiên bản tiêu chuẩn Java.
sleep(milliseconds)	void	Ngủ trong số mili giây đã chỉ định.
ungzip(blob)	Blob	Giải nén đối tượng Blob và trả về Blob chứa dữ liệu chưa nén.
unzip(blob)	Blob[]	Lấy một Blob đại diện cho tệp zip và trả về các tệp thành phần của tệp đó.
zip(blobs)	Blob	Tạo một đối tượng Blob mới là tệp zip chứa dữ liệu từ các Blob được truyền vào.
zip(blobs, name)	Blob	Tạo một đối tượng Blob mới là tệp zip chứa dữ liệu từ các Blob được truyền vào.

Các phương thức ngừng hoạt động

Phương thức	Loại dữ liệu trả về	Mô tả ngắn
jsonParse(jsonString)	Object	Trả về một đối tượng tương ứng với chuỗi JSON được truyền vào.
jsonStringify(obj)	String	Trả về một chuỗi JSON của đối tượng được truyền vào.

Tài liệu chi tiết

base64Decode(encoded)

Giải mã chuỗi được mã hoá base-64 thành mảng byte UTF-8.

// This is the base64 encoded form of "Google グループ"
const base64data = 'R29vZ2xlIOOCsOODq+ODvOODlw==';

// This logs:
//     [71, 111, 111, 103, 108, 101, 32, -29, -126, -80,
//      -29, -125, -85, -29, -125, -68, -29, -125, -105]
const decoded = Utilities.base64Decode(base64data);
Logger.log(decoded);

// If we want a String instead of a byte array:
// This logs the original "Google グループ"
Logger.log(Utilities.newBlob(decoded).getDataAsString());

Tham số

Tên	Loại	Mô tả
encoded	String	Một mảng byte dữ liệu cần giải mã.

Cầu thủ trả bóng

Byte[] – Dữ liệu thô được biểu thị bằng đối số được mã hoá base-64 dưới dạng mảng byte.

---

base64Decode(encoded, charset)

Giải mã chuỗi được mã hoá base-64 thành một mảng byte trong một bộ ký tự cụ thể.

// This is the base64 encoded form of "Google グループ"
const base64data = 'R29vZ2xlIOOCsOODq+ODvOODlw==';

const decoded = Utilities.base64Decode(base64data, Utilities.Charset.UTF_8);

// This logs:
//     [71, 111, 111, 103, 108, 101, 32, -29, -126, -80,
//      -29, -125, -85, -29, -125, -68, -29, -125, -105]
Logger.log(decoded);

// If we want a String instead of a byte array:
// This logs the original "Google グループ"
Logger.log(Utilities.newBlob(decoded).getDataAsString());

Tham số

Tên	Loại	Mô tả
encoded	String	Chuỗi dữ liệu cần giải mã.
charset	Charset	Charset chỉ định bộ ký tự của dữ liệu đầu vào.

Cầu thủ trả bóng

Byte[] – Dữ liệu thô được biểu thị bằng đối số được mã hoá base-64 dưới dạng mảng byte.

---

base64DecodeWebSafe(encoded)

Giải mã chuỗi được mã hoá base-64 an toàn cho web thành mảng byte UTF-8.

// This is the base64 web-safe encoded form of "Google グループ"
const base64data = 'R29vZ2xlIOOCsOODq-ODvOODlw==';

const decoded = Utilities.base64DecodeWebSafe(base64data);

// This logs:
//     [71, 111, 111, 103, 108, 101, 32, -29, -126, -80,
//      -29, -125, -85, -29, -125, -68, -29, -125, -105]
Logger.log(decoded);

// If we want a String instead of a byte array:
// This logs the original "Google グループ"
Logger.log(Utilities.newBlob(decoded).getDataAsString());

Tham số

Tên	Loại	Mô tả
encoded	String	Một mảng byte dữ liệu an toàn cho web để giải mã.

Cầu thủ trả bóng

Byte[] – Dữ liệu thô được biểu thị bằng đối số được mã hoá base-64 an toàn cho web dưới dạng mảng byte.

---

base64DecodeWebSafe(encoded, charset)

Giải mã chuỗi được mã hoá base-64 an toàn cho web thành một mảng byte trong một bộ ký tự cụ thể.

// This is the base64 web-safe encoded form of "Google グループ"
const base64data = 'R29vZ2xlIOOCsOODq-ODvOODlw==';

const decoded = Utilities.base64DecodeWebSafe(
    base64data,
    Utilities.Charset.UTF_8,
);

// This logs:
//     [71, 111, 111, 103, 108, 101, 32, -29, -126, -80,
//      -29, -125, -85, -29, -125, -68, -29, -125, -105]
Logger.log(decoded);

// If we want a String instead of a byte array:
// This logs the original "Google グループ"
Logger.log(Utilities.newBlob(decoded).getDataAsString());

Tham số

Tên	Loại	Mô tả
encoded	String	Chuỗi dữ liệu an toàn cho web cần giải mã.
charset	Charset	Charset chỉ định bộ ký tự của dữ liệu đầu vào.

Cầu thủ trả bóng

Byte[] – Dữ liệu thô được biểu thị bằng đối số được mã hoá base-64 an toàn cho web dưới dạng mảng byte.

---

base64Encode(data)

Tạo một chuỗi được mã hoá base-64 từ mảng byte đã cho. Base 64 là một phương thức mã hoá phổ biến được nhiều công cụ chấp nhận nhưng không thể chấp nhận dữ liệu nhị phân. Cơ sở 64 thường được dùng trong các giao thức Internet như email, HTTP hoặc trong tài liệu XML.

// Instantiates a blob here for clarity
const blob = Utilities.newBlob('A string here');

// Writes 'QSBzdHJpbmcgaGVyZQ==' to the log.
const encoded = Utilities.base64Encode(blob.getBytes());
Logger.log(encoded);

Tham số

Tên	Loại	Mô tả
data	Byte[]	Một byte[] dữ liệu cần mã hoá.

Cầu thủ trả bóng

String – Biểu diễn được mã hoá base-64 của dữ liệu được truyền vào.

---

base64Encode(data)

Tạo một chuỗi được mã hoá base-64 từ chuỗi đã cho. Base 64 là một phương thức mã hoá phổ biến được nhiều công cụ chấp nhận mà không chấp nhận dữ liệu nhị phân. Cơ sở 64 thường được dùng trong các giao thức Internet như email, HTTP hoặc trong tài liệu XML.

// Writes 'QSBzdHJpbmcgaGVyZQ==' to the log.
const encoded = Utilities.base64Encode('A string here');
Logger.log(encoded);

Tham số

Tên	Loại	Mô tả
data	String	Chuỗi cần mã hoá.

Cầu thủ trả bóng

String – Biểu diễn chuỗi đầu vào được mã hoá base-64.

---

base64Encode(data, charset)

Tạo một chuỗi được mã hoá base-64 từ chuỗi đã cho trong một bộ ký tự cụ thể. Bộ ký tự là một cách mã hoá các ký tự để có thể mã hoá các ký tự đó. Các thao tác này thường được thực hiện ở định dạng nhị phân, thường không tương thích với một số giao thức truyền dữ liệu nhất định. Để dữ liệu tương thích, dữ liệu thường được mã hoá thành cơ sở 64. Đây là một phương thức mã hoá phổ biến được nhiều công cụ chấp nhận, những công cụ này không thể chấp nhận dữ liệu nhị phân. Cơ sở 64 thường được dùng trong các giao thức Internet như email, HTTP hoặc trong tài liệu XML.

// "Google Groups" in Katakana (Japanese)
const input = 'Google グループ';

// Writes "R29vZ2xlIOOCsOODq+ODvOODlw==" to the log
const encoded = Utilities.base64Encode(input, Utilities.Charset.UTF_8);
Logger.log(encoded);

Tham số

Tên	Loại	Mô tả
data	String	Chuỗi dữ liệu cần mã hoá.
charset	Charset	Charset chỉ định bộ ký tự của dữ liệu đầu vào.

Cầu thủ trả bóng

String – Biểu diễn chuỗi đầu vào được mã hoá base-64 với Charset đã cho.

---

base64EncodeWebSafe(data)

Tạo một chuỗi được mã hoá base-64 an toàn cho web từ mảng byte đã cho. Base 64 là một phương thức mã hoá phổ biến được nhiều công cụ chấp nhận nhưng không thể chấp nhận dữ liệu nhị phân. Base 64 an toàn cho web thường được dùng trong các giao thức Internet như email, HTTP hoặc trong tài liệu XML.

// Instantiates a blob here for clarity
const blob = Utilities.newBlob('A string here');

// Writes 'QSBzdHJpbmcgaGVyZQ==' to the log.
const encoded = Utilities.base64EncodeWebSafe(blob.getBytes());
Logger.log(encoded);

Tham số

Tên	Loại	Mô tả
data	Byte[]	Một mảng byte dữ liệu cần mã hoá.

Cầu thủ trả bóng

String – Biểu thị được mã hoá base-64 an toàn cho web của dữ liệu được truyền vào.

---

base64EncodeWebSafe(data)

Tạo một chuỗi được mã hoá base-64 an toàn cho web từ chuỗi đã cho. Base 64 là một phương thức mã hoá phổ biến được nhiều công cụ chấp nhận nhưng không thể chấp nhận dữ liệu nhị phân. Cơ sở 64 an toàn cho web thường được sử dụng trong các giao thức Internet như email, HTTP hoặc trong tài liệu XML.

// Writes 'QSBzdHJpbmcgaGVyZQ==' to the log.
const encoded = Utilities.base64EncodeWebSafe('A string here');
Logger.log(encoded);

Tham số

Tên	Loại	Mô tả
data	String	Chuỗi cần mã hoá.

Cầu thủ trả bóng

String – Biểu thị chuỗi đầu vào được mã hoá base-64 an toàn cho web.

---

base64EncodeWebSafe(data, charset)

Tạo một chuỗi được mã hoá base-64 an toàn cho web từ chuỗi đã cho trong một bộ ký tự cụ thể. Bộ ký tự là một cách mã hoá các ký tự để có thể mã hoá chúng. Các thao tác này thường được thực hiện ở định dạng tệp nhị phân, thường không tương thích với một số giao thức truyền dữ liệu nhất định. Để tương thích với dữ liệu, dữ liệu thường được mã hoá thành cơ sở 64. Đây là một phương thức mã hoá phổ biến được nhiều công cụ chấp nhận, những công cụ này không thể chấp nhận dữ liệu nhị phân. Cơ sở 64 an toàn cho web thường được dùng trong các giao thức Internet như email, HTTP hoặc trong tài liệu XML.

// "Google Groups" in Katakana (Japanese)
const input = 'Google グループ';

// Writes "R29vZ2xlIOOCsOODq-ODvOODlw==" to the log
const encoded = Utilities.base64EncodeWebSafe(input, Utilities.Charset.UTF_8);
Logger.log(encoded);

Tham số

Tên	Loại	Mô tả
data	String	Chuỗi dữ liệu cần mã hoá.
charset	Charset	Charset chỉ định bộ ký tự của dữ liệu đầu vào.

Cầu thủ trả bóng

String – Biểu diễn chuỗi đầu vào được mã hoá base-64 an toàn trên web bằng Charset đã cho.

---

computeDigest(algorithm, value)

Tính toán chuỗi đại diện bằng cách sử dụng thuật toán được chỉ định trên giá trị Byte[] được chỉ định.

const input = Utilities.base64Decode(
    'aW5wdXQgdG8gaGFzaA0K');  // == base64encode("input to hash")
const digest = Utilities.computeDigest(Utilities.DigestAlgorithm.MD5, input);
Logger.log(digest);

Tham số

Tên	Loại	Mô tả
algorithm	DigestAlgorithm	DigestAlgorithm để sử dụng.
value	Byte[]	Giá trị chuỗi đầu vào để tính toán chuỗi đại diện.

Cầu thủ trả bóng

Byte[] – Một byte[] đại diện cho chuỗi đại diện đầu ra.

---

computeDigest(algorithm, value)

Tính toán chuỗi đại diện bằng cách sử dụng thuật toán được chỉ định trên giá trị String được chỉ định.

const digest = Utilities.computeDigest(
    Utilities.DigestAlgorithm.MD5,
    'input to hash',
);
Logger.log(digest);

Tham số

Tên	Loại	Mô tả
algorithm	DigestAlgorithm	DigestAlgorithm để sử dụng.
value	String	Giá trị chuỗi đầu vào để tính toán chuỗi đại diện.

Cầu thủ trả bóng

Byte[] – Một byte[] đại diện cho chuỗi đại diện đầu ra.

---

computeDigest(algorithm, value, charset)

Tính toán chuỗi đại diện bằng cách sử dụng thuật toán đã chỉ định trên giá trị String đã chỉ định với bộ ký tự đã cho.

const digest = Utilities.computeDigest(
    Utilities.DigestAlgorithm.MD5,
    'input to hash',
    Utilities.Charset.US_ASCII,
);
Logger.log(digest);

Tham số

Tên	Loại	Mô tả
algorithm	DigestAlgorithm	DigestAlgorithm để sử dụng.
value	String	Giá trị chuỗi đầu vào để tính toán chuỗi đại diện.
charset	Charset	Charset đại diện cho bộ ký tự đầu vào.

Cầu thủ trả bóng

Byte[] – Một byte[] đại diện cho chuỗi đại diện đầu ra.

---

computeHmacSha256Signature(value, key)

Ký giá trị được cung cấp bằng HMAC-SHA256 với khoá đã cho.

// This writes an array of bytes to the log.
const input = Utilities.base64Decode(
    'aW5wdXQgdG8gaGFzaA0K');                 // == base64encode("input to hash")
const key = Utilities.base64Decode('a2V5');  // == base64encode("key")
const signature = Utilities.computeHmacSha256Signature(input, key);
Logger.log(signature);

Tham số

Tên	Loại	Mô tả
value	Byte[]	Giá trị đầu vào để tạo hàm băm.
key	Byte[]	Khoá dùng để tạo hàm băm.

Cầu thủ trả bóng

Byte[] – Một byte[] đại diện cho chữ ký đầu ra.

---

computeHmacSha256Signature(value, key)

Ký giá trị được cung cấp bằng HMAC-SHA256 với khoá đã cho.

// This writes an array of bytes to the log.
const signature = Utilities.computeHmacSha256Signature(
    'this is my input',
    'my key - use a stronger one',
);
Logger.log(signature);

Tham số

Tên	Loại	Mô tả
value	String	Giá trị đầu vào để tạo hàm băm.
key	String	Khoá dùng để tạo hàm băm.

Cầu thủ trả bóng

Byte[] – Một byte[] đại diện cho chữ ký đầu ra.

---

computeHmacSha256Signature(value, key, charset)

Ký giá trị được cung cấp bằng HMAC-SHA256 với khoá và bộ ký tự đã cho.

// This writes an array of bytes to the log.
const signature = Utilities.computeHmacSha256Signature(
    'this is my input',
    'my key - use a stronger one',
    Utilities.Charset.US_ASCII,
);
Logger.log(signature);

Tham số

Tên	Loại	Mô tả
value	String	Giá trị đầu vào để tạo hàm băm.
key	String	Khoá dùng để tạo hàm băm.
charset	Charset	Charset đại diện cho bộ ký tự đầu vào.

Cầu thủ trả bóng

Byte[] – Một byte[] đại diện cho chữ ký đầu ra.

---

computeHmacSignature(algorithm, value, key)

Tính toán mã xác thực thông báo bằng thuật toán đã chỉ định trên khoá và giá trị đã chỉ định.

// This writes an array of bytes to the log.
const input = Utilities.base64Decode(
    'aW5wdXQgdG8gaGFzaA0K');                 // == base64encode("input to hash")
const key = Utilities.base64Decode('a2V5');  // == base64encode("key")
const signature = Utilities.computeHmacSignature(
    Utilities.MacAlgorithm.HMAC_MD5,
    input,
    key,
);
Logger.log(signature);

Tham số

Tên	Loại	Mô tả
algorithm	MacAlgorithm	Thuật toán MacAlgorithm để sử dụng nhằm băm giá trị đầu vào.
value	Byte[]	Giá trị đầu vào để tạo hàm băm.
key	Byte[]	Khoá dùng để tạo hàm băm.

Cầu thủ trả bóng

Byte[] – Một byte[] đại diện cho chữ ký đầu ra.

---

computeHmacSignature(algorithm, value, key)

Tính toán mã xác thực thông báo bằng thuật toán đã chỉ định trên khoá và giá trị đã chỉ định.

// This writes an array of bytes to the log.
const signature = Utilities.computeHmacSignature(
    Utilities.MacAlgorithm.HMAC_MD5,
    'input to hash',
    'key',
);
Logger.log(signature);

Tham số

Tên	Loại	Mô tả
algorithm	MacAlgorithm	Thuật toán MacAlgorithm để sử dụng nhằm băm giá trị đầu vào.
value	String	Giá trị đầu vào để tạo hàm băm.
key	String	Khoá dùng để tạo hàm băm.

Cầu thủ trả bóng

Byte[] – Một byte[] đại diện cho chữ ký đầu ra.

---

computeHmacSignature(algorithm, value, key, charset)

Tính toán mã xác thực thông báo bằng thuật toán đã chỉ định trên khoá và giá trị đã chỉ định.

// This writes an array of bytes to the log.
const signature = Utilities.computeHmacSignature(
    Utilities.MacAlgorithm.HMAC_MD5,
    'input to hash',
    'key',
    Utilities.Charset.US_ASCII,
);
Logger.log(signature);

Tham số

Tên	Loại	Mô tả
algorithm	MacAlgorithm	Thuật toán MacAlgorithm để sử dụng nhằm băm giá trị đầu vào.
value	String	Giá trị đầu vào để tạo hàm băm.
key	String	Khoá dùng để tạo hàm băm.
charset	Charset	Charset đại diện cho bộ ký tự đầu vào.

Cầu thủ trả bóng

Byte[] – Một byte[] đại diện cho chữ ký đầu ra.

---

computeRsaSha1Signature(value, key)

Ký giá trị được cung cấp bằng RSA-SHA1 với khoá đã cho.

// This writes an array of bytes to the log.
const signature = Utilities.computeRsaSha1Signature(
    'this is my input',
    PropertiesService.getScriptProperties().getProperty('YOUR_PRIVATE_KEY'),
);
Logger.log(signature);

Tham số

Tên	Loại	Mô tả
value	String	Giá trị đầu vào để tạo hàm băm.
key	String	Khoá định dạng PEM dùng để tạo chữ ký.

Cầu thủ trả bóng

Byte[] – Một byte[] đại diện cho chữ ký đầu ra.

---

computeRsaSha1Signature(value, key, charset)

Ký giá trị được cung cấp bằng RSA-SHA1 với khoá và bộ ký tự đã cho.

// This writes an array of bytes to the log.
const signature = Utilities.computeRsaSha1Signature(
    'this is my input',
    PropertiesService.getScriptProperties().getProperty('YOUR_PRIVATE_KEY'),
    Utilities.Charset.US_ASCII,
);
Logger.log(signature);

Tham số

Tên	Loại	Mô tả
value	String	Giá trị đầu vào để tạo hàm băm.
key	String	Khoá định dạng PEM dùng để tạo chữ ký.
charset	Charset	Charset đại diện cho bộ ký tự đầu vào.

Cầu thủ trả bóng

Byte[] – Một byte[] đại diện cho chữ ký đầu ra.

---

computeRsaSha256Signature(value, key)

Ký giá trị được cung cấp bằng RSA-SHA256 với khoá đã cho.

// This writes an array of bytes to the log.
const signature = Utilities.computeRsaSha256Signature(
    'this is my input',
    PropertiesService.getScriptProperties().getProperty('YOUR_PRIVATE_KEY'),
);
Logger.log(signature);

Tham số

Tên	Loại	Mô tả
value	String	Giá trị đầu vào để tạo hàm băm.
key	String	Khoá định dạng PEM dùng để tạo chữ ký.

Cầu thủ trả bóng

Byte[] – Một byte[] đại diện cho chữ ký đầu ra.

---

computeRsaSha256Signature(value, key, charset)

Ký giá trị được cung cấp bằng RSA-SHA256 với khoá đã cho.

// This writes an array of bytes to the log.
const signature = Utilities.computeRsaSha256Signature(
    'this is my input',
    PropertiesService.getScriptProperties().getProperty('YOUR_PRIVATE_KEY'),
);
Logger.log(signature);

Tham số

Tên	Loại	Mô tả
value	String	Giá trị đầu vào để tạo hàm băm.
key	String	Khoá định dạng PEM dùng để tạo chữ ký.
charset	Charset	Charset đại diện cho bộ ký tự đầu vào.

Cầu thủ trả bóng

Byte[] – Một byte[] đại diện cho chữ ký đầu ra.

---

computeRsaSignature(algorithm, value, key)

Ký giá trị được cung cấp bằng thuật toán RSA được chỉ định với khoá đã cho.

// This writes an array of bytes to the log.
const signature = Utilities.computeRsaSignature(
    Utilities.RsaAlgorithm.RSA_SHA_256,
    'this is my input',
    PropertiesService.getScriptProperties().getProperty('YOUR_PRIVATE_KEY'),
);
Logger.log(signature);

Tham số

Tên	Loại	Mô tả
algorithm	RsaAlgorithm	Thuật toán RsaAlgorithm để sử dụng nhằm băm giá trị đầu vào.
value	String	Giá trị đầu vào để tạo hàm băm.
key	String	Khoá định dạng PEM dùng để tạo chữ ký.

Cầu thủ trả bóng

Byte[] – Một byte[] đại diện cho chữ ký đầu ra.

---

computeRsaSignature(algorithm, value, key, charset)

Ký giá trị được cung cấp bằng thuật toán RSA đã chỉ định với khoá và bộ ký tự đã cho.

// This writes an array of bytes to the log.
const signature = Utilities.computeRsaSignature(
    Utilities.RsaAlgorithm.RSA_SHA_256,
    'this is my input',
    PropertiesService.getScriptProperties().getProperty('YOUR_PRIVATE_KEY'),
    Utilities.Charset.US_ASCII,
);
Logger.log(signature);

Tham số

Tên	Loại	Mô tả
algorithm	RsaAlgorithm	Thuật toán RsaAlgorithm để sử dụng nhằm băm giá trị đầu vào.
value	String	Giá trị đầu vào để tạo hàm băm.
key	String	Khoá định dạng PEM dùng để tạo chữ ký.
charset	Charset	Charset đại diện cho bộ ký tự đầu vào.

Cầu thủ trả bóng

Byte[] – Một byte[] đại diện cho chữ ký đầu ra.

---

formatDate(date, timeZone, format)

Định dạng ngày theo quy cách được mô tả trong lớp SimpleDateFormat của Java SE. Vui lòng truy cập vào thông số kỹ thuật tại http://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html

// This formats the date as Greenwich Mean Time in the format
// year-month-dateThour-minute-second.
const formattedDate = Utilities.formatDate(
    new Date(),
    'GMT',
    'yyyy-MM-dd\'T\'HH:mm:ss\'Z\'',
);
Logger.log(formattedDate);

Tham số

Tên	Loại	Mô tả
date	Date	Date để định dạng dưới dạng Chuỗi.
timeZone	String	Múi giờ đầu ra của kết quả.
format	String	Một định dạng theo quy cách SimpleDateFormat.

Cầu thủ trả bóng

String – Ngày nhập dưới dạng chuỗi được định dạng.

---

formatString(template, args)

Thực hiện định dạng chuỗi giống như sprintf bằng cách sử dụng chuỗi định dạng kiểu "%".

// " 123.456000"
Utilities.formatString('%11.6f', 123.456);

// "   abc"
Utilities.formatString('%6s', 'abc');

Tham số

Tên	Loại	Mô tả
template	String	Chuỗi định dạng kiểm soát nội dung được trả về.
args	Object...	Các đối tượng cần sử dụng để điền vào phần giữ chỗ "%" trong mẫu.

Cầu thủ trả bóng

String – Chuỗi đã định dạng.

---

getUuid()

Lấy UUID dưới dạng chuỗi (tương đương với việc sử dụng phương thức java.util.UUID.randomUUID()). Giá trị nhận dạng này không được đảm bảo là duy nhất trong mọi không gian và thời gian. Do đó, đừng sử dụng trong những trường hợp cần đảm bảo tính duy nhất.

// This assigns a UUID as a temporary ID for a data object you are creating in
// your script.
const myDataObject = {
  tempId: Utilities.getUuid(),
};

Cầu thủ trả bóng

String – Chuỗi đại diện cho UUID.

---

gzip(blob)

gzip-nén dữ liệu Blob được cung cấp và trả về dữ liệu đó trong một đối tượng Blob mới.

const textBlob = Utilities.newBlob(
    'Some text to compress using gzip compression',
);

// Create the compressed blob.
const gzipBlob = Utilities.gzip(textBlob);

Tham số

Tên	Loại	Mô tả
blob	BlobSource	Một đối tượng Blob để nén bằng gzip.

Cầu thủ trả bóng

Blob – Một Blob mới chứa dữ liệu đã nén.

---

gzip(blob, name)

gzip-nén dữ liệu Blob được cung cấp và trả về dữ liệu đó trong một đối tượng Blob mới. Phiên bản phương thức này cho phép chỉ định tên tệp.

const textBlob = Utilities.newBlob(
    'Some text to compress using gzip compression',
);

// Create the compressed blob.
const gzipBlob = Utilities.gzip(textBlob, 'text.gz');

Tham số

Tên	Loại	Mô tả
blob	BlobSource	Một đối tượng Blob để nén bằng gzip.
name	String	Tên của tệp gzip cần tạo.

Cầu thủ trả bóng

Blob – Một Blob mới chứa dữ liệu đã nén.

---

newBlob(data)

Tạo một đối tượng Blob mới từ một mảng byte. Blob được dùng trong nhiều API Apps Script lấy dữ liệu nhị phân làm dữ liệu đầu vào.

// Creates a blob object from a byte array.
const data = [71, 79, 79, 71, 76, 69];
const blob = Utilities.newBlob(data);

// Logs the blob data as a string to the console.
console.log(blob.getDataAsString());

Tham số

Tên	Loại	Mô tả
data	Byte[]	Số byte cho blob.

Cầu thủ trả bóng

Blob – Blob mới tạo.

---

newBlob(data, contentType)

Tạo một đối tượng Blob mới từ một mảng byte và loại nội dung. Blob được dùng trong nhiều API Apps Script lấy dữ liệu nhị phân làm dữ liệu đầu vào.

// Declares a byte array.
const data = [71, 79, 79, 71, 76, 69];

// Declares the content type of the blob.
const contentType = 'application/json';

// Creates a blob object from the byte array and content type.
const blob = Utilities.newBlob(data, contentType);

// Logs the blob data as a string to the console.
console.log(blob.getDataAsString());

// Logs the content type of the blob to the console.
console.log(blob.getContentType());

Tham số

Tên	Loại	Mô tả
data	Byte[]	Số byte cho blob.
contentType	String	Loại nội dung của blob – có thể là null.

Cầu thủ trả bóng

Blob – Blob mới tạo.

---

newBlob(data, contentType, name)

Tạo một đối tượng Blob mới từ một mảng byte, loại nội dung và tên. Blob được dùng trong nhiều API tập lệnh ứng dụng lấy dữ liệu nhị phân làm dữ liệu đầu vào.

// Declares a byte array.
const data = [71, 79, 79, 71, 76, 69];

// Declares the content type of the blob.
const contentType = 'application/json';

// Declares the name of the blob.
const name = 'Example blob';

// Creates a blob object from the byte array, content type, and name.
const blob = Utilities.newBlob(data, contentType, name);

// Logs the blob data as a string to the console.
console.log('Blob data:', blob.getDataAsString());

// Logs the content type of the blob to the console.
console.log('Blob content type:', blob.getContentType());

// Logs the name of the blob to the console.
console.log('Blob name:', blob.getName());

Tham số

Tên	Loại	Mô tả
data	Byte[]	Số byte cho blob.
contentType	String	– Loại nội dung của blob – có thể là null.
name	String	Tên của blob – có thể là null.

Cầu thủ trả bóng

Blob – Blob mới tạo.

---

newBlob(data)

Tạo một đối tượng Blob mới từ một chuỗi. Blob được dùng trong nhiều API Apps Script lấy dữ liệu nhị phân làm dữ liệu đầu vào.

// Declares a string for the blob.
const data = 'GOOGLE';

// Creates a blob object from a string.
const blob = Utilities.newBlob(data);

// Logs the blob data in byte array to the console.
console.log('Blob Data:', blob.getBytes());

Tham số

Tên	Loại	Mô tả
data	String	Chuỗi cho blob, giả định là UTF-8.

Cầu thủ trả bóng

Blob – Blob mới tạo.

---

newBlob(data, contentType)

Tạo một đối tượng Blob mới từ một chuỗi và loại nội dung. Blob được dùng trong nhiều API Apps Script lấy dữ liệu nhị phân làm dữ liệu đầu vào.

// Declares a string for the blob.
const data = 'GOOGLE';

// Declares the content type of blob.
const contentType = 'application/json';

// Creates a blob object from the string and content type.
const blob = Utilities.newBlob(data, contentType);

// Logs the blob data in byte array to the console.
console.log('Blob data:', blob.getBytes());

// Logs the content type of the blob to the console.
console.log(blob.getContentType());

Tham số

Tên	Loại	Mô tả
data	String	Chuỗi cho blob, giả định là UTF-8.
contentType	String	Loại nội dung của blob – có thể là null.

Cầu thủ trả bóng

Blob – Blob mới tạo.

---

newBlob(data, contentType, name)

Tạo một đối tượng Blob mới từ một chuỗi, loại nội dung và tên. Blob được dùng trong nhiều API tập lệnh ứng dụng lấy dữ liệu nhị phân làm dữ liệu đầu vào.

// Declares a string for the blob.
const data = 'GOOGLE';

// Declares the content type of the blob.
const contentType = 'application/json';

// Declares the name of the blob.
const name = 'Example blob';

// Create a blob object from the string, content type, and name.
const blob = Utilities.newBlob(data, contentType, name);

// Logs the blob data in byte array to the console.
console.log('Blob data:', blob.getBytes());

// Logs the content type of the blob to the console.
console.log('Blob content type:', blob.getContentType());

// Logs the name of the blob to the console.
console.log('Blob name:', blob.getName());

Tham số

Tên	Loại	Mô tả
data	String	Chuỗi cho blob, giả định là UTF-8.
contentType	String	Loại nội dung của blob – có thể là null.
name	String	Tên của blob – có thể là null.

Cầu thủ trả bóng

Blob – Blob mới tạo.

---

parseCsv(csv)

Trả về một mảng 2D dạng bảng biểu thị chuỗi CSV.

// This creates a two-dimensional array of the format [[a, b, c], [d, e, f]]
const csvString = 'a,b,c\nd,e,f';
const data = Utilities.parseCsv(csvString);

Tham số

Tên	Loại	Mô tả
csv	String	Một chuỗi chứa dữ liệu một hoặc nhiều dòng ở định dạng giá trị được phân tách bằng dấu phẩy (CSV).

Cầu thủ trả bóng

String[][] – Một mảng hai chiều chứa các giá trị trong chuỗi CSV.

---

parseCsv(csv, delimiter)

Trả về một mảng 2D dạng bảng đại diện cho một chuỗi CSV bằng cách sử dụng dấu phân cách tuỳ chỉnh.

// This creates a two-dimensional array of the format [[a, b, c], [d, e, f]]
const csvString = 'a\tb\tc\nd\te\tf';
const data = Utilities.parseCsv(csvString, '\t');

Tham số

Tên	Loại	Mô tả
csv	String	Một chuỗi chứa dữ liệu một hoặc nhiều dòng ở định dạng giá trị được phân tách bằng dấu phẩy (CSV).
delimiter	Char	Giữa các giá trị.

Cầu thủ trả bóng

String[][] – Một mảng hai chiều chứa các giá trị trong chuỗi CSV.

---

parseDate(date, timeZone, format)

Phân tích cú pháp ngày chuỗi được cung cấp theo thông số kỹ thuật được mô tả trong lớp SimpleDateFormat của Phiên bản tiêu chuẩn Java. Để biết thêm thông tin, hãy xem lớp SimpleDateFormat của Java.

// This set of parameters parses the given string as a date in Greenwich Mean
// Time, formatted as year-month-dateThour-minute-second.
const date = Utilities.parseDate(
    '1970-01-01 00:00:00',
    'GMT',
    'yyyy-MM-dd\' \'HH:mm:ss',
);
Logger.log(date);

Tham số

Tên	Loại	Mô tả
date	String	Giá trị chuỗi để phân tích cú pháp dưới dạng ngày.
timeZone	String	Múi giờ đầu ra.
format	String	Định dạng ngày theo quy cách SimpleDateFormat.

Cầu thủ trả bóng

Date – Chuỗi đầu vào dưới dạng ngày.

---

sleep(milliseconds)

Ngủ trong số mili giây đã chỉ định. Ngay lập tức đưa tập lệnh vào trạng thái ngủ trong số mili giây đã chỉ định. Giá trị tối đa được phép là 300000 (hoặc 5 phút).

// Creates a blob object from a string.
const data = 'GOOGLE';
const blob = Utilities.newBlob(data);

// Puts the script to sleep for 10,000 milliseconds (10 seconds).
Utilities.sleep(10000);

// Logs the blob data in byte array to the console.
console.log(blob.getBytes());

Tham số

Tên	Loại	Mô tả
milliseconds	Integer	Số mili giây để ngủ.

---

ungzip(blob)

Giải nén đối tượng Blob và trả về Blob chứa dữ liệu chưa nén.

const textBlob = Utilities.newBlob(
    'Some text to compress using gzip compression',
);

// Create the compressed blob.
const gzipBlob = Utilities.gzip(textBlob, 'text.gz');

// Uncompress the data.
const uncompressedBlob = Utilities.ungzip(gzipBlob);

Tham số

Tên	Loại	Mô tả
blob	BlobSource	Blob của dữ liệu nén.

Cầu thủ trả bóng

Blob – Blob đại diện cho dữ liệu đã giải nén.

---

unzip(blob)

Lấy một Blob đại diện cho tệp zip và trả về các tệp thành phần của tệp đó.

const googleFavIconUrl = 'https://www.google.com/favicon.ico';
const googleLogoUrl = 'https://www.google.com/images/srpr/logo3w.png';

// Fetch the Google favicon.ico file and get the Blob data
const faviconBlob = UrlFetchApp.fetch(googleFavIconUrl).getBlob();
const logoBlob = UrlFetchApp.fetch(googleLogoUrl).getBlob();

// zip now references a blob containing an archive of both faviconBlob and
// logoBlob
const zip = Utilities.zip([faviconBlob, logoBlob], 'google_images.zip');

// This now unzips the blobs
const files = Utilities.unzip(zip);

Tham số

Tên	Loại	Mô tả
blob	BlobSource	Blob tệp zip.

Cầu thủ trả bóng

Blob[] – Một Blob[] đại diện cho các blob thành phần, mỗi blob được đặt tên bằng đường dẫn đầy đủ bên trong tệp ZIP.

---

zip(blobs)

Tạo một đối tượng Blob mới là tệp zip chứa dữ liệu từ các Blob được truyền vào.

const googleFavIconUrl = 'https://www.google.com/favicon.ico';
const googleLogoUrl = 'https://www.google.com/images/srpr/logo3w.png';

// Fetch the Google favicon.ico file and get the Blob data
const faviconBlob = UrlFetchApp.fetch(googleFavIconUrl).getBlob();
const logoBlob = UrlFetchApp.fetch(googleLogoUrl).getBlob();

// zip now references a blob containing an archive of both faviconBlob and
// logoBlob
const zip = Utilities.zip([faviconBlob, logoBlob]);

Tham số

Tên	Loại	Mô tả
blobs	BlobSource[]	Một mảng blob để nén.

Cầu thủ trả bóng

Blob – Một blob mới chứa dữ liệu đầu vào dưới dạng tệp lưu trữ.

---

zip(blobs, name)

Tạo một đối tượng Blob mới là tệp zip chứa dữ liệu từ các Blob được truyền vào. Phiên bản phương thức này cho phép chỉ định tên tệp.

const googleFavIconUrl = 'https://www.google.com/favicon.ico';
const googleLogoUrl = 'https://www.google.com/images/srpr/logo3w.png';

// Fetch the Google favicon.ico file and get the Blob data
const faviconBlob = UrlFetchApp.fetch(googleFavIconUrl).getBlob();
const logoBlob = UrlFetchApp.fetch(googleLogoUrl).getBlob();

// zip now references a blob containing an archive of both faviconBlob and
// logoBlob
const zip = Utilities.zip([faviconBlob, logoBlob], 'google_images.zip');

Tham số

Tên	Loại	Mô tả
blobs	BlobSource[]	Một mảng blob để nén.
name	String	Tên của tệp zip cần tạo.

Cầu thủ trả bóng

Blob – Một blob mới chứa dữ liệu đầu vào dưới dạng tệp lưu trữ.

Các phương thức ngừng hoạt động

jsonParse(jsonString)

Không dùng nữa. Kể từ tháng 11 năm 2013, được thay thế bằng JSON.parse()

Trả về một đối tượng tương ứng với chuỗi JSON được truyền vào.

// Returns the object { name: "John Smith", company: "Virginia Company"}
const obj = Utilities.jsonParse(
    '{"name":"John Smith","company":"Virginia Company"}',
);

Tham số

Tên	Loại	Mô tả
jsonString	String	Chuỗi đại diện cho một đối tượng JavaScript để giải mã tuần tự.

Cầu thủ trả bóng

Object – Đối tượng JavaScript đại diện cho dữ liệu đầu vào.

---

jsonStringify(obj)

Không dùng nữa. Kể từ tháng 11 năm 2013, được thay thế bằng JSON.stringify()

Trả về một chuỗi JSON của đối tượng được truyền vào.

// Logs: {"name":"John Smith","company":"Virginia Company"}
const person = {
  name: 'John Smith',
  company: 'Virginia Company',
};
const json = Utilities.jsonStringify(person);
Logger.log(json);

Tham số

Tên	Loại	Mô tả
obj	Object	đối tượng JavaScript để chuyển đổi tuần tự sang JSON

Cầu thủ trả bóng

String – đối tượng JavaScript được chuyển đổi tuần tự JSON