Class GmailAttachment

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
مرفق Gmail

مرفق من 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).

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

copyBlob()

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

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

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


getAs(contentType)

عرض البيانات داخل هذا العنصر ككائن ثنائي كبير (blob) تم تحويله إلى نوع المحتوى المحدد. تضيف هذه الطريقة الامتداد المناسب إلى اسم الملف، على سبيل المثال، "myfile.pdf". ومع ذلك، يفترض أنّ الجزء من اسم الملف الذي يتبع النقطة الأخيرة (إن وجد) هو إضافة حالية يجب استبدالها. نتيجةً لذلك، يصبح "ShoppingList.12.25.2014" "ShoppingList.12.25.pdf".

لعرض الحصص اليومية للإحالات الناجحة، يُرجى الاطّلاع على حصص خدمات Google. قد تخضع نطاقات Google Workspace التي تم إنشاؤها حديثًا إلى عروض أسعار أكثر صرامة.

المعلّمات

الاسمالنوعالوصف
contentTypeStringنوع 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) كسلسلة بالترميز المحدد.

المعلّمات

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

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

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


getHash()

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

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

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

التفويض

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

  • https://mail.google.com/

getName()

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

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

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


getSize()

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

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

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

التفويض

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

  • https://mail.google.com/

isGoogleType()

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

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

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


setBytes(data)

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

المعلّمات

الاسمالنوعالوصف
dataByte[]البيانات الجديدة

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

Blob — هذا الكائن الثنائي الكبير (blob) للسلاسل.


setContentType(contentType)

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

المعلّمات

الاسمالنوعالوصف
contentTypeStringنوع المحتوى الجديد.

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

Blob — هذا الكائن الثنائي الكبير (blob) للسلاسل.


setContentTypeFromExtension()

يحدِّد هذا الإعداد نوع محتوى وحدات البايت في هذا الكائن الثنائي الكبير (blob) استنادًا إلى امتداد الملف. نوع المحتوى هو null وإذا تعذّر تخمينه من الإضافة.

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

Blob — هذا الكائن الثنائي الكبير (blob) للسلاسل.


setDataFromString(string)

تُحدِّد بيانات هذا الكائن الثنائي الكبير (blob) من سلسلة بترميز UTF-8.

المعلّمات

الاسمالنوعالوصف
stringStringبيانات السلسلة.

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

Blob — هذا الكائن الثنائي الكبير (blob) للسلاسل.


setDataFromString(string, charset)

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

المعلّمات

الاسمالنوعالوصف
stringStringبيانات السلسلة.
charsetStringمجموعة الأحرف المستخدمة في تفسير السلسلة كوحدات بايت.

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

Blob — هذا الكائن الثنائي الكبير (blob) للسلاسل.


setName(name)

تحدّد اسم هذا الكائن الثنائي الكبير (blob).

المعلّمات

الاسمالنوعالوصف
nameStringالاسم الجديد.

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

Blob — هذا الكائن الثنائي الكبير (blob) للسلاسل.

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