تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

Class GmailAttachment

مرفق من Gmail هذا Blob عادي باستثناء أنّه يحتوي على طريقة getSize() إضافية أسرع من استدعاء getBytes().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(),
      );
    }
  }
}

الطُرق

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

`getDataAsString()`

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

الإرجاع

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

`getDataAsString(charset)`

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

المعلمات

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

الإرجاع

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

`getHash()`

تحصل على تجزئة محتوى SHA1 لهذا المرفق. ولا يتم احتساب هذه الطريقة ضمن حصة Gmail للقراءة.

الإرجاع

String: تجزئة المحتوى باستخدام SHA1، بالتنسيق السلسلي

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:

https://mail.google.com/

`getName()`

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

الإرجاع

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

`getSize()`

تحصل على حجم هذا المرفق. هذه الطريقة أسرع من الاتصال برقم getBytes().length ولا يتم احتسابها ضمن حصة القراءة في Gmail.

الإرجاع

‫Integer: حجم المرفق، بالبايت

التفويض

https://mail.google.com/

`isGoogleType()`

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

الإرجاع

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

`setBytes(data)`

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