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

Class GmailAttachment

مرفق من Gmail. هذه Blob عادية، ولكنها تستخدم طريقة getSize() إضافية أسرع من الاتصال getBytes().length ولا يتم احتسابها ضمن حصة القراءة في Gmail.

// Logs information about any attachments in the first 100 inbox threads.
var threads = GmailApp.getInboxThreads(0, 100);
var msgs = GmailApp.getMessagesForThreads(threads);
for (var i = 0 ; i < msgs.length; i++) {
  for (var j = 0; j < msgs[i].length; j++) {
    var attachments = msgs[i][j].getAttachments();
    for (var 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`	عرض نسخة من هذا الكائن الثنائي الكبير (blob)
`getAs(contentType)`	`Blob`	عرض البيانات داخل هذا العنصر ككائن ثنائي كبير (blob) تم تحويله إلى نوع المحتوى المحدد.
`getBytes()`	`Byte[]`	الحصول على البيانات المخزنة في هذا الكائن الثنائي الكبير (blob).
`getContentType()`	`String`	تحصل على نوع المحتوى بالبايت في هذا الكائن الثنائي الكبير (blob).
`getDataAsString()`	`String`	يحصل على بيانات هذا الكائن الثنائي الكبير (blob) كسلسلة بترميز UTF-8.
`getDataAsString(charset)`	`String`	يحصل على بيانات هذا الكائن الثنائي الكبير (blob) كسلسلة بالترميز المحدد.
`getHash()`	`String`	تحصل على تجزئة محتوى SHA1 لهذا المرفق.
`getName()`	`String`	الحصول على اسم هذا الكائن الثنائي الكبير (blob).
`getSize()`	`Integer`	يحدّد حجم هذا المرفق.
`isGoogleType()`	`Boolean`	يعرض ما إذا كان هذا الكائن الثنائي الكبير (blob) هو ملف Google Workspace ("جداول بيانات Google" أو "مستندات Google" أو غير ذلك).
`setBytes(data)`	`Blob`	لضبط البيانات المخزّنة في هذا الكائن الثنائي الكبير (blob).
`setContentType(contentType)`	`Blob`	يحدّد هذا الإعداد نوع محتوى وحدات البايت في هذا الكائن الثنائي الكبير (blob).
`setContentTypeFromExtension()`	`Blob`	يحدِّد هذا الإعداد نوع محتوى وحدات البايت في هذا الكائن الثنائي الكبير (blob) استنادًا إلى امتداد الملف.
`setDataFromString(string)`	`Blob`	تُحدِّد بيانات هذا الكائن الثنائي الكبير (blob) من سلسلة بترميز UTF-8.
`setDataFromString(string, charset)`	`Blob`	تتيح هذه السياسة ضبط بيانات الكائن الثنائي الكبير (blob) من سلسلة باستخدام الترميز المحدّد.
`setName(name)`	`Blob`	تحدّد اسم هذا الكائن الثنائي الكبير (blob).

الطرق التي تم إيقافها نهائيًا

الطريقة	نوع الإرجاع	وصف قصير
`getAllBlobs()`	`Blob[]`	تحصل على الكائن الثنائي الكبير (blob) المضمّن في الكائن الثنائي الكبير (blob) هذا.

المستندات التفصيلية

`copyBlob()`

عرض نسخة من هذا الكائن الثنائي الكبير (blob)

تذكرة ذهاب وعودة

Blob — النسخة الجديدة:

`getAs(contentType)`

عرض البيانات داخل هذا العنصر ككائن ثنائي كبير (blob) تم تحويله إلى نوع المحتوى المحدد. تضيف هذه الطريقة الامتداد المناسب إلى اسم الملف، على سبيل المثال، "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'` صالح أيضًا.

تذكرة ذهاب وعودة

Blob — البيانات كائن ثنائي كبير.

`getBytes()`

الحصول على البيانات المخزنة في هذا الكائن الثنائي الكبير (blob).

تذكرة ذهاب وعودة

Byte[] — وحدات البايت المخزّنة.

`getContentType()`

تحصل على نوع المحتوى بالبايت في هذا الكائن الثنائي الكبير (blob).

تذكرة ذهاب وعودة

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

`getDataAsString()`

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

تذكرة ذهاب وعودة

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

`getDataAsString(charset)`

يحصل على بيانات هذا الكائن الثنائي الكبير (blob) كسلسلة بالترميز المحدد.

المعلّمات

الاسم	النوع	الوصف
`charset`	`String`	مجموعة الأحرف المستخدمة في ترميز البيانات في هذا الكائن الثنائي الكبير (blob) كسلسلة بيانات.

تذكرة ذهاب وعودة

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

`getHash()`

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

تذكرة ذهاب وعودة

String - تجزئة محتوى SHA1، كسلسلة.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

https://mail.google.com/

`getName()`

الحصول على اسم هذا الكائن الثنائي الكبير (blob).

تذكرة ذهاب وعودة

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

`getSize()`

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

تذكرة ذهاب وعودة

Integer — حجم المرفق بالبايت.

التفويض

https://mail.google.com/

`isGoogleType()`

يعرض ما إذا كان هذا الكائن الثنائي الكبير (blob) هو ملف Google Workspace ("جداول بيانات Google" أو "مستندات Google" أو غير ذلك).

تذكرة ذهاب وعودة

Boolean - true إذا كان هذا الكائن الثنائي الكبير (blob) هو ملف Google Workspace، false إذا لم يكن ملفًا.

`setBytes(data)`

لضبط البيانات المخزّنة في هذا الكائن الثنائي الكبير (blob).