Class Utilities

實用工具

這項服務提供公用程式編碼/解碼、日期格式、JSON 操作、 和其他雜訊

屬性

屬性	類型	說明
Charset	Charset
DigestAlgorithm	DigestAlgorithm
MacAlgorithm	MacAlgorithm
RsaAlgorithm	RsaAlgorithm

方法

方法	傳回類型	簡短說明
base64Decode(encoded)	Byte[]	將 Base-64 編碼字串解碼為 UTF-8 位元組陣列。
base64Decode(encoded, charset)	Byte[]	將 base-64 編碼字串解碼成特定字元集的位元組陣列。
base64DecodeWebSafe(encoded)	Byte[]	將 Base-64 網路安全編碼字串解碼為 UTF-8 位元組陣列。
base64DecodeWebSafe(encoded, charset)	Byte[]	將 base-64 網路安全編碼字串解碼，成為特定字元集的位元組陣列。
base64Encode(data)	String	從指定的位元組陣列產生 Base-64 編碼字串。
base64Encode(data)	String	從指定字串產生 Base-64 編碼字串。
base64Encode(data, charset)	String	從特定字元集內的指定字串，產生 Base-64 編碼字串。
base64EncodeWebSafe(data)	String	從指定的位元組陣列產生 Base-64 網頁安全編碼字串。
base64EncodeWebSafe(data)	String	從指定字串產生 Base-64 網頁安全編碼字串。
base64EncodeWebSafe(data, charset)	String	以特定字元集內的指定字串，產生 base-64 網路安全編碼字串。
computeDigest(algorithm, value)	Byte[]	對指定 Byte[] 值使用指定的演算法計算摘要。
computeDigest(algorithm, value)	Byte[]	對指定 String 值使用指定的演算法計算摘要。
computeDigest(algorithm, value, charset)	Byte[]	以指定的 String 值，使用指定的演算法計算摘要，並加上 指定的字元集
computeHmacSha256Signature(value, key)	Byte[]	使用 HMAC-SHA256 搭配指定金鑰簽署提供的值。
computeHmacSha256Signature(value, key)	Byte[]	使用 HMAC-SHA256 搭配指定金鑰簽署提供的值。
computeHmacSha256Signature(value, key, charset)	Byte[]	使用 HMAC-SHA256 搭配指定鍵和字元集簽署提供的值。
computeHmacSignature(algorithm, value, key)	Byte[]	對指定金鑰使用指定的演算法，計算訊息驗證碼，並 值。
computeHmacSignature(algorithm, value, key)	Byte[]	對指定金鑰使用指定的演算法，計算訊息驗證碼，並 值。
computeHmacSignature(algorithm, value, key, charset)	Byte[]	對指定金鑰使用指定的演算法，計算訊息驗證碼，並 值。
computeRsaSha1Signature(value, key)	Byte[]	使用 RSA-SHA1 搭配指定金鑰簽署提供的值。
computeRsaSha1Signature(value, key, charset)	Byte[]	使用 RSA-SHA1 搭配指定鍵和字元集簽署提供的值。
computeRsaSha256Signature(value, key)	Byte[]	使用 RSA-SHA256 搭配指定金鑰簽署提供的值。
computeRsaSha256Signature(value, key, charset)	Byte[]	使用 RSA-SHA256 搭配指定金鑰簽署提供的值。
computeRsaSignature(algorithm, value, key)	Byte[]	使用指定的 RSA 演算法搭配指定金鑰簽署指定值。
computeRsaSignature(algorithm, value, key, charset)	Byte[]	使用指定的 RSA 演算法搭配特定鍵和字元集，簽署指定值。
formatDate(date, timeZone, format)	String	根據 Java SE SimpleDateFormat 類別所述的規格設定日期格式。
formatString(template, args)	String	使用「%」樣式字串執行類似 sprintf 的字串格式。
getUuid()	String	以字串形式取得 UUID (相當於使用 java.util.UUID.randomUUID() 方法)。
gzip(blob)	Blob	gzip 會壓縮提供的 Blob 資料，並在新的 Blob 物件中傳回。
gzip(blob, name)	Blob	gzip 會壓縮提供的 Blob 資料，並在新的 Blob 物件中傳回。
newBlob(data)	Blob	使用位元組陣列建立新的 Blob 物件。
newBlob(data, contentType)	Blob	從位元組陣列和內容類型建立新的 Blob 物件。
newBlob(data, contentType, name)	Blob	從位元組陣列、內容類型和名稱建立新的 Blob 物件。
newBlob(data)	Blob	從字串建立新的 Blob 物件。
newBlob(data, contentType)	Blob	從字串和內容類型建立新的 Blob 物件。
newBlob(data, contentType, name)	Blob	使用字串、內容類型和名稱建立新的 Blob 物件。
parseCsv(csv)	String[][]	傳回 CSV 字串的表格式 2D 陣列。
parseCsv(csv, delimiter)	String[][]	使用自訂分隔符號傳回 CSV 字串的表格 2D 陣列表示法。
parseDate(date, timeZone, format)	Date	根據 Java 標準中所述的規格剖析指定字串日期 版本 SimpleDateFormat 類別。
sleep(milliseconds)	void	休眠數 (以毫秒為單位)。
ungzip(blob)	Blob	解壓縮 Blob 物件並傳回包含未壓縮的 Blob 資料。
unzip(blob)	Blob[]	取用代表 ZIP 檔案的 Blob，並傳回其元件檔案。
zip(blobs)	Blob	建立新的 Blob 物件，該物件為 ZIP 檔案，內含所傳入的 Blob 資料。
zip(blobs, name)	Blob	建立新的 Blob 物件，該物件為 ZIP 檔案，內含所傳入的 Blob 資料。

已淘汰的方法

方法	傳回類型	簡短說明
jsonParse(jsonString)	Object	傳回與傳入 JSON 字串相對應的物件。
jsonStringify(obj)	String	傳回傳入物件的 JSON 字串。

內容詳盡的說明文件

base64Decode(encoded)

將 Base-64 編碼字串解碼為 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());

參數

名稱	類型	說明
encoded	String	要解碼的資料位元組陣列。

回攻員

Byte[] — 以 Base-64 編碼引數表示為位元組陣列的原始資料。

---

base64Decode(encoded, charset)

將 base-64 編碼字串解碼成特定字元集的位元組陣列。

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

參數

名稱	類型	說明
encoded	String	要解碼的資料字串。
charset	Charset	Charset 用於指定輸入內容的字元集。

回攻員

Byte[] — 以 Base-64 編碼引數表示為位元組陣列的原始資料。

---

base64DecodeWebSafe(encoded)

將 Base-64 網路安全編碼字串解碼為 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());

參數

名稱	類型	說明
encoded	String	要解碼的網路安全資料位元組陣列。

回攻員

Byte[]：以 Base-64 網路安全編碼引數表示的原始資料，做為位元組陣列。

---

base64DecodeWebSafe(encoded, charset)

將 base-64 網路安全編碼字串解碼，成為特定字元集的位元組陣列。

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

參數

名稱	類型	說明
encoded	String	要解碼的網路安全資料字串。
charset	Charset	Charset 用於指定輸入內容的字元集。

回攻員

Byte[]：以 Base-64 網路安全編碼引數表示的原始資料，做為位元組陣列。

---

base64Encode(data)

從指定的位元組陣列產生 Base-64 編碼字串。Base64 也是常見的編碼方式 許多無法接受二進位資料的工具都接受。Base64 常用於 例如電子郵件、HTTP 或 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);

參數

名稱	類型	說明
data	Byte[]	要編碼的資料位元組 []。

回攻員

String — 以 Base-64 編碼表示傳入的資料。

---

base64Encode(data)

從指定字串產生 Base-64 編碼字串。Base64 是可接受的通用編碼 各種無法接受二進位資料的工具產生。Base64 常用於網際網路 通訊協定 (例如電子郵件、HTTP) 或 XML 文件中

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

參數

名稱	類型	說明
data	String	要編碼的字串。

回攻員

String：輸入字串的 Base-64 編碼表示法。

---

base64Encode(data, charset)

從特定字元集內的指定字串，產生 Base-64 編碼字串。字元集 是一種編碼字元，以便加以編碼的方式。這類動作通常會在 二進位格式，這類格式通常與某些資料傳輸通訊協定不相容。目的地： 使資料相容，它們通常會被編碼為 base 64，這是一個常見的編碼方式 許多無法接受二進位資料的工具都接受。Base64 常用於 例如電子郵件、HTTP 或 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);

參數

名稱	類型	說明
data	String	要編碼的資料字串。
charset	Charset	Charset 用於指定輸入內容的字元集。

回攻員

String：以 Base-64 編碼表示含有指定 Charset 的輸入字串。

---

base64EncodeWebSafe(data)

從指定的位元組陣列產生 Base-64 網頁安全編碼字串。Base64 是常見的 各類型工具接受的編碼。Base64 網路安全是 通常用於電子郵件、HTTP 或 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);

參數

名稱	類型	說明
data	Byte[]	要編碼的資料位元組陣列。

回攻員

String：傳入資料的 Base-64 網頁安全編碼表示法。

---

base64EncodeWebSafe(data)

從指定字串產生 Base-64 網頁安全編碼字串。Base64 也是常見的編碼方式 許多無法接受二進位資料的工具都接受。Base64 可以確保網路安全 用於電子郵件、HTTP 等網際網路通訊協定，或用於 XML 文件。

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

參數

名稱	類型	說明
data	String	要編碼的字串。

回攻員

String：輸入字串的 Base-64 網路安全編碼表示法。

---

base64EncodeWebSafe(data, charset)

以特定字元集內的指定字串，產生 base-64 網路安全編碼字串。 Charset 是將字元編碼的方式，以便加以編碼。這類事件通常會 是以二進位格式執行，且通常可能與某些資料傳輸不相容 通訊協定為使資料相容，系統通常會將兩者編碼為 base 64，也就是 各種無法接受二進位資料的工具接受的通用編碼。適用於網路安全的 Base64 通常用於電子郵件、HTTP 或 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);

參數

名稱	類型	說明
data	String	要編碼的資料字串。
charset	Charset	Charset 用於指定輸入內容的字元集。

回攻員

String：採用 Base-64 網路安全編碼的輸入字串，代表具有指定的 Charset 的輸入字串。

---

computeDigest(algorithm, value)

對指定 Byte[] 值使用指定的演算法計算摘要。

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

參數

名稱	類型	說明
algorithm	DigestAlgorithm	要使用的 DigestAlgorithm。
value	Byte[]	要計算摘要的輸入字串值。

回攻員

Byte[] — 代表輸出摘要的 byte[]。

---

computeDigest(algorithm, value)

對指定 String 值使用指定的演算法計算摘要。

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

參數

名稱	類型	說明
algorithm	DigestAlgorithm	要使用的 DigestAlgorithm。
value	String	要計算摘要的輸入字串值。

回攻員

Byte[] — 代表輸出摘要的 byte[]。

---

computeDigest(algorithm, value, charset)

以指定的 String 值，使用指定的演算法計算摘要，並加上 指定的字元集

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

參數

名稱	類型	說明
algorithm	DigestAlgorithm	要使用的 DigestAlgorithm。
value	String	要計算摘要的輸入字串值。
charset	Charset	代表輸入字元集的 Charset。

回攻員

Byte[] — 代表輸出摘要的 byte[]。

---

computeHmacSha256Signature(value, key)

使用 HMAC-SHA256 搭配指定金鑰簽署提供的值。

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

參數

名稱	類型	說明
value	Byte[]	要產生雜湊的輸入值。
key	Byte[]	用於產生雜湊的鍵。

回攻員

Byte[] — 代表輸出簽章的 byte[]。

---

computeHmacSha256Signature(value, key)

使用 HMAC-SHA256 搭配指定金鑰簽署提供的值。

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

參數

名稱	類型	說明
value	String	要產生雜湊的輸入值。
key	String	用於產生雜湊的鍵。

回攻員

Byte[] — 代表輸出簽章的 byte[]。

---

computeHmacSha256Signature(value, key, charset)

使用 HMAC-SHA256 搭配指定鍵和字元集簽署提供的值。

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

參數

名稱	類型	說明
value	String	要產生雜湊的輸入值。
key	String	用於產生雜湊的鍵。
charset	Charset	代表輸入字元集的 Charset。

回攻員

Byte[] — 代表輸出簽章的 byte[]。

---

computeHmacSignature(algorithm, value, key)

對指定金鑰使用指定的演算法，計算訊息驗證碼，並 值。

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

參數

名稱	類型	說明
algorithm	MacAlgorithm	用於將輸入值雜湊的 MacAlgorithm 演算法。
value	Byte[]	要產生雜湊的輸入值。
key	Byte[]	用於產生雜湊的鍵。

回攻員

Byte[] — 代表輸出簽章的 byte[]。

---

computeHmacSignature(algorithm, value, key)

對指定金鑰使用指定的演算法，計算訊息驗證碼，並 值。

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

參數

名稱	類型	說明
algorithm	MacAlgorithm	用於將輸入值雜湊的 MacAlgorithm 演算法。
value	String	要產生雜湊的輸入值。
key	String	用於產生雜湊的鍵。

回攻員

Byte[] — 代表輸出簽章的 byte[]。

---

computeHmacSignature(algorithm, value, key, charset)

對指定金鑰使用指定的演算法，計算訊息驗證碼，並 值。

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

參數

名稱	類型	說明
algorithm	MacAlgorithm	用於將輸入值雜湊的 MacAlgorithm 演算法。
value	String	要產生雜湊的輸入值。
key	String	用於產生雜湊的鍵。
charset	Charset	代表輸入字元集的 Charset。

回攻員

Byte[] — 代表輸出簽章的 byte[]。

---

computeRsaSha1Signature(value, key)

使用 RSA-SHA1 搭配指定金鑰簽署提供的值。

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

參數

名稱	類型	說明
value	String	要產生雜湊的輸入值。
key	String	用於產生簽章的 PEM 格式金鑰。

回攻員

Byte[] — 代表輸出簽章的 byte[]。

---

computeRsaSha1Signature(value, key, charset)

使用 RSA-SHA1 搭配指定鍵和字元集簽署提供的值。

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

參數

名稱	類型	說明
value	String	要產生雜湊的輸入值。
key	String	用於產生簽章的 PEM 格式金鑰。
charset	Charset	代表輸入字元集的 Charset。

回攻員

Byte[] — 代表輸出簽章的 byte[]。

---

computeRsaSha256Signature(value, key)

使用 RSA-SHA256 搭配指定金鑰簽署提供的值。

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

參數

名稱	類型	說明
value	String	要產生雜湊的輸入值。
key	String	用於產生簽章的 PEM 格式金鑰。

回攻員

Byte[] — 代表輸出簽章的 byte[]。

---

computeRsaSha256Signature(value, key, charset)

使用 RSA-SHA256 搭配指定金鑰簽署提供的值。

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

參數

名稱	類型	說明
value	String	要產生雜湊的輸入值。
key	String	用於產生簽章的 PEM 格式金鑰。
charset	Charset	代表輸入字元集的 Charset。

回攻員

Byte[] — 代表輸出簽章的 byte[]。

---

computeRsaSignature(algorithm, value, key)

使用指定的 RSA 演算法搭配指定金鑰簽署指定值。

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

參數

名稱	類型	說明
algorithm	RsaAlgorithm	用於將輸入值雜湊的 RsaAlgorithm 演算法。
value	String	要產生雜湊的輸入值。
key	String	用於產生簽章的 PEM 格式金鑰。

回攻員

Byte[] — 代表輸出簽章的 byte[]。

---

computeRsaSignature(algorithm, value, key, charset)

使用指定的 RSA 演算法搭配特定鍵和字元集，簽署指定值。

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

參數

名稱	類型	說明
algorithm	RsaAlgorithm	用於將輸入值雜湊的 RsaAlgorithm 演算法。
value	String	要產生雜湊的輸入值。
key	String	用於產生簽章的 PEM 格式金鑰。
charset	Charset	代表輸入字元集的 Charset。

回攻員

Byte[] — 代表輸出簽章的 byte[]。

---

formatDate(date, timeZone, format)

根據 Java SE SimpleDateFormat 類別所述的規格設定日期格式。請 請參閱 的規格 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);

參數

名稱	類型	說明
date	Date	將 Date 格式化為字串的 Date。
timeZone	String	結果的輸出時區。
format	String	符合 SimpleDateFormat 規格的格式。

回攻員

String：以格式化字串表示的輸入日期。

---

formatString(template, args)

使用「%」樣式字串執行類似 sprintf 的字串格式。

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

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

參數

名稱	類型	說明
template	String	用於控管傳回內容的格式字串。
args	Object...	用來填入「%」的物件預留位置。

回攻員

String：格式化字串。

---

getUuid()

以字串形式取得 UUID (相當於使用 java.util.UUID.randomUUID() 方法)。這個 ID 不保證在 讓所有人員都能找到需要的資訊因此，請勿在需要保證不重複性的情況下使用。

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

回攻員

String：UUID 的字串表示方式。

---

gzip(blob)

gzip 會壓縮提供的 Blob 資料，並在新的 Blob 物件中傳回。

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

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

參數

名稱	類型	說明
blob	BlobSource	使用 gzip 壓縮的 Blob 物件。

回攻員

Blob：包含壓縮資料的新 Blob。

---

gzip(blob, name)

gzip 會壓縮提供的 Blob 資料，並在新的 Blob 物件中傳回。這個版本的方法允許指定檔案名稱。

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

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

參數

名稱	類型	說明
blob	BlobSource	使用 gzip 壓縮的 Blob 物件。
name	String	要建立的 gzip 檔案名稱。

回攻員

Blob：包含壓縮資料的新 Blob。

---

newBlob(data)

使用位元組陣列建立新的 Blob 物件。Blob 用於許多 Apps Script API， 做為輸入內容

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

參數

名稱	類型	說明
data	Byte[]	blob 的位元組。

回攻員

Blob：新建立的 Blob。

---

newBlob(data, contentType)

從位元組陣列和內容類型建立新的 Blob 物件。許多 Apps Script 都使用 Blob 將二進位資料做為輸入內容的 API。

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

參數

名稱	類型	說明
data	Byte[]	blob 的位元組。
contentType	String	blob 的內容類型 - 可以是 null。

回攻員

Blob：新建立的 Blob。

---

newBlob(data, contentType, name)

從位元組陣列、內容類型和名稱建立新的 Blob 物件。許多應用程式都使用 blob 採用二進位資料做為輸入內容的指令碼 API。

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

參數

名稱	類型	說明
data	Byte[]	blob 的位元組。
contentType	String	- blob 的內容類型 - 可以是 null。
name	String	blob 的名稱：可以是 null。

回攻員

Blob：新建立的 Blob。

---

newBlob(data)

從字串建立新的 Blob 物件。Blob 用於許多 Apps Script API， 做為輸入內容

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

參數

名稱	類型	說明
data	String	blob 字串，假設為 UTF-8。

回攻員

Blob：新建立的 Blob。

---

newBlob(data, contentType)

使用字串和內容類型建立新的 Blob 物件。許多 Apps Script 都使用 Blob 將二進位資料做為輸入內容的 API。

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

參數

名稱	類型	說明
data	String	blob 字串，假設為 UTF-8。
contentType	String	blob 的內容類型 - 可以是 null。

回攻員

Blob：新建立的 Blob。

---

newBlob(data, contentType, name)

使用字串、內容類型和名稱建立新的 Blob 物件。許多應用程式都使用 blob 採用二進位資料做為輸入內容的指令碼 API。

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

參數

名稱	類型	說明
data	String	blob 字串，假設為 UTF-8。
contentType	String	blob 的內容類型 - 可以是 null。
name	String	blob 的名稱：可以是 null。

回攻員

Blob：新建立的 Blob。

---

parseCsv(csv)

傳回 CSV 字串的表格式 2D 陣列。

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

參數

名稱	類型	說明
csv	String	包含單行或多行資料的字串 (以半形逗號分隔值，CSV) 格式。

回攻員

String[][]：包含 CSV 字串值的二維陣列。

---

parseCsv(csv, delimiter)

使用自訂分隔符號傳回 CSV 字串的表格 2D 陣列表示法。

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

參數

名稱	類型	說明
csv	String	包含單行或多行資料的字串 (以半形逗號分隔值，CSV) 格式。
delimiter	Char	介於兩個值之間。

回攻員

String[][]：包含 CSV 字串值的二維陣列。

---

parseDate(date, timeZone, format)

根據 Java 標準中所述的規格剖析指定字串日期 版本 SimpleDateFormat 類別。詳情請參閱 Java SimpleDateFormat 類別。

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

參數

名稱	類型	說明
date	String	要剖析為日期的字串值。
timeZone	String	輸出時區。
format	String	符合 SimpleDateFormat 規格的日期格式。

回攻員

Date：以日期表示的輸入字串。

---

sleep(milliseconds)

休眠數 (以毫秒為單位)。立即讓指令碼進入休眠狀態， 指定毫秒允許的最大值為 300000 (或 5 分鐘)。

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

參數

名稱	類型	說明
milliseconds	Integer	要休眠的毫秒數。

---

ungzip(blob)

解壓縮 Blob 物件並傳回包含未壓縮的 Blob 資料。

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

參數

名稱	類型	說明
blob	BlobSource	壓縮資料的 Blob。

回攻員

Blob - 代表已解壓縮資料的 Blob。

---

unzip(blob)

取用代表 ZIP 檔案的 Blob，並傳回其元件檔案。

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

參數

名稱	類型	說明
blob	BlobSource	ZIP 檔案 blob。

回攻員

Blob[] — 代表元件 blob 的 Blob[]，每個 Blob[] 會以 zip 檔案。

---

zip(blobs)

建立新的 Blob 物件，該物件為 ZIP 檔案，內含所傳入的 Blob 資料。

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

參數

名稱	類型	說明
blobs	BlobSource[]	要壓縮的 blob 陣列。

回攻員

Blob — 新的 blob，含有做為封存的輸入。

---

zip(blobs, name)

建立新的 Blob 物件，該物件為 ZIP 檔案，內含所傳入的 Blob 資料。這個 方法可讓您指定檔案名稱。

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

參數

名稱	類型	說明
blobs	BlobSource[]	要壓縮的 blob 陣列。
name	String	要建立的 ZIP 檔案名稱。

回攻員

Blob — 新的 blob，含有做為封存的輸入。

已淘汰的方法

jsonParse(jsonString)

已淘汰。自 2013 年 11 月起，由「JSON.parse()」取代

傳回與傳入 JSON 字串相對應的物件。

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

參數

名稱	類型	說明
jsonString	String	要還原序列化的 JavaScript 物件的 String 表示法。

回攻員

Object：輸入的 JavaScript 物件表示法。

---

jsonStringify(obj)

已淘汰。自 2013 年 11 月起，由「JSON.stringify()」取代

傳回傳入物件的 JSON 字串。

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

參數

名稱	類型	說明
obj	Object	要序列化為 JSON 的 JavaScript 物件

回攻員

String：JSON 序列化 JavaScript 物件