השירות הזה מספק כלי עזר לקידוד/פענוח מחרוזות, לעיצוב תאריכים, לטיפול ב-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[] | פענוח מחרוזת בקידוד 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 לשימוש באינטרנט מהמחרוזת הנתונה בקבוצת תווים ספציפית. |
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 עם המפתח וה-charset שצוינו. |
compute | Byte[] | חתימה על הערך שסופק באמצעות RSA-SHA256 עם המפתח הנתון. |
compute | Byte[] | חתימה על הערך שסופק באמצעות RSA-SHA256 עם המפתח הנתון. |
compute | Byte[] | חתימה על הערך שסופק באמצעות אלגוריתם ה-RSA שצוין עם המפתח שצוין. |
compute | Byte[] | חתימה על הערך שסופק באמצעות אלגוריתם ה-RSA שצוין, עם המפתח וה-charset שצוינו. |
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. |
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());
פרמטרים
שם | סוג | תיאור |
---|---|---|
encoded | String | מערך של בייטים של נתונים לפענוח. |
חזרה
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());
פרמטרים
שם | סוג | תיאור |
---|---|---|
encoded | String | מחרוזת הנתונים שרוצים לפענח. |
charset | Charset | Charset שמציין את קוד ה-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());
פרמטרים
שם | סוג | תיאור |
---|---|---|
encoded | String | מערך של בייטים של נתונים בטוחים לאינטרנט לצורך פענוח. |
חזרה
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());
פרמטרים
שם | סוג | תיאור |
---|---|---|
encoded | String | מחרוזת הנתונים הבטוחים לאינטרנט לפענוח. |
charset | Charset | Charset שמציין את קוד ה-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);
פרמטרים
שם | סוג | תיאור |
---|---|---|
data | Byte[] | מערך של נתונים בפורמט 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);
פרמטרים
שם | סוג | תיאור |
---|---|---|
data | String | המחרוזת שרוצים לקודד. |
חזרה
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);
פרמטרים
שם | סוג | תיאור |
---|---|---|
data | String | מחרוזת הנתונים לקודד. |
charset | Charset | Charset שמציין את קוד ה-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);
פרמטרים
שם | סוג | תיאור |
---|---|---|
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 לשימוש באינטרנט מהמחרוזת הנתונה בקבוצת תווים ספציפית. 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);
פרמטרים
שם | סוג | תיאור |
---|---|---|
data | String | מחרוזת הנתונים לקודד. |
charset | Charset | Charset שמציין את קוד ה-character set של הקלט. |
חזרה
String
– הייצוג המקודד ב-base64 לשימוש באינטרנט של מחרוזת הקלט עם Charset
הנתון.
compute Digest(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[]
– מערך של בייטים שמייצג את סיכום הפלט.
compute Digest(algorithm, value)
חישוב סיכום באמצעות האלגוריתם שצוין בערך String
שצוין.
const digest = Utilities.computeDigest( Utilities.DigestAlgorithm.MD5, 'input to hash', ); Logger.log(digest);
פרמטרים
שם | סוג | תיאור |
---|---|---|
algorithm | Digest | Digest לשימוש. |
value | String | ערך מחרוזת קלט לחישוב סיכום. |
חזרה
Byte[]
– מערך של בייטים שמייצג את סיכום הפלט.
compute Digest(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[]
– מערך של בייטים שמייצג את סיכום הפלט.
compute Hmac Sha256Signature(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[]
– מערך של בייטים שמייצג את חתימה הפלט.
compute Hmac Sha256Signature(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[]
– מערך של בייטים שמייצג את חתימה הפלט.
compute Hmac Sha256Signature(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[]
– מערך של בייטים שמייצג את חתימה הפלט.
compute Hmac Signature(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[]
– מערך של בייטים שמייצג את חתימה הפלט.
compute Hmac Signature(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[]
– מערך של בייטים שמייצג את חתימה הפלט.
compute Hmac Signature(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[]
– מערך של בייטים שמייצג את חתימה הפלט.
compute Rsa Sha1Signature(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[]
– מערך של בייטים שמייצג את חתימה הפלט.
compute Rsa Sha1Signature(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);
פרמטרים
שם | סוג | תיאור |
---|---|---|
value | String | ערך הקלט שעבורו רוצים ליצור גיבוב. |
key | String | מפתח בפורמט PEM שמשמש ליצירת החתימה. |
charset | Charset | Charset שמייצג את מערכת התווים של הקלט. |
חזרה
Byte[]
– מערך של בייטים שמייצג את חתימה הפלט.
compute Rsa Sha256Signature(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[]
– מערך של בייטים שמייצג את חתימה הפלט.
compute Rsa Sha256Signature(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[]
– מערך של בייטים שמייצג את חתימה הפלט.
compute Rsa Signature(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[]
– מערך של בייטים שמייצג את חתימה הפלט.
compute Rsa Signature(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);
פרמטרים
שם | סוג | תיאור |
---|---|---|
algorithm | Rsa | אלגוריתם Rsa שמשמש לגיבוב ערך הקלט. |
value | String | ערך הקלט שעבורו רוצים ליצור גיבוב. |
key | String | מפתח בפורמט PEM שמשמש ליצירת החתימה. |
charset | Charset | Charset שמייצג את מערכת התווים של הקלט. |
חזרה
Byte[]
– מערך של בייטים שמייצג את חתימה הפלט.
format Date(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
– תאריך הקלט כמחרוזת בפורמט.
format String(template, args)
ביצוע עיצוב מחרוזת כמו sprintf
באמצעות מחרוזות עיצוב בסגנון '%'.
// " 123.456000" Utilities.formatString('%11.6f', 123.456); // " abc" Utilities.formatString('%6s', 'abc');
פרמטרים
שם | סוג | תיאור |
---|---|---|
template | String | מחרוזת הפורמט שקובע מה יוחזר. |
args | Object... | אובייקטים שישמשו למילוא של תוספי ה-% בתבנית. |
חזרה
String
— המחרוזת בפורמט מסוים.
get Uuid()
אחזור של 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 שייווצר. |
חזרה
new Blob(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());
פרמטרים
שם | סוג | תיאור |
---|---|---|
data | Byte[] | הבייטים של ה-blob. |
חזרה
Blob
– ה-Blob החדש שנוצר.
new Blob(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 החדש שנוצר.
new Blob(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());
פרמטרים
שם | סוג | תיאור |
---|---|---|
data | Byte[] | הבייטים של ה-blob. |
content | String | - סוג התוכן של ה-blob – יכול להיות null . |
name | String | שם ה-blob – יכול להיות null . |
חזרה
Blob
– ה-Blob החדש שנוצר.
new Blob(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());
פרמטרים
שם | סוג | תיאור |
---|---|---|
data | String | המחרוזת של ה-blob, בהנחה שהיא ב-UTF-8. |
חזרה
Blob
– ה-Blob החדש שנוצר.
new Blob(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());
פרמטרים
שם | סוג | תיאור |
---|---|---|
data | String | המחרוזת של ה-blob, בהנחה שהיא ב-UTF-8. |
content | String | סוג התוכן של ה-blob – יכול להיות null . |
חזרה
Blob
– ה-Blob החדש שנוצר.
new Blob(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());
פרמטרים
שם | סוג | תיאור |
---|---|---|
data | String | המחרוזת של ה-blob, בהנחה שהיא ב-UTF-8. |
content | String | סוג התוכן של ה-blob – יכול להיות null . |
name | String | שם ה-blob – יכול להיות null . |
חזרה
Blob
– ה-Blob החדש שנוצר.
parse Csv(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.
parse Csv(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.
parse Date(date, timeZone, format)
ניתוח התאריך של המחרוזת שצוינה בהתאם למפרט שמתואר בכיתה Simple
של מהדורת Java Standard. מידע נוסף זמין בכיתה Simple
של 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 | מערך של 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');
פרמטרים
שם | סוג | תיאור |
---|---|---|
blobs | Blob | מערך של blobs ליצירת קובץ zip. |
name | String | השם של קובץ ה-ZIP שייווצר. |
חזרה
Blob
– blob חדש שמכיל את הקלטים כארכיון.