Class Blob

Blob

كائن لتبادل البيانات بين خدمات "برمجة تطبيقات Google".

الطُرق

الطريقةنوع القيمة التي تم إرجاعهاوصف قصير
copyBlob()Blobتعرض هذه الدالة نسخة من كائن البيانات الثنائية الكبير.
getAs(contentType)Blobلعرض البيانات داخل هذا العنصر ككائن ثنائي كبير تم تحويله إلى نوع المحتوى المحدّد
getBytes()Byte[]تعرض هذه الطريقة البيانات المخزّنة في هذا الكائن الثنائي الكبير.
getContentType()String|nullتعرض هذه السمة نوع المحتوى الخاص بالبايت في كائن التخزين الثنائي الكبير هذا.
getDataAsString()Stringتعرض هذه الطريقة بيانات الكائن الثنائي الكبير (blob) كسلسلة بترميز UTF-8.
getDataAsString(charset)Stringتعرض بيانات هذا الكائن الثنائي الكبير كسلسلة باستخدام الترميز المحدّد.
getName()String|nullتعرض هذه السمة اسم الكائن الثنائي الكبير.
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: نوع محتوى هذه البيانات، إذا كان معروفًا، أو null


getDataAsString()

تعرض هذه الطريقة بيانات الكائن الثنائي الكبير (blob) كسلسلة بترميز UTF-8.

الإرجاع

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


getDataAsString(charset)

تعرض بيانات هذا الكائن الثنائي الكبير كسلسلة باستخدام الترميز المحدّد.

المعلمات

الاسمالنوعالوصف
charsetStringترميز الأحرف الذي سيتم استخدامه في ترميز البيانات في هذا الملف الثنائي الكبير (BLOB) كسلسلة.

الإرجاع

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


getName()

تعرض هذه السمة اسم الكائن الثنائي الكبير.

الإرجاع

String|null: اسم هذه البيانات، إذا كان معروفًا، أو 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: هذه هي مساحة التخزين، ويتم استخدامها في التسلسل.

الطُرق المتوقّفة نهائيًا