Class GmailAttachment

GmailAttachment

קובץ מצורף מ-Gmail. זהו Blob רגיל, רק שיש לו שיטה נוספת getSize() שהיא מהירה יותר מקריאה ל-getBytes().length והיא לא נספרת במכסת הקריאה של Gmail.

// Logs information about any attachments in the first 100 inbox threads.
const threads = GmailApp.getInboxThreads(0, 100);
const msgs = GmailApp.getMessagesForThreads(threads);
for (let i = 0; i < msgs.length; i++) {
  for (let j = 0; j < msgs[i].length; j++) {
    const attachments = msgs[i][j].getAttachments();
    for (let 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(),
      );
    }
  }
}

Methods

שיטה	סוג הערך שמוחזר	תיאור קצר
copyBlob()	Blob	מחזירה עותק של ה-blob הזה.
getAs(contentType)	Blob	החזרת הנתונים בתוך האובייקט הזה כ-Blob שהומר לסוג התוכן שצוין.
getBytes()	Byte[]	מקבל את הנתונים שמאוחסנים ב-blob הזה.
getContentType()	String|null	מקבל את סוג התוכן של הבייטים ב-Blob הזה.
getDataAsString()	String	מחזירה את הנתונים של ה-blob הזה כמחרוזת עם קידוד UTF-8.
getDataAsString(charset)	String	הפונקציה מחזירה את הנתונים של ה-blob הזה כמחרוזת עם הקידוד שצוין.
getHash()	String	הפונקציה מחזירה את גיבוב התוכן SHA1 של הקובץ המצורף הזה.
getName()	String|null	הפונקציה מחזירה את השם של ה-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 הזה.

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

שיטה	סוג הערך שמוחזר	תיאור קצר
getAllBlobs()	Blob[]	מקבל את כל ה-blob שכלולים ב-blob הזה (יכול להיות שהוא מורכב).

תיעוד מפורט

copyBlob()

מחזירה עותק של ה-blob הזה.

חזרה

‫Blob — העותק החדש.

---

getAs(contentType)

החזרת הנתונים בתוך האובייקט הזה כ-Blob שהומר לסוג התוכן שצוין. בשיטה הזו, הסיומת המתאימה מתווספת לשם הקובץ – לדוגמה, 'myfile.pdf'. עם זאת, המערכת מניחה שהחלק של שם הקובץ שאחרי הנקודה האחרונה (אם יש כזו) הוא סיומת קיימת שצריך להחליף. לכן, השם ShoppingList.12.25.2014 הופך ל-ShoppingList.12.25.pdf.

כדי לראות את המכסות היומיות להמרות, אפשר לעיין במאמר בנושא מכסות לשירותי Google. יכול להיות שדומיינים חדשים ב-Google Workspace יהיו כפופים באופן זמני למכסות מחמירות יותר.

פרמטרים

שם	סוג	תיאור
contentType	String	סוג ה-MIME שאליו רוצים להמיר. ברוב ה-blob, ‏ '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 — סוג התוכן של הנתונים האלה, אם ידוע, או null.

---

getDataAsString()

מחזירה את הנתונים של ה-blob הזה כמחרוזת עם קידוד UTF-8.

חזרה

‫String — הנתונים כמחרוזת.

---

getDataAsString(charset)

הפונקציה מחזירה את הנתונים של ה-blob הזה כמחרוזת עם הקידוד שצוין.

פרמטרים

שם	סוג	תיאור
charset	String	ערכת התווים שבה יש להשתמש כדי לקודד את הנתונים ב-blob הזה כמחרוזת.

חזרה

‫String — הנתונים כמחרוזת.

---

getHash()

הפונקציה מחזירה את גיבוב התוכן SHA1 של הקובץ המצורף הזה. השיטה הזו לא נכללת במכסת הקריאה של Gmail.

חזרה

‫String — גיבוב התוכן מסוג SHA1, כמחרוזת.

אישור

סקריפטים שמשתמשים ב-method הזה צריכים הרשאה עם אחת או יותר מהיקפים הבאים או היקפים מתאימים מה-API בארכיטקטורת REST שקשור:

• https://mail.google.com/

---

getName()

הפונקציה מחזירה את השם של ה-blob הזה.

חזרה

‫String|null — השם של הנתונים האלה, אם ידוע, או null.

---

getSize()

הפונקציה מחזירה את הגודל של הקובץ המצורף. השיטה הזו מהירה יותר מהתקשרות אל getBytes().length והיא לא נספרת במכסת הקריאה של Gmail.

חזרה

‫Integer — גודל הקובץ המצורף בבייטים.

אישור

סקריפטים שמשתמשים ב-method הזה צריכים הרשאה עם אחת או יותר מהיקפים הבאים או היקפים מתאימים מה-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	סוג התוכן החדש.

חזרה

‫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	ה-charset שמשמש לפרש את המחרוזת כבייטים.

חזרה

‫Blob — ה-blob הזה, לשרשור.

---

setName(name)

מגדיר את השם של ה-blob הזה.

פרמטרים

שם	סוג	תיאור
name	String	השם החדש.

חזרה

‫Blob — ה-blob הזה, לשרשור.

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

getAllBlobs()

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

מקבל את כל ה-blob שכלולים ב-blob הזה (יכול להיות שהוא מורכב).

חזרה

‫Blob[] — ה-blobs שכלולים ב-blob.