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à thực hiện các thao tác khác.

Thuộc tính

Tài sản	Loại	Nội dung mô tả
Charset	Charset
DigestAlgorithm	DigestAlgorithm
MacAlgorithm	MacAlgorithm
RsaAlgorithm	RsaAlgorithm

Phương thức

Phương thức	Kiểu dữ liệu trả về	Mô tả ngắn
base64Decode(encoded)	Byte[]	Giải mã một chuỗi được mã hoá base-64 thành một mảng byte UTF-8.
base64Decode(encoded, charset)	Byte[]	Giải mã một 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ã một chuỗi được mã hoá an toàn cho web cơ sở 64 thành một mảng byte UTF-8.
base64DecodeWebSafe(encoded, charset)	Byte[]	Giải mã một chuỗi được mã hoá an toàn trên web base-64 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á cơ số 64 từ mảng byte đã cho.
base64Encode(data)	String	Tạo một chuỗi được mã hoá theo cơ sở 64 từ chuỗi đã cho.
base64Encode(data, charset)	String	Tạo một chuỗi được mã hoá theo cơ số 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á an toàn trên web dựa trên cơ sở 64 từ mảng byte đã cho.
base64EncodeWebSafe(data)	String	Tạo một chuỗi được mã hoá an toàn trên web dựa trên cơ sở 64 từ chuỗi đã cho.
base64EncodeWebSafe(data, charset)	String	Tạo một chuỗi được mã hoá an toàn trên web dựa trên cơ sở 64 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 đã chỉ định cho giá trị Byte[] đã 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 đã chỉ định cho giá trị String đã 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 cho 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 bằng khoá đã cho.
computeHmacSha256Signature(value, key)	Byte[]	Ký giá trị được cung cấp bằng HMAC-SHA256 bằng 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 điệp bằng thuật toán được chỉ định cho khoá và giá trị được chỉ định.
computeHmacSignature(algorithm, value, key)	Byte[]	Tính toán mã xác thực thông điệp bằng thuật toán được chỉ định cho khoá và giá trị được chỉ định.
computeHmacSignature(algorithm, value, key, charset)	Byte[]	Tính toán mã xác thực thông điệp bằng thuật toán được chỉ định cho khoá và giá trị được chỉ định.
computeRsaSha1Signature(value, key)	Byte[]	Ký giá trị đã cung cấp bằng RSA-SHA1 bằng khoá đã cho.
computeRsaSha1Signature(value, key, charset)	Byte[]	Ký giá trị đã cung cấp bằng RSA-SHA1 bằng khoá và bộ ký tự đã cho.
computeRsaSha256Signature(value, key)	Byte[]	Ký giá trị đã cung cấp bằng RSA-SHA256 bằng khoá đã cho.
computeRsaSha256Signature(value, key, charset)	Byte[]	Ký giá trị đã cung cấp bằng RSA-SHA256 bằng khoá đã cho.
computeRsaSignature(algorithm, value, key)	Byte[]	Ký giá trị đã cho bằng thuật toán RSA được chỉ định với khoá đã cho.
computeRsaSignature(algorithm, value, key, charset)	Byte[]	Ký giá trị đã cho bằng thuật toán RSA đã chỉ định với khoá và bộ ký tự cho trước.
formatDate(date, timeZone, format)	String	Định dạng ngày theo thông số kỹ thuật được mô tả trong lớp Java SE SimpleDateFormat.
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 đã cung cấp rồi 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 đã cung cấp rồi trả về dữ liệu đó trong một đối tượng Blob mới.
newBlob(data)	Blob	Tạo đối tượng Blob mới từ một mảng byte.
newBlob(data, contentType)	Blob	Tạo đố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 đố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 đối tượng Blob mới từ một chuỗi.
newBlob(data, contentType)	Blob	Tạo đối tượng Blob mới từ một chuỗi và loại nội dung.
newBlob(data, contentType, name)	Blob	Tạo đố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 bảng biểu diễn mảng 2D của một chuỗi CSV.
parseCsv(csv, delimiter)	String[][]	Trả về đại diện mảng 2D dạng bảng của một chuỗi CSV bằng dấu phân tách tuỳ chỉnh.
parseDate(date, timeZone, format)	Date	Phân tích cú pháp ngày của 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 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 biểu thị một tệp zip và trả về các tệp thành phần của tệp đó.
zip(blobs)	Blob	Tạo đối tượng Blob mới là tệp zip chứa dữ liệu từ Blobs đã được truyền vào.
zip(blobs, name)	Blob	Tạo đối tượng Blob mới là tệp zip chứa dữ liệu từ Blobs đã được truyền vào.

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

Phương thức	Kiểu 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ã một chuỗi được mã hoá base-64 thành một mảng byte UTF-8.

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

// This logs:
//     [71, 111, 111, 103, 108, 101, 32, -29, -126, -80,
//      -29, -125, -85, -29, -125, -68, -29, -125, -105]
var 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());

Các tham số

Tên	Loại	Nội dung mô tả
encoded	String	Một mảng các 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ố mã hoá base-64 dưới dạng một mảng byte.

---

base64Decode(encoded, charset)

Giải mã một 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 グループ"
var base64data = "R29vZ2xlIOOCsOODq+ODvOODlw==";

var 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());

Các tham số

Tên	Loại	Nội dung mô tả
encoded	String	Chuỗi dữ liệu cần giải mã.
charset	Charset	Charset xác định bộ ký tự của dữ liệu nhập.

Cầu thủ trả bóng

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

---

base64DecodeWebSafe(encoded)

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

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

var 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());

Các tham số

Tên	Loại	Nội dung mô tả
encoded	String	Một mảng các byte dữ liệu an toàn trên web 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á an toàn cho web-64 dưới dạng một mảng byte.

---

base64DecodeWebSafe(encoded, charset)

Giải mã một chuỗi được mã hoá an toàn trên web base-64 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 グループ"
var base64data = "R29vZ2xlIOOCsOODq-ODvOODlw==";

var 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());

Các tham số

Tên	Loại	Nội dung mô tả
encoded	String	Chuỗi dữ liệu an toàn trên web cần giải mã.
charset	Charset	Charset xác định bộ ký tự của dữ liệu nhập.

Cầu thủ trả bóng

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

---

base64Encode(data)

Tạo một chuỗi được mã hoá cơ số 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ụ không chấp nhận dữ liệu nhị phân. Base 64 thường được dùng trong các giao thức Internet, chẳng hạn như email, HTTP hoặc trong các tài liệu XML.

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

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

Các tham số

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

Cầu thủ trả bóng

String – Biểu thị được mã hoá dưới dạng base-64 của dữ liệu được truyền vào.

---

base64Encode(data)

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

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

Các tham số

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

Cầu thủ trả bóng

String – Biểu thị được mã hoá dưới dạng base-64 của chuỗi nhập.

---

base64Encode(data, charset)

Tạo một chuỗi được mã hoá theo cơ số 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ự sao cho chúng có thể được mã hoá. Các thao tác này thường được thực hiện ở định dạng nhị phân, thường có thể không tương thích với một số giao thức truyền dữ liệu nhất định. Để làm cho dữ liệu tương thích, các dữ liệu này thường được mã hoá thành cơ sở 64. Đây là phương thức mã hoá phổ biến được nhiều công cụ không thể chấp nhận dữ liệu nhị phân chấp nhận. Base 64 thường được dùng trong các giao thức Internet, chẳng hạn như email, HTTP hoặc trong các tài liệu XML.

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

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

Các tham số

Tên	Loại	Nội dung mô tả
data	String	Chuỗi dữ liệu cần mã hoá.
charset	Charset	Charset xác định bộ ký tự của dữ liệu nhập.

Cầu thủ trả bóng

String – Biểu thị được mã hoá dưới dạng base-64 của chuỗi nhập bằng Charset cho trước.

---

base64EncodeWebSafe(data)

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

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

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

Các tham số

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

Cầu thủ trả bóng

String – Bản trình bày được mã hoá dưới dạng base-64 an toàn trên web của dữ liệu được truyền vào.

---

base64EncodeWebSafe(data)

Tạo một chuỗi được mã hoá an toàn trên web dựa trên cơ sở 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ụ không chấp nhận dữ liệu nhị phân. Base 64 an toàn trên web thường được sử dụng trong các giao thức Internet, chẳng hạn như email, HTTP hoặc trong các tài liệu XML.

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

Các tham số

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

Cầu thủ trả bóng

String – Bản trình bày chuỗi nhập vào được mã hoá an toàn trên web dưới dạng base-64.

---

base64EncodeWebSafe(data, charset)

Tạo một chuỗi được mã hoá an toàn trên web dựa trên cơ sở 64 từ chuỗi đã cho trong một bộ ký tự cụ thể. Tập hợp ký tự là một cách mã hoá các ký tự sao cho chúng có thể được mã hoá. Các thao tác này thường được thực hiện ở định dạng nhị phân, thường có thể 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, chúng thường được mã hoá thành cơ sở 64. Đây là phương thức mã hoá phổ biến được nhiều công cụ không thể chấp nhận dữ liệu nhị phân. Base 64 an toàn trên web thường được sử dụng trong các giao thức Internet, chẳng hạn như email, HTTP hoặc trong các tài liệu XML.

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

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

Các tham số

Tên	Loại	Nội dung mô tả
data	String	Chuỗi dữ liệu cần mã hoá.
charset	Charset	Charset xác định bộ ký tự của dữ liệu nhập.

Cầu thủ trả bóng

String – Bản trình bày được mã hoá dưới dạng base-64 an toàn trên web của chuỗi nhập 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 đã chỉ định cho giá trị Byte[] đã chỉ định.

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

Các tham số

Tên	Loại	Nội dung mô tả
algorithm	DigestAlgorithm	DigestAlgorithm để sử dụng.
value	Byte[]	Một giá trị chuỗi đầu vào để tính toán một 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 đã chỉ định cho giá trị String đã chỉ định.

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

Các tham số

Tên	Loại	Nội dung mô tả
algorithm	DigestAlgorithm	DigestAlgorithm để sử dụng.
value	String	Một giá trị chuỗi đầu vào để tính toán một 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 cho giá trị String đã chỉ định với bộ ký tự đã cho.

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

Các tham số

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

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 bằng khoá đã cho.

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

Các tham số

Tên	Loại	Nội dung mô tả
value	Byte[]	Giá trị nhập 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 bằng khoá đã cho.

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

Các tham số

Tên	Loại	Nội dung mô tả
value	String	Giá trị nhập 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.
var signature = Utilities.computeHmacSha256Signature("this is my input",
                                                     "my key - use a stronger one",
                                                     Utilities.Charset.US_ASCII);
Logger.log(signature);

Các tham số

Tên	Loại	Nội dung mô tả
value	String	Giá trị nhập 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ự nhập.

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 điệp bằng thuật toán được chỉ định cho khoá và giá trị được chỉ định.

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

Các tham số

Tên	Loại	Nội dung mô tả
algorithm	MacAlgorithm	Thuật toán MacAlgorithm dùng để băm giá trị đầu vào.
value	Byte[]	Giá trị nhập 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 điệp bằng thuật toán được chỉ định cho khoá và giá trị được chỉ định.

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

Các tham số

Tên	Loại	Nội dung mô tả
algorithm	MacAlgorithm	Thuật toán MacAlgorithm dùng để băm giá trị đầu vào.
value	String	Giá trị nhập 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 điệp bằng thuật toán được chỉ định cho khoá và giá trị được chỉ định.

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

Các tham số

Tên	Loại	Nội dung mô tả
algorithm	MacAlgorithm	Thuật toán MacAlgorithm dùng để băm giá trị đầu vào.
value	String	Giá trị nhập 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ự nhập.

Cầu thủ trả bóng

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

---

computeRsaSha1Signature(value, key)

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

// This writes an array of bytes to the log.
var signature = Utilities.computeRsaSha1Signature("this is my input",
    "-----BEGIN PRIVATE KEY-----\nprivatekeyhere\n-----END PRIVATE KEY-----\n");
Logger.log(signature);

Các tham số

Tên	Loại	Nội dung mô tả
value	String	Giá trị nhập vào để tạo hàm băm.
key	String	Khoá ở định dạng PEM được 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ị đã cung cấp bằng RSA-SHA1 bằng khoá và bộ ký tự đã cho.

// This writes an array of bytes to the log.
var signature = Utilities.computeRsaSha1Signature("this is my input",
    "-----BEGIN PRIVATE KEY-----\nprivatekeyhere\n-----END PRIVATE KEY-----\n"
    Utilities.Charset.US_ASCII);
Logger.log(signature);

Các tham số

Tên	Loại	Nội dung mô tả
value	String	Giá trị nhập vào để tạo hàm băm.
key	String	Khoá ở định dạng PEM được dùng để tạo chữ ký.
charset	Charset	Charset đại diện cho bộ ký tự nhập.

Cầu thủ trả bóng

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

---

computeRsaSha256Signature(value, key)

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

// This writes an array of bytes to the log.
var signature = Utilities.computeRsaSha256Signature("this is my input",
    "-----BEGIN PRIVATE KEY-----\nprivatekeyhere\n-----END PRIVATE KEY-----\n");
Logger.log(signature);

Các tham số

Tên	Loại	Nội dung mô tả
value	String	Giá trị nhập vào để tạo hàm băm.
key	String	Khoá ở định dạng PEM được 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ị đã cung cấp bằng RSA-SHA256 bằng khoá đã cho.

// This writes an array of bytes to the log.
var signature = Utilities.computeRsaSha256Signature("this is my input",
    "-----BEGIN PRIVATE KEY-----\nprivatekeyhere\n-----END PRIVATE KEY-----\n");
Logger.log(signature);

Các tham số

Tên	Loại	Nội dung mô tả
value	String	Giá trị nhập vào để tạo hàm băm.
key	String	Khoá ở định dạng PEM được dùng để tạo chữ ký.
charset	Charset	Charset đại diện cho bộ ký tự nhập.

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ị đã cho bằng thuật toán RSA được chỉ định với khoá đã cho.

// This writes an array of bytes to the log.
var signature = Utilities.computeRsaSignature(Utilities.RsaAlgorithm.RSA_SHA_256,
    "this is my input",
    "-----BEGIN PRIVATE KEY-----\nprivatekeyhere\n-----END PRIVATE KEY-----\n");
Logger.log(signature);

Các tham số

Tên	Loại	Nội dung mô tả
algorithm	RsaAlgorithm	Thuật toán RsaAlgorithm dùng để băm giá trị đầu vào.
value	String	Giá trị nhập vào để tạo hàm băm.
key	String	Khoá ở định dạng PEM được 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ị đã cho bằng thuật toán RSA đã chỉ định với khoá và bộ ký tự cho trước.

// This writes an array of bytes to the log.
var signature = Utilities.computeRsaSignature(Utilities.RsaAlgorithm.RSA_SHA_256,
    "this is my input",
    "-----BEGIN PRIVATE KEY-----\nprivatekeyhere\n-----END PRIVATE KEY-----\n",
    Utilities.Charset.US_ASCII);
Logger.log(signature);

Các tham số

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

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 thông số kỹ thuật được mô tả trong lớp Java SE SimpleDateFormat. Vui lòng truy cập 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.
var formattedDate = Utilities.formatDate(new Date(), "GMT", "yyyy-MM-dd'T'HH:mm:ss'Z'");
Logger.log(formattedDate);

Các tham số

Tên	Loại	Nội dung 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	Đị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');

Các tham số

Tên	Loại	Nội dung 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 được đị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()). Không đảm bảo giá trị nhận dạng này là duy nhất trong mọi thời gian và không gian. Do đó, đừng sử dụng trong các trường hợp bắt buộc phải đả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.
var myDataObject = {
   tempId: Utilities.getUuid();
};

Cầu thủ trả bóng

String – Chuỗi đại diện cho mã nhận dạng duy nhất (UUID).

---

gzip(blob)

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

var textBlob = Utilities.newBlob("Some text to compress using gzip compression");

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

Các tham số

Tên	Loại	Nội dung mô tả
blob	BlobSource	Một đối tượng Blob cần 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 đã cung cấp rồi trả về dữ liệu đó trong một đối tượng Blob mới. Phiên bản này của phương thức cho phép chỉ định tên tệp.

var textBlob = Utilities.newBlob("Some text to compress using gzip compression");

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

Các tham số

Tên	Loại	Nội dung mô tả
blob	BlobSource	Một đối tượng Blob cần nén bằng gzip.
name	String	Tên của tệp gzip sẽ được 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 đối tượng Blob mới từ một mảng byte. Blob được sử dụng trong nhiều API Apps Script. API này 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());

Các tham số

Tên	Loại	Nội dung mô tả
data	Byte[]	Các byte của blob.

Cầu thủ trả bóng

Blob – Blob mới tạo.

---

newBlob(data, contentType)

Tạo đối tượng Blob mới từ một mảng byte và loại nội dung. Blob được sử dụng trong nhiều API Apps Script. API này 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());

Các tham số

Tên	Loại	Nội dung mô tả
data	Byte[]	Các byte của 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 đối tượng Blob mới từ một mảng byte, loại nội dung và tên. Blob được sử dụng trong nhiều API Apps Script. API này 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());

Các tham số

Tên	Loại	Nội dung mô tả
data	Byte[]	Các byte của 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 đối tượng Blob mới từ một chuỗi. Blob được sử dụng trong nhiều API Apps Script. API này 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());

Các tham số

Tên	Loại	Nội dung 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 đối tượng Blob mới từ một chuỗi và loại nội dung. Blob được sử dụng trong nhiều API Apps Script. API này 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());

Các tham số

Tên	Loại	Nội dung 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 đối tượng Blob mới từ một chuỗi, loại nội dung và tên. Blob được sử dụng trong nhiều API Apps Script. API này 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());

Các tham số

Tên	Loại	Nội dung 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 bảng biểu diễn mảng 2D của một chuỗi CSV.

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

Các tham số

Tên	Loại	Nội dung 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ảng hai chiều chứa các giá trị trong chuỗi CSV.

---

parseCsv(csv, delimiter)

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

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

Các tham số

Tên	Loại	Nội dung 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ả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 của 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 chuẩn Java. Để biết thêm thông tin, hãy xem lớp SimpleDateFormat trong Java.

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

Các tham số

Tên	Loại	Nội dung mô tả
date	String	Một 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 thông số kỹ thuật SimpleDateFormat.

Cầu thủ trả bóng

Date – Chuỗi nhập dưới dạng ngày.

---

sleep(milliseconds)

Ngủ trong số mili giây đã chỉ định. Ngay lập tức đặt tập lệnh vào chế độ 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());

Các tham số

Tên	Loại	Nội dung 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.

var textBlob = Utilities.newBlob("Some text to compress using gzip compression");

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

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

Các tham số

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

Cầu thủ trả bóng

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

---

unzip(blob)

Lấy một Blob biểu thị một tệp zip và trả về các tệp thành phần của tệp đó.

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

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

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

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

Các tham số

Tên	Loại	Nội dung mô tả
blob	BlobSource	Blob tệp zip.

Cầu thủ trả bóng

Blob[] – A 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 đối tượng Blob mới là tệp zip chứa dữ liệu từ Blobs đã được truyền vào.

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

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

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

Các tham số

Tên	Loại	Nội dung mô tả
blobs	BlobSource[]	Một dãy các giọt nước để nén lại.

Cầu thủ trả bóng

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

---

zip(blobs, name)

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

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

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

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

Các tham số

Tên	Loại	Nội dung mô tả
blobs	BlobSource[]	Một dãy các giọt nước để nén lại.
name	String	Tên của tệp zip cần tạo.

Cầu thủ trả bóng

Blob – Một đốm màu mới chứa các dữ liệu đầu vào dưới dạng một 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"}
var obj = Utilities.jsonParse('{"name":"John Smith","company":"Virginia Company"}');

Các tham số

Tên	Loại	Nội dung mô tả
jsonString	String	Chuỗi đại diện của một đối tượng JavaScript cần giải trình tự.

Cầu thủ trả bóng

Object – Biểu thị đối tượng JavaScript của 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"}
var person = { name: "John Smith", company: "Virginia Company" };
var json = Utilities.jsonStringify(person);
Logger.log(json);

Các tham số

Tên	Loại	Nội dung mô tả
obj	Object	đối tượng JavaScript để chuyển đổi tuần tự thành JSON

Cầu thủ trả bóng

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