דף זה תורגם על ידי Cloud Translation API.

Class 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 הזה.

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

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

מסמכי תיעוד מפורטים

`copyBlob()`

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

חזרה

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

`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 – הגודל בבייטים של הקובץ המצורף.

אישור

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 הזה, לשרשור.

`setName(name)`

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

פרמטרים

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

חזרה

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

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

`getAllBlobs()`

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

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

חזרה

Blob[] – ה-blobs בתוך ה-blob.