Class Utilities

จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
ยูทิลิตี

บริการนี้มียูทิลิตีสําหรับการเข้ารหัส/การถอดรหัสสตริง การจัดรูปแบบวันที่ การจัดการ JSON และงานเบ็ดเตล็ดอื่นๆ

พร็อพเพอร์ตี้

พร็อพเพอร์ตี้ประเภทคำอธิบาย
CharsetCharset
DigestAlgorithmDigestAlgorithm
MacAlgorithmMacAlgorithm
RsaAlgorithmRsaAlgorithm

เมธอด

วิธีการประเภทการแสดงผลรายละเอียดแบบย่อ
base64Decode(encoded)Byte[]ถอดรหัสสตริงฐาน 64 เป็นอาร์เรย์ UTF-8 ไบต์
base64Decode(encoded, charset)Byte[]ถอดรหัสสตริงฐาน 64 เป็นอาร์เรย์ไบต์ในชุดอักขระที่เจาะจง
base64DecodeWebSafe(encoded)Byte[]ถอดรหัสสตริงที่เข้ารหัสบนเว็บที่ปลอดภัยฐาน 64 เป็นอาร์เรย์ UTF-8 ไบต์
base64DecodeWebSafe(encoded, charset)Byte[]ถอดรหัสสตริงที่เข้ารหัสบนเว็บที่ปลอดภัยฐาน 64 เป็นอาร์เรย์ไบต์ในชุดอักขระที่เจาะจง
base64Encode(data)Stringสร้างสตริงที่เข้ารหัสฐาน 64 จากอาร์เรย์ไบต์ที่ระบุ
base64Encode(data)Stringสร้างสตริงที่เข้ารหัสฐาน 64 จากสตริงที่ระบุ
base64Encode(data, charset)Stringสร้างสตริงที่เข้ารหัสฐาน 64 จากสตริงที่ระบุในชุดอักขระที่กําหนด
base64EncodeWebSafe(data)Stringสร้างสตริงที่เข้ารหัสฐานเว็บที่ปลอดภัย 64 รายการจากอาร์เรย์ไบต์ที่ระบุ
base64EncodeWebSafe(data)Stringสร้างสตริงที่เข้ารหัสฐานเว็บที่ปลอดภัย 64 รายการจากสตริงที่กําหนด
base64EncodeWebSafe(data, charset)Stringสร้างสตริงที่เข้ารหัสฐาน 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)Blobgzip จะบีบอัดข้อมูล Blob ที่ระบุ และแสดงผลในออบเจ็กต์ Blob ใหม่
gzip(blob, name)Blobgzip จะบีบอัดข้อมูล 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[][]แสดงผลการนําเสนออาร์เรย์ 2D ของสตริง CSV
parseCsv(csv, delimiter)String[][]แสดงผลสตริงอาร์เรย์ 2D แบบสตริงของสตริง CSV โดยใช้ตัวคั่นที่กําหนดเอง
sleep(milliseconds)voidสลีปตามจํานวนมิลลิวินาทีที่ระบุไว้
ungzip(blob)Blobยกเลิกการบีบอัดออบเจ็กต์ Blob และแสดงผล Blob ที่มีข้อมูลที่ยังไม่ได้บีบอัด
unzip(blob)Blob[]ใช้ BLOB แสดงถึงไฟล์ ZIP และส่งไฟล์คอมโพเนนต์กลับมา
zip(blobs)Blobสร้างออบเจ็กต์ Blob ใหม่ซึ่งเป็นไฟล์ ZIP ที่มีข้อมูลจาก Blob ที่ส่งไป
zip(blobs, name)Blobสร้างออบเจ็กต์ Blob ใหม่ซึ่งเป็นไฟล์ ZIP ที่มีข้อมูลจาก Blob ที่ส่งไป

เอกสารประกอบโดยละเอียด

base64Decode(encoded)

ถอดรหัสสตริงฐาน 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());

พารามิเตอร์

ชื่อประเภทคำอธิบาย
encodedStringอาร์เรย์ของไบต์ข้อมูลที่จะถอดรหัส

ไปกลับ

Byte[] — ข้อมูลดิบที่นําเสนอโดยอาร์กิวเมนต์ที่เข้ารหัส base-64 เป็นอาร์เรย์ไบต์


base64Decode(encoded, charset)

ถอดรหัสสตริงฐาน 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());

พารามิเตอร์

ชื่อประเภทคำอธิบาย
encodedStringสตริงข้อมูลที่จะถอดรหัส
charsetCharsetCharset ที่ระบุชุดอักขระของอินพุต

ไปกลับ

Byte[] — ข้อมูลดิบที่นําเสนอโดยอาร์กิวเมนต์ที่เข้ารหัส base-64 เป็นอาร์เรย์ไบต์


base64DecodeWebSafe(encoded)

ถอดรหัสสตริงที่เข้ารหัสบนเว็บที่ปลอดภัยฐาน 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());

พารามิเตอร์

ชื่อประเภทคำอธิบาย
encodedStringอาร์เรย์ของข้อมูลไบต์ที่ปลอดภัยต่อเว็บเพื่อถอดรหัส

ไปกลับ

Byte[] — ข้อมูลดิบที่นําเสนอโดยอาร์กิวเมนต์ที่เข้ารหัสบนเว็บที่ปลอดภัยฐาน 64 เป็นอาร์เรย์ไบต์


base64DecodeWebSafe(encoded, charset)

ถอดรหัสสตริงที่เข้ารหัสบนเว็บที่ปลอดภัยฐาน 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());

พารามิเตอร์

ชื่อประเภทคำอธิบาย
encodedStringสตริงข้อมูลที่เว็บปลอดภัยเพื่อถอดรหัส
charsetCharsetCharset ที่ระบุชุดอักขระของอินพุต

ไปกลับ

Byte[] — ข้อมูลดิบที่นําเสนอโดยอาร์กิวเมนต์ที่เข้ารหัสบนเว็บที่ปลอดภัยฐาน 64 เป็นอาร์เรย์ไบต์


base64Encode(data)

สร้างสตริงที่เข้ารหัสฐาน 64 จากอาร์เรย์ไบต์ที่ระบุ Base66 เป็นการเข้ารหัสทั่วไปที่เครื่องมือต่างๆ ยอมรับไม่ได้ยอมรับข้อมูลไบนารี Base66 มักใช้ในโปรโตคอลอินเทอร์เน็ต เช่น อีเมล, 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);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
dataByte[]ไบต์[]]ของข้อมูลเพื่อเข้ารหัส

ไปกลับ

String — การนําเสนอที่เข้ารหัสในรูปแบบเลข 64 ของข้อมูลที่ผ่านใน


base64Encode(data)

สร้างสตริงที่เข้ารหัสฐาน 64 จากสตริงที่ระบุ Base66 เป็นการเข้ารหัสทั่วไปที่เครื่องมือต่างๆ ยอมรับไม่ได้ในข้อมูลไบนารี Base66 มักใช้ในโปรโตคอลอินเทอร์เน็ต เช่น อีเมล, HTTP หรือในเอกสาร XML

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
dataStringสตริงที่จะเข้ารหัส

ไปกลับ

String — การแสดงสตริงอินพุตฐาน 64 ที่เข้ารหัส


base64Encode(data, charset)

สร้างสตริงที่เข้ารหัสฐาน 64 จากสตริงที่ระบุในชุดอักขระที่กําหนด ชุดอักขระเป็นวิธีการเข้ารหัสอักขระเพื่อให้มีการเข้ารหัสได้ ซึ่งโดยปกติจะดําเนินการในรูปแบบไบนารี ซึ่งปกติแล้วจะไม่สามารถใช้ได้กับโปรโตคอลการส่งข้อมูลบางประเภท เพื่อทําให้ข้อมูลเข้ากันได้ โดยทั่วไปแล้ว ข้อมูลจะเข้ารหัสเป็นฐาน 64 ซึ่งเป็นการเข้ารหัสทั่วไปที่เครื่องมือต่างๆ ยอมรับไม่ได้ในข้อมูลไบนารี Base66 มักใช้ในโปรโตคอลอินเทอร์เน็ต เช่น อีเมล, 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);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
dataStringสตริงข้อมูลที่จะเข้ารหัส
charsetCharsetCharset ที่ระบุชุดอักขระของอินพุต

ไปกลับ

String — การแสดงสตริงอินพุตฐาน 64 ที่เข้ารหัสด้วย Charset ที่ระบุ


base64EncodeWebSafe(data)

สร้างสตริงที่เข้ารหัสฐานเว็บที่ปลอดภัย 64 รายการจากอาร์เรย์ไบต์ที่ระบุ Base66 เป็นการเข้ารหัสทั่วไปที่เครื่องมือต่างๆ ยอมรับไม่ได้ยอมรับข้อมูลไบนารี Base-64 ซึ่งเป็นแบบปลอดภัยบนเว็บนั้นมักใช้ในโปรโตคอลอินเทอร์เน็ต เช่น อีเมล, 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);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
dataByte[]อาร์เรย์ของจํานวนไบต์ของข้อมูลที่จะเข้ารหัส

ไปกลับ

String — การนําเสนอที่เข้ารหัสในรูปแบบเว็บ-64 ที่ปลอดภัย


base64EncodeWebSafe(data)

สร้างสตริงที่เข้ารหัสฐานเว็บที่ปลอดภัย 64 รายการจากสตริงที่กําหนด Base66 เป็นการเข้ารหัสทั่วไปที่เครื่องมือต่างๆ ยอมรับไม่ได้ยอมรับข้อมูลไบนารี Base66 เป็นเว็บที่ใช้กันโดยทั่วไป ในโปรโตคอลอินเทอร์เน็ต เช่น อีเมล, HTTP หรือในเอกสาร XML

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
dataStringสตริงที่จะเข้ารหัส

ไปกลับ

String — เป็นตัวแทนที่เข้ารหัสสตริงที่ปลอดภัยสําหรับเว็บฐาน 64


base64EncodeWebSafe(data, charset)

สร้างสตริงที่เข้ารหัสฐาน 64 บนเว็บได้อย่างปลอดภัยจากสตริงที่ระบุในชุดอักขระที่กําหนด ชุดอักขระเป็นวิธีการเข้ารหัสอักขระเพื่อให้มีการเข้ารหัสได้ ซึ่งโดยปกติจะอยู่ในรูปแบบไบนารี ซึ่งโดยทั่วไปจะเข้ากันไม่ได้กับโปรโตคอลการส่งข้อมูลบางอย่าง เพื่อทําให้ข้อมูลใช้งานร่วมกันได้ โดยทั่วไปแล้ว ข้อมูลเหล่านี้จะเข้ารหัสเป็นฐาน 64 ซึ่งเป็นการเข้ารหัสทั่วไปที่เครื่องมือต่างๆ ยอมรับไม่ได้ในข้อมูลไบนารี Base-64 แบบปลอดภัยบนเว็บมักใช้ในโปรโตคอลอินเทอร์เน็ต เช่น อีเมล, 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);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
dataStringสตริงข้อมูลที่จะเข้ารหัส
charsetCharsetCharset ที่ระบุชุดอักขระของอินพุต

ไปกลับ

String — การแสดงสตริงอินพุตแบบเว็บฐาน 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);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
algorithmDigestAlgorithmDigestAlgorithm เพื่อใช้
valueByte[]ค่าสตริงอินพุตเพื่อคํานวณไดเจสต์สําหรับ

ไปกลับ

Byte[] — ไบต์[] ที่แสดงสรุปเอาต์พุต


computeDigest(algorithm, value)

คํานวณไดเจสต์โดยใช้อัลกอริทึมที่ระบุในค่า String ที่ระบุ

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
algorithmDigestAlgorithmDigestAlgorithm เพื่อใช้
valueStringค่าสตริงอินพุตเพื่อคํานวณไดเจสต์สําหรับ

ไปกลับ

Byte[] — ไบต์[] ที่แสดงสรุปเอาต์พุต


computeDigest(algorithm, value, charset)

คํานวณไดเจสต์โดยใช้อัลกอริทึมที่ระบุในค่า String ที่ระบุด้วยชุดอักขระที่กําหนด

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
algorithmDigestAlgorithmDigestAlgorithm เพื่อใช้
valueStringค่าสตริงอินพุตเพื่อคํานวณไดเจสต์สําหรับ
charsetCharsetCharset ที่แสดงชุดอักขระอินพุต

ไปกลับ

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
valueByte[]ค่าอินพุตเพื่อสร้างแฮชสําหรับ
keyByte[]คีย์ที่จะใช้สร้างแฮช

ไปกลับ

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
valueStringค่าอินพุตเพื่อสร้างแฮชสําหรับ
keyStringคีย์ที่จะใช้สร้างแฮช

ไปกลับ

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
valueStringค่าอินพุตเพื่อสร้างแฮชสําหรับ
keyStringคีย์ที่จะใช้สร้างแฮช
charsetCharsetCharset ที่แสดงชุดอักขระอินพุต

ไปกลับ

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
algorithmMacAlgorithmอัลกอริทึม MacAlgorithm ที่จะใช้แฮชค่าอินพุต
valueByte[]ค่าอินพุตเพื่อสร้างแฮชสําหรับ
keyByte[]คีย์ที่จะใช้สร้างแฮช

ไปกลับ

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
algorithmMacAlgorithmอัลกอริทึม MacAlgorithm ที่จะใช้แฮชค่าอินพุต
valueStringค่าอินพุตเพื่อสร้างแฮชสําหรับ
keyStringคีย์ที่จะใช้สร้างแฮช

ไปกลับ

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
algorithmMacAlgorithmอัลกอริทึม MacAlgorithm ที่จะใช้แฮชค่าอินพุต
valueStringค่าอินพุตเพื่อสร้างแฮชสําหรับ
keyStringคีย์ที่จะใช้สร้างแฮช
charsetCharsetCharset ที่แสดงชุดอักขระอินพุต

ไปกลับ

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
valueStringค่าอินพุตที่ใช้สร้างแฮช
keyStringคีย์รูปแบบ PEM ที่ใช้สร้างลายเซ็น

ไปกลับ

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
valueStringค่าอินพุตที่ใช้สร้างแฮช
keyStringคีย์รูปแบบ PEM ที่ใช้สร้างลายเซ็น
charsetCharsetCharset ที่แสดงชุดอักขระอินพุต

ไปกลับ

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
valueStringค่าอินพุตเพื่อสร้างแฮชสําหรับ
keyStringคีย์รูปแบบ PEM ที่ใช้สร้างลายเซ็น

ไปกลับ

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
valueStringค่าอินพุตเพื่อสร้างแฮชสําหรับ
keyStringคีย์รูปแบบ PEM ที่ใช้สร้างลายเซ็น
charsetCharsetCharset ที่แสดงชุดอักขระอินพุต

ไปกลับ

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
algorithmRsaAlgorithmอัลกอริทึม RsaAlgorithm ที่ใช้สําหรับแฮชค่าอินพุต
valueStringค่าอินพุตที่ใช้สร้างแฮช
keyStringคีย์รูปแบบ PEM ที่ใช้สร้างลายเซ็น

ไปกลับ

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
algorithmRsaAlgorithmอัลกอริทึม RsaAlgorithm ที่ใช้สําหรับแฮชค่าอินพุต
valueStringค่าอินพุตที่ใช้สร้างแฮช
keyStringคีย์รูปแบบ PEM ที่ใช้สร้างลายเซ็น
charsetCharsetCharset ที่แสดงชุดอักขระอินพุต

ไปกลับ

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
dateDateDate เพื่อจัดรูปแบบเป็นสตริง
timeZoneStringเขตเวลาเอาต์พุตของผลการค้นหา
formatStringรูปแบบตามข้อกําหนด SimpleDateFormat

ไปกลับ

String — วันที่ป้อนข้อมูลเป็นสตริงที่จัดรูปแบบ


formatString(template, args)

ดําเนินการจัดรูปแบบสตริงแบบ sprintf โดยใช้สตริงรูปแบบ '%'

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

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
templateStringสตริงรูปแบบที่ควบคุมสิ่งที่ได้รับกลับมา
argsObject...ออบเจ็กต์เพื่อใช้กรอกข้อมูลในตัวยึดตําแหน่ง '%' ในเทมเพลต

ไปกลับ

String — สตริงที่จัดรูปแบบแล้ว


getUuid()

รับ UUID เป็นสตริง (เทียบเท่ากับการใช้เมธอด java.util.UUID.randomUUID()) ตัวระบุนี้ไม่ซ้ํา ตลอดกาลและพื้นที่ ดังนั้น อย่าใช้ในสถานการณ์ที่ต้องรับประกันว่าไม่ซ้ํากัน

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
blobBlobSourceออบเจ็กต์ Blob เพื่อบีบอัดโดยใช้ gzip

ไปกลับ

BlobBlob ใหม่ที่มีข้อมูลที่บีบอัด


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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
blobBlobSourceออบเจ็กต์ Blob เพื่อบีบอัดโดยใช้ gzip
nameStringชื่อของไฟล์ gzip ที่จะสร้าง

ไปกลับ

BlobBlob ใหม่ที่มีข้อมูลที่บีบอัด


newBlob(data)

สร้างออบเจ็กต์ Blob ใหม่จากอาร์เรย์ไบต์ BLOB จะใช้ใน Apps Script API จํานวนมากที่ใช้ข้อมูลไบนารีเป็นอินพุต

พารามิเตอร์

ชื่อประเภทคำอธิบาย
dataByte[]ไบต์สําหรับ BLOB

ไปกลับ

Blob - Blob ที่สร้างใหม่


newBlob(data, contentType)

สร้างออบเจ็กต์ Blob ใหม่จากอาร์เรย์ไบต์และประเภทเนื้อหา BLOB จะใช้ใน Apps Script API จํานวนมาก ซึ่งใช้ข้อมูลไบนารีเป็นอินพุต

พารามิเตอร์

ชื่อประเภทคำอธิบาย
dataByte[]ไบต์สําหรับ BLOB
contentTypeStringประเภทเนื้อหาของ BLOB - เป็นค่าว่างได้

ไปกลับ

Blob - Blob ที่สร้างใหม่


newBlob(data, contentType, name)

สร้างออบเจ็กต์ Blob ใหม่จากอาร์เรย์ไบต์ ประเภทเนื้อหา และชื่อ BLOB จะใช้ใน Apps Script API จํานวนมากที่ใช้ข้อมูลไบนารีเป็นอินพุต

พารามิเตอร์

ชื่อประเภทคำอธิบาย
dataByte[]ไบต์สําหรับ BLOB
contentTypeString- ประเภทเนื้อหาของ BLOB - เป็นค่าว่างได้
nameStringชื่อของ BLOB - เป็นค่าว่างได้

ไปกลับ

Blob - Blob ที่สร้างใหม่


newBlob(data)

สร้างออบเจ็กต์ Blob ใหม่จากสตริง BLOB จะใช้ใน Apps Script API จํานวนมากที่ใช้ข้อมูลไบนารีเป็นอินพุต

พารามิเตอร์

ชื่อประเภทคำอธิบาย
dataStringสตริงสําหรับ BLOB จะถือว่า UTF-8

ไปกลับ

Blob - Blob ที่สร้างใหม่


newBlob(data, contentType)

สร้างออบเจ็กต์ Blob ใหม่จากสตริงและประเภทเนื้อหา BLOB จะใช้ใน Apps Script API จํานวนมาก ซึ่งใช้ข้อมูลไบนารีเป็นอินพุต

พารามิเตอร์

ชื่อประเภทคำอธิบาย
dataStringสตริงสําหรับ BLOB จะถือว่า UTF-8
contentTypeStringประเภทเนื้อหาของ BLOB - เป็นค่าว่างได้

ไปกลับ

Blob - Blob ที่สร้างใหม่


newBlob(data, contentType, name)

สร้างออบเจ็กต์ Blob ใหม่จากสตริง ประเภทเนื้อหา และชื่อ BLOB จะใช้ใน Apps Script API จํานวนมากที่ใช้ข้อมูลไบนารีเป็นอินพุต

พารามิเตอร์

ชื่อประเภทคำอธิบาย
dataStringสตริงสําหรับ BLOB จะถือว่า UTF-8
contentTypeStringประเภทเนื้อหาของ BLOB - เป็นค่าว่างได้
nameStringชื่อของ BLOB - เป็นค่าว่างได้

ไปกลับ

Blob - Blob ที่สร้างใหม่


parseCsv(csv)

แสดงผลการนําเสนออาร์เรย์ 2D ของสตริง 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);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
csvStringสตริงที่มีข้อมูลเดียวหรือหลายบรรทัดในรูปแบบค่าที่คั่นด้วยคอมมา (CSV)

ไปกลับ

String[][] — อาร์เรย์ 2 มิติที่มีค่าในสตริง CSV


parseCsv(csv, delimiter)

แสดงผลสตริงอาร์เรย์ 2D แบบสตริงของสตริง CSV โดยใช้ตัวคั่นที่กําหนดเอง

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
csvStringสตริงที่มีข้อมูลเดียวหรือหลายบรรทัดในรูปแบบค่าที่คั่นด้วยคอมมา (CSV)
delimiterCharระหว่างค่า

ไปกลับ

String[][] — อาร์เรย์ 2 มิติที่มีค่าในสตริง CSV


sleep(milliseconds)

สลีปตามจํานวนมิลลิวินาทีที่ระบุไว้ ทําให้สคริปต์เข้าสู่โหมดสลีปตาม จํานวนมิลลิวินาทีที่ระบุในทันที ค่าสูงสุดที่อนุญาตคือ 300000 (หรือ 5 นาที)

พารามิเตอร์

ชื่อประเภทคำอธิบาย
millisecondsIntegerจํานวนมิลลิวินาทีที่สามารถนอนหลับได้

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
blobBlobSourceBlob ของข้อมูลที่บีบอัด

ไปกลับ

BlobBlob แสดงแทนข้อมูลที่บีบอัด


unzip(blob)

ใช้ BLOB แสดงถึงไฟล์ ZIP และส่งไฟล์คอมโพเนนต์กลับมา

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
blobBlobSourceBLOB ไฟล์ ZIP

ไปกลับ

Blob[] — Blob[] แสดงถึง Blob ของคอมโพเนนต์ โดยแต่ละชื่อจะมีเส้นทางแบบเต็มภายในรหัสไปรษณีย์


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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
blobsBlobSource[]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");

พารามิเตอร์

ชื่อประเภทคำอธิบาย
blobsBlobSource[]BLOB ที่บีบเพื่อซิป
nameStringชื่อไฟล์ ZIP ที่จะสร้าง

ไปกลับ

Blob BLOB ใหม่ที่มีอินพุตเป็นที่เก็บถาวร

วิธีการเลิกใช้งาน