پیوستی از جیمیل. این یک 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 | یک کپی از این لکه را برمی گرداند. |
getAs(contentType) | Blob | داده های داخل این شی را به عنوان یک حباب تبدیل به نوع محتوای مشخص شده برگردانید. |
getBytes() | Byte[] | داده های ذخیره شده در این لکه را دریافت می کند. |
getContentType() | String | نوع محتوای بایت های این لکه را دریافت می کند. |
getDataAsString() | String | داده های این حباب را به صورت رشته ای با رمزگذاری UTF-8 دریافت می کند. |
getDataAsString(charset) | String | داده های این لکه را به صورت رشته ای با رمزگذاری مشخص شده دریافت می کند. |
getHash() | String | هش محتوای SHA1 را برای این پیوست دریافت می کند. |
getName() | String | نام این لکه را می گیرد. |
getSize() | Integer | اندازه این پیوست را دریافت می کند. |
isGoogleType() | Boolean | نشان می دهد که آیا این لکه یک فایل Google Workspace (کاربرگ، اسناد و غیره) است یا خیر. |
setBytes(data) | Blob | داده های ذخیره شده در این لکه را تنظیم می کند. |
setContentType(contentType) | Blob | نوع محتوای بایت های این لکه را تنظیم می کند. |
setContentTypeFromExtension() | Blob | نوع محتوای بایت های این لکه را بر اساس پسوند فایل تنظیم می کند. |
setDataFromString(string) | Blob | داده های این حباب را از یک رشته با رمزگذاری UTF-8 تنظیم می کند. |
setDataFromString(string, charset) | Blob | داده های این حباب را از یک رشته با رمزگذاری مشخص شده تنظیم می کند. |
setName(name) | Blob | نام این لکه را تنظیم می کند. |
مستندات دقیق
copyBlob()
getAs(contentType)
داده های داخل این شی را به عنوان یک حباب تبدیل به نوع محتوای مشخص شده برگردانید. این روش پسوند مناسب را به نام فایل اضافه می کند - به عنوان مثال، "myfile.pdf". با این حال، فرض میکند که بخشی از نام فایل که پس از آخرین نقطه (در صورت وجود) یک پسوند موجود است که باید جایگزین شود. در نتیجه، "ShoppingList.12.25.2014" به "ShoppingList.12.25.pdf" تبدیل می شود.
برای مشاهده سهمیه های روزانه برای تبدیل، به سهمیه خدمات Google مراجعه کنید. دامنههای جدید Google Workspace ممکن است به طور موقت مشمول سهمیههای سختگیرانهتر شوند.
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
contentType | String | نوع MIME برای تبدیل. برای اکثر حبابها، 'application/pdf' تنها گزینه معتبر است. برای تصاویر با فرمت BMP، GIF، JPEG یا PNG، هر یک از 'image/bmp' ، 'image/gif' ، 'image/jpeg' یا 'image/png' نیز معتبر هستند. |
برگشت
Blob
- داده ها به عنوان یک لکه.
getBytes()
داده های ذخیره شده در این لکه را دریافت می کند.
برگشت
Byte[]
- بایت های ذخیره شده.
getContentType()
نوع محتوای بایت های این لکه را دریافت می کند.
برگشت
String
- نوع محتوای این داده، در صورت شناخته شدن، یا null
.
getDataAsString()
داده های این حباب را به صورت رشته ای با رمزگذاری UTF-8 دریافت می کند.
برگشت
String
- داده به عنوان یک رشته.
getDataAsString(charset)
داده های این لکه را به صورت رشته ای با رمزگذاری مشخص شده دریافت می کند.
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
charset | String | مجموعه نویسه ای که در رمزگذاری داده های این لکه به عنوان یک رشته استفاده می شود. |
برگشت
String
- داده به عنوان یک رشته.
getHash()
هش محتوای SHA1 را برای این پیوست دریافت می کند. این روش در سهمیه خواندن Gmail به حساب نمی آید.
برگشت
String
- هش محتوای SHA1، به عنوان یک رشته.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر یا محدوده های مناسب از REST API مربوطه دارند:
-
https://mail.google.com/
getName()
نام این لکه را می گیرد.
برگشت
String
- نام این داده، در صورت شناخته شدن، یا null
.
getSize()
اندازه این پیوست را دریافت می کند. این روش سریعتر از فراخوانی getBytes()
.length
است و در سهمیه خواندن Gmail به حساب نمی آید.
برگشت
Integer
- اندازه پیوست، بر حسب بایت.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر یا محدوده های مناسب از REST API مربوطه دارند:
-
https://mail.google.com/
isGoogleType()
نشان می دهد که آیا این لکه یک فایل Google Workspace (کاربرگ، اسناد و غیره) است یا خیر.
برگشت
Boolean
- اگر این لکه یک فایل Google Workspace باشد true
. false
اگر نه
setBytes(data)
داده های ذخیره شده در این لکه را تنظیم می کند.
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
data | Byte[] | داده های جدید |
برگشت
Blob
- این لکه، برای زنجیر کردن.
setContentType(contentType)
نوع محتوای بایت های این لکه را تنظیم می کند.
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
contentType | String | نوع محتوای جدید. |
برگشت
Blob
- این لکه، برای زنجیر کردن.
setContentTypeFromExtension()
نوع محتوای بایت های این لکه را بر اساس پسوند فایل تنظیم می کند. ContentType اگر نتوان از پسوند آن حدس زد null
است.
برگشت
Blob
- این لکه، برای زنجیر کردن.
setDataFromString(string)
داده های این حباب را از یک رشته با رمزگذاری UTF-8 تنظیم می کند.
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
string | String | داده های رشته ای |
برگشت
Blob
- این لکه، برای زنجیر کردن.
setDataFromString(string, charset)
داده های این حباب را از یک رشته با رمزگذاری مشخص شده تنظیم می کند.
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
string | String | داده های رشته ای |
charset | String | مجموعه نویسه ای که در تفسیر رشته به عنوان بایت استفاده می شود. |
برگشت
Blob
- این لکه، برای زنجیر کردن.
setName(name)
نام این لکه را تنظیم می کند.
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
name | String | نام جدید. |
برگشت
Blob
- این لکه، برای زنجیر کردن.