Class Utilities

Mendekode string yang dienkode base-64 menjadi array 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());

Parameter

Return

Byte[] — data mentah yang direpresentasikan oleh argumen berenkode base-64 sebagai array byte

Mendekode string yang dienkode base-64 ke array byte dalam kumpulan karakter tertentu.

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

Parameter

Return

Byte[] — data mentah yang direpresentasikan oleh argumen berenkode base-64 sebagai array byte

Mendekode string yang dienkode dengan aman di web base-64 menjadi array 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());

Parameter

Return

Byte[] — data mentah yang diwakili oleh argumen yang dienkode dengan web-safe dasar-64 sebagai array byte

Mendekode string yang dienkode dengan aman di web base-64 menjadi array byte dalam kumpulan karakter tertentu.

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

Parameter

Return

Byte[] — data mentah yang diwakili oleh argumen yang dienkode dengan web-safe dasar-64 sebagai array byte

Menghasilkan string berenkode base-64 dari array byte yang diberikan. Base64 adalah encoding umum yang diterima oleh berbagai alat yang tidak dapat menerima data biner. Base64 biasanya digunakan dalam protokol internet seperti email, HTTP, atau dalam dokumen 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);

Parameter

Return

String — representasi berenkode base-64 untuk data yang diteruskan

Menghasilkan string berenkode base-64 dari string tertentu. Base64 adalah encoding umum yang diterima oleh berbagai alat yang tidak dapat menerima data biner. Base64 biasanya digunakan dalam protokol internet seperti email, HTTP, atau dokumen XML.

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

Parameter

Return

String — representasi berenkode base-64 untuk string input

Menghasilkan string berenkode base-64 dari string tertentu dalam kumpulan karakter tertentu. Charset adalah cara untuk mengenkode karakter sehingga dapat dienkode. Ini biasanya dilakukan dalam format biner, yang umumnya tidak kompatibel dengan protokol transmisi data tertentu. Agar data kompatibel, umumnya data dienkode ke dalam base 64, yang merupakan encoding umum yang diterima oleh berbagai alat yang tidak dapat menerima data biner. Base64 biasanya digunakan dalam protokol internet seperti email, HTTP, atau dalam dokumen 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);

Parameter

Return

String — representasi berenkode base-64 untuk string input dengan Charset yang diberikan

Menghasilkan string berenkode web-safe base-64 dari array byte yang diberikan. Base64 adalah encoding umum yang diterima oleh berbagai alat yang tidak dapat menerima data biner. Safe web Base 64 biasanya digunakan dalam protokol internet seperti email, HTTP, atau dalam dokumen 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);

Parameter

Return

String — representasi berenkode base-64 yang aman bagi web dari data yang diteruskan

Menghasilkan string yang dienkode dengan aman di web base-64 dari string yang diberikan. Base64 adalah encoding umum yang diterima oleh berbagai alat yang tidak dapat menerima data biner. Web-safe Base 64 biasanya digunakan dalam protokol internet seperti email, HTTP, atau dokumen XML.

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

Parameter

Return

String — representasi berenkode base-64 yang aman untuk web dari string input

Menghasilkan string berenkode base-64 yang aman bagi web dari string tertentu dalam kumpulan karakter tertentu. Charset adalah cara untuk mengenkode karakter sehingga dapat dienkode. Ini biasanya dilakukan dalam format biner, yang umumnya tidak kompatibel dengan protokol transmisi data tertentu. Untuk membuat data tersebut kompatibel, umumnya dienkode ke dalam base 64, yang merupakan encoding umum yang diterima oleh berbagai alat yang tidak dapat menerima data biner. Safe web base 64 umumnya digunakan dalam protokol internet seperti email, HTTP, atau dalam dokumen 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);

Parameter

Return

String — representasi berenkode base-64 yang aman untuk web dari string input dengan Charset yang diberikan

Menghitung ringkasan menggunakan algoritme yang ditentukan pada nilai Byte[] yang ditentukan.

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

Parameter

Return

Byte[] — byte[] yang mewakili digest output

Menghitung ringkasan menggunakan algoritme yang ditentukan pada nilai String yang ditentukan.

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

Parameter

Return

Byte[] — byte[] yang mewakili digest output

Menghitung digest menggunakan algoritme yang ditentukan pada nilai String yang ditentukan dengan himpunan karakter yang diberikan.

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

Parameter

Return

Byte[] — byte[] yang mewakili digest output

Menandatangani nilai yang diberikan menggunakan HMAC-SHA256 dengan kunci yang diberikan.

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

Parameter

Return

Byte[] — byte[] yang mewakili tanda tangan output

Menandatangani nilai yang diberikan menggunakan HMAC-SHA256 dengan kunci yang diberikan.

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

Parameter

Return

Byte[] — byte[] yang mewakili tanda tangan output

Menandatangani nilai yang diberikan menggunakan HMAC-SHA256 dengan kunci dan himpunan karakter yang diberikan.

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

Parameter

Return

Byte[] — byte[] yang mewakili tanda tangan output

Menghitung kode autentikasi pesan menggunakan algoritme yang ditentukan pada kunci dan nilai yang ditentukan.

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

Parameter

Return

Byte[] — byte[] yang mewakili tanda tangan output

Menghitung kode autentikasi pesan menggunakan algoritme yang ditentukan pada kunci dan nilai yang ditentukan.

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

Parameter

Return

Byte[] — byte[] yang mewakili tanda tangan output

Menghitung kode autentikasi pesan menggunakan algoritme yang ditentukan pada kunci dan nilai yang ditentukan.

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

Parameter

Return

Byte[] — byte[] yang mewakili tanda tangan output

Menandatangani nilai yang diberikan menggunakan RSA-SHA1 dengan kunci yang diberikan.

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

Parameter

Return

Byte[] — Byte[] yang mewakili tanda tangan output.

Menandatangani nilai yang diberikan menggunakan RSA-SHA1 dengan kunci dan charset yang ditentukan.

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

Parameter

Return

Byte[] — Byte[] yang mewakili tanda tangan output.

Menandatangani nilai yang diberikan menggunakan RSA-SHA256 dengan kunci yang diberikan.

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

Parameter

Return

Byte[] — byte[] yang mewakili tanda tangan output

Menandatangani nilai yang diberikan menggunakan RSA-SHA256 dengan kunci yang diberikan.

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

Parameter

Return

Byte[] — byte[] yang mewakili tanda tangan output

Menandatangani nilai yang diberikan menggunakan algoritme RSA yang ditentukan dengan kunci yang diberikan.

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

Parameter

Return

Byte[] — Byte[] yang mewakili tanda tangan output.

Menandatangani nilai yang diberikan menggunakan algoritme RSA yang ditentukan dengan kunci dan charset yang ditentukan.

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

Parameter

Return

Byte[] — Byte[] yang mewakili tanda tangan output.

Memformat tanggal sesuai dengan spesifikasi yang dijelaskan dalam class SimpleDateFormat Java SE. Harap lihat spesifikasinya di 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);

Parameter

Return

String — tanggal input sebagai string yang diformat

Melakukan pemformatan string seperti sprintf menggunakan string format bergaya '%'.

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

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

Parameter

Return

String — string yang diformat.

Dapatkan UUID sebagai string (setara dengan penggunaan metode java.util.UUID.randomUUID()). ID ini tidak dijamin unik sepanjang waktu dan ruang. Dengan demikian, jangan gunakan dalam situasi ketika jaminan keunikan diperlukan.

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

Return

String — representasi string dari UUID

gzip akan mengompresi data Blob yang disediakan dan menampilkannya dalam objek Blob baru.

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

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

Parameter

Return

Blob — Blob baru yang berisi data yang dikompresi.

gzip akan mengompresi data Blob yang disediakan dan menampilkannya dalam objek Blob baru. Versi metode ini memungkinkan nama file ditentukan.

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

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

Parameter

Return

Blob — Blob baru yang berisi data yang dikompresi.

Membuat objek Blob baru dari array byte. Blob digunakan di banyak Apps Script API yang menggunakan data biner sebagai input.

Parameter

Return

Blob — Blob yang baru dibuat

Buat objek Blob baru dari array byte dan jenis konten. Blob digunakan di banyak API Apps Script yang menggunakan data biner sebagai input.

Parameter

Return

Blob — Blob yang baru dibuat

Buat objek Blob baru dari array byte, jenis konten, dan nama. Blob digunakan di banyak API Apps Script yang menggunakan data biner sebagai input.

Parameter

Return

Blob — Blob yang baru dibuat

Buat objek Blob baru dari string. Blob digunakan di banyak Apps Script API yang menggunakan data biner sebagai input.

Parameter

Return

Blob — Blob yang baru dibuat

Buat objek Blob baru dari string dan jenis konten. Blob digunakan di banyak API Apps Script yang menggunakan data biner sebagai input.

Parameter

Return

Blob — Blob yang baru dibuat

Buat objek Blob baru dari string, jenis konten, dan nama. Blob digunakan di banyak API Apps Script yang menggunakan data biner sebagai input.

Parameter

Return

Blob — Blob yang baru dibuat

Menampilkan representasi array 2D tabel dari string 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);

Parameter

Return

String[][] — array dua dimensi yang berisi nilai dalam string CSV

Menampilkan representasi array 2D tabel dari string CSV menggunakan pembatas kustom.

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

Parameter

Return

String[][] — array dua dimensi yang berisi nilai dalam string CSV

Menguraikan tanggal string yang disediakan sesuai dengan spesifikasi yang dijelaskan dalam class SimpleDateFormat Edisi Standar Java. Untuk informasi selengkapnya, lihat class SimpleDateFormat 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);

Parameter

Return

Date — String input sebagai tanggal.

Tidur untuk jumlah milidetik yang ditentukan. Langsung membuat skrip tidur selama jumlah milidetik yang ditentukan. Nilai maksimum yang diizinkan adalah 300.000 (atau 5 menit).

Parameter

Mengompresi objek Blob dan menampilkan Blob yang berisi data yang tidak dikompresi.

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

Parameter

Return

Blob — Blob yang mewakili data yang didekompresi.

Mengambil Blob yang mewakili file zip dan menampilkan file komponennya.

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

Parameter

Return

Blob[] — Blob[] yang mewakili blob komponen, masing-masing diberi nama dengan jalur lengkap di dalam zip

Membuat objek Blob baru yang merupakan file zip yang berisi data dari Blob yang diteruskan.

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

Parameter

Return

Blob — blob baru yang berisi input sebagai arsip

Membuat objek Blob baru yang merupakan file zip yang berisi data dari Blob yang diteruskan. Versi metode ini memungkinkan nama file ditentukan.

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

Parameter

Return

Blob — blob baru yang berisi input sebagai arsip