Class Blob

Blob

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

الطُرق

الطريقة	نوع القيمة التي تم إرجاعها	وصف قصير
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	تضبط هذه السمة اسم الكائن الثنائي الكبير.

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

الطريقة	نوع القيمة التي تم إرجاعها	وصف قصير
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: نوع محتوى هذه البيانات، إذا كان معروفًا، أو null

---

getDataAsString()

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

الإرجاع

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

---

getDataAsString(charset)

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

المعلمات

الاسم	النوع	الوصف
charset	String	ترميز الأحرف الذي سيتم استخدامه في ترميز البيانات في هذا الكائن الثنائي الكبير كقيمة سلسلة

الإرجاع

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

---

getName()

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

الإرجاع

String|null — اسم هذه البيانات، إذا كان معروفًا، أو 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[]: الكائنات الثنائية الكبيرة المتغيرة الحجم التي يتضمّنها الكائن الثنائي الكبير المتغير الحجم