Class Utilities

ยูทิลิตี

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

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

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

เมธอด

วิธีการประเภทการแสดงผลรายละเอียดแบบย่อ
base64Decode(encoded)Byte[]ถอดรหัสสตริงที่เข้ารหัส Base64 เป็นอาร์เรย์ไบต์ UTF-8
base64Decode(encoded, charset)Byte[]ถอดรหัสสตริงที่เข้ารหัสฐาน 64 เป็นอาร์เรย์ไบต์ในชุดอักขระที่เฉพาะเจาะจง
base64DecodeWebSafe(encoded)Byte[]ถอดรหัสสตริงที่เข้ารหัส Web-safe base64 เป็นอาร์เรย์ไบต์ UTF-8
base64DecodeWebSafe(encoded, charset)Byte[]ถอดรหัสสตริงที่เข้ารหัสฐาน 64 ที่เข้ากันได้กับเว็บเป็นอาร์เรย์ไบต์ในชุดอักขระที่เฉพาะเจาะจง
base64Encode(data)Stringสร้างสตริงที่เข้ารหัสฐาน 64 จากอาร์เรย์ไบต์ที่ระบุ
base64Encode(data)Stringสร้างสตริงที่เข้ารหัสฐาน 64 จากสตริงที่ระบุ
base64Encode(data, charset)Stringสร้างสตริงที่เข้ารหัสฐาน 64 จากสตริงที่ระบุในชุดอักขระที่เฉพาะเจาะจง
base64EncodeWebSafe(data)Stringสร้างสตริงที่เข้ารหัส Web-safe base64 จากอาร์เรย์ไบต์ที่ระบุ
base64EncodeWebSafe(data)Stringสร้างสตริงที่เข้ารหัสฐาน 64 ที่เข้ากันได้กับเว็บจากสตริงที่ระบุ
base64EncodeWebSafe(data, charset)Stringสร้างสตริงที่เข้ารหัส Base64 ที่ปลอดภัยสําหรับเว็บจากสตริงที่ระบุในชุดอักขระที่เฉพาะเจาะจง
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จัดรูปแบบวันที่ตามข้อกำหนดที่อธิบายไว้ในคลาส SimpleDateFormat ของ Java SE
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[][]แสดงผลอาร์เรย์ 2 มิติในตารางของสตริง CSV
parseCsv(csv, delimiter)String[][]แสดงผลอาร์เรย์ 2 มิติรูปแบบตารางของสตริง CSV โดยใช้ตัวคั่นที่กำหนดเอง
parseDate(date, timeZone, format)Dateแยกวิเคราะห์วันที่สตริงที่ระบุตามข้อกำหนดที่อธิบายไว้ในคลาส Java Standard Edition SimpleDateFormat
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)

ถอดรหัสสตริงที่เข้ารหัส Base64 เป็นอาร์เรย์ไบต์ UTF-8 

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

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

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

พารามิเตอร์

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

รีเทิร์น

Byte[] — ข้อมูลดิบซึ่งแสดงโดยอาร์กิวเมนต์ที่เข้ารหัส Base64 เป็นอาร์เรย์ไบต์

base64Decode(encoded, charset)

ถอดรหัสสตริงที่เข้ารหัสฐาน 64 เป็นอาร์เรย์ไบต์ในชุดอักขระที่เฉพาะเจาะจง 

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

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

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

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

พารามิเตอร์

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

รีเทิร์น

Byte[] — ข้อมูลดิบซึ่งแสดงโดยอาร์กิวเมนต์ที่เข้ารหัส Base64 เป็นอาร์เรย์ไบต์

base64DecodeWebSafe(encoded)

ถอดรหัสสตริงที่เข้ารหัส Web-safe base64 เป็นอาร์เรย์ไบต์ UTF-8 

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

const decoded = Utilities.base64DecodeWebSafe(base64data);

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

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

พารามิเตอร์

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

รีเทิร์น

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

base64DecodeWebSafe(encoded, charset)

ถอดรหัสสตริงที่เข้ารหัสฐาน 64 ที่เข้ากันได้กับเว็บเป็นอาร์เรย์ไบต์ในชุดอักขระที่เฉพาะเจาะจง 

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

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

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

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

พารามิเตอร์

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

รีเทิร์น

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

base64Encode(data)

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

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

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
dataByte[]ข้อมูล byte[] ที่จะเข้ารหัส

รีเทิร์น

String — การนําเสนอข้อมูลที่ส่งเข้ามาซึ่งเข้ารหัส Base64

base64Encode(data)

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

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

พารามิเตอร์

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

รีเทิร์น

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

base64Encode(data, charset)

สร้างสตริงที่เข้ารหัสฐาน 64 จากสตริงที่ระบุในชุดอักขระที่เฉพาะเจาะจง Charset เป็นวิธีเข้ารหัสอักขระเพื่อให้เข้ารหัสได้ โดยปกติแล้ว การดำเนินการเหล่านี้จะทำในรูปแบบไบนารี ซึ่งโดยทั่วไปแล้วอาจใช้ร่วมกับโปรโตคอลการส่งข้อมูลบางรายการไม่ได้ โดยทั่วไปข้อมูลจะได้รับการเข้ารหัสเป็นฐาน 64 ซึ่งเป็นการเข้ารหัสทั่วไปที่เครื่องมือต่างๆ ยอมรับ ซึ่งไม่สามารถรับข้อมูลไบนารีได้ เพื่อให้ข้อมูลเข้ากันได้ Base 64 มักใช้ในโปรโตคอลอินเทอร์เน็ต เช่น อีเมล, HTTP หรือในเอกสาร XML 

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

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

พารามิเตอร์

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

รีเทิร์น

String — การนำเสนอสตริงอินพุตที่เข้ารหัสฐาน 64 ที่มี Charset ที่ให้ไว้

base64EncodeWebSafe(data)

สร้างสตริงที่เข้ารหัส Web-safe base64 จากอาร์เรย์ไบต์ที่ระบุ Base 64 คือการเข้ารหัสทั่วไปที่เครื่องมือต่างๆ ยอมรับ ซึ่งไม่สามารถรับข้อมูลไบนารีได้ Base 64 ที่ปลอดภัยบนเว็บมักใช้ในโปรโตคอลอินเทอร์เน็ต เช่น อีเมล, HTTP หรือในเอกสาร XML 

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

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

พารามิเตอร์

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

รีเทิร์น

String — การนําเสนอข้อมูลที่ส่งเข้ามาซึ่งเข้ารหัส Base64 ซึ่งใช้กับเว็บได้

base64EncodeWebSafe(data)

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

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

พารามิเตอร์

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

รีเทิร์น

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

base64EncodeWebSafe(data, charset)

สร้างสตริงที่เข้ารหัส Base64 ที่ปลอดภัยสําหรับเว็บจากสตริงที่ระบุในชุดอักขระที่เฉพาะเจาะจง การเข้ารหัสอักขระเป็นวิธีเข้ารหัสอักขระเพื่อให้เข้ารหัสได้ โดยปกติแล้ว การดำเนินการเหล่านี้จะทำในรูปแบบไบนารี ซึ่งโดยทั่วไปอาจใช้ร่วมกับโปรโตคอลการส่งข้อมูลบางรายการไม่ได้ โดยทั่วไปข้อมูลจะได้รับการเข้ารหัสเป็นฐาน 64 ซึ่งเป็นการเข้ารหัสทั่วไปที่เครื่องมือต่างๆ ยอมรับ ซึ่งไม่สามารถรับข้อมูลไบนารีได้ เพื่อให้ข้อมูลเข้ากันได้ Base 64 ที่ปลอดภัยบนเว็บมักใช้ในโปรโตคอลอินเทอร์เน็ต เช่น อีเมล, HTTP หรือในเอกสาร XML 

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

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

พารามิเตอร์

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

รีเทิร์น

String — การแสดงสตริงอินพุตที่เข้ารหัสฐาน 64 ที่เข้ากันได้กับเว็บซึ่งมี Charset ที่ให้ไว้

computeDigest(algorithm, value)

คำนวณข้อมูลสรุปโดยใช้อัลกอริทึมที่ระบุในค่า Byte[] ที่ระบุ 

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
algorithmDigestAlgorithmDigestAlgorithm ที่จะใช้งาน
valueByte[]ค่าสตริงอินพุตที่จะคํานวณข้อมูลสรุป

รีเทิร์น

Byte[] — byte[] ที่แสดงข้อมูลสรุปเอาต์พุต

computeDigest(algorithm, value)

คำนวณข้อมูลสรุปโดยใช้อัลกอริทึมที่ระบุในค่า String ที่ระบุ 

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
algorithmDigestAlgorithmDigestAlgorithm ที่จะใช้งาน
valueStringค่าสตริงอินพุตที่จะคํานวณข้อมูลสรุป

รีเทิร์น

Byte[] — byte[] ที่แสดงข้อมูลสรุปเอาต์พุต

computeDigest(algorithm, value, charset)

คํานวณข้อมูลสรุปโดยใช้อัลกอริทึมที่ระบุในค่า String ที่ระบุด้วยชุดอักขระที่ระบุ 

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

พารามิเตอร์

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

รีเทิร์น

Byte[] — byte[] ที่แสดงข้อมูลสรุปเอาต์พุต

computeHmacSha256Signature(value, key)

เซ็นชื่อค่าที่ระบุโดยใช้ HMAC-SHA256 ด้วยคีย์ที่ระบุ 

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

พารามิเตอร์

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

รีเทิร์น

Byte[] — byte[] ที่แสดงลายเซ็นเอาต์พุต

computeHmacSha256Signature(value, key)

เซ็นชื่อค่าที่ระบุโดยใช้ HMAC-SHA256 ด้วยคีย์ที่ระบุ 

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

พารามิเตอร์

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

รีเทิร์น

Byte[] — byte[] ที่แสดงลายเซ็นเอาต์พุต

computeHmacSha256Signature(value, key, charset)

ลงนามในค่าที่ระบุโดยใช้ HMAC-SHA256 ด้วยคีย์และชุดอักขระที่ระบุ 

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

พารามิเตอร์

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

รีเทิร์น

Byte[] — byte[] ที่แสดงลายเซ็นเอาต์พุต

computeHmacSignature(algorithm, value, key)

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

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

พารามิเตอร์

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

รีเทิร์น

Byte[] — byte[] ที่แสดงลายเซ็นเอาต์พุต

computeHmacSignature(algorithm, value, key)

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

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

พารามิเตอร์

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

รีเทิร์น

Byte[] — byte[] ที่แสดงลายเซ็นเอาต์พุต

computeHmacSignature(algorithm, value, key, charset)

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

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

พารามิเตอร์

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

รีเทิร์น

Byte[] — byte[] ที่แสดงลายเซ็นเอาต์พุต

computeRsaSha1Signature(value, key)

เซ็นชื่อค่าที่ระบุโดยใช้ RSA-SHA1 ด้วยคีย์ที่ระบุ 

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

พารามิเตอร์

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

รีเทิร์น

Byte[] — byte[] ที่แสดงลายเซ็นเอาต์พุต

computeRsaSha1Signature(value, key, charset)

เซ็นชื่อค่าที่ระบุโดยใช้ RSA-SHA1 ด้วยคีย์และชุดอักขระที่ระบุ 

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

พารามิเตอร์

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

รีเทิร์น

Byte[] — byte[] ที่แสดงลายเซ็นเอาต์พุต

computeRsaSha256Signature(value, key)

เซ็นชื่อค่าที่ระบุโดยใช้ RSA-SHA256 ด้วยคีย์ที่ระบุ 

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

พารามิเตอร์

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

รีเทิร์น

Byte[] — byte[] ที่แสดงลายเซ็นเอาต์พุต

computeRsaSha256Signature(value, key, charset)

เซ็นชื่อค่าที่ระบุโดยใช้ RSA-SHA256 ด้วยคีย์ที่ระบุ 

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

พารามิเตอร์

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

รีเทิร์น

Byte[] — byte[] ที่แสดงลายเซ็นเอาต์พุต

computeRsaSignature(algorithm, value, key)

เซ็นชื่อค่าที่ระบุโดยใช้อัลกอริทึม RSA ที่ระบุด้วยคีย์ที่ระบุ 

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

พารามิเตอร์

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

รีเทิร์น

Byte[] — byte[] ที่แสดงลายเซ็นเอาต์พุต

computeRsaSignature(algorithm, value, key, charset)

เซ็นชื่อค่าที่ระบุโดยใช้อัลกอริทึม RSA ที่ระบุด้วยคีย์และชุดอักขระที่ระบุ 

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

พารามิเตอร์

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

รีเทิร์น

Byte[] — byte[] ที่แสดงลายเซ็นเอาต์พุต

formatDate(date, timeZone, format)

จัดรูปแบบวันที่ตามข้อกำหนดที่อธิบายไว้ในคลาส SimpleDateFormat ของ Java SE โปรดไปที่ข้อกำหนดที่ http://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html 

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
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.
const myDataObject = {
  tempId: Utilities.getUuid(),
};

รีเทิร์น

String — การนําเสนอ UUID เป็นสตริง

gzip(blob)

gzip- บีบอัดข้อมูล Blob ที่ระบุและแสดงผลในออบเจ็กต์ Blob ใหม่ 

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

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

พารามิเตอร์

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

รีเทิร์น

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

gzip(blob, name)

gzip- บีบอัดข้อมูล Blob ที่ระบุและแสดงผลในออบเจ็กต์ Blob ใหม่ วิธีการเวอร์ชันนี้อนุญาตให้ระบุชื่อไฟล์ได้ 

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

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

พารามิเตอร์

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

รีเทิร์น

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

newBlob(data)

สร้างออบเจ็กต์ Blob ใหม่จากอาร์เรย์ไบต์ Blobs ใช้ใน 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());

พารามิเตอร์

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

รีเทิร์น

Blob — BLOB ที่สร้างขึ้นใหม่

newBlob(data, contentType)

สร้างออบเจ็กต์ Blob ใหม่จากอาร์เรย์ไบต์และประเภทเนื้อหา Blobs ใช้ใน Apps Script 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());

พารามิเตอร์

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

รีเทิร์น

Blob — BLOB ที่สร้างขึ้นใหม่

newBlob(data, contentType, name)

สร้างออบเจ็กต์ Blob ใหม่จากอาร์เรย์ไบต์ ประเภทเนื้อหา และชื่อ Blobs ใช้ใน Apps Script 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());

พารามิเตอร์

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

รีเทิร์น

Blob — BLOB ที่สร้างขึ้นใหม่

newBlob(data)

สร้างออบเจ็กต์ Blob ใหม่จากสตริง Blobs ใช้ใน 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());

พารามิเตอร์

ชื่อประเภทคำอธิบาย
dataStringสตริงสำหรับ Blob ซึ่งจะถือว่าอยู่ในรูปแบบ UTF-8

รีเทิร์น

Blob — BLOB ที่สร้างขึ้นใหม่

newBlob(data, contentType)

สร้างออบเจ็กต์ Blob ใหม่จากสตริงและประเภทเนื้อหา Blobs ใช้ใน Apps Script 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());

พารามิเตอร์

ชื่อประเภทคำอธิบาย
dataStringสตริงสำหรับ Blob ซึ่งจะถือว่าอยู่ในรูปแบบ UTF-8
contentTypeStringประเภทเนื้อหาของ Blob อาจเป็น null

รีเทิร์น

Blob — BLOB ที่สร้างขึ้นใหม่

newBlob(data, contentType, name)

สร้างออบเจ็กต์ Blob ใหม่จากสตริง ประเภทเนื้อหา และชื่อ Blobs ใช้ใน Apps Script 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());

พารามิเตอร์

ชื่อประเภทคำอธิบาย
dataStringสตริงสำหรับ Blob ซึ่งจะถือว่าอยู่ในรูปแบบ UTF-8
contentTypeStringประเภทเนื้อหาของ Blob อาจเป็น null
nameStringชื่อของ Blob - อาจเป็น null

รีเทิร์น

Blob — BLOB ที่สร้างขึ้นใหม่

parseCsv(csv)

แสดงผลอาร์เรย์ 2 มิติในตารางของสตริง CSV 

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

พารามิเตอร์

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

รีเทิร์น

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

parseCsv(csv, delimiter)

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

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

พารามิเตอร์

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

รีเทิร์น

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

parseDate(date, timeZone, format)

แยกวิเคราะห์วันที่สตริงที่ระบุตามข้อกำหนดที่อธิบายไว้ในคลาส Java Standard Edition SimpleDateFormat ดูข้อมูลเพิ่มเติมได้ที่คลาส SimpleDateFormat ของ Java 

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
dateStringค่าสตริงที่จะแยกวิเคราะห์เป็นวันที่
timeZoneStringเขตเวลาเอาต์พุต
formatStringรูปแบบวันที่ตามข้อกำหนด 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());

พารามิเตอร์

ชื่อประเภทคำอธิบาย
millisecondsIntegerจำนวนมิลลิวินาทีที่จะหยุดทำงาน

ungzip(blob)

ขยายไฟล์ออบเจ็กต์ Blob และแสดงผล Blob ที่มีข้อมูลที่ขยายไฟล์แล้ว 

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

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

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

พารามิเตอร์

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

รีเทิร์น

Blob — Blob ที่แสดงข้อมูลที่ขยายไฟล์แล้ว

unzip(blob)

รับ Blob ที่แสดงไฟล์ ZIP และแสดงผลไฟล์คอมโพเนนต์ 

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

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

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

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

พารามิเตอร์

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

รีเทิร์น

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

zip(blobs)

สร้างออบเจ็กต์ Blob ใหม่ซึ่งเป็นไฟล์ ZIP ที่มีข้อมูลจาก Blob ที่ส่งเข้ามา 

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

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

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
blobsBlobSource[]อาร์เรย์ของ Blob ที่จะบีบอัด

รีเทิร์น

Blob — Blob ใหม่ที่มีอินพุตเป็นไฟล์เก็บถาวร

zip(blobs, name)

สร้างออบเจ็กต์ Blob ใหม่ซึ่งเป็นไฟล์ ZIP ที่มีข้อมูลจาก Blob ที่ส่งเข้ามา วิธีการเวอร์ชันนี้อนุญาตให้ระบุชื่อไฟล์ได้ 

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

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

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

พารามิเตอร์

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

รีเทิร์น

Blob — Blob ใหม่ที่มีอินพุตเป็นไฟล์เก็บถาวร

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