این صفحه به‌وسیله ‏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'` نیز معتبر هستند.

برگشت

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)`

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