דף זה תורגם על ידי Cloud Translation API.

Class Utilities

השירות הזה מספק כלים לקידוד/פענוח מחרוזות, עיצוב תאריכים, מניפולציה של JSON ומשימות שונות.

תכונות

נכס	תיאור	התיאור
`Charset`	`Charset`
`DigestAlgorithm`	`DigestAlgorithm`
`MacAlgorithm`	`MacAlgorithm`
`RsaAlgorithm`	`RsaAlgorithm`

שיטות

שיטה	סוג הערך שמוחזר	תיאור קצר
`base64Decode(encoded)`	`Byte[]`	פענוח של מחרוזת בקידוד base-64 למערך בייטים מסוג UTF-8.
`base64Decode(encoded, charset)`	`Byte[]`	פענוח של מחרוזת בקידוד base64 למערך בייטים במערך תווים ספציפי.
`base64DecodeWebSafe(encoded)`	`Byte[]`	פענוח של מחרוזת מקודדת ב-base-64 עם אבטחה לשימוש באינטרנט למערך בייטים מסוג UTF-8.
`base64DecodeWebSafe(encoded, charset)`	`Byte[]`	פענוח של מחרוזת מקודדת ב-base-64 שבטוחה לאינטרנט למערך בייטים במערך תווים ספציפי.
`base64Encode(data)`	`String`	יוצרת מחרוזת בקידוד base64 ממערך בייטים נתון.
`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.
`sleep(milliseconds)`	`void`	מעבר למצב שינה במשך מספר אלפיות השנייה שצוין.
`ungzip(blob)`	`Blob`	הפונקציה מבטלת את הדחיסה של אובייקט `Blob` ומחזירה `Blob` שמכיל את הנתונים לא דחוסים.
`unzip(blob)`	`Blob[]`	הפונקציה לוקחת כדור הארץ שמייצג קובץ ZIP ומחזירה את קובצי הרכיב שלו.
`zip(blobs)`	`Blob`	יוצר אובייקטblob חדש שהוא קובץ ZIP שמכיל את הנתונים מה-blobs שהועברו.
`zip(blobs, name)`	`Blob`	יוצר אובייקטblob חדש שהוא קובץ ZIP שמכיל את הנתונים מה-blobs שהועברו.

שיטות שהוצאו משימוש

שיטה	סוג הערך שמוחזר	תיאור קצר
`jsonParse(jsonString)`	`Object`	מחזירה אובייקט שתואם למחרוזת ה-JSON שהועברה.
`jsonStringify(obj)`	`String`	מחזירה מחרוזת JSON של האובייקט שהועבר.

תיעוד מפורט

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

פענוח של מחרוזת בקידוד base64 למערך בייטים במערך תווים ספציפי.

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

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

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

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

פרמטרים

שם	תיאור	התיאור
`encoded`	`String`	מחרוזת הנתונים שצריך לפענח.
`charset`	`Charset`	`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`	`Charset` שמציין את קבוצת התווים של הקלט.

החזרות

Byte[] – הנתונים הגולמיים המיוצגים על ידי הארגומנט המקודד base-64 כמערך בייטים.

`base64Encode(data)`

יוצרת מחרוזת בקידוד base64 ממערך בייטים נתון. קידוד Base 64 הוא קידוד נפוץ שמקובל על ידי מגוון כלים שלא יכולים לקבל נתונים בינאריים. בדרך כלל משתמשים ב-Base 64 בפרוטוקולים של אינטרנט כמו אימייל, HTTP או במסמכי XML.

// Instantiates a blob here for clarity
var blob = Utilities.newBlob("A string here");

// Writes 'QSBzdHJpbmcgaGVyZQ==' to the log.
var encoded = Utilities.base64Encode(blob.getBytes());
Logger.log(encoded);

פרמטרים

שם	תיאור	התיאור
`data`	`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`	`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`	`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[] - בייט[] שמייצג את תקציר הפלט.

`computeDigest(algorithm, value)`

חישוב תקציר באמצעות האלגוריתם שצוין בערך String שצוין.

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

פרמטרים

שם	תיאור	התיאור
`algorithm`	`DigestAlgorithm`	`DigestAlgorithm` לשימוש.
`value`	`String`	ערך של מחרוזת קלט לחישוב תקציר.

החזרות

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`	`Charset` שמייצג את קבוצת תווי הקלט.

החזרות

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[] - בייט[] שמייצג את חתימת הפלט.

`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[] - בייט[] שמייצג את חתימת הפלט.

`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`	`Charset` שמייצג את קבוצת תווי הקלט.

החזרות

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` שיכול לשמש לגיבוב (hash) של ערך הקלט.
`value`	`Byte[]`	ערך הקלט שעבורו יש ליצור גיבוב.
`key`	`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` שיכול לשמש לגיבוב (hash) של ערך הקלט.
`value`	`String`	ערך הקלט שעבורו יש ליצור גיבוב.
`key`	`String`	מפתח לשימוש כדי ליצור את הגיבוב.

החזרות

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` שיכול לשמש לגיבוב (hash) של ערך הקלט.
`value`	`String`	ערך הקלט שעבורו יש ליצור גיבוב.
`key`	`String`	מפתח לשימוש כדי ליצור את הגיבוב.
`charset`	`Charset`	`Charset` שמייצג את קבוצת תווי הקלט.

החזרות

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[] - בייט[] שמייצג את חתימת הפלט.

`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[] - בייט[] שמייצג את חתימת הפלט.

`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[] - בייט[] שמייצג את חתימת הפלט.

`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`	`Charset` שמייצג את קבוצת תווי הקלט.

החזרות

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` שיכול לשמש לגיבוב (hash) של ערך הקלט.
`value`	`String`	ערך הקלט שעבורו יש ליצור גיבוב.
`key`	`String`	מפתח בפורמט PEM לשימוש כדי ליצור את החתימה.

החזרות

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` שיכול לשמש לגיבוב (hash) של ערך הקלט.
`value`	`String`	ערך הקלט שעבורו יש ליצור גיבוב.
`key`	`String`	מפתח בפורמט PEM לשימוש כדי ליצור את החתימה.
`charset`	`Charset`	`Charset` שמייצג את קבוצת תווי הקלט.

החזרות

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...`	אובייקטים שישמשו למילוי ה-placeholders מסוג '%' בתבנית.

החזרות

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 חדש ממערך בייטים. נעשה שימוש ב-blobs בממשקי API רבים של Apps Script שכוללים נתונים בינאריים כקלט.

// Creates a blob object from a byte array.
const data = [71, 79, 79, 71, 76, 69];
const blob = Utilities.newBlob(data);

// Logs the blob data as a string to the console.
console.log(blob.getDataAsString());

פרמטרים

שם	תיאור	התיאור
`data`	`Byte[]`	הבייטים של ה-blob.

החזרות

Blob – ה-blob החדש שנוצר.

`newBlob(data, contentType)`

יצירת אובייקטblob חדש ממערך בייטים ומסוג תוכן. blobs נמצאים בשימוש בממשקי API רבים של Apps Script שכוללים נתונים בינאריים כקלט.

// Declares a byte array.
const data = [71, 79, 79, 71, 76, 69];

// Declares the content type of the blob.
const contentType = 'application/json';

// Creates a blob object from the byte array and content type.
const blob = Utilities.newBlob(data, contentType);

// Logs the blob data as a string to the console.
console.log(blob.getDataAsString());

// Logs the content type of the blob to the console.
console.log(blob.getContentType());

פרמטרים

שם	תיאור	התיאור
`data`	`Byte[]`	הבייטים של ה-blob.
`contentType`	`String`	סוג התוכן של ה-blob – יכול להיות `null`.

החזרות

Blob – ה-blob החדש שנוצר.

`newBlob(data, contentType, name)`

יצירת אובייקטblob חדש ממערך בייטים, מסוג תוכן ומשם. תוכנות blob נמצאות בשימוש בממשקי API רבים של Apps Script שמקבלות נתונים בינאריים כקלט.

// Declares a byte array.
const data = [71, 79, 79, 71, 76, 69];

// Declares the content type of the blob.
const contentType = 'application/json';

// Declares the name of the blob.
const name = 'Example blob';

// Creates a blob object from the byte array, content type, and name.
const blob = Utilities.newBlob(data, contentType, name);

// Logs the blob data as a string to the console.
console.log('Blob data:', blob.getDataAsString());

// Logs the content type of the blob to the console.
console.log('Blob content type:', blob.getContentType());

// Logs the name of the blob to the console.
console.log('Blob name:', blob.getName());

פרמטרים

שם	תיאור	התיאור
`data`	`Byte[]`	הבייטים של ה-blob.
`contentType`	`String`	- סוג התוכן של ה-blob - יכול להיות `null`.
`name`	`String`	שם ה-blob – יכול להיות `null`.

החזרות

Blob – ה-blob החדש שנוצר.

`newBlob(data)`

יצירת אובייקטblob חדש ממחרוזת. נעשה שימוש ב-blobs בממשקי API רבים של Apps Script שכוללים נתונים בינאריים כקלט.

// Declares a string for the blob.
const data = 'GOOGLE';

// Creates a blob object from a string.
const blob = Utilities.newBlob(data);

// Logs the blob data in byte array to the console.
console.log('Blob Data:', blob.getBytes());

פרמטרים

שם	תיאור	התיאור
`data`	`String`	המחרוזת של ה-blob, ההנחה היא UTF-8.

החזרות

Blob – ה-blob החדש שנוצר.

`newBlob(data, contentType)`

יצירת אובייקטblob חדש ממחרוזת ומסוג תוכן. blobs נמצאים בשימוש בממשקי API רבים של Apps Script שכוללים נתונים בינאריים כקלט.

// Declares a string for the blob.
const data = 'GOOGLE';

// Declares the content type of blob.
const contentType = 'application/json';

// Creates a blob object from the string and content type.
const blob = Utilities.newBlob(data, contentType);

// Logs the blob data in byte array to the console.
console.log('Blob data:', blob.getBytes());

// Logs the content type of the blob to the console.
console.log(blob.getContentType());

פרמטרים

שם	תיאור	התיאור
`data`	`String`	המחרוזת של ה-blob, ההנחה היא UTF-8.
`contentType`	`String`	סוג התוכן של ה-blob – יכול להיות `null`.

החזרות

Blob – ה-blob החדש שנוצר.

`newBlob(data, contentType, name)`

יצירת אובייקטblob חדש ממחרוזת, סוג תוכן ושם. תוכנות blob נמצאות בשימוש בממשקי API רבים של Apps Script שמקבלות נתונים בינאריים כקלט.

// Declares a string for the blob.
const data = 'GOOGLE';

// Declares the content type of the blob.
const contentType = 'application/json';

// Declares the name of the blob.
const name = 'Example blob';

// Create a blob object from the string, content type, and name.
const blob = Utilities.newBlob(data, contentType, name);

// Logs the blob data in byte array to the console.
console.log('Blob data:', blob.getBytes());

// Logs the content type of the blob to the console.
console.log('Blob content type:', blob.getContentType());

// Logs the name of the blob to the console.
console.log('Blob name:', blob.getName());

פרמטרים

שם	תיאור	התיאור
`data`	`String`	המחרוזת של ה-blob, ההנחה היא UTF-8.
`contentType`	`String`	סוג התוכן של ה-blob – יכול להיות `null`.
`name`	`String`	שם ה-blob – יכול להיות `null`.

החזרות

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. למידע נוסף, עיין במחלקה 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);

פרמטרים

שם	תיאור	התיאור
`date`	`String`	ערך מחרוזת לניתוח כתאריך.
`timeZone`	`String`	אזור הזמן של הפלט.
`format`	`String`	פורמט התאריך לפי המפרט של `SimpleDateFormat`.

החזרות

Date – מחרוזת הקלט כתאריך.

`sleep(milliseconds)`

מעבר למצב שינה במשך מספר אלפיות השנייה שצוין. מעביר מיד את הסקריפט למצב שינה למשך מספר אלפיות השנייה שצוין. הערך המקסימלי המותר הוא 300,000 (או 5 דקות).

// Creates a blob object from a string.
const data = 'GOOGLE';
const blob = Utilities.newBlob(data);

// Puts the script to sleep for 10,000 milliseconds (10 seconds).
Utilities.sleep(10000);

// Logs the blob data in byte array to the console.
console.log(blob.getBytes());

פרמטרים

שם	תיאור	התיאור
`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)`

הפונקציה לוקחת כדור הארץ שמייצג קובץ 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`	ה-blob של קובץ ה-ZIP.

החזרות

Blob[] – Ablob[] שמייצג את blobs של הרכיב, שלכל אחד שם יש נתיב מלא שבתוך ה-ZIP.

`zip(blobs)`

יוצר אובייקטblob חדש שהוא קובץ ZIP שמכיל את הנתונים מה-blobs שהועברו.

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[]`	מערך של blobs שצריך לדחוס.

החזרות

Blob – blob חדש שמכיל את הקלט כארכיון.

`zip(blobs, name)`

יוצר אובייקטblob חדש שהוא קובץ ZIP שמכיל את הנתונים מה-blobs שהועברו. בגרסה הזו של השיטה אפשר לציין שם קובץ.

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[]`	מערך של blobs שצריך לדחוס.
`name`	`String`	שם קובץ ה-ZIP שצריך ליצור.

החזרות

Blob – blob חדש שמכיל את הקלט כארכיון.

שיטות שהוצאו משימוש

`jsonParse(jsonString)`

הוצא משימוש. החל מנובמבר 2013, הוחלף על ידי JSON.parse()

מחזירה אובייקט שתואם למחרוזת ה-JSON שהועברה.

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

פרמטרים

שם	תיאור	התיאור
`jsonString`	`String`	ייצוג מחרוזת של אובייקט JavaScript לביצוע פעולת deserialize.

החזרות

Object - ייצוג אובייקט JavaScript של הקלט.

`jsonStringify(obj)`

הוצא משימוש. החל מנובמבר 2013, הוחלף על ידי JSON.stringify()

מחזירה מחרוזת JSON של האובייקט שהועבר.

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

פרמטרים

שם	תיאור	התיאור
`obj`	`Object`	את אובייקט ה-JavaScript לעריכה טורית ל-JSON

החזרות

String – אובייקט JavaScript בסדרה של JSON