השירות הזה מספק כלי עזר לקידוד ולפענוח מחרוזות, לעיצוב תאריכים, לשינוי נתוני JSON ולמשימות שונות אחרות.
מאפיינים
| נכס | סוג | תיאור |
|---|---|---|
Charset | Charset | |
Digest | Digest | |
Mac | Mac | |
Rsa | Rsa |
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 שמתאימה לאינטרנט מהמחרוזת הנתונה בערכת תווים ספציפית. |
compute | Byte[] | מחשבים את הגיבוב באמצעות האלגוריתם שצוין על הערך Byte[] שצוין. |
compute | Byte[] | מחשבים את הגיבוב באמצעות האלגוריתם שצוין על הערך String שצוין. |
compute | Byte[] | מחשבים תקציר באמצעות האלגוריתם שצוין על הערך String שצוין עם קבוצת התווים שצוינה. |
compute | Byte[] | חתימה על הערך שצוין באמצעות HMAC-SHA256 עם המפתח שצוין. |
compute | Byte[] | חתימה על הערך שצוין באמצעות HMAC-SHA256 עם המפתח שצוין. |
compute | Byte[] | חתימה על הערך שצוין באמצעות HMAC-SHA256 עם המפתח ומערכת התווים שצוינו. |
compute | Byte[] | חישוב קוד אימות הודעה באמצעות האלגוריתם שצוין במפתח ובערך שצוינו. |
compute | Byte[] | חישוב קוד אימות הודעה באמצעות האלגוריתם שצוין במפתח ובערך שצוינו. |
compute | Byte[] | חישוב קוד אימות הודעה באמצעות האלגוריתם שצוין במפתח ובערך שצוינו. |
compute | Byte[] | חתימה על הערך שסופק באמצעות RSA-SHA1 עם המפתח שצוין. |
compute | Byte[] | הפונקציה חותמת על הערך שסופק באמצעות RSA-SHA1 עם המפתח וערכת התווים שסופקו. |
compute | Byte[] | הפונקציה חותמת על הערך שצוין באמצעות RSA-SHA256 עם המפתח שצוין. |
compute | Byte[] | הפונקציה חותמת על הערך שצוין באמצעות RSA-SHA256 עם המפתח שצוין. |
compute | Byte[] | חתימה על הערך שסופק באמצעות אלגוריתם ה-RSA שצוין עם המפתח הנתון. |
compute | Byte[] | הפונקציה חותמת על הערך שצוין באמצעות אלגוריתם ה-RSA שצוין עם המפתח וערכת התווים שצוינו. |
format | String | הפונקציה מעצבת את התאריך לפי המפרט שמתואר במחלקה SimpleDateFormat של Java SE. |
format | String | מבצעת עיצוב מחרוזות כמו sprintf באמצעות מחרוזות פורמט בסגנון '%'. |
get | String | קבלת UUID כמחרוזת (שווה לשימוש בשיטה java.util.UUID.randomUUID()). |
gzip(blob) | Blob | gzip-דוחס את נתוני Blob ומחזיר אותם באובייקט Blob חדש. |
gzip(blob, name) | Blob | gzip-דוחס את נתוני Blob ומחזיר אותם באובייקט Blob חדש. |
new | Blob | יוצרים אובייקט Blob חדש ממערך בייטים. |
new | Blob | יוצרים אובייקט Blob חדש ממערך בייטים ומסוג תוכן. |
new | Blob | יצירת אובייקט Blob חדש ממערך בייטים, מסוג תוכן ומשם. |
new | Blob | יצירת אובייקט Blob חדש ממחרוזת. |
new | Blob | יוצרים אובייקט Blob חדש ממחרוזת ומסוג תוכן. |
new | Blob | יוצרים אובייקט Blob חדש ממחרוזת, מסוג תוכן ומשם. |
parse | String[][] | הפונקציה מחזירה ייצוג של מחרוזת CSV כמערך דו-ממדי טבלאי. |
parse | String[][] | הפונקציה מחזירה ייצוג של מחרוזת CSV כמערך דו-ממדי טבלאי, באמצעות תו מפריד בהתאמה אישית. |
parse | Date | מנתח את מחרוזת התאריך שסופקה לפי המפרט שמתואר במחלקה Simple של 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());
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
encoded | String | מערך של בייטים של נתונים לפענוח. |
חזרה
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());
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
encoded | String | מחרוזת הנתונים לפענוח. |
charset | Charset | Charset שמציין את ערכת התווים של הקלט. |
חזרה
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());
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
encoded | String | מערך של בייטים של נתונים בטוחים לשימוש באינטרנט שצריך לפענח. |
חזרה
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());
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
encoded | String | המחרוזת של הנתונים שניתנים לשימוש באינטרנט שצריך לפענח. |
charset | Charset | Charset שמציין את ערכת התווים של הקלט. |
חזרה
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);
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
data | Byte[] | מערך 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);
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
data | String | המחרוזת לקידוד. |
חזרה
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);
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
data | String | מחרוזת הנתונים שצריך לקודד. |
charset | Charset | Charset שמציין את ערכת התווים של הקלט. |
חזרה
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);
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
data | Byte[] | מערך של בייטים של נתונים שצריך לקודד. |
חזרה
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);
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
data | String | המחרוזת לקידוד. |
חזרה
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);
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
data | String | מחרוזת הנתונים שצריך לקודד. |
charset | Charset | Charset שמציין את ערכת התווים של הקלט. |
חזרה
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);
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
algorithm | Digest | Digest לשימוש. |
value | Byte[] | ערך מחרוזת קלט לחישוב תקציר. |
חזרה
Byte[] — מערך byte[] שמייצג את הגיבוב של הפלט.
computeDigest(algorithm, value)
מחשבים את הגיבוב באמצעות האלגוריתם שצוין על הערך String שצוין.
const digest = Utilities.computeDigest( Utilities.DigestAlgorithm.MD5, 'input to hash', ); Logger.log(digest);
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
algorithm | Digest | Digest לשימוש. |
value | String | ערך מחרוזת קלט לחישוב תקציר. |
חזרה
Byte[] — מערך byte[] שמייצג את הגיבוב של הפלט.
computeDigest(algorithm, value, charset)
מחשבים תקציר באמצעות האלגוריתם שצוין על הערך String שצוין עם קבוצת התווים שצוינה.
const digest = Utilities.computeDigest( Utilities.DigestAlgorithm.MD5, 'input to hash', Utilities.Charset.US_ASCII, ); Logger.log(digest);
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
algorithm | Digest | Digest לשימוש. |
value | String | ערך מחרוזת קלט לחישוב תקציר. |
charset | Charset | Charset שמייצג את מערכת התווים של הקלט. |
חזרה
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);
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
value | Byte[] | ערך הקלט ליצירת הגיבוב. |
key | Byte[] | מפתח שמשמש ליצירת הגיבוב. |
חזרה
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);
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
value | String | ערך הקלט ליצירת הגיבוב. |
key | String | מפתח שמשמש ליצירת הגיבוב. |
חזרה
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);
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
value | String | ערך הקלט ליצירת הגיבוב. |
key | String | מפתח שמשמש ליצירת הגיבוב. |
charset | Charset | Charset שמייצג את מערכת התווים של הקלט. |
חזרה
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);
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
algorithm | Mac | אלגוריתם Mac לגיבוב של ערך הקלט. |
value | Byte[] | ערך הקלט ליצירת הגיבוב. |
key | Byte[] | מפתח שמשמש ליצירת הגיבוב. |
חזרה
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);
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
algorithm | Mac | אלגוריתם Mac לגיבוב של ערך הקלט. |
value | String | ערך הקלט ליצירת הגיבוב. |
key | String | מפתח שמשמש ליצירת הגיבוב. |
חזרה
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);
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
algorithm | Mac | אלגוריתם Mac לגיבוב של ערך הקלט. |
value | String | ערך הקלט ליצירת הגיבוב. |
key | String | מפתח שמשמש ליצירת הגיבוב. |
charset | Charset | Charset שמייצג את מערכת התווים של הקלט. |
חזרה
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);
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
value | String | ערך הקלט ליצירת הגיבוב. |
key | String | מפתח בפורמט 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);
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
value | String | ערך הקלט ליצירת הגיבוב. |
key | String | מפתח בפורמט PEM שמשמש ליצירת החתימה. |
charset | Charset | Charset שמייצג את מערכת התווים של הקלט. |
חזרה
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);
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
value | String | ערך הקלט ליצירת הגיבוב. |
key | String | מפתח בפורמט 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);
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
value | String | ערך הקלט ליצירת הגיבוב. |
key | String | מפתח בפורמט PEM שמשמש ליצירת החתימה. |
charset | Charset | Charset שמייצג את מערכת התווים של הקלט. |
חזרה
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);
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
algorithm | Rsa | אלגוריתם Rsa לגיבוב של ערך הקלט. |
value | String | ערך הקלט ליצירת הגיבוב. |
key | String | מפתח בפורמט 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);
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
algorithm | Rsa | אלגוריתם Rsa לגיבוב של ערך הקלט. |
value | String | ערך הקלט ליצירת הגיבוב. |
key | String | מפתח בפורמט PEM שמשמש ליצירת החתימה. |
charset | Charset | Charset שמייצג את מערכת התווים של הקלט. |
חזרה
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);
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
date | Date | Date לעיצוב כמחרוזת. |
time | String | אזור הזמן של התוצאה. |
format | String | פורמט לפי המפרט של Simple. |
חזרה
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. 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);
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
blob | Blob | אובייקט Blob לדחיסה באמצעות gzip. |
חזרה
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');
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
blob | Blob | אובייקט Blob לדחיסה באמצעות gzip. |
name | String | השם של קובץ gzip שייווצר. |
חזרה
newBlob(data)
יוצרים אובייקט Blob חדש ממערך בייטים. Blobs משמשים בהרבה ממשקי API של Apps Script שמקבלים נתונים בינאריים כקלט.
// Creates a blob object from a byte array. const data = [71, 79, 79, 71, 76, 69]; const blob = Utilities.newBlob(data); // Logs the blob data as a string to the console. console.log(blob.getDataAsString());
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
data | Byte[] | מספר הבייטים של ה-blob. |
חזרה
Blob – ה-Blob שנוצר.
newBlob(data, contentType)
יוצרים אובייקט Blob חדש ממערך בייטים ומסוג תוכן. blobs משמשים בממשקי API רבים של Apps Script שמקבלים נתונים בינאריים כקלט.
// Declares a byte array. const data = [71, 79, 79, 71, 76, 69]; // Declares the content type of the blob. const contentType = 'application/json'; // Creates a blob object from the byte array and content type. const blob = Utilities.newBlob(data, contentType); // Logs the blob data as a string to the console. console.log(blob.getDataAsString()); // Logs the content type of the blob to the console. console.log(blob.getContentType());
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
data | Byte[] | מספר הבייטים של ה-blob. |
content | String | סוג התוכן של ה-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());
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
data | Byte[] | מספר הבייטים של ה-blob. |
content | String | – סוג התוכן של ה-blob – יכול להיות null. |
name | String | השם של ה-blob – יכול להיות null. |
חזרה
Blob – ה-Blob שנוצר.
newBlob(data)
יצירת אובייקט Blob חדש ממחרוזת. Blobs משמשים בהרבה ממשקי API של Apps Script שמקבלים נתונים בינאריים כקלט.
// Declares a string for the blob. const data = 'GOOGLE'; // Creates a blob object from a string. const blob = Utilities.newBlob(data); // Logs the blob data in byte array to the console. console.log('Blob Data:', blob.getBytes());
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
data | String | המחרוזת של ה-blob, בהנחה שהיא בקידוד UTF-8. |
חזרה
Blob – ה-Blob שנוצר.
newBlob(data, contentType)
יוצרים אובייקט Blob חדש ממחרוזת ומסוג תוכן. blobs משמשים בממשקי API רבים של Apps Script שמקבלים נתונים בינאריים כקלט.
// Declares a string for the blob. const data = 'GOOGLE'; // Declares the content type of blob. const contentType = 'application/json'; // Creates a blob object from the string and content type. const blob = Utilities.newBlob(data, contentType); // Logs the blob data in byte array to the console. console.log('Blob data:', blob.getBytes()); // Logs the content type of the blob to the console. console.log(blob.getContentType());
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
data | String | המחרוזת של ה-blob, בהנחה שהיא בקידוד UTF-8. |
content | String | סוג התוכן של ה-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());
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
data | String | המחרוזת של ה-blob, בהנחה שהיא בקידוד UTF-8. |
content | 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]] const csvString = 'a,b,c\nd,e,f'; const 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]] const csvString = 'a\tb\tc\nd\te\tf'; const data = Utilities.parseCsv(csvString, '\t');
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
csv | String | מחרוזת שמכילה נתונים בשורה אחת או בכמה שורות בפורמט של ערכים מופרדים בפסיקים (CSV). |
delimiter | Char | בין ערכים. |
חזרה
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);
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
date | String | ערך מחרוזת לניתוח כתאריך. |
time | String | אזור הזמן של הפלט. |
format | String | פורמט התאריך לפי המפרט של Simple. |
חזרה
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 שמכיל את הנתונים הלא דחוסים.
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);
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
blob | Blob | Blob של נתונים דחוסים. |
חזרה
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);
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
blob | Blob | ה-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]);
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
blobs | Blob | מערך של אובייקטים מסוג 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');
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
blobs | Blob | מערך של אובייקטים מסוג Blob שרוצים לכווץ. |
name | String | השם של קובץ ה-ZIP שייווצר. |
חזרה
Blob – Blob חדש שמכיל את קובצי הקלט כארכיון.