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 یک کپی از این لکه را برمی گرداند.
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()

یک کپی از این لکه را برمی گرداند.

بازگشت

Blob - نسخه جدید.

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' نیز معتبر هستند. برای سند Google Docs، 'text/markdown' نیز معتبر است.

بازگشت

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 - این لکه، برای زنجیر زدن.

روش های منسوخ شده