Class Utilities

Декодирует строку в кодировке Base64 в массив байтов 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());

Параметры

Возвращаться

Byte[] — необработанные данные, представленные аргументом в кодировке Base64 в виде массива байтов.

Декодирует строку в кодировке Base64 в массив байтов в определенном наборе символов.

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

Параметры

Возвращаться

Byte[] — необработанные данные, представленные аргументом в кодировке Base64 в виде массива байтов.

Декодирует строку, закодированную в веб-безопасном формате Base64, в массив байтов 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());

Параметры

Возвращаться

Byte[] — необработанные данные, представленные аргументом, закодированным в веб-безопасности base-64, в виде массива байтов.

Декодирует строку, закодированную в веб-безопасном формате Base64, в массив байтов в определенном наборе символов.

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

Параметры

Возвращаться

Byte[] — необработанные данные, представленные аргументом, закодированным в веб-безопасности base-64, в виде массива байтов.

Генерирует строку в кодировке Base64 из заданного массива байтов. Base 64 — это распространенная кодировка, принимаемая различными инструментами, которые не могут принимать двоичные данные. 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.base64Encode(blob.getBytes());
Logger.log(encoded);

Параметры

Возвращаться

String — представление переданных данных в кодировке Base64.

Генерирует строку в кодировке Base64 из заданной строки. Base 64 — это распространенная кодировка, принимаемая различными инструментами, которые не могут принимать двоичные данные. Base 64 обычно используется в интернет-протоколах, таких как электронная почта, HTTP или в документах XML.

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

Параметры

Возвращаться

String — представление входной строки в кодировке Base64.

Генерирует строку в кодировке Base64 из заданной строки в определенном наборе символов. Кодировка — это способ кодирования символов, позволяющий их кодировать. Обычно они выполняются в двоичном формате, который обычно может быть несовместим с некоторыми протоколами передачи данных. Чтобы сделать данные совместимыми, их обычно кодируют в кодировке Base 64, которая является общепринятой кодировкой, принимаемой различными инструментами, которые не могут принимать двоичные данные. Base 64 обычно используется в интернет-протоколах, таких как электронная почта, 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);

Параметры

Возвращаться

String — Представление входной строки в кодировке Base-64 с заданным Charset .

Генерирует строку в веб-кодировке Base64 из заданного массива байтов. Base 64 — это распространенная кодировка, принимаемая различными инструментами, которые не могут принимать двоичные данные. Веб-безопасность 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);

Параметры

Возвращаться

String — веб-безопасное представление передаваемых данных в формате Base64.

Генерирует строку в веб-кодировке Base64 из заданной строки. Base 64 — это распространенная кодировка, принимаемая различными инструментами, которые не могут принимать двоичные данные. Веб-безопасность Base 64 обычно используется в интернет-протоколах, таких как электронная почта, HTTP или в XML-документах.

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

Параметры

Возвращаться

String — представление входной строки в веб-коде Base64.

Генерирует строку в веб-кодировке Base64 из заданной строки в определенном наборе символов. Кодировка — это способ кодирования символов, позволяющий их кодировать. Обычно они выполняются в двоичном формате, который обычно может быть несовместим с некоторыми протоколами передачи данных. Чтобы сделать данные совместимыми, их обычно кодируют в кодировке Base 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);

Параметры

Возвращаться

String — представление входной строки в веб-коде Base64 с заданным Charset .

Вычислите дайджест, используя указанный алгоритм для указанного значения Byte[] .

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

Параметры

Возвращаться

Byte[] — Байт[], представляющий выходной дайджест.

Вычислите дайджест, используя указанный алгоритм для указанного String значения.

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

Параметры

Возвращаться

Byte[] — Байт[], представляющий выходной дайджест.

Вычислите дайджест, используя указанный алгоритм для указанного значения String с заданным набором символов.

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

Параметры

Возвращаться

Byte[] — Байт[], представляющий выходной дайджест.

Подписывает предоставленное значение с помощью 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);

Параметры

Возвращаться

Byte[] — Байт[], представляющий выходную подпись.

Подписывает предоставленное значение с помощью 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);

Параметры

Возвращаться

Byte[] — Байт[], представляющий выходную подпись.

Подписывает предоставленное значение с помощью 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);

Параметры

Возвращаться

Byte[] — Байт[], представляющий выходную подпись.

Вычислите код аутентификации сообщения, используя указанный алгоритм для указанного ключа и значения.

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

Параметры

Возвращаться

Byte[] — Байт[], представляющий выходную подпись.

Вычислите код аутентификации сообщения, используя указанный алгоритм для указанного ключа и значения.

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

Параметры

Возвращаться

Byte[] — Байт[], представляющий выходную подпись.

Вычислите код аутентификации сообщения, используя указанный алгоритм для указанного ключа и значения.

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

Параметры

Возвращаться

Byte[] — Байт[], представляющий выходную подпись.

Подписывает предоставленное значение с помощью 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);

Параметры

Возвращаться

Byte[] — Байт[], представляющий выходную подпись.

Подписывает предоставленное значение с помощью 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);

Параметры

Возвращаться

Byte[] — Байт[], представляющий выходную подпись.

Подписывает предоставленное значение с помощью 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);

Параметры

Возвращаться

Byte[] — Байт[], представляющий выходную подпись.

Подписывает предоставленное значение с помощью 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);

Параметры

Возвращаться

Byte[] — Байт[], представляющий выходную подпись.

Подписывает предоставленное значение, используя указанный алгоритм 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);

Параметры

Возвращаться

Byte[] — Байт[], представляющий выходную подпись.

Подписывает предоставленное значение, используя указанный алгоритм 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);

Параметры

Возвращаться

Byte[] — Байт[], представляющий выходную подпись.

Форматирует дату в соответствии со спецификацией, описанной в классе 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);

Параметры

Возвращаться

String — Входная дата в виде форматированной строки.

Выполняет форматирование строк в стиле sprintf с использованием строк формата '%'.

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

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

Параметры

Возвращаться

String — форматированная строка.

Получите 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 и возвращает их в новом объекте Blob .

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

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

Параметры

Возвращаться

Blob — новый Blob , содержащий сжатые данные.

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 — новый Blob , содержащий сжатые данные.

Создайте новый объект Blob из массива байтов. Большие двоичные объекты используются во многих API-интерфейсах Apps Script, которые принимают двоичные данные в качестве входных данных.

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

Параметры

Возвращаться

Blob — недавно созданный Blob.

Создайте новый объект Blob на основе байтового массива и типа контента. Большие двоичные объекты используются во многих API-интерфейсах Apps Script, которые принимают двоичные данные в качестве входных данных.

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

Параметры

Возвращаться

Blob — недавно созданный Blob.

Создайте новый объект Blob на основе байтового массива, типа контента и имени. Большие двоичные объекты используются во многих API-интерфейсах Apps Script, которые принимают двоичные данные в качестве входных данных.

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

Параметры

Возвращаться

Blob — недавно созданный Blob.

Создайте новый объект Blob из строки. Большие двоичные объекты используются во многих API-интерфейсах Apps Script, которые принимают двоичные данные в качестве входных данных.

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

Параметры

Возвращаться

Blob — недавно созданный Blob.

Создайте новый объект Blob на основе строки и типа контента. Большие двоичные объекты используются во многих API-интерфейсах Apps Script, которые принимают двоичные данные в качестве входных данных.

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

Параметры

Возвращаться

Blob — недавно созданный Blob.

Создайте новый объект Blob на основе строки, типа контента и имени. Большие двоичные объекты используются во многих API-интерфейсах Apps Script, которые принимают двоичные данные в качестве входных данных.

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

Параметры

Возвращаться

Blob — недавно созданный Blob.

Возвращает табличное представление двумерного массива строки 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);

Параметры

Возвращаться

String[][] — двумерный массив, содержащий значения в строке CSV.

Возвращает табличное представление 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');

Параметры

Возвращаться

String[][] — двумерный массив, содержащий значения в строке CSV.

Анализирует предоставленную строку даты в соответствии со спецификацией, описанной в классе SimpleDateFormat Java Standard Edition. Для получения дополнительной информации см. класс 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 — Входная строка в виде даты.

Спит в течение указанного количества миллисекунд. Немедленно переводит скрипт в спящий режим на указанное количество миллисекунд. Максимально допустимое значение — 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());

Параметры

Распаковывает объект 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 — 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);

Параметры

Возвращаться

Blob[] — объект Blob[], представляющий BLOB-объекты компонента, каждый из которых имеет полный путь внутри zip-архива.

Создает новый объект 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]);

Параметры

Возвращаться

Blob — новый большой двоичный объект, содержащий входные данные в виде архива.

Создает новый объект 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");

Параметры

Возвращаться

Blob — новый большой двоичный объект, содержащий входные данные в виде архива.