Class Utilities

כלי תחזוקה

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

מאפיינים

נכססוגתיאור
CharsetCharset
DigestAlgorithmDigestAlgorithm
MacAlgorithmMacAlgorithm
RsaAlgorithmRsaAlgorithm

Methods

שיטהסוג הערך שמוחזרתיאור קצר
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יוצרת מחרוזת בקידוד Base64 ממערך הבייטים הנתון.
base64Encode(data)Stringיוצרת מחרוזת בקידוד Base-64 מהמחרוזת שצוינה.
base64Encode(data, charset)Stringיוצרת מחרוזת בקידוד Base-64 מהמחרוזת הנתונה בערכת תווים ספציפית.
base64EncodeWebSafe(data)Stringיוצרת מחרוזת בקידוד Base64 שמותאם לאינטרנט ממערך הבייטים הנתון.
base64EncodeWebSafe(data)Stringיוצרת מחרוזת בקידוד Base64 שמתאימה לאינטרנט מהמחרוזת שצוינה.
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הפונקציה מעצבת את התאריך לפי המפרט שמתואר במחלקה SimpleDateFormat של Java SE.
formatString(template, args)Stringמבצעת עיצוב מחרוזות כמו sprintf באמצעות מחרוזות פורמט בסגנון '%'.
getUuid()Stringקבלת UUID כמחרוזת (שווה לשימוש בשיטה java.util.UUID.randomUUID()).
gzip(blob)Blobgzip-דוחס את נתוני Blob ומחזיר אותם באובייקט Blob חדש.
gzip(blob, name)Blobgzip-דוחס את נתוני 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 Edition.
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 グループ"
const base64data = 'R29vZ2xlIOOCsOODq+ODvOODlw==';

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

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

פרמטרים

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

חזרה

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


base64Decode(encoded, charset)

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

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

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

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

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

פרמטרים

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

חזרה

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


base64DecodeWebSafe(encoded)

מפענח מחרוזת בקידוד base-64 שבטוחה לשימוש באינטרנט למערך בייטים בקידוד UTF-8.

// This is the base64 web-safe encoded form of "Google グループ"
const base64data = 'R29vZ2xlIOOCsOODq-ODvOODlw==';

const decoded = Utilities.base64DecodeWebSafe(base64data);

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

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

פרמטרים

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

חזרה

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


base64DecodeWebSafe(encoded, charset)

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

// This is the base64 web-safe encoded form of "Google グループ"
const base64data = 'R29vZ2xlIOOCsOODq-ODvOODlw==';

const decoded = Utilities.base64DecodeWebSafe(
    base64data,
    Utilities.Charset.UTF_8,
);

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

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

פרמטרים

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

חזרה

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


base64Encode(data)

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

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

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

פרמטרים

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

חזרה

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


base64Encode(data)

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

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

פרמטרים

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

חזרה

String – ייצוג בקידוד Base-64 של מחרוזת הקלט.


base64Encode(data, charset)

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

// "Google Groups" in Katakana (Japanese)
const input = 'Google グループ';

// Writes "R29vZ2xlIOOCsOODq+ODvOODlw==" to the log
const encoded = Utilities.base64Encode(input, Utilities.Charset.UTF_8);
Logger.log(encoded);

פרמטרים

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

חזרה

String — ייצוג בקידוד Base-64 של מחרוזת הקלט עם Charset הנתון.


base64EncodeWebSafe(data)

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

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

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

פרמטרים

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

חזרה

String — ייצוג בקידוד Base64 שמתאים לאינטרנט של הנתונים שהועברו.


base64EncodeWebSafe(data)

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

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

פרמטרים

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

חזרה

String — ייצוג בקידוד Base64 שבטוח לשימוש באינטרנט של מחרוזת הקלט.


base64EncodeWebSafe(data, charset)

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

// "Google Groups" in Katakana (Japanese)
const input = 'Google グループ';

// Writes "R29vZ2xlIOOCsOODq-ODvOODlw==" to the log
const encoded = Utilities.base64EncodeWebSafe(input, Utilities.Charset.UTF_8);
Logger.log(encoded);

פרמטרים

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

חזרה

String — ייצוג בקידוד Base-64 בטוח לשימוש באינטרנט של מחרוזת הקלט עם Charset הנתון.


computeDigest(algorithm, value)

מחשבים את הגיבוב באמצעות האלגוריתם שצוין על הערך Byte[] שצוין.

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

פרמטרים

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

חזרה

Byte[] — מערך byte[] שמייצג את הגיבוב של הפלט.


computeDigest(algorithm, value)

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

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

פרמטרים

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

חזרה

Byte[] — מערך byte[] שמייצג את הגיבוב של הפלט.


computeDigest(algorithm, value, charset)

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

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

פרמטרים

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

חזרה

Byte[] — מערך byte[] שמייצג את הגיבוב של הפלט.


computeHmacSha256Signature(value, key)

חתימה על הערך שצוין באמצעות HMAC-SHA256 עם המפתח שצוין.

// This writes an array of bytes to the log.
const input = Utilities.base64Decode(
    'aW5wdXQgdG8gaGFzaA0K');                 // == base64encode("input to hash")
const key = Utilities.base64Decode('a2V5');  // == base64encode("key")
const signature = Utilities.computeHmacSha256Signature(input, key);
Logger.log(signature);

פרמטרים

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

חזרה

Byte[] – מערך byte[] שמייצג את חתימת הפלט.


computeHmacSha256Signature(value, key)

חתימה על הערך שצוין באמצעות HMAC-SHA256 עם המפתח שצוין.

// This writes an array of bytes to the log.
const signature = Utilities.computeHmacSha256Signature(
    'this is my input',
    'my key - use a stronger one',
);
Logger.log(signature);

פרמטרים

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

חזרה

Byte[] – מערך byte[] שמייצג את חתימת הפלט.


computeHmacSha256Signature(value, key, charset)

חתימה על הערך שצוין באמצעות HMAC-SHA256 עם המפתח ומערכת התווים שצוינו.

// This writes an array of bytes to the log.
const signature = Utilities.computeHmacSha256Signature(
    'this is my input',
    'my key - use a stronger one',
    Utilities.Charset.US_ASCII,
);
Logger.log(signature);

פרמטרים

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

חזרה

Byte[] – מערך byte[] שמייצג את חתימת הפלט.


computeHmacSignature(algorithm, value, key)

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

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

פרמטרים

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

חזרה

Byte[] – מערך byte[] שמייצג את חתימת הפלט.


computeHmacSignature(algorithm, value, key)

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

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

פרמטרים

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

חזרה

Byte[] – מערך byte[] שמייצג את חתימת הפלט.


computeHmacSignature(algorithm, value, key, charset)

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

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

פרמטרים

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

חזרה

Byte[] – מערך byte[] שמייצג את חתימת הפלט.


computeRsaSha1Signature(value, key)

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

// This writes an array of bytes to the log.
const signature = Utilities.computeRsaSha1Signature(
    'this is my input',
    PropertiesService.getScriptProperties().getProperty('YOUR_PRIVATE_KEY'),
);
Logger.log(signature);

פרמטרים

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

חזרה

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


computeRsaSha1Signature(value, key, charset)

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

// This writes an array of bytes to the log.
const signature = Utilities.computeRsaSha1Signature(
    'this is my input',
    PropertiesService.getScriptProperties().getProperty('YOUR_PRIVATE_KEY'),
    Utilities.Charset.US_ASCII,
);
Logger.log(signature);

פרמטרים

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

חזרה

Byte[] – מערך byte[] שמייצג את חתימת הפלט.


computeRsaSha256Signature(value, key)

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

// This writes an array of bytes to the log.
const signature = Utilities.computeRsaSha256Signature(
    'this is my input',
    PropertiesService.getScriptProperties().getProperty('YOUR_PRIVATE_KEY'),
);
Logger.log(signature);

פרמטרים

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

חזרה

Byte[] – מערך byte[] שמייצג את חתימת הפלט.


computeRsaSha256Signature(value, key, charset)

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

// This writes an array of bytes to the log.
const signature = Utilities.computeRsaSha256Signature(
    'this is my input',
    PropertiesService.getScriptProperties().getProperty('YOUR_PRIVATE_KEY'),
);
Logger.log(signature);

פרמטרים

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

חזרה

Byte[] – מערך byte[] שמייצג את חתימת הפלט.


computeRsaSignature(algorithm, value, key)

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

// This writes an array of bytes to the log.
const signature = Utilities.computeRsaSignature(
    Utilities.RsaAlgorithm.RSA_SHA_256,
    'this is my input',
    PropertiesService.getScriptProperties().getProperty('YOUR_PRIVATE_KEY'),
);
Logger.log(signature);

פרמטרים

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

חזרה

Byte[] – מערך byte[] שמייצג את חתימת הפלט.


computeRsaSignature(algorithm, value, key, charset)

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

// This writes an array of bytes to the log.
const signature = Utilities.computeRsaSignature(
    Utilities.RsaAlgorithm.RSA_SHA_256,
    'this is my input',
    PropertiesService.getScriptProperties().getProperty('YOUR_PRIVATE_KEY'),
    Utilities.Charset.US_ASCII,
);
Logger.log(signature);

פרמטרים

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

חזרה

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


formatDate(date, timeZone, format)

הפונקציה מעצבת את התאריך לפי המפרט שמתואר במחלקה SimpleDateFormat של Java SE. אפשר לעיין במפרט בכתובת http://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html

// This formats the date as Greenwich Mean Time in the format
// year-month-dateThour-minute-second.
const formattedDate = Utilities.formatDate(
    new Date(),
    'GMT',
    'yyyy-MM-dd\'T\'HH:mm:ss\'Z\'',
);
Logger.log(formattedDate);

פרמטרים

שםסוגתיאור
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.
const myDataObject = {
  tempId: Utilities.getUuid(),
};

חזרה

String — ייצוג מחרוזת של ה-UUID.


gzip(blob)

gzip-דוחס את נתוני Blob ומחזיר אותם באובייקט Blob חדש.

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

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

פרמטרים

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

חזרה

Blob — קובץ Blob חדש שמכיל את הנתונים הדחוסים.


gzip(blob, name)

gzip-דוחס את נתוני Blob ומחזיר אותם באובייקט Blob חדש. הגרסה הזו של השיטה מאפשרת לציין שם קובץ.

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

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

פרמטרים

שםסוגתיאור
blobBlobSourceאובייקט Blob לדחיסה באמצעות gzip.
nameStringהשם של קובץ 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());

פרמטרים

שםסוגתיאור
dataByte[]מספר הבייטים של ה-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());

פרמטרים

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

חזרה

Blob – ה-Blob שנוצר.


newBlob(data, contentType, name)

יצירת אובייקט 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';

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

פרמטרים

שםסוגתיאור
dataByte[]מספר הבייטים של ה-blob.
contentTypeString– סוג התוכן של ה-blob – יכול להיות null.
nameStringהשם של ה-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());

פרמטרים

שםסוגתיאור
dataStringהמחרוזת של ה-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());

פרמטרים

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

חזרה

Blob – ה-Blob שנוצר.


newBlob(data, contentType, name)

יוצרים אובייקט Blob חדש ממחרוזת, מסוג תוכן ומשם. ‫blobs משמשים בהרבה ממשקי 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());

פרמטרים

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

חזרה

Blob – ה-Blob שנוצר.


parseCsv(csv)

הפונקציה מחזירה ייצוג של מחרוזת CSV כמערך דו-ממדי טבלאי.

// This creates a two-dimensional array of the format [[a, b, c], [d, e, f]]
const csvString = 'a,b,c\nd,e,f';
const data = Utilities.parseCsv(csvString);

פרמטרים

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

חזרה

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


parseCsv(csv, delimiter)

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

// This creates a two-dimensional array of the format [[a, b, c], [d, e, f]]
const csvString = 'a\tb\tc\nd\te\tf';
const data = Utilities.parseCsv(csvString, '\t');

פרמטרים

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

חזרה

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


parseDate(date, timeZone, format)

מנתח את מחרוזת התאריך שסופקה לפי המפרט שמתואר במחלקה SimpleDateFormat של Java Standard Edition. מידע נוסף זמין במאמר בנושא SimpleDateFormat class ב-Java.

// This set of parameters parses the given string as a date in Greenwich Mean
// Time, formatted as year-month-dateThour-minute-second.
const date = Utilities.parseDate(
    '1970-01-01 00:00:00',
    'GMT',
    'yyyy-MM-dd\' \'HH:mm:ss',
);
Logger.log(date);

פרמטרים

שםסוגתיאור
dateStringערך מחרוזת לניתוח כתאריך.
timeZoneStringאזור הזמן של הפלט.
formatStringפורמט התאריך לפי המפרט של 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());

פרמטרים

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

ungzip(blob)

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

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

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

// Uncompress the data.
const uncompressedBlob = Utilities.ungzip(gzipBlob);

פרמטרים

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

חזרה

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


unzip(blob)

מקבלת Blob שמייצג קובץ ZIP ומחזירה את קובצי הרכיבים שלו.

const googleFavIconUrl = 'https://www.google.com/favicon.ico';
const googleLogoUrl = 'https://www.google.com/images/srpr/logo3w.png';

// Fetch the Google favicon.ico file and get the Blob data
const faviconBlob = UrlFetchApp.fetch(googleFavIconUrl).getBlob();
const logoBlob = UrlFetchApp.fetch(googleLogoUrl).getBlob();

// zip now references a blob containing an archive of both faviconBlob and
// logoBlob
const zip = Utilities.zip([faviconBlob, logoBlob], 'google_images.zip');

// This now unzips the blobs
const files = Utilities.unzip(zip);

פרמטרים

שםסוגתיאור
blobBlobSourceה-blob של קובץ ה-ZIP.

חזרה

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


zip(blobs)

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

const googleFavIconUrl = 'https://www.google.com/favicon.ico';
const googleLogoUrl = 'https://www.google.com/images/srpr/logo3w.png';

// Fetch the Google favicon.ico file and get the Blob data
const faviconBlob = UrlFetchApp.fetch(googleFavIconUrl).getBlob();
const logoBlob = UrlFetchApp.fetch(googleLogoUrl).getBlob();

// zip now references a blob containing an archive of both faviconBlob and
// logoBlob
const zip = Utilities.zip([faviconBlob, logoBlob]);

פרמטרים

שםסוגתיאור
blobsBlobSource[]מערך של אובייקטים מסוג Blob שרוצים לכווץ.

חזרה

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


zip(blobs, name)

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

const googleFavIconUrl = 'https://www.google.com/favicon.ico';
const googleLogoUrl = 'https://www.google.com/images/srpr/logo3w.png';

// Fetch the Google favicon.ico file and get the Blob data
const faviconBlob = UrlFetchApp.fetch(googleFavIconUrl).getBlob();
const logoBlob = UrlFetchApp.fetch(googleLogoUrl).getBlob();

// zip now references a blob containing an archive of both faviconBlob and
// logoBlob
const zip = Utilities.zip([faviconBlob, logoBlob], 'google_images.zip');

פרמטרים

שםסוגתיאור
blobsBlobSource[]מערך של אובייקטים מסוג Blob שרוצים לכווץ.
nameStringהשם של קובץ ה-ZIP שייווצר.

חזרה

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

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