عنصر تبادل البيانات لخدمات Apps Script
الطُرق
الطريقة | نوع القيمة التي يتم عرضها | وصف قصير |
---|---|---|
copy | Blob | عرض نسخة من هذا العنصر |
get | Blob | عرض البيانات داخل هذا العنصر كبيانات ثنائية كبيرة تم تحويلها إلى نوع المحتوى المحدّد |
get | Byte[] | تحصل على البيانات المخزّنة في هذا المربّع. |
get | String | تحصل على نوع محتوى البايتات في ملف تخزين البيانات الثنائية الكبير هذا. |
get | String | تحصل على بيانات هذا العنصر المصغّر كسلسلة بترميز UTF-8. |
get | String | تحصل على بيانات هذا المربّع المصغّر كسلسلة باستخدام ترميز محدّد. |
get | String | تحصل على اسم هذا المربّع. |
is | Boolean | تُعرِض ما إذا كان هذا المخطّط البياني ملفًا على Google Workspace ("جداول بيانات Google" أو "مستندات Google" أو غير ذلك). |
set | Blob | تُستخدَم لضبط البيانات المخزّنة في هذه الكتلة. |
set | Blob | لضبط نوع محتوى البايتات في ملف تخزين البيانات الثنائية الكبير هذا. |
set | Blob | لضبط نوع محتوى البايتات في هذه الكتلة، استنادًا إلى امتداد الملف |
set | Blob | تُستخدَم لضبط بيانات هذا العنصر من سلسلة بترميز UTF-8. |
set | Blob | تُستخدَم هذه الدالة لضبط بيانات هذا العنصر من سلسلة باستخدام ترميز محدّد. |
set | Blob | تُستخدَم لضبط اسم هذا المربّع. |
مستندات تفصيلية
copy Blob()
get As(contentType)
عرض البيانات داخل هذا العنصر كبيانات ثنائية كبيرة تم تحويلها إلى نوع المحتوى المحدّد تُضيف هذه الطريقة امتداد اسم الملف المناسب، على سبيل المثال "myfile.pdf". ومع ذلك، فإنه يفترض أنّ جزء اسم الملف الذي يلي النقطة الأخيرة (إن وُجد) هو امتداد حالي يجب استبداله. ونتيجةً لذلك، يصبح ملف ShoppingList.12.25.2014 هو ShoppingList.12.25.pdf.
للاطّلاع على الحصص اليومية للإحالات الناجحة، يُرجى الاطّلاع على الحصص لخدمات Google. قد تخضع نطاقات Google Workspace التي تم إنشاؤها حديثًا مؤقتًا لحدود برمجية أكثر صرامة.
المعلَمات
الاسم | النوع | الوصف |
---|---|---|
content | String | نوع MIME المطلوب التحويل إليه بالنسبة إلى معظم العناصر المصغّرة، يكون 'application/pdf' هو
الخيار الوحيد الصالح. بالنسبة إلى الصور بتنسيق BMP أو GIF أو JPEG أو PNG، يمكن استخدام أي من 'image/bmp' أو 'image/gif' أو 'image/jpeg' أو 'image/png'
أيضًا. بالنسبة إلى مستند "مستندات Google"، يكون 'text/markdown' صالحًا أيضًا. |
الإرجاع
Blob
: البيانات بتنسيق ملف نصي
get Bytes()
تحصل على البيانات المخزّنة في هذا المربّع.
الإرجاع
Byte[]
: عدد البايتات المخزّنة
get Content Type()
تحصل على نوع محتوى البايتات في ملف تخزين البيانات الثنائية الكبير هذا.
الإرجاع
String
: نوع محتوى هذه البيانات، إذا كان معروفًا، أو null
get Data As String()
تحصل على بيانات هذا العنصر المصغّر كسلسلة بترميز UTF-8.
الإرجاع
String
: البيانات كسلسلة.
get Data As String(charset)
تحصل على بيانات هذا المربّع المصغّر كسلسلة باستخدام ترميز محدّد.
المعلَمات
الاسم | النوع | الوصف |
---|---|---|
charset | String | ترميز الأحرف المراد استخدامه في ترميز البيانات في هذا العنصر المصغّر كسلسلة. |
الإرجاع
String
: البيانات كسلسلة.
get Name()
تحصل على اسم هذا المربّع.
الإرجاع
String
: اسم هذه البيانات، إذا كان معروفًا، أو null
is Google Type()
تُعرِض ما إذا كان هذا المخطّط البياني ملفًا على Google Workspace ("جداول بيانات Google" أو "مستندات Google" أو غير ذلك).
الإرجاع
Boolean
: true
إذا كان هذا المخطّط البياني ملفًا على Google Workspace، false
إذا لم يكن كذلك
set Bytes(data)
تُستخدَم لضبط البيانات المخزّنة في هذه الكتلة.
المعلَمات
الاسم | النوع | الوصف |
---|---|---|
data | Byte[] | البيانات الجديدة. |
الإرجاع
Blob
— هذا الجزء المُجمَّع، لإنشاء سلسلة.
set Content Type(contentType)
لضبط نوع محتوى البايتات في ملف تخزين البيانات الثنائية الكبير هذا.
المعلَمات
الاسم | النوع | الوصف |
---|---|---|
content | String | نوع المحتوى الجديد. |
الإرجاع
Blob
— هذا الجزء المُجمَّع، لإنشاء سلسلة.
set Content Type From Extension()
لضبط نوع محتوى البايتات في هذه الكتلة، استنادًا إلى امتداد الملف يكون contentType هو
null
إذا تعذّر تخمينه من امتداده.
الإرجاع
Blob
— هذا الجزء المُجمَّع، لإنشاء سلسلة.
set Data From String(string)
تُستخدَم لضبط بيانات هذا العنصر من سلسلة بترميز UTF-8.
المعلَمات
الاسم | النوع | الوصف |
---|---|---|
string | String | بيانات السلسلة |
الإرجاع
Blob
— هذا الجزء المُجمَّع، لإنشاء سلسلة.
set Data From String(string, charset)
تُستخدَم هذه الدالة لضبط بيانات هذا العنصر من سلسلة باستخدام ترميز محدّد.
المعلَمات
الاسم | النوع | الوصف |
---|---|---|
string | String | بيانات السلسلة |
charset | String | ترميز الأحرف المراد استخدامه في تفسير السلسلة على أنّها بايت |
الإرجاع
Blob
— هذا الجزء المُجمَّع، لإنشاء سلسلة.
set Name(name)
تُستخدَم لضبط اسم هذا المربّع.
المعلَمات
الاسم | النوع | الوصف |
---|---|---|
name | String | الاسم الجديد |
الإرجاع
Blob
— هذا الجزء المُجمَّع، لإنشاء سلسلة.