קובץ מצורף מ-Gmail. זהו Blob
רגיל, אבל יש לו שיטה נוספת של getSize()
, שהיא מהירה יותר מקריאה ל-getBytes()
.length
ולא נספרת במכסת הקריאה ב-Gmail.
// Logs information about any attachments in the first 100 inbox threads. var threads = GmailApp.getInboxThreads(0, 100); var msgs = GmailApp.getMessagesForThreads(threads); for (var i = 0 ; i < msgs.length; i++) { for (var j = 0; j < msgs[i].length; j++) { var attachments = msgs[i][j].getAttachments(); for (var k = 0; k < attachments.length; k++) { Logger.log('Message "%s" contains the attachment "%s" (%s bytes)', msgs[i][j].getSubject(), attachments[k].getName(), attachments[k].getSize()); } } }
שיטות
שיטה | סוג הערך שמוחזר | תיאור קצר |
---|---|---|
copyBlob() | Blob | הפונקציה מחזירה עותק של ה-blob הזה. |
getAs(contentType) | Blob | החזרת הנתונים שבתוך האובייקט הזה כ-blob שהומר לסוג התוכן שצוין. |
getBytes() | Byte[] | הפונקציה מקבלת את הנתונים שמאוחסנים ב-blob הזה. |
getContentType() | String | הפונקציה מקבלת את סוג התוכן של הבייטים ב-blob הזה. |
getDataAsString() | String | הפונקציה מקבלת את הנתונים של ה-blob הזה כמחרוזת עם קידוד UTF-8. |
getDataAsString(charset) | String | הפונקציה מקבלת את הנתונים של ה-blob הזה כמחרוזת עם הקידוד שצוין. |
getHash() | String | הפונקציה מקבלת את גיבוב התוכן SHA1 של הקובץ המצורף. |
getName() | String | הפונקציה מקבלת את השם של ה-blob הזה. |
getSize() | Integer | משיג את הגודל של הקובץ המצורף הזה. |
isGoogleType() | Boolean | מחזירה אם ה-blob הזה הוא קובץ Google Workspace (Sheets , Docs וכו'). |
setBytes(data) | Blob | מגדיר את הנתונים שמאוחסנים ב-blob הזה. |
setContentType(contentType) | Blob | מגדיר את סוג התוכן של הבייטים ב-blob הזה. |
setContentTypeFromExtension() | Blob | סוג התוכן של הבייטים ב-blob הזה מוגדר על סמך סיומת הקובץ. |
setDataFromString(string) | Blob | מגדיר את הנתונים של ה-blob הזה ממחרוזת עם קידוד UTF-8. |
setDataFromString(string, charset) | Blob | מגדיר את הנתונים של ה-blob הזה ממחרוזת עם הקידוד שצוין. |
setName(name) | Blob | הגדרת השם של ה-blob הזה. |
תיעוד מפורט
copyBlob()
getAs(contentType)
החזרת הנתונים שבתוך האובייקט הזה כ-blob שהומר לסוג התוכן שצוין. השיטה הזו מוסיפה את הסיומת המתאימה לשם הקובץ, לדוגמה, 'myfile.pdf'. עם זאת, ההנחה היא שהחלק שמופיע בשם הקובץ אחרי הנקודה האחרונה (אם יש כזה) הוא תוסף קיים שצריך להחליף. בעקבות זאת, הערך "ShoppingList.12.25.2014" הופך ל-"ShoppingList.12.25.pdf".
במאמר מכסות לשירותי Google תוכלו לראות את המכסות היומיות להמרות. באופן זמני, דומיינים חדשים ב-Google Workspace עשויים להיות כפופים למכסות מחמירות יותר.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
contentType | String | סוג ה-MIME שאליו יש להמיר. ברוב ה-blobs, 'application/pdf' היא
האפשרות החוקית היחידה. עבור תמונות בפורמט BMP, GIF, JPEG או PNG, ניתן גם להשתמש בכל אחד מהערכים 'image/bmp' , 'image/gif' , 'image/jpeg' או 'image/png' . |
החזרות
Blob
– הנתונים כ-blob.
getBytes()
הפונקציה מקבלת את הנתונים שמאוחסנים ב-blob הזה.
החזרות
Byte[]
- הבייטים המאוחסנים.
getContentType()
הפונקציה מקבלת את סוג התוכן של הבייטים ב-blob הזה.
החזרות
String
– סוג התוכן של הנתונים האלה, אם ידוע, או null
.
getDataAsString()
הפונקציה מקבלת את הנתונים של ה-blob הזה כמחרוזת עם קידוד UTF-8.
החזרות
String
- הנתונים כמחרוזת.
getDataAsString(charset)
הפונקציה מקבלת את הנתונים של ה-blob הזה כמחרוזת עם הקידוד שצוין.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
charset | String | ערכת התווים לשימוש בקידוד הנתונים ב-blob זה כמחרוזת. |
החזרות
String
- הנתונים כמחרוזת.
getHash()
הפונקציה מקבלת את גיבוב התוכן SHA1 של הקובץ המצורף. השיטה הזו לא נחשבת כחלק ממכסת הקריאה ב-Gmail.
החזרות
String
- גיבוב (hash) של תוכן SHA1, כמחרוזת.
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה עם אחד או יותר מההיקפים הבאים או עם ההיקפים המתאימים מ-API ל-REST הקשור:
-
https://mail.google.com/
getName()
הפונקציה מקבלת את השם של ה-blob הזה.
החזרות
String
- השם של הנתונים האלה, אם הוא ידוע, או null
.
getSize()
משיג את הגודל של הקובץ המצורף הזה. השיטה הזו מהירה יותר מקריאה ל-getBytes()
.length
והיא לא נספרת במכסת הקריאה של Gmail.
החזרות
Integer
- גודל הקובץ המצורף, בבייטים.
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה עם אחד או יותר מההיקפים הבאים או עם ההיקפים המתאימים מ-API ל-REST הקשור:
-
https://mail.google.com/
isGoogleType()
מחזירה אם ה-blob הזה הוא קובץ Google Workspace (Sheets , Docs וכו').
החזרות
Boolean
– true
אם ה-blob הזה הוא קובץ Google Workspace. אם לא, false
.
setBytes(data)
מגדיר את הנתונים שמאוחסנים ב-blob הזה.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
data | Byte[] | הנתונים החדשים. |
החזרות
Blob
– ה-blob הזה, לשרשור.
setContentType(contentType)
מגדיר את סוג התוכן של הבייטים ב-blob הזה.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
contentType | String | ה-contentType החדש. |
החזרות
Blob
– ה-blob הזה, לשרשור.
setContentTypeFromExtension()
סוג התוכן של הבייטים ב-blob הזה מוגדר על סמך סיומת הקובץ. הערך ב-contentType הוא null
, אם אי אפשר לנחש אותו מהתוסף שלו.
החזרות
Blob
– ה-blob הזה, לשרשור.
setDataFromString(string)
מגדיר את הנתונים של ה-blob הזה ממחרוזת עם קידוד UTF-8.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
string | String | נתוני המחרוזת. |
החזרות
Blob
– ה-blob הזה, לשרשור.
setDataFromString(string, charset)
מגדיר את הנתונים של ה-blob הזה ממחרוזת עם הקידוד שצוין.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
string | String | נתוני המחרוזת. |
charset | String | קבוצת התווים שיש להשתמש בה כדי לפרש את המחרוזת כבייטים. |
החזרות
Blob
– ה-blob הזה, לשרשור.
setName(name)
הגדרת השם של ה-blob הזה.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
name | String | השם החדש. |
החזרות
Blob
– ה-blob הזה, לשרשור.