Ta strona została przetłumaczona przez Cloud Translation API.

Class Utilities

Ta usługa udostępnia narzędzia do kodowania i dekodowania ciągu znaków, formatowania dat, manipulowania danymi JSON oraz wykonywania innych zadań.

Właściwości

Właściwość	Typ	Opis
`Charset`	`Charset`
`DigestAlgorithm`	`DigestAlgorithm`
`MacAlgorithm`	`MacAlgorithm`
`RsaAlgorithm`	`RsaAlgorithm`

Metody

Metoda	Zwracany typ	Krótki opis
`base64Decode(encoded)`	`Byte[]`	Dekoduje ciąg zakodowany w formacie base64 do postaci tablicy bajtów UTF-8.
`base64Decode(encoded, charset)`	`Byte[]`	Dekoduje ciąg zakodowany w standardzie Base64 do postaci tablicy bajtów w określonym zbiorze znaków.
`base64DecodeWebSafe(encoded)`	`Byte[]`	Dekoduje ciąg znaków zakodowany w standardzie base64 w internecie do postaci tablicy bajtów UTF-8.
`base64DecodeWebSafe(encoded, charset)`	`Byte[]`	Dekoduje ciąg tekstowy zakodowany w standardzie base64 w internecie do postaci tablicy bajtów w określonym zbiorze znaków.
`base64Encode(data)`	`String`	Generuje ciąg zakodowany w formacie Base64 z danej tablicy bajtów.
`base64Encode(data)`	`String`	Generuje ciąg zakodowany w formacie Base64 na podstawie podanego ciągu.
`base64Encode(data, charset)`	`String`	Generuje ciąg zakodowany w formacie Base64 z podanego ciągu w określonym zbiorze znaków.
`base64EncodeWebSafe(data)`	`String`	Generuje ciąg znaków zakodowany w standardzie base64 z danej tablicy bajtów.
`base64EncodeWebSafe(data)`	`String`	Generuje z danego ciągu ciąg zakodowany w standardzie base64 obsługiwany w internecie.
`base64EncodeWebSafe(data, charset)`	`String`	Generuje ciąg tekstowy zakodowany w standardzie base64 z podanego ciągu tekstowego w określonym zbiorze znaków.
`computeDigest(algorithm, value)`	`Byte[]`	Oblicz digest za pomocą podanego algorytmu na podstawie określonej wartości `Byte[]`.
`computeDigest(algorithm, value)`	`Byte[]`	Oblicz digest za pomocą podanego algorytmu na podstawie określonej wartości `String`.
`computeDigest(algorithm, value, charset)`	`Byte[]`	Oblicz digest za pomocą podanego algorytmu na podstawie wartości `String` w danym zbiorze znaków.
`computeHmacSha256Signature(value, key)`	`Byte[]`	Podpisuje podaną wartość za pomocą algorytmu HMAC-SHA256 z danym kluczem.
`computeHmacSha256Signature(value, key)`	`Byte[]`	Podpisuje podaną wartość za pomocą algorytmu HMAC-SHA256 z danym kluczem.
`computeHmacSha256Signature(value, key, charset)`	`Byte[]`	Podpisuje podaną wartość za pomocą funkcji HMAC-SHA256 z danym kluczem i zbiorem znaków.
`computeHmacSignature(algorithm, value, key)`	`Byte[]`	Obliczanie kodu uwierzytelniania wiadomości za pomocą podanego algorytmu na podstawie podanego klucza i wartości.
`computeHmacSignature(algorithm, value, key)`	`Byte[]`	Obliczanie kodu uwierzytelniania wiadomości za pomocą podanego algorytmu na podstawie podanego klucza i wartości.
`computeHmacSignature(algorithm, value, key, charset)`	`Byte[]`	Obliczanie kodu uwierzytelniania wiadomości za pomocą podanego algorytmu na podstawie podanego klucza i wartości.
`computeRsaSha1Signature(value, key)`	`Byte[]`	Podpisuje podaną wartość za pomocą algorytmu RSA-SHA1 przy użyciu podanego klucza.
`computeRsaSha1Signature(value, key, charset)`	`Byte[]`	Podpisuje podaną wartość za pomocą algorytmu RSA-SHA1 z danym kluczem i zbiórem znaków.
`computeRsaSha256Signature(value, key)`	`Byte[]`	Podpisuje podaną wartość za pomocą algorytmu RSA-SHA256 z danym kluczem.
`computeRsaSha256Signature(value, key, charset)`	`Byte[]`	Podpisuje podaną wartość za pomocą algorytmu RSA-SHA256 z danym kluczem.
`computeRsaSignature(algorithm, value, key)`	`Byte[]`	Podpisuje podaną wartość za pomocą podanego algorytmu RSA i klucza.
`computeRsaSignature(algorithm, value, key, charset)`	`Byte[]`	Podpisuje podaną wartość za pomocą podanego algorytmu RSA z kluczem i zbiórem znaków.
`formatDate(date, timeZone, format)`	`String`	Formatuje datę zgodnie ze specyfikacją opisaną w klasie Java SE SimpleDateFormat.
`formatString(template, args)`	`String`	Formatuje ciągi znaków w sposób podobny do funkcji `sprintf`, używając ciągów formatu w stylu „%”.
`getUuid()`	`String`	Pobierz identyfikator UUID jako ciąg znaków (to działanie jest równoważne użyciu metody `java.util.UUID.randomUUID()`).
`gzip(blob)`	`Blob`	`gzip` – kompresuje podane dane `Blob` i zwraca je w nowym obiekcie `Blob`.
`gzip(blob, name)`	`Blob`	`gzip` – kompresuje podane dane `Blob` i zwraca je w nowym obiekcie `Blob`.
`newBlob(data)`	`Blob`	Tworzenie nowego obiektu Blob z tablicy bajtów.
`newBlob(data, contentType)`	`Blob`	Utwórz nowy obiekt Blob na podstawie tablicy bajtów i typu treści.
`newBlob(data, contentType, name)`	`Blob`	Utwórz nowy obiekt Blob na podstawie tablicy bajtów, typu treści i nazwy.
`newBlob(data)`	`Blob`	Utwórz nowy obiekt Blob na podstawie ciągu znaków.
`newBlob(data, contentType)`	`Blob`	Utwórz nowy obiekt Blob na podstawie ciągu znaków i typu treści.
`newBlob(data, contentType, name)`	`Blob`	Utwórz nowy obiekt Blob na podstawie ciągu znaków, typu treści i nazwy.
`parseCsv(csv)`	`String[][]`	Zwraca tablicową reprezentację tablicy dwuwymiarowej ciągu CSV.
`parseCsv(csv, delimiter)`	`String[][]`	Zwraca tablicową reprezentację tablicy dwuwymiarowej ciągu CSV za pomocą niestandardowego ogranicznika.
`parseDate(date, timeZone, format)`	`Date`	Parsuje podany ciąg znaków zgodnie ze specyfikacją opisaną w klasie Java Standard Edition `SimpleDateFormat`.
`sleep(milliseconds)`	`void`	Zatrzymuje działanie na określony czas w milisekundach.
`ungzip(blob)`	`Blob`	Dekompresuje obiekt `Blob` i zwraca obiekt `Blob` zawierający dane w postaci nieskompresowanej.
`unzip(blob)`	`Blob[]`	Odbiera obiekt Blob reprezentujący plik zip i zwraca jego pliki komponentów.
`zip(blobs)`	`Blob`	Tworzy nowy obiekt Blob, który jest plikiem ZIP zawierającym dane z przekazanych obiektów Blob.
`zip(blobs, name)`	`Blob`	Tworzy nowy obiekt Blob, który jest plikiem ZIP zawierającym dane z przekazanych obiektów Blob.

Wycofane metody

Metoda	Zwracany typ	Krótki opis
`jsonParse(jsonString)`	`Object`	Zwraca obiekt odpowiadający przekazanemu ciągowi znaków JSON.
`jsonStringify(obj)`	`String`	Zwraca ciąg znaków JSON obiektu przekazanego jako argument.

Szczegółowa dokumentacja

`base64Decode(encoded)`

Dekoduje ciąg zakodowany w formacie base64 do postaci tablicy bajtów 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());

Parametry

Nazwa	Typ	Opis
`encoded`	`String`	Tablica bajtów danych do zdekodowania.

Powrót

Byte[] – nieprzetworzone dane reprezentowane przez argument zakodowany w formacie Base64 jako tablica bajtów.

`base64Decode(encoded, charset)`

Dekoduje ciąg zakodowany w standardzie Base64 do postaci tablicy bajtów w określonym zbiorze znaków.

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

Parametry

Nazwa	Typ	Opis
`encoded`	`String`	Ciąg danych do dekodowania.
`charset`	`Charset`	`Charset` określający zestaw znaków danych wejściowych.

Powrót

Byte[] – nieprzetworzone dane reprezentowane przez argument zakodowany w formacie Base64 jako tablica bajtów.

`base64DecodeWebSafe(encoded)`

Dekoduje ciąg znaków zakodowany w standardzie base64 w internecie do postaci tablicy bajtów 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());

Parametry

Nazwa	Typ	Opis
`encoded`	`String`	Tablica bajtów danych bezpiecznych dla sieci do dekodowania.

Powrót

Byte[] – nieprzetworzone dane reprezentowane przez argument zakodowany w standardzie base64 w bezpiecznym formacie internetowym jako tablica bajtów.

`base64DecodeWebSafe(encoded, charset)`

Dekoduje ciąg tekstowy zakodowany w standardzie base64 w internecie do postaci tablicy bajtów w określonym zbiorze znaków.

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

Parametry

Nazwa	Typ	Opis
`encoded`	`String`	ciąg znaków danych bezpiecznych dla sieci do dekodowania;
`charset`	`Charset`	`Charset` określający zestaw znaków danych wejściowych.

Powrót

Byte[] – nieprzetworzone dane reprezentowane przez argument zakodowany w standardzie base64 w bezpiecznym formacie internetowym jako tablica bajtów.

`base64Encode(data)`

Generuje ciąg zakodowany w formacie Base64 z danej tablicy bajtów. Base64 to powszechny format kodowania, który jest obsługiwany przez wiele narzędzi, które nie mogą przyjmować danych binarnych. Podstawa 64 jest często używana w protokołach internetowych, takich jak poczta e-mail, HTTP czy dokumenty 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);

Parametry

Nazwa	Typ	Opis
`data`	`Byte[]`	tablica bajtów danych do zakodowania.

Powrót

String – zakodowana w formacie base64 reprezentacja przekazanych danych.

`base64Encode(data)`

Generuje ciąg zakodowany w formacie Base64 na podstawie podanego ciągu. Base64 to powszechne kodowanie stosowane przez różne narzędzia, które nie obsługują danych binarnych. Podstawa 64 jest często używana w protokołach internetowych, takich jak poczta e-mail czy HTTP, oraz w dokumentach XML.

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

Parametry

Nazwa	Typ	Opis
`data`	`String`	Ciąg do zakodowania.

Powrót

String – reprezentacja ciągu wejściowego zakodowana w formacie Base64.

`base64Encode(data, charset)`

Generuje ciąg zakodowany w formacie Base64 z podanego ciągu w określonym zbiorze znaków. Kodowanie znaków to sposób kodowania znaków. Zwykle są one zapisywane w formacie binarnym, który może być niezgodny z określonymi protokołami przesyłania danych. Aby dane były zgodne, są one zwykle kodowane w formacie base64, który jest powszechnie akceptowany przez różne narzędzia, które nie obsługują danych binarnych. Podstawa 64 jest często używana w protokołach internetowych, takich jak poczta e-mail, HTTP lub dokumenty 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);

Parametry

Nazwa	Typ	Opis
`data`	`String`	Ciąg znaków do zakodowania.
`charset`	`Charset`	`Charset` określający zestaw znaków danych wejściowych.

Powrót

String – reprezentacja ciągu wejściowego z kluczem Charset zakodowana w formacie Base64.

`base64EncodeWebSafe(data)`

Generuje ciąg znaków zakodowany w standardzie base64 z danej tablicy bajtów. Base64 to powszechny kod, który jest obsługiwany przez wiele narzędzi, które nie mogą przyjmować danych binarnych. Kodowanie Base64 jest często używane w protokołach internetowych, takich jak e-mail czy HTTP, oraz w dokumentach 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);

Parametry

Nazwa	Typ	Opis
`data`	`Byte[]`	Tablica bajtów danych do zakodowania.

Powrót

String – reprezentacja przekazanych danych w formacie base64 obsługiwanym w internecie.

`base64EncodeWebSafe(data)`

Generuje z danego ciągu ciąg zakodowany w standardzie base64 obsługiwany w internecie. Base64 to powszechny format kodowania, który jest obsługiwany przez wiele narzędzi, które nie mogą przyjmować danych binarnych. Kodowanie Base64 jest często używane w protokołach internetowych, takich jak e-mail czy HTTP, oraz w dokumentach XML.

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

Parametry

Nazwa	Typ	Opis
`data`	`String`	Ciąg do zakodowania.

Powrót

String – reprezentacja ciągu wejściowego w formacie base64 obsługiwanym w internecie.

`base64EncodeWebSafe(data, charset)`

Generuje ciąg tekstowy zakodowany w standardzie base64 z podanego ciągu tekstowego w określonym zbiorze znaków. Zestaw znaków to sposób kodowania znaków, który umożliwia ich kodowanie. Zwykle są one zapisywane w formacie binarnym, który może być niezgodny z pewnymi protokołami przesyłania danych. Aby zapewnić zgodność danych, są one zwykle kodowane w formacie base64, który jest powszechnym kodem obsługiwanym przez różne narzędzia, które nie mogą obsługiwać danych binarnych. Kodowanie Base64 jest często używane w protokołach internetowych, takich jak poczta e-mail czy HTTP, oraz w dokumentach 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);

Parametry

Nazwa	Typ	Opis
`data`	`String`	Ciąg znaków do zakodowania.
`charset`	`Charset`	`Charset` określający zestaw znaków danych wejściowych.

Powrót

String – reprezentacja ciągu wejściowego z danym Charset w formacie Base64 obsługiwanym w internecie.

`computeDigest(algorithm, value)`

Oblicz digest za pomocą podanego algorytmu na podstawie określonej wartości Byte[].

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

Parametry

Nazwa	Typ	Opis
`algorithm`	`DigestAlgorithm`	`DigestAlgorithm` do użycia.
`value`	`Byte[]`	Wartość ciągu wejściowego, dla której ma zostać obliczone skrót.

Powrót

Byte[] – tablica bajtów reprezentująca wynikowy digest.

`computeDigest(algorithm, value)`

Oblicz digest za pomocą podanego algorytmu na podstawie określonej wartości String.

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

Parametry

Nazwa	Typ	Opis
`algorithm`	`DigestAlgorithm`	`DigestAlgorithm` do użycia.
`value`	`String`	Wartość ciągu wejściowego, dla której ma zostać obliczone streszczenie.

Powrót

Byte[] – tablica bajtów reprezentująca wynikowy digest.

`computeDigest(algorithm, value, charset)`

Oblicz digest za pomocą podanego algorytmu na podstawie wartości String w danym zbiorze znaków.

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

Parametry

Nazwa	Typ	Opis
`algorithm`	`DigestAlgorithm`	`DigestAlgorithm` do użycia.
`value`	`String`	Wartość ciągu wejściowego, dla której ma zostać obliczone skrót.
`charset`	`Charset`	`Charset` reprezentujący zestaw znaków wejściowych.

Powrót

Byte[] – tablica bajtów reprezentująca wynikowy digest.

`computeHmacSha256Signature(value, key)`

Podpisuje podaną wartość za pomocą algorytmu HMAC-SHA256 z danym kluczem.

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

Parametry

Nazwa	Typ	Opis
`value`	`Byte[]`	Wartość wejściowa, dla której ma zostać wygenerowany hash.
`key`	`Byte[]`	Klucz do użycia do wygenerowania hasha.

Powrót

Byte[] – tablica bajtów reprezentująca podpis wyjściowy.

`computeHmacSha256Signature(value, key)`

Podpisuje podaną wartość za pomocą algorytmu HMAC-SHA256 z danym kluczem.

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

Parametry

Nazwa	Typ	Opis
`value`	`String`	Wartość wejściowa, dla której ma zostać wygenerowany hash.
`key`	`String`	Klucz do użycia do wygenerowania hasha.

Powrót

Byte[] – tablica bajtów reprezentująca podpis wyjściowy.

`computeHmacSha256Signature(value, key, charset)`

Podpisuje podaną wartość za pomocą funkcji HMAC-SHA256 z danym kluczem i zbiorem znaków.

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

Parametry

Nazwa	Typ	Opis
`value`	`String`	Wartość wejściowa, dla której ma zostać wygenerowany hash.
`key`	`String`	Klucz do użycia do wygenerowania hasha.
`charset`	`Charset`	`Charset` reprezentujący zestaw znaków wejściowych.

Powrót

Byte[] – tablica bajtów reprezentująca podpis wyjściowy.

`computeHmacSignature(algorithm, value, key)`

Obliczanie kodu uwierzytelniania wiadomości za pomocą podanego algorytmu na podstawie podanego klucza i wartości.

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

Parametry

Nazwa	Typ	Opis
`algorithm`	`MacAlgorithm`	Algorytm `MacAlgorithm` do użycia do zaszyfrowania wartości wejściowej.
`value`	`Byte[]`	Wartość wejściowa, dla której ma zostać wygenerowany hash.
`key`	`Byte[]`	Klucz do użycia do wygenerowania hasha.

Powrót

Byte[] – tablica bajtów reprezentująca podpis wyjściowy.

`computeHmacSignature(algorithm, value, key)`

Obliczanie kodu uwierzytelniania wiadomości za pomocą podanego algorytmu na podstawie podanego klucza i wartości.

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

Parametry

Nazwa	Typ	Opis
`algorithm`	`MacAlgorithm`	Algorytm `MacAlgorithm` do użycia do zaszyfrowania wartości wejściowej.
`value`	`String`	Wartość wejściowa, dla której ma zostać wygenerowany hash.
`key`	`String`	Klucz do użycia do wygenerowania hasha.

Powrót

Byte[] – tablica bajtów reprezentująca podpis wyjściowy.

`computeHmacSignature(algorithm, value, key, charset)`

Obliczanie kodu uwierzytelniania wiadomości za pomocą podanego algorytmu na podstawie podanego klucza i wartości.

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

Parametry

Nazwa	Typ	Opis
`algorithm`	`MacAlgorithm`	Algorytm `MacAlgorithm` do użycia do zaszyfrowania wartości wejściowej.
`value`	`String`	Wartość wejściowa, dla której ma zostać wygenerowany hash.
`key`	`String`	Klucz do użycia do wygenerowania hasha.
`charset`	`Charset`	`Charset` reprezentujący zestaw znaków wejściowych.

Powrót

Byte[] – tablica bajtów reprezentująca podpis wyjściowy.

`computeRsaSha1Signature(value, key)`

Podpisuje podaną wartość za pomocą algorytmu RSA-SHA1 przy użyciu podanego klucza.

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

Parametry

Nazwa	Typ	Opis
`value`	`String`	Wartość wejściowa, dla której ma zostać wygenerowany hash.
`key`	`String`	klucz w formacie PEM, którego należy użyć do wygenerowania podpisu.

Powrót

Byte[] – tablica bajtów reprezentująca podpis wyjściowy.

`computeRsaSha1Signature(value, key, charset)`

Podpisuje podaną wartość za pomocą algorytmu RSA-SHA1 z danym kluczem i zbiórem znaków.

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

Parametry

Nazwa	Typ	Opis
`value`	`String`	Wartość wejściowa, dla której ma zostać wygenerowany hash.
`key`	`String`	klucz w formacie PEM, którego należy użyć do wygenerowania podpisu.
`charset`	`Charset`	`Charset` reprezentujący zestaw znaków wejściowych.

Powrót

Byte[] – tablica bajtów reprezentująca podpis wyjściowy.

`computeRsaSha256Signature(value, key)`

Podpisuje podaną wartość za pomocą algorytmu RSA-SHA256 z danym kluczem.

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

Parametry

Nazwa	Typ	Opis
`value`	`String`	Wartość wejściowa, dla której ma zostać wygenerowany hash.
`key`	`String`	klucz w formacie PEM, którego należy użyć do wygenerowania podpisu.

Powrót

Byte[] – tablica bajtów reprezentująca podpis wyjściowy.

`computeRsaSha256Signature(value, key, charset)`

Podpisuje podaną wartość za pomocą algorytmu RSA-SHA256 z danym kluczem.

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

Parametry

Nazwa	Typ	Opis
`value`	`String`	Wartość wejściowa, dla której ma zostać wygenerowany hash.
`key`	`String`	klucz w formacie PEM, którego należy użyć do wygenerowania podpisu;
`charset`	`Charset`	`Charset` reprezentujący zestaw znaków wejściowych.

Powrót

Byte[] – tablica bajtów reprezentująca podpis wyjściowy.

`computeRsaSignature(algorithm, value, key)`

Podpisuje podaną wartość za pomocą podanego algorytmu RSA i klucza.

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

Parametry

Nazwa	Typ	Opis
`algorithm`	`RsaAlgorithm`	Algorytm `RsaAlgorithm` do użycia do zaszyfrowania wartości wejściowej.
`value`	`String`	Wartość wejściowa, dla której ma zostać wygenerowany hash.
`key`	`String`	klucz w formacie PEM, którego należy użyć do wygenerowania podpisu.

Powrót

Byte[] – tablica bajtów reprezentująca podpis wyjściowy.

`computeRsaSignature(algorithm, value, key, charset)`

Podpisuje podaną wartość za pomocą podanego algorytmu RSA z kluczem i zbiórem znaków.

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

Parametry

Nazwa	Typ	Opis
`algorithm`	`RsaAlgorithm`	Algorytm `RsaAlgorithm` do użycia do zaszyfrowania wartości wejściowej.
`value`	`String`	Wartość wejściowa, dla której ma zostać wygenerowany hash.
`key`	`String`	klucz w formacie PEM, którego należy użyć do wygenerowania podpisu.
`charset`	`Charset`	`Charset` reprezentujący zestaw znaków wejściowych.

Powrót

Byte[] – tablica bajtów reprezentująca podpis wyjściowy.

`formatDate(date, timeZone, format)`

Formatuje datę zgodnie ze specyfikacją opisaną w klasie Java SE SimpleDateFormat. Zapoznaj się ze specyfikacją dostępną pod adresem 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);

Parametry

Nazwa	Typ	Opis
`date`	`Date`	`Date` do sformatowania jako ciąg znaków.
`timeZone`	`String`	Strefa czasowa danych wyjściowych.
`format`	`String`	Format zgodny ze specyfikacją `SimpleDateFormat`.

Powrót

String – podana data w postaci sformatowanego ciągu znaków.

`formatString(template, args)`

Formatuje ciągi znaków w sposób podobny do funkcji sprintf, używając ciągów formatu w stylu „%”.

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

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

Parametry

Nazwa	Typ	Opis
`template`	`String`	Ciąg tekstowy formatu, który określa, co zostanie zwrócone.
`args`	`Object...`	Obiekty, które mają wypełnić substytuty „%” w szablonie.

Powrót

String – sformatowany ciąg znaków.

`getUuid()`

Pobierz identyfikator UUID jako ciąg znaków (to działanie jest równoważne użyciu metody java.util.UUID.randomUUID()). Nie ma gwarancji, że ten identyfikator jest unikalny w czasie i przestrzeni. Z tego powodu nie używaj ich w sytuacjach, w których wymagana jest gwarantowana unikalność.

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

Powrót

String – ciąg znaków reprezentujący identyfikator UUID.

`gzip(blob)`

gzip – kompresuje podane dane Blob i zwraca je w nowym obiekcie Blob.

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

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

Parametry

Nazwa	Typ	Opis
`blob`	`BlobSource`	Obiekt `Blob` do skompresowania za pomocą funkcji `gzip`.

Powrót

Blob – nowy plik Blob zawierający skompresowane dane.

`gzip(blob, name)`

gzip – kompresuje podane dane Blob i zwraca je w nowym obiekcie Blob. Ta wersja metody umożliwia podanie nazwy pliku.

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

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

Parametry

Nazwa	Typ	Opis
`blob`	`BlobSource`	Obiekt `Blob` do skompresowania za pomocą funkcji `gzip`.
`name`	`String`	Nazwa pliku `gzip`, który ma zostać utworzony.

Powrót

Blob – nowy plik Blob zawierający skompresowane dane.

`newBlob(data)`

Tworzenie nowego obiektu Blob z tablicy bajtów. Bloby są używane w wielu interfejsach API Apps Script, które przyjmują dane binarne jako dane wejściowe.

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

Parametry

Nazwa	Typ	Opis
`data`	`Byte[]`	Bajty bloba.

Powrót

Blob – nowo utworzony obiekt blob.

`newBlob(data, contentType)`

Utwórz nowy obiekt Blob na podstawie tablicy bajtów i typu treści. Bloby są używane w wielu interfejsach API Apps Script, które przyjmują dane binarne jako dane wejściowe.

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

Parametry

Nazwa	Typ	Opis
`data`	`Byte[]`	Bajty bloba.
`contentType`	`String`	Typ treści bloba – może być `null`.

Powrót

Blob – nowo utworzony obiekt blob.

`newBlob(data, contentType, name)`

Utwórz nowy obiekt Blob na podstawie tablicy bajtów, typu treści i nazwy. Bloby są używane w wielu interfejsach Apps Script API, które przyjmują dane binarne jako dane wejściowe.

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

Parametry

Nazwa	Typ	Opis
`data`	`Byte[]`	Bajty bloba.
`contentType`	`String`	– Typ treści bloba – może to być `null`.
`name`	`String`	Nazwa bloba – może być `null`.

Powrót

Blob – nowo utworzony obiekt blob.

`newBlob(data)`

Utwórz nowy obiekt Blob na podstawie ciągu znaków. Bloby są używane w wielu interfejsach API Apps Script, które przyjmują dane binarne jako dane wejściowe.

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

Parametry

Nazwa	Typ	Opis
`data`	`String`	Ciąg znaków bloba, domyślnie w formacie UTF-8.

Powrót

Blob – nowo utworzony obiekt blob.

`newBlob(data, contentType)`

Utwórz nowy obiekt Blob na podstawie ciągu znaków i typu treści. Bloby są używane w wielu interfejsach API Apps Script, które przyjmują dane binarne jako dane wejściowe.

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

Parametry

Nazwa	Typ	Opis
`data`	`String`	Ciąg znaków bloba, domyślnie w formacie UTF-8.
`contentType`	`String`	Typ treści bloba – może być `null`.

Powrót

Blob – nowo utworzony obiekt blob.

`newBlob(data, contentType, name)`

Utwórz nowy obiekt Blob na podstawie ciągu znaków, typu treści i nazwy. Bloby są używane w wielu interfejsach Apps Script API, które przyjmują dane binarne jako dane wejściowe.

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

Parametry

Nazwa	Typ	Opis
`data`	`String`	Ciąg znaków bloba, domyślnie w formacie UTF-8.
`contentType`	`String`	Typ treści bloba – może być `null`.
`name`	`String`	Nazwa bloba – może być `null`.

Powrót

Blob – nowo utworzony obiekt blob.

`parseCsv(csv)`

Zwraca tablicową reprezentację tablicy dwuwymiarowej ciągu 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);

Parametry

Nazwa	Typ	Opis
`csv`	`String`	Ciąg znaków zawierający dane pojedyncze lub wielowierszowe w formacie CSV (wartości rozdzielane przecinkami).

Powrót

String[][] – dwuwymiarowy tablica zawierająca wartości w ciągu tekstowym CSV.

`parseCsv(csv, delimiter)`

Zwraca tablicową reprezentację tablicy dwuwymiarowej ciągu CSV za pomocą niestandardowego ogranicznika.

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

Parametry

Nazwa	Typ	Opis
`csv`	`String`	Ciąg znaków zawierający dane pojedynczej lub wielu linii w formacie CSV (wartości rozdzielane przecinkami).
`delimiter`	`Char`	między wartościami,

Powrót

String[][] – dwuwymiarowy tablica zawierająca wartości w ciągu tekstowym CSV.

`parseDate(date, timeZone, format)`

Parsuje podany ciąg znaków zgodnie ze specyfikacją opisaną w klasie Java Standard Edition SimpleDateFormat. Więcej informacji znajdziesz w klasie Java SimpleDateFormat.

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

Parametry

Nazwa	Typ	Opis
`date`	`String`	Wartość ciągu do przeanalizowania jako data.
`timeZone`	`String`	Strefa czasowa danych wyjściowych.
`format`	`String`	Format daty zgodny ze specyfikacją `SimpleDateFormat`.

Powrót

Date – podany ciąg znaków jako data.

`sleep(milliseconds)`

Zatrzymuje działanie na określony czas w milisekundach. Skrypt jest natychmiast przenoszony do stanu uśpienia na określonyą liczbę milisekund. Maksymalna dozwolona wartość to 300 000 (czyli 5 minut).

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

Parametry

Nazwa	Typ	Opis
`milliseconds`	`Integer`	Liczba milisekund na uśpienie.

`ungzip(blob)`

Dekompresuje obiekt Blob i zwraca obiekt Blob zawierający dane w postaci nieskompresowanej.

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

Parametry

Nazwa	Typ	Opis
`blob`	`BlobSource`	`Blob` skompresowanych danych.

Powrót

Blob – Blob przedstawiający skompresowane dane.

`unzip(blob)`

Odbiera obiekt Blob reprezentujący plik zip i zwraca jego pliki komponentów.

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

Parametry

Nazwa	Typ	Opis
`blob`	`BlobSource`	Blob pliku zip.

Powrót

Blob[] – obiekt Blob[], który reprezentuje obiekty blob komponentu. Każdy z nich ma nazwę z pełną ścieżką w pliku zip.

`zip(blobs)`

Tworzy nowy obiekt Blob, który jest plikiem ZIP zawierającym dane z przekazanych obiektów 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]);

Parametry

Nazwa	Typ	Opis
`blobs`	`BlobSource[]`	Tablica blobów do skompresowania.

Powrót

Blob – nowy blob zawierający dane wejściowe w postaci archiwum.

`zip(blobs, name)`

Tworzy nowy obiekt Blob, który jest plikiem ZIP zawierającym dane z przekazanych obiektów Blob. Ta wersja metody umożliwia podanie nazwy pliku.

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

Parametry

Nazwa	Typ	Opis
`blobs`	`BlobSource[]`	Tablica blobów do skompresowania.
`name`	`String`	Nazwa pliku ZIP, który ma zostać utworzony.

Powrót

Blob – nowy blob zawierający dane wejściowe w postaci archiwum.

Wycofane metody

`jsonParse(jsonString)`

Wycofany. Od listopada 2013 r. zastąpiony przez JSON.parse()

Zwraca obiekt odpowiadający przekazanemu ciągowi znaków JSON.

// Returns the object { name: "John Smith", company: "Virginia Company"}
const obj = Utilities.jsonParse(
    '{"name":"John Smith","company":"Virginia Company"}',
);

Parametry

Nazwa	Typ	Opis
`jsonString`	`String`	Reprezentacja ciągu znaków obiektu JavaScriptu do deserializacji.

Powrót

Object – reprezentacja wejścia w postaci obiektu JavaScriptu.

`jsonStringify(obj)`

Wycofany. Od listopada 2013 r. zastąpiony przez JSON.stringify()

Zwraca ciąg znaków JSON obiektu przekazanego jako argument.

// Logs: {"name":"John Smith","company":"Virginia Company"}
const person = {
  name: 'John Smith',
  company: 'Virginia Company',
};
const json = Utilities.jsonStringify(person);
Logger.log(json);

Parametry

Nazwa	Typ	Opis
`obj`	`Object`	obiekt JavaScript, który ma zostać zserializowany do formatu JSON

Powrót

String – serializowany obiekt JavaScript w formacie JSON