Class Utilities

קל לארגן דפים בעזרת אוספים אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
כלי תחזוקה

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

נכסים

מאפיין (property)סוגתיאור
CharsetCharset
DigestAlgorithmDigestAlgorithm
MacAlgorithmMacAlgorithm
RsaAlgorithmRsaAlgorithm

שיטות

שיטהסוג הערך המוחזרתיאור קצר
base64Decode(encoded)Byte[]מפענח מחרוזת קידוד base-64 למערך UTF-8 בייט.
base64Decode(encoded, charset)Byte[]מפענח מחרוזת מקודדת מסוג base-64 למערך בייט בקבוצת תווים ספציפית.
base64DecodeWebSafe(encoded)Byte[]מפענח מחרוזת מקודדת מסוג base-64 לאינטרנט במערך UTF-8 בייט.
base64DecodeWebSafe(encoded, charset)Byte[]מפענח מחרוזת מקודדת-safe-data 64 במערך בייטים בקבוצת תווים ספציפית.
base64Encode(data)Stringיוצרת מחרוזת בקידוד בקידוד base-64 ממערך הבייט הנתון.
base64Encode(data)Stringיוצרת מחרוזת בקידוד base-64 מהמחרוזת הנתונה.
base64Encode(data, charset)Stringיוצרת מחרוזת בקידוד base-64 מהמחרוזת הנתונה בקבוצת תווים ספציפית.
base64EncodeWebSafe(data)Stringיוצרת מחרוזת מקודדת-בסיסית מסוג web-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 SimpleDateformat.
formatString(template, args)Stringיוצרת מחרוזת בפורמט דמוי sprintf, עם מחרוזות בסגנון '%' .
getUuid()StringUUID כמחרוזת (זהה לשימוש בשיטה 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 של מהדורת Standard Java.
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 שהועברו.

תיעוד מפורט

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

פרמטרים

שםסוגתיאור
encodedStringמערך של בייטים של נתונים לפענוח

הלוך ושוב

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


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

פרמטרים

שםסוגתיאור
encodedStringמחרוזת הנתונים שיש לפענח
charsetCharsetCharset המציין את מערכת הערכים של הקלט

הלוך ושוב

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


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

פרמטרים

שםסוגתיאור
encodedStringמערך של בייטים של נתונים בטוחים לאינטרנט לפענוח

הלוך ושוב

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


base64DecodeWebSafe(encoded, charset)

מפענח מחרוזת מקודדת-safe-data 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());

פרמטרים

שםסוגתיאור
encodedStringמחרוזת הנתונים הבטוחים באינטרנט לפענוח
charsetCharsetCharset המציין את מערכת הערכים של הקלט

הלוך ושוב

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


base64Encode(data)

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

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

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

פרמטרים

שםסוגתיאור
dataByte[]בייט[] נתונים לקידוד

הלוך ושוב

String — הייצוג לפי קוד Base66 של הנתונים שהועברו


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

פרמטרים

שםסוגתיאור
dataStringהמחרוזת שיש לקודד

הלוך ושוב

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

פרמטרים

שםסוגתיאור
dataStringמחרוזת הנתונים לקידוד
charsetCharsetCharset המציין את מערכת הערכים של הקלט

הלוך ושוב

String — הייצוג בקידוד base-64 של מחרוזת הקלט עם הערך Charset


base64EncodeWebSafe(data)

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

פרמטרים

שםסוגתיאור
dataByte[]מערך של בייטים של נתונים לקידוד

הלוך ושוב

String – הייצוג מבוסס-הקידוד של Web-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);

פרמטרים

שםסוגתיאור
dataStringהמחרוזת שיש לקודד

הלוך ושוב

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

פרמטרים

שםסוגתיאור
dataStringמחרוזת הנתונים לקידוד
charsetCharsetCharset המציין את מערכת הערכים של הקלט

הלוך ושוב

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

פרמטרים

שםסוגתיאור
algorithmDigestAlgorithmDigestAlgorithm לשימוש
valueByte[]ערך מחרוזת קלט לחישוב תקציר

הלוך ושוב

Byte[] — בייט[] של תקציר הפלט


computeDigest(algorithm, value)

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

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

פרמטרים

שםסוגתיאור
algorithmDigestAlgorithmDigestAlgorithm לשימוש
valueStringערך מחרוזת קלט לחישוב תקציר

הלוך ושוב

Byte[] — בייט[] של תקציר הפלט


computeDigest(algorithm, value, charset)

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

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

פרמטרים

שםסוגתיאור
algorithmDigestAlgorithmDigestAlgorithm לשימוש
valueStringערך מחרוזת קלט לחישוב תקציר
charsetCharsetCharset שמייצג את קבוצת התווים להזנת קלט

הלוך ושוב

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

פרמטרים

שםסוגתיאור
valueByte[]ערך הקלט שישמש לגיבוב
keyByte[]מפתח שאפשר להשתמש בו כדי ליצור את הגיבוב

הלוך ושוב

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

פרמטרים

שםסוגתיאור
valueStringערך הקלט שישמש לגיבוב
keyStringמפתח שאפשר להשתמש בו כדי ליצור את הגיבוב

הלוך ושוב

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

פרמטרים

שםסוגתיאור
valueStringערך הקלט שישמש לגיבוב
keyStringמפתח שאפשר להשתמש בו כדי ליצור את הגיבוב
charsetCharsetCharset שמייצג את קבוצת התווים להזנת קלט

הלוך ושוב

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

פרמטרים

שםסוגתיאור
algorithmMacAlgorithmאלגוריתם MacAlgorithm המשמש לגיבוב ערך הקלט
valueByte[]ערך הקלט שישמש לגיבוב
keyByte[]מפתח שאפשר להשתמש בו כדי ליצור את הגיבוב

הלוך ושוב

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

פרמטרים

שםסוגתיאור
algorithmMacAlgorithmאלגוריתם MacAlgorithm המשמש לגיבוב ערך הקלט
valueStringערך הקלט שישמש לגיבוב
keyStringמפתח שאפשר להשתמש בו כדי ליצור את הגיבוב

הלוך ושוב

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

פרמטרים

שםסוגתיאור
algorithmMacAlgorithmאלגוריתם MacAlgorithm המשמש לגיבוב ערך הקלט
valueStringערך הקלט שישמש לגיבוב
keyStringמפתח שאפשר להשתמש בו כדי ליצור את הגיבוב
charsetCharsetCharset שמייצג את קבוצת התווים להזנת קלט

הלוך ושוב

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

פרמטרים

שםסוגתיאור
valueStringערך הקלט שישמש לגיבוב.
keyStringמפתח בפורמט 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);

פרמטרים

שםסוגתיאור
valueStringערך הקלט שישמש לגיבוב.
keyStringמפתח בפורמט PEM המשמש ליצירת החתימה.
charsetCharsetCharset שמייצג את קבוצת התווים שהוזנו.

הלוך ושוב

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

פרמטרים

שםסוגתיאור
valueStringערך הקלט שישמש לגיבוב
keyStringמפתח בפורמט 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);

פרמטרים

שםסוגתיאור
valueStringערך הקלט שישמש לגיבוב
keyStringמפתח בפורמט PEM המשמש ליצירת החתימה
charsetCharsetCharset שמייצג את קבוצת התווים להזנת קלט

הלוך ושוב

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

פרמטרים

שםסוגתיאור
algorithmRsaAlgorithmאלגוריתם מסוג RsaAlgorithm שמשמש לגיבוב ערך הקלט.
valueStringערך הקלט שישמש לגיבוב.
keyStringמפתח בפורמט 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);

פרמטרים

שםסוגתיאור
algorithmRsaAlgorithmאלגוריתם מסוג RsaAlgorithm שמשמש לגיבוב ערך הקלט.
valueStringערך הקלט שישמש לגיבוב.
keyStringמפתח בפורמט PEM המשמש ליצירת החתימה.
charsetCharsetCharset שמייצג את קבוצת התווים שהוזנו.

הלוך ושוב

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


formatDate(date, timeZone, format)

הפורמט נקבע בהתאם למפרט שצוין במחלקה Java 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);

פרמטרים

שםסוגתיאור
dateDateDate לעיצוב מחרוזת
timeZoneStringאזור הזמן של הפלט של התוצאה
formatStringפורמט בהתאם למפרט של SimpleDateFormat

הלוך ושוב

String — תאריך הקלט כמחרוזת בפורמט


formatString(template, args)

יוצרת מחרוזת בפורמט דמוי sprintf, עם מחרוזות בסגנון '%' .

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

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

פרמטרים

שםסוגתיאור
templateStringמחרוזת הפורמט השולטת באפשרות ההחזרה.
argsObject...אובייקטים לשימוש למילוי ה-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);

פרמטרים

שםסוגתיאור
blobBlobSourceאובייקט Blob לדחיסה באמצעות gzip.

הלוך ושוב

BlobBlob חדש שמכיל את הנתונים הדחוסים.


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

פרמטרים

שםסוגתיאור
blobBlobSourceאובייקט Blob לדחיסה באמצעות gzip.
nameStringשם הקובץ gzip שברצונך ליצור

הלוך ושוב

BlobBlob חדש שמכיל את הנתונים הדחוסים.


newBlob(data)

יצירת אובייקט Blob חדש ממערך בייט. אובייקטים של

פרמטרים

שםסוגתיאור
dataByte[]הבייטים של ה-blob

הלוך ושוב

Blob — ה-Blob החדש שנוצר


newBlob(data, contentType)

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

פרמטרים

שםסוגתיאור
dataByte[]הבייטים של ה-blob
contentTypeStringסוג התוכן של ה-blob - יכול להיות null

הלוך ושוב

Blob — ה-Blob החדש שנוצר


newBlob(data, contentType, name)

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

פרמטרים

שםסוגתיאור
dataByte[]הבייטים של ה-blob
contentTypeString- סוג התוכן של ה-blob - יכול להיות ריק
nameStringשם ה-blob - יכול להיות ריק

הלוך ושוב

Blob — ה-Blob החדש שנוצר


newBlob(data)

יוצרים אובייקט Blob חדש ממחרוזת. אובייקטים של

פרמטרים

שםסוגתיאור
dataStringהמחרוזת של ה-blob, בהנחה ש-UTF-8

הלוך ושוב

Blob — ה-Blob החדש שנוצר


newBlob(data, contentType)

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

פרמטרים

שםסוגתיאור
dataStringהמחרוזת של ה-blob, בהנחה ש-UTF-8
contentTypeStringסוג התוכן של ה-blob - יכול להיות null

הלוך ושוב

Blob — ה-Blob החדש שנוצר


newBlob(data, contentType, name)

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

פרמטרים

שםסוגתיאור
dataStringהמחרוזת של ה-blob, בהנחה ש-UTF-8
contentTypeStringסוג התוכן של ה-blob - יכול להיות null
nameStringשם ה-blob - יכול להיות ריק

הלוך ושוב

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

פרמטרים

שםסוגתיאור
csvStringמחרוזת שמכילה נתונים יחידים או של מספר שורות בפורמט של ערכים מופרדים בפסיקים (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');

פרמטרים

שםסוגתיאור
csvStringמחרוזת שמכילה נתונים יחידים או של מספר שורות בפורמט של ערכים מופרדים בפסיקים (CSV)
delimiterCharבין ערכים

הלוך ושוב

String[][] — מערך דו-מימדי המכיל את הערכים במחרוזת ה-CSV


parseDate(date, timeZone, format)

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

פרמטרים

שםסוגתיאור
dateStringערך מחרוזת לניתוח כתאריך.
timeZoneStringאזור הזמן לפלט.
formatStringפורמט התאריך בהתאם למפרט של SimpleDateFormat.

הלוך ושוב

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


sleep(milliseconds)

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

פרמטרים

שםסוגתיאור
millisecondsIntegerמספר אלפיות השנייה שינה.

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

פרמטרים

שםסוגתיאור
blobBlobSourceBlob של נתונים דחוסים.

הלוך ושוב

BlobBlob שמייצג את הנתונים המושבתים.


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

פרמטרים

שםסוגתיאור
blobBlobSourceblob של קובץ ה-zip.

הלוך ושוב

Blob[] — בועות[] המייצגות את blobs הרכיבים, כאשר כל אחד מהם מכיל את הנתיב המלא בתוך המיקוד


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

פרמטרים

שםסוגתיאור
blobsBlobSource[]מערך של 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");

פרמטרים

שםסוגתיאור
blobsBlobSource[]מערך של blobs לדחיסה
nameStringהשם של קובץ ה-ZIP שצריך ליצור

הלוך ושוב

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

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