Class Utilities

כלי תחזוקה

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

מאפיינים

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

Methods

שיטהסוג הערך המוחזרתיאור קצר
base64Decode(encoded)Byte[]פענוח של מחרוזת בקידוד base-64 למערך בייטים של UTF-8.
base64Decode(encoded, charset)Byte[]הפונקציה מפענחת מחרוזת בקידוד base-64 למערך בייטים בקבוצת תווים ספציפית.
base64DecodeWebSafe(encoded)Byte[]פענוח מחרוזת בקידוד base64 שבטוח לשימוש באינטרנט למערך בייטים של UTF-8.
base64DecodeWebSafe(encoded, charset)Byte[]הפונקציה מפענחת מחרוזת בקידוד Base64 שמתאימה לאינטרנט למערך בייטים בקבוצת תווים ספציפית.
base64Encode(data)Stringיצירת מחרוזת בקידוד Base64 ממערך הבייטים הנתון.
base64Encode(data)Stringיצירת מחרוזת בקידוד Base64 מהמחרוזת שצוינה.
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 עם המפתח וה-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הפורמט של התאריך לפי המפרט שמתואר בכיתה 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.
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 we want a String instead of a byte array:
// This logs the original "Google グループ"
Logger.log(Utilities.newBlob(decoded).getDataAsString());

פרמטרים

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

חזרה

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


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 we want a String instead of a byte array:
// This logs the original "Google グループ"
Logger.log(Utilities.newBlob(decoded).getDataAsString());

פרמטרים

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

חזרה

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


base64DecodeWebSafe(encoded)

פענוח מחרוזת בקידוד base64 שבטוח לשימוש באינטרנט למערך בייטים של 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 we 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)

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

// 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 we want a String instead of a byte array:
// This logs the original "Google グループ"
Logger.log(Utilities.newBlob(decoded).getDataAsString());

פרמטרים

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

חזרה

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)

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

חזרה

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


base64EncodeWebSafe(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.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 לשימוש באינטרנט מהמחרוזת הנתונה בקבוצת תווים ספציפית. Charset הוא דרך לקידוד תווים כך שניתן יהיה לקודד אותם. בדרך כלל, הנתונים האלה נשלחים בפורמט בינארי, שבדרך כלל לא תואם לפרוטוקולים מסוימים להעברת נתונים. כדי שהנתונים יהיו תואמים, הם בדרך כלל מקודדים ל-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 שמציין את קוד ה-character set של הקלט.

חזרה

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


computeDigest(algorithm, value)

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

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

פרמטרים

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

חזרה

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[] – מערך של בייטים שמייצג את סיכום הפלט.


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


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


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


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


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


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


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 עם המפתח וה-charset שצוינו.

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


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


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


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


computeRsaSignature(algorithm, value, key, charset)

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

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

חזרה

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 ב-APIs רבים של 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 משמשים ב-APIs רבים של 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 ב-APIs רבים של 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 משמשים ב-APIs רבים של 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 משמשים ב-APIs רבים של 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. מידע נוסף זמין בכיתה SimpleDateFormat של 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[]מערך של blobs ליצירת קובץ zip.

חזרה

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[]מערך של blobs ליצירת קובץ zip.
nameStringהשם של קובץ ה-ZIP שייווצר.

חזרה

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

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