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

Class GmailAttachment

پیوستی از جیمیل. این یک Blob معمولی است با این تفاوت که یک متد get Size() اضافی دارد که سریعتر از فراخوانی get Bytes() .length است و در سهمیه خواندن Gmail به حساب نمی آید.

// Logs information about any attachments in the first 100 inbox threads.
const threads = GmailApp.getInboxThreads(0, 100);
const msgs = GmailApp.getMessagesForThreads(threads);
for (let i = 0; i < msgs.length; i++) {
  for (let j = 0; j < msgs[i].length; j++) {
    const attachments = msgs[i][j].getAttachments();
    for (let 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(),
      );
    }
  }
}

روش ها

روش	نوع برگشت	شرح مختصر
`copy Blob()`	`Blob`	یک کپی از این لکه را برمی گرداند.
`get As(contentType)`	`Blob`	داده های داخل این شی را به عنوان یک حباب تبدیل به نوع محتوای مشخص شده برگردانید.
`get Bytes()`	`Byte[]`	داده های ذخیره شده در این لکه را دریافت می کند.
`get Content Type()`	`String`	نوع محتوای بایت های این لکه را دریافت می کند.
`get Data As String()`	`String`	داده های این حباب را به صورت رشته ای با رمزگذاری UTF-8 دریافت می کند.
`get Data As String(charset)`	`String`	داده های این لکه را به صورت رشته ای با رمزگذاری مشخص شده دریافت می کند.
`get Hash()`	`String`	هش محتوای SHA1 را برای این پیوست دریافت می کند.
`get Name()`	`String`	نام این لکه را می گیرد.
`get Size()`	`Integer`	اندازه این پیوست را دریافت می کند.
`is Google Type()`	`Boolean`	نشان می دهد که آیا این لکه یک فایل Google Workspace (کاربرگ، اسناد و غیره) است یا خیر.
`set Bytes(data)`	`Blob`	داده های ذخیره شده در این لکه را تنظیم می کند.
`set Content Type(contentType)`	`Blob`	نوع محتوای بایت های این لکه را تنظیم می کند.
`set Content Type From Extension()`	`Blob`	نوع محتوای بایت های این لکه را بر اساس پسوند فایل تنظیم می کند.
`set Data From String(string)`	`Blob`	داده های این حباب را از یک رشته با رمزگذاری UTF-8 تنظیم می کند.
`set Data From String(string, charset)`	`Blob`	داده های این حباب را از یک رشته با رمزگذاری مشخص شده تنظیم می کند.
`set Name(name)`	`Blob`	نام این لکه را تنظیم می کند.

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

روش	نوع برگشت	شرح مختصر
`get All Blobs()`	`Blob[]`	تمام حباب های موجود در این لکه (احتمالاً ترکیبی) را دریافت می کند.

مستندات دقیق

`copy Blob()`

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

بازگشت

Blob - نسخه جدید.

`get As(contentType)`

داده های داخل این شی را به عنوان یک حباب تبدیل به نوع محتوای مشخص شده برگردانید. این روش پسوند مناسب را به نام فایل اضافه می کند - به عنوان مثال، "myfile.pdf". با این حال، فرض می‌کند که بخشی از نام فایل که پس از آخرین نقطه (در صورت وجود) یک پسوند موجود است که باید جایگزین شود. در نتیجه، "ShoppingList.12.25.2014" به "ShoppingList.12.25.pdf" تبدیل می شود.

برای مشاهده سهمیه های روزانه برای تبدیل، به سهمیه خدمات Google مراجعه کنید. دامنه‌های جدید Google Workspace ممکن است به طور موقت مشمول سهمیه‌های سخت‌گیرانه‌تر شوند.

پارامترها

نام	تایپ کنید	توضیحات
`content Type`	`String`	نوع MIME برای تبدیل. برای اکثر حباب‌ها، `'application/pdf'` تنها گزینه معتبر است. برای تصاویر با فرمت BMP، GIF، JPEG یا PNG، هر یک از `'image/bmp'` ، `'image/gif'` ، `'image/jpeg'` یا `'image/png'` نیز معتبر هستند. برای سند Google Docs، `'text/markdown'` نیز معتبر است.

بازگشت

Blob - داده ها به عنوان یک لکه.

`get Bytes()`

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

بازگشت

Byte[] - بایت های ذخیره شده.

`get Content Type()`

نوع محتوای بایت های این لکه را دریافت می کند.

بازگشت

String - نوع محتوای این داده، در صورت شناخته شدن، یا null .

`get Data As String()`

داده های این حباب را به صورت رشته ای با رمزگذاری UTF-8 دریافت می کند.

بازگشت

String - داده به عنوان یک رشته.

`get Data As String(charset)`

داده های این لکه را به صورت رشته ای با رمزگذاری مشخص شده دریافت می کند.

پارامترها

نام	تایپ کنید	توضیحات
`charset`	`String`	مجموعه نویسه ای که در رمزگذاری داده های این لکه به عنوان یک رشته استفاده می شود.

بازگشت

String - داده به عنوان یک رشته.

`get Hash()`

هش محتوای SHA1 را برای این پیوست دریافت می کند. این روش در سهمیه خواندن Gmail به حساب نمی آید.

بازگشت

String - هش محتوای SHA1، به عنوان یک رشته.

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر یا محدوده های مناسب از REST API مربوطه دارند:

https://mail.google.com/

`get Name()`

نام این لکه را می گیرد.

بازگشت

String - نام این داده، در صورت شناخته شدن، یا null .

`get Size()`

اندازه این پیوست را دریافت می کند. این روش سریعتر از فراخوانی get Bytes() .length است و در سهمیه خواندن Gmail به حساب نمی آید.

بازگشت

Integer - اندازه پیوست، بر حسب بایت.

مجوز

https://mail.google.com/

`is Google Type()`

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

بازگشت

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

`set Bytes(data)`

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