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

Class Blob

یک شی تبادل داده برای سرویس های Apps Script.

روش ها

روش	نوع برگشت	شرح مختصر
`copyBlob()`	`Blob`	یک کپی از این لکه را برمی گرداند.
`getAs(contentType)`	`Blob`	داده های داخل این شی را به عنوان یک حباب تبدیل به نوع محتوای مشخص شده برگردانید.
`getBytes()`	`Byte[]`	داده های ذخیره شده در این لکه را دریافت می کند.
`getContentType()`	`String`	نوع محتوای بایت های این لکه را دریافت می کند.
`getDataAsString()`	`String`	داده های این حباب را به صورت رشته ای با رمزگذاری UTF-8 دریافت می کند.
`getDataAsString(charset)`	`String`	داده های این لکه را به صورت رشته ای با رمزگذاری مشخص شده دریافت می کند.
`getName()`	`String`	نام این لکه را می گیرد.
`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'` نیز معتبر هستند. برای سند Google Docs، `'text/markdown'` نیز معتبر است.

بازگشت

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

`getBytes()`

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

بازگشت

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

`getContentType()`

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

بازگشت

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

`getDataAsString()`

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

بازگشت

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

`getDataAsString(charset)`

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

پارامترها

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

بازگشت

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

`getName()`

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

بازگشت

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

`isGoogleType()`

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

بازگشت

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

`setBytes(data)`

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