مرفق من Gmail هذا Blob
عادي باستثناء أنّه يحتوي على طريقة get
إضافية أسرع من استدعاء
get
.length
ولا يتم احتسابه ضمن حصة القراءة في Gmail.
// Logs information about any attachments in the first 100 inbox threads. const threads = GmailApp.getInboxThreads(0, 100); const msgs = GmailApp.getMessagesForThreads(threads); for (let i = 0; i < msgs.length; i++) { for (let j = 0; j < msgs[i].length; j++) { const attachments = msgs[i][j].getAttachments(); for (let k = 0; k < attachments.length; k++) { Logger.log( 'Message "%s" contains the attachment "%s" (%s bytes)', msgs[i][j].getSubject(), attachments[k].getName(), attachments[k].getSize(), ); } } }
الطُرق
الطريقة | نوع القيمة التي يتم عرضها | وصف قصير |
---|---|---|
copy | Blob | عرض نسخة من هذا العنصر |
get | Blob | عرض البيانات داخل هذا العنصر كبيانات ثنائية كبيرة تم تحويلها إلى نوع المحتوى المحدّد |
get | Byte[] | تحصل على البيانات المخزّنة في هذا المربّع. |
get | String | تحصل على نوع محتوى البايتات في ملف تخزين البيانات الثنائية الكبير هذا. |
get | String | تحصل على بيانات هذا المربّع المصغّر كسلسلة بترميز UTF-8. |
get | String | تحصل على بيانات هذا المربّع المصغّر كسلسلة باستخدام ترميز محدّد. |
get | String | تحصل على تجزئة محتوى SHA1 لهذا المرفق. |
get | String | تحصل على اسم هذا المربّع. |
get | Integer | تحصل على حجم هذا المرفق. |
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 Hash()
تحصل على تجزئة محتوى SHA1 لهذا المرفق. ولا يتم احتساب هذه الطريقة ضمن حصة Gmail للقراءة.
الإرجاع
String
: تجزئة المحتوى باستخدام SHA1، بالتنسيق السلسلي
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://mail.google.com/
get Name()
تحصل على اسم هذا المربّع.
الإرجاع
String
: اسم هذه البيانات، إذا كان معروفًا، أو null
get Size()
تحصل على حجم هذا المرفق. هذه الطريقة أسرع من الاتصال برقم get
.length
ولا يتم احتسابها ضمن حصة القراءة في Gmail.
الإرجاع
Integer
: حجم المرفق، بالبايت
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://mail.google.com/
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
— هذا الجزء المُجمَّع، لإنشاء سلسلة.