این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

Class GmailAttachment

پیوستی از جیمیل. این یک 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`	نام این لکه را تنظیم می کند.

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

روش	نوع برگشت	توضیح مختصر
`getAllBlobs()`	`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'` نیز معتبر هستند.

برگشت

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 - اندازه پیوست، بر حسب بایت.

مجوز

https://mail.google.com/

`isGoogleType()`

نشان می دهد که آیا این لکه یک فایل Google Workspace (کاربرگ، اسناد و غیره) است یا خیر.

برگشت

Boolean - اگر این لکه یک فایل Google Workspace باشد true . false اگر نه

`setBytes(data)`

داده های ذخیره شده در این لکه را تنظیم می کند.