Class Utilities

Утилиты

Этот сервис предоставляет утилиты для кодирования/декодирования строк, форматирования даты, обработки JSON и других разных задач.

Характеристики

Имущество Тип Описание
Charset Charset
DigestAlgorithm DigestAlgorithm
MacAlgorithm MacAlgorithm
RsaAlgorithm RsaAlgorithm

Методы

Метод Тип возврата Краткое описание
base64Decode(encoded) Byte[] Декодирует строку в кодировке base-64 в массив байтов UTF-8.
base64Decode(encoded, charset) Byte[] Декодирует строку в кодировке Base-64 в массив байтов в определенном наборе символов.
base64DecodeWebSafe(encoded) Byte[] Декодирует закодированную строку base-64 в веб-безопасный массив байтов UTF-8.
base64DecodeWebSafe(encoded, charset) Byte[] Декодирует строку, закодированную в формате base-64, в веб-кодировку в массив байтов в определенном наборе символов.
base64Encode(data) String Генерирует строку в кодировке base-64 из заданного массива байтов.
base64Encode(data) String Генерирует строку в кодировке base-64 из заданной строки.
base64Encode(data, charset) String Генерирует строку в кодировке base-64 из заданной строки в определенном наборе символов.
base64EncodeWebSafe(data) String Генерирует строку в кодировке base-64 из заданного массива байтов.
base64EncodeWebSafe(data) String Генерирует из заданной строки строку, закодированную в безопасном веб-формате base-64.
base64EncodeWebSafe(data, charset) String Генерирует строку в кодировке base-64 из заданной строки в определенном наборе символов.
computeDigest(algorithm, value) Byte[] Вычислить дайджест, используя указанный алгоритм для указанного значения Byte[] .
computeDigest(algorithm, value) Byte[] Вычислить дайджест, используя указанный алгоритм для указанного значения String .
computeDigest(algorithm, value, charset) Byte[] Вычислить дайджест, используя указанный алгоритм для указанного значения String с заданным набором символов.
computeHmacSha256Signature(value, key) Byte[] Подписывает предоставленное значение, используя HMAC-SHA256 с заданным ключом.
computeHmacSha256Signature(value, key) Byte[] Подписывает предоставленное значение, используя HMAC-SHA256 с заданным ключом.
computeHmacSha256Signature(value, key, charset) Byte[] Подписывает предоставленное значение с помощью HMAC-SHA256 с заданным ключом и набором символов.
computeHmacSignature(algorithm, value, key) Byte[] Вычислите код проверки подлинности сообщения, используя указанный алгоритм для указанного ключа и значения.
computeHmacSignature(algorithm, value, key) Byte[] Вычислите код проверки подлинности сообщения, используя указанный алгоритм для указанного ключа и значения.
computeHmacSignature(algorithm, value, key, charset) Byte[] Вычислите код проверки подлинности сообщения, используя указанный алгоритм для указанного ключа и значения.
computeRsaSha1Signature(value, key) Byte[] Подписывает предоставленное значение, используя RSA-SHA1 с заданным ключом.
computeRsaSha1Signature(value, key, charset) Byte[] Подписывает предоставленное значение, используя RSA-SHA1 с заданным ключом и кодировкой.
computeRsaSha256Signature(value, key) Byte[] Подписывает предоставленное значение, используя RSA-SHA256 с заданным ключом.
computeRsaSha256Signature(value, key, charset) Byte[] Подписывает предоставленное значение, используя RSA-SHA256 с заданным ключом.
computeRsaSignature(algorithm, value, key) Byte[] Подписывает предоставленное значение, используя указанный алгоритм RSA с заданным ключом.
computeRsaSignature(algorithm, value, key, charset) Byte[] Подписывает предоставленное значение, используя указанный алгоритм RSA с заданным ключом и набором символов.
formatDate(date, timeZone, format) String Форматирует дату в соответствии со спецификацией, описанной в классе Java SE SimpleDateFormat.
formatString(template, args) String Выполняет форматирование строк в стиле sprintf , используя строки формата в стиле '%'.
getUuid() String Получите UUID в виде строки (эквивалентно использованию метода java.util.UUID.randomUUID() ).
gzip(blob) Blob gzip — Blob предоставленные данные большого двоичного объекта и возвращает их в новый объект большого Blob объекта.
gzip(blob, name) Blob gzip — Blob предоставленные данные большого двоичного объекта и возвращает их в новый объект большого Blob объекта.
newBlob(data) Blob Создайте новый объект Blob из массива байтов.
newBlob(data, contentType) Blob Создайте новый объект Blob из массива байтов и типа контента.
newBlob(data, contentType, name) Blob Создайте новый объект Blob из массива байтов, типа содержимого и имени.
newBlob(data) Blob Создайте новый объект Blob из строки.
newBlob(data, contentType) Blob Создайте новый объект Blob из строки и типа контента.
newBlob(data, contentType, name) Blob Создайте новый объект Blob из строки, типа содержимого и имени.
parseCsv(csv) String[][] Возвращает табличное представление двумерного массива строки CSV.
parseCsv(csv, delimiter) String[][] Возвращает табличное представление двумерного массива строки CSV с использованием пользовательского разделителя.
parseDate(date, timeZone, format) Date Разбирает предоставленную строковую дату в соответствии со спецификацией, описанной в классе SimpleDateFormat Java Standard Edition.
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)

Декодирует строку в кодировке base-64 в массив байтов UTF-8.

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

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

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

Параметры

Имя Тип Описание
encoded String массив байтов данных для декодирования

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

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

base64Decode(encoded, charset)

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

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

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

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

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

Параметры

Имя Тип Описание
encoded String строка данных для декодирования
charset Charset a Charset , указывающий кодировку ввода

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

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

base64DecodeWebSafe(encoded)

Декодирует закодированную строку base-64 в веб-безопасный массив байтов UTF-8.

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

var decoded = Utilities.base64DecodeWebSafe(base64data);

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

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

Параметры

Имя Тип Описание
encoded String массив байтов веб-безопасных данных для декодирования

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

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

base64DecodeWebSafe(encoded, charset)

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

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

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

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

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

Параметры

Имя Тип Описание
encoded String строка веб-безопасных данных для декодирования
charset Charset a Charset , указывающий кодировку ввода

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

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

base64Encode(data)

Генерирует строку в кодировке base-64 из заданного массива байтов. 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);

Параметры

Имя Тип Описание
data Byte[] byte[] данных для кодирования

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

String — представление передаваемых данных в кодировке base-64.

base64Encode(data)

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

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

Параметры

Имя Тип Описание
data String строка для кодирования

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

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

base64Encode(data, charset)

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

Параметры

Имя Тип Описание
data String строка данных для кодирования
charset Charset a Charset , указывающий кодировку ввода

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

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

base64EncodeWebSafe(data)

Генерирует строку в кодировке base-64 из заданного массива байтов. 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);

Параметры

Имя Тип Описание
data Byte[] массив байтов данных для кодирования

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

String — закодированное в base-64 веб-представление переданных данных.

base64EncodeWebSafe(data)

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

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

Параметры

Имя Тип Описание
data String строка для кодирования

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

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

base64EncodeWebSafe(data, charset)

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

Параметры

Имя Тип Описание
data String строка данных для кодирования
charset Charset a Charset , указывающий кодировку ввода

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

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

computeDigest(algorithm, value)

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

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

Параметры

Имя Тип Описание
algorithm DigestAlgorithm DigestAlgorithm для использования
value Byte[] входное строковое значение для вычисления дайджеста для

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

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

computeDigest(algorithm, value)

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

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

Параметры

Имя Тип Описание
algorithm DigestAlgorithm DigestAlgorithm для использования
value String входное строковое значение для вычисления дайджеста для

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

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

computeDigest(algorithm, value, charset)

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

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

Параметры

Имя Тип Описание
algorithm DigestAlgorithm DigestAlgorithm для использования
value String входное строковое значение для вычисления дайджеста для
charset Charset a Charset , представляющий набор входных символов

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

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

computeHmacSha256Signature(value, key)

Подписывает предоставленное значение, используя HMAC-SHA256 с заданным ключом.

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

Параметры

Имя Тип Описание
value Byte[] входное значение для генерации хэша для
key Byte[] ключ для использования для генерации хэша с

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

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

computeHmacSha256Signature(value, key)

Подписывает предоставленное значение, используя HMAC-SHA256 с заданным ключом.

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

Параметры

Имя Тип Описание
value String входное значение для генерации хэша для
key String ключ для использования для генерации хэша с

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

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

computeHmacSha256Signature(value, key, charset)

Подписывает предоставленное значение с помощью HMAC-SHA256 с заданным ключом и набором символов.

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

Параметры

Имя Тип Описание
value String входное значение для генерации хэша для
key String ключ для использования для генерации хэша с
charset Charset a Charset , представляющий набор входных символов

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

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

computeHmacSignature(algorithm, value, key)

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

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

Параметры

Имя Тип Описание
algorithm MacAlgorithm алгоритм MacAlgorithm , используемый для хеширования входного значения
value Byte[] входное значение для генерации хэша для
key Byte[] ключ для использования для генерации хэша с

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

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

computeHmacSignature(algorithm, value, key)

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

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

Параметры

Имя Тип Описание
algorithm MacAlgorithm алгоритм MacAlgorithm , используемый для хеширования входного значения
value String входное значение для генерации хэша для
key String ключ для использования для генерации хэша с

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

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

computeHmacSignature(algorithm, value, key, charset)

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

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

Параметры

Имя Тип Описание
algorithm MacAlgorithm алгоритм MacAlgorithm , используемый для хеширования входного значения
value String входное значение для генерации хэша для
key String ключ для использования для генерации хэша с
charset Charset a Charset , представляющий набор входных символов

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

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

computeRsaSha1Signature(value, key)

Подписывает предоставленное значение, используя RSA-SHA1 с заданным ключом.

// This writes an array of bytes to the log.
var signature = Utilities.computeRsaSha1Signature("this is my input",
    "-----BEGIN PRIVATE KEY-----\nprivatekeyhere\n-----END PRIVATE KEY-----\n");
Logger.log(signature);

Параметры

Имя Тип Описание
value String Входное значение, для которого создается хэш.
key String Ключ в формате PEM, используемый для создания подписи.

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

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

computeRsaSha1Signature(value, key, charset)

Подписывает предоставленное значение, используя RSA-SHA1 с заданным ключом и кодировкой.

// This writes an array of bytes to the log.
var signature = Utilities.computeRsaSha1Signature("this is my input",
    "-----BEGIN PRIVATE KEY-----\nprivatekeyhere\n-----END PRIVATE KEY-----\n"
    Utilities.Charset.US_ASCII);
Logger.log(signature);

Параметры

Имя Тип Описание
value String Входное значение, для которого создается хэш.
key String Ключ в формате PEM, используемый для создания подписи.
charset Charset Набор Charset , представляющий входной набор символов.

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

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

computeRsaSha256Signature(value, key)

Подписывает предоставленное значение, используя RSA-SHA256 с заданным ключом.

// This writes an array of bytes to the log.
var signature = Utilities.computeRsaSha256Signature("this is my input",
    "-----BEGIN PRIVATE KEY-----\nprivatekeyhere\n-----END PRIVATE KEY-----\n");
Logger.log(signature);

Параметры

Имя Тип Описание
value String входное значение для генерации хэша для
key String ключ в формате PEM для использования для создания подписи

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

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

computeRsaSha256Signature(value, key, charset)

Подписывает предоставленное значение, используя RSA-SHA256 с заданным ключом.

// This writes an array of bytes to the log.
var signature = Utilities.computeRsaSha256Signature("this is my input",
    "-----BEGIN PRIVATE KEY-----\nprivatekeyhere\n-----END PRIVATE KEY-----\n");
Logger.log(signature);

Параметры

Имя Тип Описание
value String входное значение для генерации хэша для
key String ключ в формате PEM для использования для создания подписи
charset Charset a Charset , представляющий набор входных символов

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

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

computeRsaSignature(algorithm, value, key)

Подписывает предоставленное значение, используя указанный алгоритм RSA с заданным ключом.

// This writes an array of bytes to the log.
var signature = Utilities.computeRsaSignature(Utilities.RsaAlgorithm.RSA_SHA_256,
    "this is my input",
    "-----BEGIN PRIVATE KEY-----\nprivatekeyhere\n-----END PRIVATE KEY-----\n");
Logger.log(signature);

Параметры

Имя Тип Описание
algorithm RsaAlgorithm Алгоритм RsaAlgorithm , используемый для хеширования входного значения.
value String Входное значение, для которого создается хэш.
key String Ключ в формате PEM, используемый для создания подписи.

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

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

computeRsaSignature(algorithm, value, key, charset)

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

// This writes an array of bytes to the log.
var signature = Utilities.computeRsaSignature(Utilities.RsaAlgorithm.RSA_SHA_256,
    "this is my input",
    "-----BEGIN PRIVATE KEY-----\nprivatekeyhere\n-----END PRIVATE KEY-----\n",
    Utilities.Charset.US_ASCII);
Logger.log(signature);

Параметры

Имя Тип Описание
algorithm RsaAlgorithm Алгоритм RsaAlgorithm , используемый для хеширования входного значения.
value String Входное значение, для которого создается хэш.
key String Ключ в формате PEM, используемый для создания подписи.
charset Charset Набор Charset , представляющий входной набор символов.

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

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

formatDate(date, timeZone, format)

Форматирует дату в соответствии со спецификацией, описанной в классе Java SE SimpleDateFormat. Ознакомьтесь со спецификацией по адресу http://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html .

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

Параметры

Имя Тип Описание
date Date Date для форматирования в виде строки
timeZone String выходной часовой пояс результата
format String формат согласно спецификации SimpleDateFormat

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

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

formatString(template, args)

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

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

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

Параметры

Имя Тип Описание
template String Строка формата, управляющая тем, что возвращается.
args Object... Объекты, используемые для заполнения заполнителей «%» в шаблоне.

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

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

getUuid()

Получите UUID в виде строки (эквивалентно использованию метода java.util.UUID.randomUUID() ). Не гарантируется, что этот идентификатор будет уникальным во времени и пространстве. Таким образом, не используйте в ситуациях, когда требуется гарантированная уникальность.

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

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

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

gzip(blob)

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

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

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

Параметры

Имя Тип Описание
blob BlobSource объект Blob для сжатия с помощью gzip .

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

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

gzip(blob, name)

gzip — Blob предоставленные данные большого двоичного объекта и возвращает их в новый объект большого Blob объекта. Эта версия метода позволяет указать имя файла.

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

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

Параметры

Имя Тип Описание
blob BlobSource объект Blob для сжатия с помощью gzip .
name String имя создаваемого gzip -файла

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

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

newBlob(data)

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

Параметры

Имя Тип Описание
data Byte[] байты для большого двоичного объекта

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

Blob — только что созданный Blob

newBlob(data, contentType)

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

Параметры

Имя Тип Описание
data Byte[] байты для большого двоичного объекта
contentType String тип содержимого большого двоичного объекта — может быть нулевым

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

Blob — только что созданный Blob

newBlob(data, contentType, name)

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

Параметры

Имя Тип Описание
data Byte[] байты для большого двоичного объекта
contentType String - тип содержимого большого двоичного объекта - может быть нулевым
name String имя блоба - может быть нулевым

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

Blob — только что созданный Blob

newBlob(data)

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

Параметры

Имя Тип Описание
data String строка для большого двоичного объекта, предполагается, что UTF-8

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

Blob — только что созданный Blob

newBlob(data, contentType)

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

Параметры

Имя Тип Описание
data String строка для большого двоичного объекта, предполагается, что UTF-8
contentType String тип содержимого большого двоичного объекта — может быть нулевым

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

Blob — только что созданный Blob

newBlob(data, contentType, name)

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

Параметры

Имя Тип Описание
data String строка для большого двоичного объекта, предполагается, что UTF-8
contentType String тип содержимого большого двоичного объекта — может быть нулевым
name String имя блоба - может быть нулевым

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

Blob — только что созданный Blob

parseCsv(csv)

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

Параметры

Имя Тип Описание
csv String строка, содержащая однострочные или многострочные данные в формате значений, разделенных запятыми (CSV)

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

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

parseCsv(csv, delimiter)

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

Параметры

Имя Тип Описание
csv String строка, содержащая однострочные или многострочные данные в формате значений, разделенных запятыми (CSV)
delimiter Char между значениями

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

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

parseDate(date, timeZone, format)

Разбирает предоставленную строковую дату в соответствии со спецификацией, описанной в классе 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 String Строковое значение для анализа как дата.
timeZone String Выходной часовой пояс.
format String Формат даты согласно спецификации SimpleDateFormat .

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

Date — Входная строка в виде даты.

sleep(milliseconds)

Засыпает на указанное количество миллисекунд. Немедленно переводит скрипт в спящий режим на указанное количество миллисекунд. Максимально допустимое значение — 300 000 (или 5 минут).

Параметры

Имя Тип Описание
milliseconds Integer Количество миллисекунд до сна.

ungzip(blob)

Распаковывает объект Blob и возвращает Blob , содержащий несжатые данные.

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

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

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

Параметры

Имя Тип Описание
blob BlobSource Blob сжатых данных.

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

Blob — Blob , представляющий распакованные данные.

unzip(blob)

Принимает объект 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 BlobSource большой двоичный объект zip-файла.

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

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

zip(blobs)

Создает новый объект Blob, представляющий собой ZIP-файл, содержащий данные из переданных BLOB-объектов.

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

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

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

Параметры

Имя Тип Описание
blobs BlobSource[] массив BLOB-объектов для архивирования

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

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

zip(blobs, name)

Создает новый объект Blob, представляющий собой ZIP-файл, содержащий данные из переданных BLOB-объектов. Эта версия метода позволяет указывать имя файла.

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

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

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

Параметры

Имя Тип Описание
blobs BlobSource[] массив BLOB-объектов для архивирования
name String имя создаваемого zip-файла

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

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

Устаревшие методы