Class GmailAttachment

GmailAttachment

קובץ מצורף מ-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()

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

חזרה

Blob – העותק החדש.


getAs(contentType)

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

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

פרמטרים

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

פרמטרים

שםסוגתיאור
charsetStringערכת התווים שבה יש להשתמש לקידוד הנתונים ב-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 וכו').

חזרה

Booleantrue אם ה-blob הזה הוא קובץ של Google Workspace; false אם לא.


setBytes(data)

הגדרת הנתונים שמאוחסנים ב-blob הזה.

פרמטרים

שםסוגתיאור
dataByte[]הנתונים החדשים

חזרה

Blob – ה-blob הזה, לשרשור.


setContentType(contentType)

מגדיר את סוג התוכן של הבייטים ב-blob הזה.

פרמטרים

שםסוגתיאור
contentTypeStringהשדה contentType החדש.

חזרה

Blob – ה-blob הזה, לשרשור.


setContentTypeFromExtension()

מגדיר את סוג התוכן של הבייטים ב-blob הזה על סמך סיומת הקובץ. סוג התוכן הוא null אם אי אפשר לנחש אותו מהתוסף שלו.

חזרה

Blob – ה-blob הזה, לשרשור.


setDataFromString(string)

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

פרמטרים

שםסוגתיאור
stringStringנתוני המחרוזת.

חזרה

Blob – ה-blob הזה, לשרשור.


setDataFromString(string, charset)

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

פרמטרים

שםסוגתיאור
stringStringנתוני המחרוזת.
charsetStringערכת התווים שבה יש להשתמש בפירוש המחרוזת כבייטים.

חזרה

Blob – ה-blob הזה, לשרשור.


setName(name)

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

פרמטרים

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

חזרה

Blob – ה-blob הזה, לשרשור.

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