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

מפענח מחרוזת בקידוד base-64 למערך בייטים במערכת תווים ספציפית.

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

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

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

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

פרמטרים

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

`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-safe) באינטרנט כמערך בייטים.

`base64Encode(data)`

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

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

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

פרמטרים

שם	סוג	תיאור
`data`	`Byte[]`	בייט[] של נתונים לקידוד.

חזרה

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 ממערך הבייטים הנתון. בסיס 64 הוא לקידוד המקובל על ידי מגוון כלים שלא יכולים לקבל נתונים בינאריים. שיעור הבטיחות באינטרנט הבסיסי 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 – ייצוג מקודד-בסיסי-אינטרנט של בסיס-64 של הנתונים שהועברו.

`base64EncodeWebSafe(data)`

יוצרת מהמחרוזת הנתונה מחרוזת מקודדת מבוססת-אינטרנט עם בסיס-64. Base 64 הוא קידוד נפוץ המקובלים על ידי מגוון כלים שלא יכולים לקבל נתונים בינאריים. לרוב, רמת ההגנה באינטרנט על בסיס 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 מהמחרוזת הנתונה, במערך תווים ספציפי. מערכת Charset היא שיטה לקידוד תווים כך שניתן לקודד אותם. בדרך כלל בפורמט בינארי, שבדרך כלל לא תואם להעברות נתונים מסוימות. ופרוטוקולים. כדי שהנתונים יהיו תואמים, הם מקודדים בדרך כלל לבסיס 64, שהוא קידוד נפוץ המקובל על ידי מגוון כלים שלא יכולים לקבל נתונים בינאריים. הגנה על בסיס 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` שבו יש להשתמש כדי לגבב את ערך הקלט.
`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` שבו יש להשתמש כדי לגבב את ערך הקלט.
`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` שבו יש להשתמש כדי לגבב את ערך הקלט.
`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 עם המפתח וה-charset הנתונים.

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

חזרה

Byte[] – בייט[] שמייצג את חתימת הפלט.

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

חתימה על הערך שסופק באמצעות אלגוריתם ה-RSA שצוין עם המפתח וה-charset הנתונים.

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

פרמטרים

שם	סוג	תיאור
`algorithm`	`RsaAlgorithm`	אלגוריתם `RsaAlgorithm` שבו יש להשתמש כדי לגבב את ערך הקלט.
`value`	`String`	ערך הקלט שעבורו יש ליצור גיבוב.
`key`	`String`	מפתח בפורמט PEM שישמש ליצירת החתימה.
`charset`	`Charset`	`Charset` שמייצג את מערכת התווים של הקלט.

חזרה

Byte[] – בייט[] שמייצג את חתימת הפלט.

`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 ב-Apps Script רבים ממשקי API שמקבלים נתונים בינאריים כקלט.

// 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 חדש ממערך בייטים, סוג תוכן ושם. blobs נמצאים בשימוש באפליקציות רבות ממשקי API של סקריפטים שמקבלים נתונים בינאריים כקלט.

// 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 ב-Apps Script רבים ממשקי API שמקבלים נתונים בינאריים כקלט.

// 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 חדש ממחרוזת, מסוג תוכן ומשם. blobs נמצאים בשימוש באפליקציות רבות ממשקי API של סקריפטים שמקבלים נתונים בינאריים כקלט.

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

ניתוח תאריך המחרוזת שסופק בהתאם למפרט שמתואר בתקן Java מהדורה SimpleDateFormat של מחלקה. למידע נוסף, ראו מחלקה 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)`

הפונקציה לוקחת את ה-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[] — אובייקט blob[] שמייצג את ה-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