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

Class Blob

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

روش‌ها

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

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

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

مستندات دقیق

`copy Blob()`

یک کپی از این blob را برمی‌گرداند.

بازگشت

Blob - نسخه جدید.

`get As(contentType)`

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

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

پارامترها

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

بازگشت

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

`get Bytes()`

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

بازگشت

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

`get Content Type()`

نوع محتوای بایت‌های موجود در این blob را دریافت می‌کند.

بازگشت

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

`get Data As String()`

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

بازگشت

String - داده‌ها به صورت رشته.

`get Data As String(charset)`

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

پارامترها

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

بازگشت

String - داده‌ها به صورت رشته.

`get Name()`

نام این لکه را دریافت می‌کند.

بازگشت

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

`is Google Type()`

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

بازگشت

Boolean - اگر این قطعه یک فایل Google Workspace باشد، true و در غیر این صورت false .

`set Bytes(data)`

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