Class Utilities

Phần mềm tiện ích

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

Thuộc tính

Thuộc tínhLoạiMô tả
CharsetCharset
DigestAlgorithmDigestAlgorithm
MacAlgorithmMacAlgorithm
RsaAlgorithmRsaAlgorithm

Phương thức

Phương thứcLoại 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 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 đã mã hoá an toàn trên web bằng base-64 thành một mảng byte UTF-8.
base64DecodeWebSafe(encoded, charset)Byte[]Giải mã một chuỗi đã mã hoá theo chuẩn cơ sở 64 được mã hoá thành một mảng byte trong một bộ ký tự cụ thể.
base64Encode(data)StringTạo một chuỗi mã hoá base-64 từ mảng byte đã cho.
base64Encode(data)StringTạo một chuỗi mã hoá base-64 từ chuỗi đã cho.
base64Encode(data, charset)StringTạo một chuỗi mã hoá base-64 từ chuỗi đã cho trong một bộ ký tự cụ thể.
base64EncodeWebSafe(data)StringTạo một chuỗi được mã hoá an toàn trên web base-64 từ mảng byte đã cho.
base64EncodeWebSafe(data)StringTạo một chuỗi được mã hoá theo chuẩn base-64 trên web từ chuỗi đã cho.
base64EncodeWebSafe(data, charset)StringTạo một chuỗi mã hoá theo chuẩn base-64 trên 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 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 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 thuật toán đã chỉ định trên giá trị String được chỉ định với giá trị bộ ký tự nhất định.
computeHmacSha256Signature(value, key)Byte[]Ký giá trị đã cho bằng HMAC-SHA256 với khoá đã cho.
computeHmacSha256Signature(value, key)Byte[]Ký giá trị đã cho bằng HMAC-SHA256 với khoá đã cho.
computeHmacSha256Signature(value, key, charset)Byte[]Ký giá trị đã cho 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 cách sử dụng thuật toán được chỉ định trên khoá được chỉ định và giá trị.
computeHmacSignature(algorithm, value, key)Byte[]Tính toán mã xác thực thông báo bằng cách sử dụng thuật toán được chỉ định trên khoá được chỉ định và giá trị.
computeHmacSignature(algorithm, value, key, charset)Byte[]Tính toán mã xác thực thông báo bằng cách sử dụng thuật toán được chỉ định trên khoá được chỉ định và giá trị.
computeRsaSha1Signature(value, key)Byte[]Ký giá trị đã cho bằng RSA-SHA1 với khoá đã cho.
computeRsaSha1Signature(value, key, charset)Byte[]Ký giá trị đã cho bằng RSA-SHA1 với khoá và bộ ký tự đã cho.
computeRsaSha256Signature(value, key)Byte[]Ký giá trị đã cho bằng RSA-SHA256 với khoá đã cho.
computeRsaSha256Signature(value, key, charset)Byte[]Ký giá trị đã cho bằng RSA-SHA256 với 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 được 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 Java SE SimpleDateFormat.
formatString(template, args)StringThực hiện định dạng chuỗi giống sprintf bằng cách sử dụng các chuỗi định dạng kiểu '%'.
getUuid()StringLấy mã nhận dạng duy nhất (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)Blobgzip nén dữ liệu Blob được cung cấp và trả về dữ liệu đó trong đối tượng Blob mới.
gzip(blob, name)Blobgzip nén dữ liệu Blob được cung cấp và trả về dữ liệu đó trong đối tượng Blob mới.
newBlob(data)BlobTạo một đối tượng Blob mới từ một mảng byte.
newBlob(data, contentType)BlobTạ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)BlobTạ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)BlobTạo một đối tượng Blob mới từ một chuỗi.
newBlob(data, contentType)BlobTạo một đối tượng Blob mới qua một chuỗi và loại nội dung.
newBlob(data, contentType, name)BlobTạo một đối tượng Blob mới từ chuỗi, loại nội dung và tên.
parseCsv(csv)String[][]Trả về một mảng 2D biểu diễn dưới dạng bảng 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 cách sử dụng dấu phân tách tuỳ chỉnh.
parseDate(date, timeZone, format)DatePhân tích cú pháp chuỗi ngày được cung cấp theo thông số kỹ thuật được mô tả trong Tiêu chuẩn Java Lớp SimpleDateFormat của phiên bản.
sleep(milliseconds)voidNgủ trong số mili giây được chỉ định.
ungzip(blob)BlobGiải nén đối tượng Blob và trả về Blob chứa đối tượng không nén .
unzip(blob)Blob[]Lấy một Blob đại diện cho một tệp zip và trả về các tệp thành phần của tệp đó.
zip(blobs)BlobTạo một đố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)BlobTạo một đối tượng Blob mới là tệp zip chứa dữ liệu từ Blobs đượ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());

Tham số

TênLoạiMô tả
encodedStringMột mảng byte dữ liệu để 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 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());

Tham số

TênLoạiMô tả
encodedStringChuỗi dữ liệu cần giải mã.
charsetCharsetCharset chỉ định bộ ký tự đầu vào.

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 đã mã hoá theo chuẩn cơ sở 64 được mã hoá 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());

Tham số

TênLoạiMô tả
encodedStringMộ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ố đã mã hoá an toàn trên web base-64 dưới dạng một mảng byte.


base64DecodeWebSafe(encoded, charset)

Giải mã một chuỗi đã mã hoá theo chuẩn cơ sở 64 được mã hoá 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());

Tham số

TênLoạiMô tả
encodedStringChuỗi dữ liệu an toàn cho web cần giải mã.
charsetCharsetCharset chỉ định bộ ký tự đầu vào.

Cầu thủ trả bóng

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


base64Encode(data)

Tạo một chuỗi mã hoá base-64 từ mảng byte đã cho. Base 64 là chế độ mã hoá phổ biến được nhiều công cụ chấp nhận, không thể chấp nhận dữ liệu nhị phân. Base 64 thường được dùng trong giao thức Internet 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);

Tham số

TênLoạiMô tả
dataByte[]Một byte[] dữ liệu cần mã hoá.

Cầu thủ trả bóng

String — Bản trình bày được mã hoá base-64 của dữ liệu được truyền.


base64Encode(data)

Tạo một chuỗi mã hoá base-64 từ chuỗi đã cho. Base 64 là phương thức mã hoá phổ biến được chấp nhận bằng nhiều công cụ không thể chấp nhận dữ liệu nhị phân. Base 64 thường được dùng trong Internet 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);

Tham số

TênLoạiMô tả
dataStringChuỗi cần mã hoá.

Cầu thủ trả bóng

String – Đại diện được mã hoá base-64 của chuỗi đầu vào.


base64Encode(data, charset)

Tạo một chuỗi mã hoá base-64 từ chuỗi đã cho trong một bộ ký tự cụ thể. Một bộ ký tự là phương pháp mã hoá các ký tự để có thể mã hoá chúng. Những việc này thường được thực hiện trong 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. Người nhận làm cho dữ liệu tương thích, chúng thường được mã hoá thành base 64, là chế độ mã hoá phổ biến được chấp nhận bởi nhiều công cụ không thể chấp nhận dữ liệu nhị phân. Base 64 thường được dùng trong giao thức Internet 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);

Tham số

TênLoạiMô tả
dataStringChuỗi dữ liệu cần mã hoá.
charsetCharsetCharset chỉ định bộ ký tự đầu vào.

Cầu thủ trả bóng

String – Giá trị đại diện được mã hoá base-64 của chuỗi đầu vào bằng Charset đã cho.


base64EncodeWebSafe(data)

Tạo một chuỗi được mã hoá an toàn trên web base-64 từ mảng byte đã cho. Base 64 là một chế độ cài đặt phổ biến mã hoá được nhiều công cụ chấp nhận, không thể chấp nhận dữ liệu nhị phân. Base 64 an toàn trên web là thường được sử dụng trong các giao thức Internet 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.base64EncodeWebSafe(blob.getBytes());
Logger.log(encoded);

Tham số

TênLoạiMô tả
dataByte[]Một mảng byte dữ liệu để mã hoá.

Cầu thủ trả bóng

String — Bản trình bày được mã hoá theo cách an toàn trên web theo chuẩn base-64 của dữ liệu được truyền.


base64EncodeWebSafe(data)

Tạo một chuỗi được mã hoá theo chuẩn base-64 trên web từ chuỗi đã cho. Base 64 là chế độ mã hoá phổ biến được chấp nhận bởi 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 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);

Tham số

TênLoạiMô tả
dataStringChuỗi cần mã hoá.

Cầu thủ trả bóng

String – Giá trị đại diện được mã hoá theo cách an toàn trên web theo chuẩn base-64 của chuỗi đầu vào.


base64EncodeWebSafe(data, charset)

Tạo một chuỗi mã hoá theo chuẩn base-64 trên web từ chuỗi đã cho trong một bộ ký tự cụ thể. Bộ ký tự là một phương pháp mã hoá các ký tự để có thể mã hoá các ký tự đó. Đây thường là đượ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ố quá trình truyền dữ liệu giao thức. Để dữ liệu tương thích, các mã này thường được mã hoá thành base 64, là mã hoá phổ biến được nhiều công cụ chấp nhận mà không thể chấp nhận dữ liệu nhị phân. An toàn trên web theo tiêu chuẩn Base 64 thường được sử dụng trong các giao thức Internet 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);

Tham số

TênLoạiMô tả
dataStringChuỗi dữ liệu cần mã hoá.
charsetCharsetCharset chỉ định bộ ký tự đầu vào.

Cầu thủ trả bóng

String – Giá trị đại diện được mã hoá theo cách an toàn trên web theo chuẩn base-64 của chuỗi đầu vào bằng Charset đã cho.


computeDigest(algorithm, value)

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

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

Tham số

TênLoạiMô tả
algorithmDigestAlgorithmMột DigestAlgorithm để sử dụng.
valueByte[]Một 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 thuật toán được chỉ định trên giá trị String được chỉ định.

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

Tham số

TênLoạiMô tả
algorithmDigestAlgorithmMột DigestAlgorithm để sử dụng.
valueStringMột 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 thuật toán được chỉ định trên giá trị String được chỉ định với phương thức bộ ký tự nhất định.

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

Tham số

TênLoạiMô tả
algorithmDigestAlgorithmMột DigestAlgorithm để sử dụng.
valueStringMột giá trị chuỗi đầu vào để tính toán chuỗi đại diện.
charsetCharsetCharset đạ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ị đã cho bằng HMAC-SHA256 với 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);

Tham số

TênLoạiMô tả
valueByte[]Giá trị đầu vào để tạo hàm băm.
keyByte[]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ị đã cho bằng HMAC-SHA256 với 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);

Tham số

TênLoạiMô tả
valueStringGiá trị đầu vào để tạo hàm băm.
keyStringKhoá 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ị đã cho 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);

Tham số

TênLoạiMô tả
valueStringGiá trị đầu vào để tạo hàm băm.
keyStringKhoá dùng để tạo hàm băm.
charsetCharsetCharset đạ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 cách sử dụng thuật toán được chỉ định trên khoá được chỉ định và giá trị.

// 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);

Tham số

TênLoạiMô tả
algorithmMacAlgorithmThuật toán MacAlgorithm dùng để băm giá trị đầu vào.
valueByte[]Giá trị đầu vào để tạo hàm băm.
keyByte[]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 cách sử dụng thuật toán được chỉ định trên khoá được chỉ định và giá trị.

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

Tham số

TênLoạiMô tả
algorithmMacAlgorithmThuật toán MacAlgorithm dùng để băm giá trị đầu vào.
valueStringGiá trị đầu vào để tạo hàm băm.
keyStringKhoá 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 cách sử dụng thuật toán được chỉ định trên khoá được chỉ định và giá trị.

// 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);

Tham số

TênLoạiMô tả
algorithmMacAlgorithmThuật toán MacAlgorithm dùng để băm giá trị đầu vào.
valueStringGiá trị đầu vào để tạo hàm băm.
keyStringKhoá dùng để tạo hàm băm.
charsetCharsetCharset đạ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ị đã cho bằng RSA-SHA1 với 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);

Tham số

TênLoạiMô tả
valueStringGiá trị đầu vào để tạo hàm băm.
keyStringKhoá có đị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ị đã cho bằng RSA-SHA1 với 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);

Tham số

TênLoạiMô tả
valueStringGiá trị đầu vào để tạo hàm băm.
keyStringKhoá có định dạng PEM dùng để tạo chữ ký.
charsetCharsetCharset đạ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ị đã cho bằng RSA-SHA256 với 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);

Tham số

TênLoạiMô tả
valueStringGiá trị đầu vào để tạo hàm băm.
keyStringKhoá có đị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ị đã cho bằng RSA-SHA256 với 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);

Tham số

TênLoạiMô tả
valueStringGiá trị đầu vào để tạo hàm băm.
keyStringKhoá có định dạng PEM dùng để tạo chữ ký.
charsetCharsetCharset đạ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ị đã 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);

Tham số

TênLoạiMô tả
algorithmRsaAlgorithmThuật toán RsaAlgorithm dùng để băm giá trị đầu vào.
valueStringGiá trị đầu vào để tạo hàm băm.
keyStringKhoá có đị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ị đã cho bằng thuật toán RSA được chỉ định với khoá và bộ ký tự đã 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",
    Utilities.Charset.US_ASCII);
Logger.log(signature);

Tham số

TênLoạiMô tả
algorithmRsaAlgorithmThuật toán RsaAlgorithm dùng để băm giá trị đầu vào.
valueStringGiá trị đầu vào để tạo hàm băm.
keyStringKhoá có định dạng PEM dùng để tạo chữ ký.
charsetCharsetCharset đạ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 Java SE SimpleDateFormat. Năn nỉ hãy 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.
var formattedDate = Utilities.formatDate(new Date(), "GMT", "yyyy-MM-dd'T'HH:mm:ss'Z'");
Logger.log(formattedDate);

Tham số

TênLoạiMô tả
dateDateDate để định dạng dưới dạng Chuỗi.
timeZoneStringMúi giờ đầu ra của kết quả.
formatStringĐịnh dạng theo thông số kỹ thuật SimpleDateFormat.

Cầu thủ trả bóng

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


formatString(template, args)

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

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

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

Tham số

TênLoạiMô tả
templateStringChuỗi định dạng kiểm soát dữ liệu được trả về.
argsObject...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 mã nhận dạng duy nhất (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 đảm bảo là riêng biệt trên mọi lúc, mọi nơi. Do đó, đừng sử dụng thuộc tính này trong trường hợp cần 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 – Một chuỗi đại diện cho mã nhận dạng duy nhất (UUID).


gzip(blob)

gzip nén dữ liệu Blob được cung cấp và trả về dữ liệu đó trong đố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);

Tham số

TênLoạiMô tả
blobBlobSourceĐố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 được cung cấp và trả về dữ liệu đó trong đố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");

Tham số

TênLoạiMô tả
blobBlobSourceĐối tượng Blob cần nén bằng gzip.
nameStringTê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 một đối tượng Blob mới từ một mảng byte. Blob được sử dụng trong nhiều API Apps Script thực hiệ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ênLoạiMô tả
dataByte[]Các 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 sử dụng trong nhiều Apps Script Các API lấy dữ liệu nhị phân làm đầ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ênLoạiMô tả
dataByte[]Các byte cho blob.
contentTypeStringLoạ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 ứng dụng Các API tập lệnh 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ênLoạiMô tả
dataByte[]Các byte cho blob.
contentTypeString– Loại nội dung của blob – có thể là null.
nameStringTê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 sử dụng trong nhiều API Apps Script thực hiệ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ênLoạiMô tả
dataStringChuỗi cho blob, được 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 qua một chuỗi và loại nội dung. Blob được sử dụng trong nhiều Apps Script Các API lấy dữ liệu nhị phân làm đầ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ênLoạiMô tả
dataStringChuỗi cho blob, được giả định là UTF-8.
contentTypeStringLoạ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ừ chuỗi, loại nội dung và tên. Blob được dùng trong nhiều ứng dụng Các API tập lệnh 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ênLoạiMô tả
dataStringChuỗi cho blob, được giả định là UTF-8.
contentTypeStringLoại nội dung của blob – có thể là null.
nameStringTê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 biểu diễn dưới dạng bảng 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);

Tham số

TênLoạiMô tả
csvStringChuỗi chứa dữ liệu đơn lẻ hoặc nhiều dòng trong 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 cách sử dụ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');

Tham số

TênLoạiMô tả
csvStringChuỗi chứa dữ liệu đơn lẻ hoặc nhiều dòng trong giá trị được phân tách bằng dấu phẩy (CSV) .
delimiterCharGiữ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 chuỗi ngày được cung cấp theo thông số kỹ thuật được mô tả trong Tiêu chuẩn Java Lớp SimpleDateFormat của phiên bản. Để 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.
var date = Utilities.parseDate("1970-01-01 00:00:00", "GMT", "yyyy-MM-dd' 'HH:mm:ss");
Logger.log(date);

Tham số

TênLoạiMô tả
dateStringGiá trị chuỗi để phân tích cú pháp dưới dạng ngày.
timeZoneStringMúi giờ đầu ra.
formatStringĐịnh dạng ngày theo quy cách SimpleDateFormat.

Cầu thủ trả bóng

Date — Chuỗi nhập ở dạng ngày.


sleep(milliseconds)

Ngủ trong số mili giây được chỉ định. Ngay lập tức đặt tập lệnh vào chế độ ngủ cho mili giây được 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ênLoạiMô tả
millisecondsIntegerSố mili giây ngủ.

ungzip(blob)

Giải nén đối tượng Blob và trả về Blob chứa đối tượng không 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);

Tham số

TênLoạiMô tả
blobBlobSourceBlob 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 đại diện cho 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);

Tham số

TênLoạiMô tả
blobBlobSourceBlob 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 mã zip.


zip(blobs)

Tạo một đố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]);

Tham số

TênLoạiMô tả
blobsBlobSource[]Một loạt các blob cần 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 một 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ừ Blobs được truyền vào. Chiến dịch này phiên bản của phương thức 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");

Tham số

TênLoạiMô tả
blobsBlobSource[]Một loạt các blob cần nén.
nameStringTên của tệp zip sẽ được 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 một tệp lưu trữ.

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