Ta usługa udostępnia narzędzia do kodowania/dekodowania ciągów znaków, formatowania dat, manipulacji JSON i inne zadania.
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 standardzie base-64 do tablicy bajtów UTF-8. |
base64Decode(encoded, charset) | Byte[] | Dekoduje ciąg zakodowany w standardzie base-64 do tablicy bajtów w określonym zestawie znaków. |
base64DecodeWebSafe(encoded) | Byte[] | Dekoduje ciąg zakodowany w standardzie base-64 do postaci tablicy bajtów w formacie UTF-8. |
base64DecodeWebSafe(encoded, charset) | Byte[] | Dekoduje ciąg zakodowany w standardzie base-64 do postaci tablicy bajtów w określonym zestawie znaków. |
base64Encode(data) | String | Generuje ciąg zakodowany w standardzie base-64 z podanej tablicy bajtów. |
base64Encode(data) | String | Generuje ciąg zakodowany w formacie base-64 z danego ciągu znaków. |
base64Encode(data, charset) | String | Generuje ciąg zakodowany w formacie base-64 z danego ciągu znaków w określonym zestawie znaków. |
base64EncodeWebSafe(data) | String | Generuje bezpieczny w internecie ciąg zakodowany w standardzie base-64 z podanej tablicy bajtów. |
base64EncodeWebSafe(data) | String | Generuje z danego ciągu ciąg zakodowany do bezpiecznego w internecie w standardzie base-64. |
base64EncodeWebSafe(data, charset) | String | Generuje bezpieczny w internecie ciąg zakodowany w standardzie base-64 z danego ciągu znaków w określonym zestawie znaków. |
computeDigest(algorithm, value) | Byte[] | Oblicz skrót przy użyciu określonego algorytmu dla określonej wartości Byte[] . |
computeDigest(algorithm, value) | Byte[] | Oblicz skrót przy użyciu określonego algorytmu dla określonej wartości String . |
computeDigest(algorithm, value, charset) | Byte[] | Oblicz skrót za pomocą podanego algorytmu dla określonej wartości String z podanym zestawem 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ą algorytmu HMAC-SHA256 z danym kluczem i zestawem znaków. |
computeHmacSignature(algorithm, value, key) | Byte[] | Oblicza kod uwierzytelniania wiadomości za pomocą określonego algorytmu dla określonego klucza i wartości. |
computeHmacSignature(algorithm, value, key) | Byte[] | Oblicza kod uwierzytelniania wiadomości za pomocą określonego algorytmu dla określonego klucza i wartości. |
computeHmacSignature(algorithm, value, key, charset) | Byte[] | Oblicza kod uwierzytelniania wiadomości za pomocą określonego algorytmu dla określonego klucza i wartości. |
computeRsaSha1Signature(value, key) | Byte[] | Podpisuje podaną wartość za pomocą algorytmu RSA-SHA1 danego klucza. |
computeRsaSha1Signature(value, key, charset) | Byte[] | Podpisuje podaną wartość za pomocą algorytmu RSA-SHA1 z danym kluczem i zestawem znaków. |
computeRsaSha256Signature(value, key) | Byte[] | Podpisuje podaną wartość za pomocą algorytmu RSA-SHA256 danego klucza. |
computeRsaSha256Signature(value, key, charset) | Byte[] | Podpisuje podaną wartość za pomocą algorytmu RSA-SHA256 danego klucza. |
computeRsaSignature(algorithm, value, key) | Byte[] | Podpisuje podaną wartość za pomocą określonego algorytmu RSA za pomocą danego klucza. |
computeRsaSignature(algorithm, value, key, charset) | Byte[] | Podpisuje podaną wartość za pomocą określonego algorytmu RSA z danym kluczem i zestawem znaków. |
formatDate(date, timeZone, format) | String | Formatuje datę zgodnie ze specyfikacją opisaną w klasie SimpleDateFormat języka Java SE. |
formatString(template, args) | String | Wykonuje formatowanie ciągów podobne do sprintf z użyciem ciągów formatu w stylu „%”. |
getUuid() | String | Pobierz identyfikator UUID jako ciąg znaków (odpowiednik 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 | Utwórz nowy obiekt Blob na podstawie 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 oraz 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 tabelaryczną tablicę 2D ciągu znaków CSV. |
parseCsv(csv, delimiter) | String[][] | Zwraca tabelę 2D reprezentującą ciąg znaków CSV z użyciem niestandardowego separatora. |
parseDate(date, timeZone, format) | Date | Analizuje podaną datę w ciągu znaków zgodnie ze specyfikacją opisaną w klasie SimpleDateFormat w standardowej wersji Java. |
sleep(milliseconds) | void | Sen przez określoną liczbę milisekund. |
ungzip(blob) | Blob | Dekompresuje obiekt Blob i zwraca obiekt Blob zawierający nieskompresowane dane. |
unzip(blob) | Blob[] | Pobiera obiekt blob reprezentujący plik ZIP i zwraca jego pliki komponentu. |
zip(blobs) | Blob | Tworzy nowy obiekt obiektu Blob w postaci pliku ZIP zawierającego dane z przekazanych obiektów blob. |
zip(blobs, name) | Blob | Tworzy nowy obiekt obiektu Blob w postaci pliku ZIP zawierającego dane z przekazanych obiektów blob. |
Szczegółowa dokumentacja
base64Decode(encoded)
Dekoduje ciąg zakodowany w standardzie base-64 do tablicy bajtów 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());
Parametry
Nazwa | Typ | Opis |
---|---|---|
encoded | String | Tablica bajtów danych do zdekodowania. |
Powroty
Byte[]
– nieprzetworzone dane reprezentowane przez argument zakodowany w formacie base-64 w postaci tablicy bajtów.
base64Decode(encoded, charset)
Dekoduje ciąg zakodowany w standardzie base-64 do tablicy bajtów w określonym zestawie znaków.
// 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());
Parametry
Nazwa | Typ | Opis |
---|---|---|
encoded | String | Ciąg danych do zdekodowania. |
charset | Charset | Charset określający zestaw znaków w danych wejściowych. |
Powroty
Byte[]
– nieprzetworzone dane reprezentowane przez argument zakodowany w formacie base-64 w postaci tablicy bajtów.
base64DecodeWebSafe(encoded)
Dekoduje ciąg zakodowany w standardzie base-64 do postaci tablicy bajtów w formacie 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());
Parametry
Nazwa | Typ | Opis |
---|---|---|
encoded | String | Tablica bajtów danych do zdekodowania w internecie. |
Powroty
Byte[]
– nieprzetworzone dane reprezentowane przez argument zakodowany w formacie base-64 w postaci tablicy bajtów.
base64DecodeWebSafe(encoded, charset)
Dekoduje ciąg zakodowany w standardzie base-64 do postaci tablicy bajtów w określonym zestawie znaków.
// 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());
Parametry
Nazwa | Typ | Opis |
---|---|---|
encoded | String | Ciąg danych do zdekodowania w internecie. |
charset | Charset | Charset określający zestaw znaków w danych wejściowych. |
Powroty
Byte[]
– nieprzetworzone dane reprezentowane przez argument zakodowany w formacie base-64 w postaci tablicy bajtów.
base64Encode(data)
Generuje ciąg zakodowany w standardzie base-64 z podanej tablicy bajtów. Base64 to popularne kodowanie akceptowane przez różne narzędzia, które nie akceptują danych binarnych. Kod Base64 jest często używany w protokołach internetowych, takich jak poczta e-mail, HTTP czy dokumenty 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
data | Byte[] | Bajt[] danych do zakodowania. |
Powroty
String
– reprezentacja danych przekazywanych w danych zakodowana w formacie base-64.
base64Encode(data)
Generuje ciąg zakodowany w formacie base-64 z danego ciągu znaków. Base64 to popularne kodowanie akceptowane przez różne narzędzia, które nie akceptują danych binarnych. Base64 jest powszechnie stosowany w protokołach internetowych, takich jak e-mail, HTTP, czy w dokumentach XML.
// Writes 'QSBzdHJpbmcgaGVyZQ==' to the log. var encoded = Utilities.base64Encode("A string here"); Logger.log(encoded);
Parametry
Nazwa | Typ | Opis |
---|---|---|
data | String | Ciąg do zakodowania. |
Powroty
String
– reprezentacja ciągu wejściowego zakodowana w formacie base64.
base64Encode(data, charset)
Generuje ciąg zakodowany w formacie base-64 z danego ciągu znaków w określonym zestawie znaków. Zestaw znaków to sposób kodowania znaków w taki sposób, aby można było je kodować. Zwykle odbywa się to w formacie binarnym, który może być niekompatybilny z niektórymi protokołami przesyłania danych. Aby dane były zgodne, są zwykle kodowane w standardzie base64, czyli kodowaniu powszechnie akceptowanym przez wiele narzędzi nie akceptujących danych binarnych. Kod Base64 jest często używany w protokołach internetowych, takich jak poczta e-mail, HTTP czy dokumenty 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
data | String | Ciąg danych do zakodowania. |
charset | Charset | Charset określający zestaw znaków w danych wejściowych. |
Powroty
String
– reprezentacja ciągu wejściowego o określonej wartości Charset
zakodowana w formacie base64.
base64EncodeWebSafe(data)
Generuje bezpieczny w internecie ciąg zakodowany w standardzie base-64 z podanej tablicy bajtów. Base64 to popularne kodowanie akceptowane przez różne narzędzia, które nie akceptują danych binarnych. Standard Base64 jest powszechnie używany w protokołach internetowych takich jak poczta e-mail, HTTP czy dokumenty 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
data | Byte[] | Tablica bajtów danych do zakodowania. |
Powroty
String
– reprezentacja przekazywanych danych zakodowana w standardzie base-64 w internecie.
base64EncodeWebSafe(data)
Generuje z danego ciągu ciąg zakodowany do bezpiecznego w internecie w standardzie base-64. Base64 to popularne kodowanie akceptowane przez różne narzędzia, które nie akceptują danych binarnych. Standard Base64 w internecie jest powszechnie stosowany w protokołach internetowych takich jak poczta e-mail, HTTP czy dokumenty XML.
// Writes 'QSBzdHJpbmcgaGVyZQ==' to the log. var encoded = Utilities.base64EncodeWebSafe("A string here"); Logger.log(encoded);
Parametry
Nazwa | Typ | Opis |
---|---|---|
data | String | Ciąg do zakodowania. |
Powroty
String
– reprezentacja ciągu wejściowego zakodowana w standardzie base-64 w internecie.
base64EncodeWebSafe(data, charset)
Generuje bezpieczny w internecie ciąg zakodowany w standardzie base-64 z danego ciągu znaków w określonym zestawie znaków. Zestaw znaków to sposób kodowania znaków w taki sposób, aby mogły one być kodowane. Zwykle odbywa się to w formacie binarnym, który może być niezgodny z niektórymi protokołami przesyłania danych. Aby dane były zgodne, są zwykle kodowane w standardzie base64, czyli kodowaniu powszechnie akceptowanym przez wiele narzędzi, które nie akceptują danych binarnych. Standard Base64 jest powszechnie używany w protokołach internetowych takich jak poczta e-mail, HTTP czy dokumenty 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
data | String | Ciąg danych do zakodowania. |
charset | Charset | Charset określający zestaw znaków w danych wejściowych. |
Powroty
String
– zakodowana w standardzie base-64 reprezentacja ciągu wejściowego z danymi Charset
.
computeDigest(algorithm, value)
Oblicz skrót przy użyciu określonego algorytmu dla określonej wartości Byte[]
.
var input = Utilities.base64Decode("aW5wdXQgdG8gaGFzaA0K") // == base64encode("input to hash") var 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órego zostanie obliczony skrót. |
Powroty
Byte[]
– bajt[] reprezentujący skrót wyjściowy.
computeDigest(algorithm, value)
Oblicz skrót przy użyciu określonego algorytmu dla określonej wartości String
.
var 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órego zostanie obliczony skrót. |
Powroty
Byte[]
– bajt[] reprezentujący skrót wyjściowy.
computeDigest(algorithm, value, charset)
Oblicz skrót za pomocą podanego algorytmu dla określonej wartości String
z podanym zestawem znaków.
var 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órego zostanie obliczony skrót. |
charset | Charset | Element Charset reprezentujący wpisany zestaw znaków. |
Powroty
Byte[]
– bajt[] reprezentujący skrót 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. 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
value | Byte[] | Wartość wejściowa, dla której ma zostać wygenerowany hasz. |
key | Byte[] | Klucz, za pomocą którego można wygenerować hasz. |
Powroty
Byte[]
– bajt[] reprezentujący 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. var 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 hasz. |
key | String | Klucz, za pomocą którego można wygenerować hasz. |
Powroty
Byte[]
– bajt[] reprezentujący podpis wyjściowy.
computeHmacSha256Signature(value, key, charset)
Podpisuje podaną wartość za pomocą algorytmu HMAC-SHA256 z danym kluczem i zestawem znaków.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
value | String | Wartość wejściowa, dla której ma zostać wygenerowany hasz. |
key | String | Klucz, za pomocą którego można wygenerować hasz. |
charset | Charset | Element Charset reprezentujący wpisany zestaw znaków. |
Powroty
Byte[]
– bajt[] reprezentujący podpis wyjściowy.
computeHmacSignature(algorithm, value, key)
Oblicza kod uwierzytelniania wiadomości za pomocą określonego algorytmu dla określonego klucza i wartości.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
algorithm | MacAlgorithm | Algorytm MacAlgorithm , który służy do haszowania wartości wejściowej. |
value | Byte[] | Wartość wejściowa, dla której ma zostać wygenerowany hasz. |
key | Byte[] | Klucz, za pomocą którego można wygenerować hasz. |
Powroty
Byte[]
– bajt[] reprezentujący podpis wyjściowy.
computeHmacSignature(algorithm, value, key)
Oblicza kod uwierzytelniania wiadomości za pomocą określonego algorytmu dla określonego klucza i wartości.
// This writes an array of bytes to the log. var signature = Utilities.computeHmacSignature(Utilities.MacAlgorithm.HMAC_MD5, "input to hash", "key"); Logger.log(signature);
Parametry
Nazwa | Typ | Opis |
---|---|---|
algorithm | MacAlgorithm | Algorytm MacAlgorithm , który służy do haszowania wartości wejściowej. |
value | String | Wartość wejściowa, dla której ma zostać wygenerowany hasz. |
key | String | Klucz, za pomocą którego można wygenerować hasz. |
Powroty
Byte[]
– bajt[] reprezentujący podpis wyjściowy.
computeHmacSignature(algorithm, value, key, charset)
Oblicza kod uwierzytelniania wiadomości za pomocą określonego algorytmu dla określonego klucza i wartości.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
algorithm | MacAlgorithm | Algorytm MacAlgorithm , który służy do haszowania wartości wejściowej. |
value | String | Wartość wejściowa, dla której ma zostać wygenerowany hasz. |
key | String | Klucz, za pomocą którego można wygenerować hasz. |
charset | Charset | Element Charset reprezentujący wpisany zestaw znaków. |
Powroty
Byte[]
– bajt[] reprezentujący podpis wyjściowy.
computeRsaSha1Signature(value, key)
Podpisuje podaną wartość za pomocą algorytmu RSA-SHA1 danego klucza.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
value | String | Wartość wejściowa, dla której ma zostać wygenerowany hasz. |
key | String | Klucz w formacie PEM służący do generowania podpisu. |
Powroty
Byte[]
– bajt[] reprezentujący podpis wyjściowy.
computeRsaSha1Signature(value, key, charset)
Podpisuje podaną wartość za pomocą algorytmu RSA-SHA1 z danym kluczem i zestawem znaków.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
value | String | Wartość wejściowa, dla której ma zostać wygenerowany hasz. |
key | String | Klucz w formacie PEM służący do generowania podpisu. |
charset | Charset | Element Charset reprezentujący wpisany zestaw znaków. |
Powroty
Byte[]
– bajt[] reprezentujący podpis wyjściowy.
computeRsaSha256Signature(value, key)
Podpisuje podaną wartość za pomocą algorytmu RSA-SHA256 danego klucza.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
value | String | Wartość wejściowa, dla której ma zostać wygenerowany hasz. |
key | String | Klucz w formacie PEM służący do generowania podpisu. |
Powroty
Byte[]
– bajt[] reprezentujący podpis wyjściowy.
computeRsaSha256Signature(value, key, charset)
Podpisuje podaną wartość za pomocą algorytmu RSA-SHA256 danego klucza.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
value | String | Wartość wejściowa, dla której ma zostać wygenerowany hasz. |
key | String | Klucz w formacie PEM służący do generowania podpisu. |
charset | Charset | Element Charset reprezentujący wpisany zestaw znaków. |
Powroty
Byte[]
– bajt[] reprezentujący podpis wyjściowy.
computeRsaSignature(algorithm, value, key)
Podpisuje podaną wartość za pomocą określonego algorytmu RSA za pomocą danego klucza.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
algorithm | RsaAlgorithm | Algorytm RsaAlgorithm , który służy do haszowania wartości wejściowej. |
value | String | Wartość wejściowa, dla której ma zostać wygenerowany hasz. |
key | String | Klucz w formacie PEM służący do generowania podpisu. |
Powroty
Byte[]
– bajt[] reprezentujący podpis wyjściowy.
computeRsaSignature(algorithm, value, key, charset)
Podpisuje podaną wartość za pomocą określonego algorytmu RSA z danym kluczem i zestawem znaków.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
algorithm | RsaAlgorithm | Algorytm RsaAlgorithm , który służy do haszowania wartości wejściowej. |
value | String | Wartość wejściowa, dla której ma zostać wygenerowany hasz. |
key | String | Klucz w formacie PEM służący do generowania podpisu. |
charset | Charset | Element Charset reprezentujący wpisany zestaw znaków. |
Powroty
Byte[]
– bajt[] reprezentujący podpis wyjściowy.
formatDate(date, timeZone, format)
Formatuje datę zgodnie ze specyfikacją opisaną w klasie SimpleDateFormat języka Java SE. Zapoznaj się ze specyfikacją na stronie 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
date | Date | Date do sformatowania jako ciągu znaków. |
timeZone | String | Strefa czasowa wyjściowa wyniku. |
format | String | Format zgodny ze specyfikacją SimpleDateFormat . |
Powroty
String
– data wejściowa w postaci sformatowanego ciągu znaków.
formatString(template, args)
Wykonuje formatowanie ciągów podobne do sprintf
z użyciem 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 formatu określający, co jest zwracane. |
args | Object... | Obiekty używane w szablonie do wypełnienia obiektów zastępczych „%”. |
Powroty
String
– sformatowany ciąg znaków.
getUuid()
Pobierz identyfikator UUID jako ciąg znaków (odpowiednik metody java.util.UUID.randomUUID()
). Nie ma gwarancji, że identyfikator będzie niepowtarzalny w całym czasie i w przestrzeni. Dlatego nie używaj ich w sytuacjach, w których jest wymagana gwarantowana niepowtarzalność.
//This assigns a UUID as a temporary ID for a data object you are creating in your script. var myDataObject = { tempId: Utilities.getUuid(); };
Powroty
String
– ciąg reprezentujący identyfikator UUID.
gzip(blob)
gzip
kompresuje podane dane Blob
i zwraca je w nowym obiekcie Blob
.
var textBlob = Utilities.newBlob("Some text to compress using gzip compression"); // Create the compressed blob. var gzipBlob = Utilities.gzip(textBlob);
Parametry
Nazwa | Typ | Opis |
---|---|---|
blob | BlobSource | Obiekt Blob do skompresowania za pomocą gzip . |
Powroty
gzip(blob, name)
gzip
kompresuje podane dane Blob
i zwraca je w nowym obiekcie Blob
. Ta wersja metody umożliwia określenie nazwy pliku.
var textBlob = Utilities.newBlob("Some text to compress using gzip compression"); // Create the compressed blob. var gzipBlob = Utilities.gzip(textBlob, "text.gz");
Parametry
Nazwa | Typ | Opis |
---|---|---|
blob | BlobSource | Obiekt Blob do skompresowania za pomocą gzip . |
name | String | Nazwa pliku gzip do utworzenia. |
Powroty
newBlob(data)
Utwórz nowy obiekt Blob na podstawie tablicy bajtów. Bloby są używane w wielu interfejsach API Apps Script, które pobierają 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 obiektu blob. |
Powroty
Blob
– nowo utworzony obiekt blob.
newBlob(data, contentType)
Utwórz nowy obiekt Blob na podstawie tablicy bajtów i typu treści. Plamy są używane w wielu interfejsach Apps Script API, które pobierają 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 obiektu blob. |
contentType | String | Typ treści obiektu blob – może być null . |
Powroty
Blob
– nowo utworzony obiekt blob.
newBlob(data, contentType, name)
Utwórz nowy obiekt Blob na podstawie tablicy bajtów oraz typu treści i nazwy. Bloby są używane w wielu interfejsach API Apps Script, które pobierają 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 obiektu blob. |
contentType | String | – typ treści obiektu blob – może być ustawiony na null . |
name | String | Nazwa obiektu blob – może być null . |
Powroty
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 pobierają 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 zakładany w formacie UTF-8. |
Powroty
Blob
– nowo utworzony obiekt blob.
newBlob(data, contentType)
Utwórz nowy obiekt Blob na podstawie ciągu znaków i typu treści. Plamy są używane w wielu interfejsach Apps Script API, które pobierają 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 zakładany w formacie UTF-8. |
contentType | String | Typ treści obiektu blob – może być null . |
Powroty
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 API Apps Script, które pobierają 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 zakładany w formacie UTF-8. |
contentType | String | Typ treści obiektu blob – może być null . |
name | String | Nazwa obiektu blob – może być null . |
Powroty
Blob
– nowo utworzony obiekt blob.
parseCsv(csv)
Zwraca tabelaryczną tablicę 2D ciągu znaków 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
csv | String | Ciąg znaków zawierający dane w jednym lub wielu wierszach w formacie CSV. |
Powroty
String[][]
– dwuwymiarowa tablica zawierająca wartości z ciągu CSV.
parseCsv(csv, delimiter)
Zwraca tabelę 2D reprezentującą ciąg znaków CSV z użyciem niestandardowego separatora.
// 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');
Parametry
Nazwa | Typ | Opis |
---|---|---|
csv | String | Ciąg znaków zawierający dane w jednym lub wielu wierszach w formacie CSV. |
delimiter | Char | Między wartościami. |
Powroty
String[][]
– dwuwymiarowa tablica zawierająca wartości z ciągu CSV.
parseDate(date, timeZone, format)
Analizuje podaną datę w ciągu znaków zgodnie ze specyfikacją opisaną w klasie SimpleDateFormat
w standardowej wersji Java. Więcej informacji znajdziesz w klasie SimpleDateFormat
Java.
// This set of parameters parses the given string as a date in Greenwich Mean Time, formatted // as year-month-dateThour-minute-second. var date = Utilities.parseDate("1970-01-01 00:00:00", "GMT", "yyyy-MM-dd' 'HH:mm:ss"); Logger.log(date);
Parametry
Nazwa | Typ | Opis |
---|---|---|
date | String | Wartość ciągu znaków do przeanalizowania jako daty. |
timeZone | String | Strefa czasowa danych wyjściowych. |
format | String | Format daty zgodny ze specyfikacją SimpleDateFormat . |
Powroty
Date
– ciąg wejściowy jako data.
sleep(milliseconds)
Sen przez określoną liczbę milisekund. Natychmiast przełącza skrypt w tryb uśpienia przez określoną 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 do snu. |
ungzip(blob)
Dekompresuje obiekt Blob
i zwraca obiekt Blob
zawierający nieskompresowane dane.
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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
blob | BlobSource | Blob skompresowanych danych. |
Powroty
unzip(blob)
Pobiera obiekt blob reprezentujący plik ZIP i zwraca jego pliki komponentu.
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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
blob | BlobSource | Obiekt blob pliku ZIP. |
Powroty
Blob[]
– obiekt blob[] reprezentujący obiekt blob komponentu, z których każda ma pełną nazwę w komponencie zip.
zip(blobs)
Tworzy nowy obiekt obiektu Blob w postaci pliku ZIP zawierającego dane z przekazanych obiektów 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]);
Parametry
Nazwa | Typ | Opis |
---|---|---|
blobs | BlobSource[] | Tablica blobów do skompresowania. |
Powroty
Blob
– nowy obiekt blob zawierający dane wejściowe jako archiwum.
zip(blobs, name)
Tworzy nowy obiekt obiektu Blob w postaci pliku ZIP zawierającego dane z przekazanych obiektów blob. Ta wersja metody umożliwia określenie nazwy pliku.
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");
Parametry
Nazwa | Typ | Opis |
---|---|---|
blobs | BlobSource[] | Tablica blobów do skompresowania. |
name | String | Nazwa pliku ZIP do utworzenia. |
Powroty
Blob
– nowy obiekt blob zawierający dane wejściowe jako archiwum.