Class Blob
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
Blob
عنصر تبادل البيانات لخدمات Apps Script
الطرق المتوقّفة
| الطريقة | نوع القيمة التي يتم عرضها | وصف قصير |
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"، يكون 'text/markdown' صالحًا أيضًا. |
الإرجاع
Blob: البيانات بتنسيق ملف نصي
getBytes()
تحصل على البيانات المخزّنة في هذا المربّع.
الإرجاع
Byte[]: عدد البايتات المخزّنة
getContentType()
تحصل على نوع محتوى البايتات في ملف تخزين البيانات الثنائية الكبير هذا.
الإرجاع
String: نوع محتوى هذه البيانات، إذا كان معروفًا، أو null
getDataAsString()
تحصل على بيانات هذا العنصر المصغّر كسلسلة بترميز UTF-8.
الإرجاع
String: البيانات كسلسلة.
getDataAsString(charset)
تحصل على بيانات هذا المربّع المصغّر كسلسلة باستخدام ترميز محدّد.
المعلَمات
| الاسم | النوع | الوصف |
charset | String | ترميز الأحرف المراد استخدامه في ترميز البيانات في هذا العنصر المصغّر كسلسلة. |
الإرجاع
String: البيانات كسلسلة.
getName()
تحصل على اسم هذا المربّع.
الإرجاع
String: اسم هذه البيانات، إذا كان معروفًا، أو null
isGoogleType()
تُعرِض ما إذا كان هذا المخطّط البياني ملفًا على Google Workspace ("جداول بيانات Google" أو "مستندات Google" أو غير ذلك).
الإرجاع
Boolean: true إذا كان هذا المخطّط البياني ملفًا على Google Workspace، false إذا لم يكن كذلك
setBytes(data)
تُستخدَم لضبط البيانات المخزّنة في هذه الكتلة.
المعلَمات
| الاسم | النوع | الوصف |
data | Byte[] | البيانات الجديدة. |
الإرجاع
Blob — هذا الجزء المُجمَّع، لإنشاء سلسلة.
setContentType(contentType)
لضبط نوع محتوى البايتات في ملف تخزين البيانات الثنائية الكبير هذا.
المعلَمات
| الاسم | النوع | الوصف |
contentType | String | نوع المحتوى الجديد. |
الإرجاع
Blob — هذا الجزء المُجمَّع، لإنشاء سلسلة.
setContentTypeFromExtension()
لضبط نوع محتوى البايتات في هذه الكتلة، استنادًا إلى امتداد الملف يكون contentType هو
null إذا تعذّر تخمينه من امتداده.
الإرجاع
Blob — هذا الجزء المُجمَّع، لإنشاء سلسلة.
setDataFromString(string)
تُستخدَم لضبط بيانات هذا العنصر من سلسلة بترميز UTF-8.
المعلَمات
| الاسم | النوع | الوصف |
string | String | بيانات السلسلة |
الإرجاع
Blob — هذا الجزء المُجمَّع، لإنشاء سلسلة.
setDataFromString(string, charset)
تُستخدَم هذه الدالة لضبط بيانات هذا العنصر من سلسلة باستخدام ترميز محدّد.
المعلَمات
| الاسم | النوع | الوصف |
string | String | بيانات السلسلة |
charset | String | ترميز الأحرف المراد استخدامه في تفسير السلسلة على أنّها بايت |
الإرجاع
Blob — هذا الجزء المُجمَّع، لإنشاء سلسلة.
setName(name)
تُستخدَم لضبط اسم هذا المربّع.
المعلَمات
| الاسم | النوع | الوصف |
name | String | الاسم الجديد |
الإرجاع
Blob — هذا الجزء المُجمَّع، لإنشاء سلسلة.
الطرق المتوقّفة
getAllBlobs()
تمّ إيقاف هذا العمود نهائيًا. هذه الدالة متوقّفة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
تحصل على جميع العناصر المصغّرة التي تتضمّنها هذه العنصر المصغّرة (التي قد تكون مركبة).
الإرجاع
Blob[]: العناصر المصغّرة المضمّنة في العنصر المصغّر
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eA Blob is a data interchange object used for storing and manipulating binary data within Apps Script services.\u003c/p\u003e\n"],["\u003cp\u003eBlobs provide methods for setting, getting, and converting data in various formats, including bytes, strings, and specific content types.\u003c/p\u003e\n"],["\u003cp\u003eIt allows manipulation of data content, type, and name using dedicated methods.\u003c/p\u003e\n"],["\u003cp\u003eBlobs can handle Google Workspace files and offer functionalities for managing them within Apps Script.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003egetAllBlobs()\u003c/code\u003e method is deprecated and should not be used in new scripts.\u003c/p\u003e\n"]]],[],null,["# Class Blob\n\nBlob\n\nA data interchange object for Apps Script services. \n\n### Methods\n\n| Method | Return type | Brief description |\n|-------------------------------------------------------------------------|-------------|---------------------------------------------------------------------------------------|\n| [copyBlob()](#copyBlob()) | [Blob](#) | Returns a copy of this blob. |\n| [getAs(contentType)](#getAs(String)) | [Blob](#) | Return the data inside this object as a blob converted to the specified content type. |\n| [getBytes()](#getBytes()) | `Byte[]` | Gets the data stored in this blob. |\n| [getContentType()](#getContentType()) | `String` | Gets the content type of the bytes in this blob. |\n| [getDataAsString()](#getDataAsString()) | `String` | Gets the data of this blob as a String with UTF-8 encoding. |\n| [getDataAsString(charset)](#getDataAsString(String)) | `String` | Gets the data of this blob as a string with the specified encoding. |\n| [getName()](#getName()) | `String` | Gets the name of this blob. |\n| [isGoogleType()](#isGoogleType()) | `Boolean` | Returns whether this blob is a Google Workspace file (Sheets, Docs, etc.). |\n| [setBytes(data)](#setBytes(Byte)) | [Blob](#) | Sets the data stored in this blob. |\n| [setContentType(contentType)](#setContentType(String)) | [Blob](#) | Sets the content type of the bytes in this blob. |\n| [setContentTypeFromExtension()](#setContentTypeFromExtension()) | [Blob](#) | Sets the content type of the bytes in this blob based on the file extension. |\n| [setDataFromString(string)](#setDataFromString(String)) | [Blob](#) | Sets the data of this blob from a string with UTF-8 encoding. |\n| [setDataFromString(string, charset)](#setDataFromString(String,String)) | [Blob](#) | Sets the data of this blob from a string with the specified encoding. |\n| [setName(name)](#setName(String)) | [Blob](#) | Sets the name of this blob. |\n\n### Deprecated methods\n\n| Method | Return type | Brief description |\n|---------------------------------|-------------|------------------------------------------------------------------------------|\n| [getAllBlobs()](#getAllBlobs()) | [Blob[]](#) | Gets all the blobs that are contained within this (possibly composite) blob. |\n\nDetailed documentation\n----------------------\n\n### `copy``Blob()`\n\nReturns a copy of this blob.\n\n#### Return\n\n\n[Blob](#) --- The new copy.\n\n*** ** * ** ***\n\n### `get``As(contentType)`\n\nReturn the data inside this object as a blob converted to the specified content type. This\nmethod adds the appropriate extension to the filename---for example, \"myfile.pdf\". However, it\nassumes that the part of the filename that follows the last period (if any) is an existing\nextension that should be replaced. Consequently, \"ShoppingList.12.25.2014\" becomes\n\"ShoppingList.12.25.pdf\".\n\nTo view the daily quotas for conversions, see [Quotas for Google\nServices](https://developers.google.com/apps-script/guides/services/quotas). Newly created Google Workspace domains might be temporarily subject to stricter\nquotas.\n\n#### Parameters\n\n| Name | Type | Description |\n|-----------------|----------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `content``Type` | `String` | The MIME type to convert to. For most blobs, `'application/pdf'` is the only valid option. For images in BMP, GIF, JPEG, or PNG format, any of `'image/bmp'`, `'image/gif'`, `'image/jpeg'`, or `'image/png'` are also valid. For a Google Docs document, `'text/markdown'` is also valid. |\n\n#### Return\n\n\n[Blob](#) --- The data as a blob.\n\n*** ** * ** ***\n\n### `get``Bytes()`\n\nGets the data stored in this blob.\n\n#### Return\n\n\n`Byte[]` --- The stored bytes.\n\n*** ** * ** ***\n\n### `get``Content``Type()`\n\nGets the content type of the bytes in this blob.\n\n#### Return\n\n\n`String` --- The content type of this data, if known, or `null`.\n\n*** ** * ** ***\n\n### `get``Data``As``String()`\n\nGets the data of this blob as a String with UTF-8 encoding.\n\n#### Return\n\n\n`String` --- The data as a string.\n\n*** ** * ** ***\n\n### `get``Data``As``String(charset)`\n\nGets the data of this blob as a string with the specified encoding.\n\n#### Parameters\n\n| Name | Type | Description |\n|-----------|----------|-------------------------------------------------------------------|\n| `charset` | `String` | The charset to use in encoding the data in this blob as a string. |\n\n#### Return\n\n\n`String` --- The data as a string.\n\n*** ** * ** ***\n\n### `get``Name()`\n\nGets the name of this blob.\n\n#### Return\n\n\n`String` --- The name of this data, if known, or `null`.\n\n*** ** * ** ***\n\n### `is``Google``Type()`\n\nReturns whether this blob is a Google Workspace file (Sheets, Docs, etc.).\n\n#### Return\n\n\n`Boolean` --- `true` if this blob is a Google Workspace file; `false` if not.\n\n*** ** * ** ***\n\n### `set``Bytes(data)`\n\nSets the data stored in this blob.\n\n#### Parameters\n\n| Name | Type | Description |\n|--------|----------|---------------|\n| `data` | `Byte[]` | The new data. |\n\n#### Return\n\n\n[Blob](#) --- This blob, for chaining.\n\n*** ** * ** ***\n\n### `set``Content``Type(contentType)`\n\nSets the content type of the bytes in this blob.\n\n#### Parameters\n\n| Name | Type | Description |\n|-----------------|----------|----------------------|\n| `content``Type` | `String` | The new contentType. |\n\n#### Return\n\n\n[Blob](#) --- This blob, for chaining.\n\n*** ** * ** ***\n\n### `set``Content``Type``From``Extension()`\n\nSets the content type of the bytes in this blob based on the file extension. The contentType is\n`null` if it cannot be guessed from its extension.\n\n#### Return\n\n\n[Blob](#) --- This blob, for chaining.\n\n*** ** * ** ***\n\n### `set``Data``From``String(string)`\n\nSets the data of this blob from a string with UTF-8 encoding.\n\n#### Parameters\n\n| Name | Type | Description |\n|----------|----------|------------------|\n| `string` | `String` | The string data. |\n\n#### Return\n\n\n[Blob](#) --- This blob, for chaining.\n\n*** ** * ** ***\n\n### `set``Data``From``String(string, charset)`\n\nSets the data of this blob from a string with the specified encoding.\n\n#### Parameters\n\n| Name | Type | Description |\n|-----------|----------|---------------------------------------------------------|\n| `string` | `String` | The string data. |\n| `charset` | `String` | The charset to use in interpreting the string as bytes. |\n\n#### Return\n\n\n[Blob](#) --- This blob, for chaining.\n\n*** ** * ** ***\n\n### `set``Name(name)`\n\nSets the name of this blob.\n\n#### Parameters\n\n| Name | Type | Description |\n|--------|----------|---------------|\n| `name` | `String` | The new name. |\n\n#### Return\n\n\n[Blob](#) --- This blob, for chaining.\n\nDeprecated methods\n------------------\n\n### `get``All``Blobs()`\n\n\n**Deprecated.** This function is deprecated and should not be used in new scripts.\n\nGets all the blobs that are contained within this (possibly composite) blob.\n\n#### Return\n\n\n[Blob[]](#) --- The blobs contained within the blob."]]
