Class Blob

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 ("جداول بيانات Google" أو "مستندات Google" أو غير ذلك).
setBytes(data)Blobتُستخدَم لضبط البيانات المخزّنة في هذه الكتلة.
setContentType(contentType)Blobلضبط نوع محتوى البايتات في ملف تخزين البيانات الثنائية الكبير هذا.
setContentTypeFromExtension()Blobلضبط نوع محتوى البايتات في هذه الكتلة، استنادًا إلى امتداد الملف
setDataFromString(string)Blobتُستخدَم لضبط بيانات هذا العنصر من سلسلة بترميز UTF-8.
setDataFromString(string, charset)Blobتُستخدَم هذه الدالة لضبط بيانات هذا العنصر من سلسلة باستخدام ترميز محدّد.
setName(name)Blobتُستخدَم لضبط اسم هذا المربّع.

مستندات تفصيلية

copyBlob()

عرض نسخة من هذا العنصر

الإرجاع

Blob: النسخة الجديدة


getAs(contentType)

عرض البيانات داخل هذا العنصر كبيانات ثنائية كبيرة تم تحويلها إلى نوع المحتوى المحدّد تُضيف هذه الطريقة امتداد اسم الملف المناسب، على سبيل المثال "myfile.pdf". ومع ذلك، فإنه يفترض أنّ جزء اسم الملف الذي يلي النقطة الأخيرة (إن وُجد) هو امتداد حالي يجب استبداله. ونتيجةً لذلك، يصبح ملف ShoppingList.12.25.2014 هو ShoppingList.12.25.pdf.

للاطّلاع على الحصص اليومية للإحالات الناجحة، يُرجى الاطّلاع على الحصص لخدمات Google. قد تخضع نطاقات Google Workspace التي تم إنشاؤها حديثًا مؤقتًا لحدود برمجية أكثر صرامة.

المعلَمات

الاسمالنوعالوصف
contentTypeStringنوع 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)

تحصل على بيانات هذا المربّع المصغّر كسلسلة باستخدام ترميز محدّد.

المعلَمات

الاسمالنوعالوصف
charsetStringترميز الأحرف المراد استخدامه في ترميز البيانات في هذا العنصر المصغّر كسلسلة.

الإرجاع

String: البيانات كسلسلة.


getName()

تحصل على اسم هذا المربّع.

الإرجاع

String: اسم هذه البيانات، إذا كان معروفًا، أو null


isGoogleType()

تُعرِض ما إذا كان هذا المخطّط البياني ملفًا على Google Workspace ("جداول بيانات Google" أو "مستندات Google" أو غير ذلك).

الإرجاع

Boolean: true إذا كان هذا المخطّط البياني ملفًا على Google Workspace، false إذا لم يكن كذلك


setBytes(data)

تُستخدَم لضبط البيانات المخزّنة في هذه الكتلة.

المعلَمات

الاسمالنوعالوصف
dataByte[]البيانات الجديدة.

الإرجاع

Blob — هذا الجزء المُجمَّع، لإنشاء سلسلة.


setContentType(contentType)

لضبط نوع محتوى البايتات في ملف تخزين البيانات الثنائية الكبير هذا.

المعلَمات

الاسمالنوعالوصف
contentTypeStringنوع المحتوى الجديد.

الإرجاع

Blob — هذا الجزء المُجمَّع، لإنشاء سلسلة.


setContentTypeFromExtension()

لضبط نوع محتوى البايتات في هذه الكتلة، استنادًا إلى امتداد الملف يكون contentType هو null إذا تعذّر تخمينه من امتداده.

الإرجاع

Blob — هذا الجزء المُجمَّع، لإنشاء سلسلة.


setDataFromString(string)

تُستخدَم لضبط بيانات هذا العنصر من سلسلة بترميز UTF-8.

المعلَمات

الاسمالنوعالوصف
stringStringبيانات السلسلة

الإرجاع

Blob — هذا الجزء المُجمَّع، لإنشاء سلسلة.


setDataFromString(string, charset)

تُستخدَم هذه الدالة لضبط بيانات هذا العنصر من سلسلة باستخدام ترميز محدّد.

المعلَمات

الاسمالنوعالوصف
stringStringبيانات السلسلة
charsetStringترميز الأحرف المراد استخدامه في تفسير السلسلة على أنّها بايت

الإرجاع

Blob — هذا الجزء المُجمَّع، لإنشاء سلسلة.


setName(name)

تُستخدَم لضبط اسم هذا المربّع.

المعلَمات

الاسمالنوعالوصف
nameStringالاسم الجديد

الإرجاع

Blob — هذا الجزء المُجمَّع، لإنشاء سلسلة.

الطرق المتوقّفة