קובץ מצורף מ-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 שהומר לסוג התוכן שצוין. הזה method מוסיפה את הסיומת המתאימה לשם הקובץ, לדוגמה, "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' צריך להיות תואם גם
תקין. במסמך של Google Docs, גם 'text/markdown' תקף. |
חזרה
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
– גיבוב התוכן באלגוריתם 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 הזה על סמך סיומת הקובץ. סוג התוכן הוא
null
אם אי אפשר לנחש אותו מהתוסף שלו.
חזרה
Blob
– ה-blob הזה, לשרשור.
setDataFromString(string)
מגדיר את הנתונים של ה-blob הזה ממחרוזת בקידוד UTF-8.
פרמטרים
שם | סוג | תיאור |
---|---|---|
string | String | נתוני המחרוזת. |
חזרה
Blob
– ה-blob הזה, לשרשור.
setDataFromString(string, charset)
מגדיר את הנתונים של ה-blob הזה ממחרוזת עם הקידוד שצוין.
פרמטרים
שם | סוג | תיאור |
---|---|---|
string | String | נתוני המחרוזת. |
charset | String | ערכת התווים שבה יש להשתמש בפירוש המחרוזת כבייטים. |
חזרה
Blob
– ה-blob הזה, לשרשור.