Class GmailAttachment

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تعرض نسخة من هذا العنصر الثنائي.
getAs(contentType)Blobعرض البيانات داخل هذا الكائن على شكل كائن ثنائي كبير يتم تحويله إلى نوع المحتوى المحدّد.
getBytes()Byte[]توفر هذه الدالة تخزين البيانات في الكائن الثنائي الكبير (blob).
getContentType()Stringللحصول على نوع محتوى وحدات البايت في هذه الكائن الثنائي الكبير.
getDataAsString()Stringنحصل على بيانات هذا العنصر الثنائي كسلسلة بترميز UTF-8.
getDataAsString(charset)Stringللحصول على بيانات هذا الكائن الثنائي النطاق كسلسلة ذات الترميز المحدّد.
getHash()Stringالحصول على تجزئة محتوى SHA1 لهذا المرفق.
getName()Stringيحصل على اسم هذه النقطة.
getSize()Integerالحصول على حجم هذا المرفق.
isGoogleType()Booleanتعرض ما إذا كان هذا الكائن الثنائي الكبير (blob) ملف Google Workspace (جداول بيانات Google، "مستندات Google"، وما إلى ذلك).
setBytes(data)Blobتُستخدَم لإعداد البيانات المخزّنة في الكائن الثنائي الكبير هذا.
setContentType(contentType)Blobلضبط نوع محتوى وحدات البايت في الكائن الثنائي الكبير هذا.
setContentTypeFromExtension()Blobلضبط نوع محتوى وحدات البايت في الكائن الثنائي الكبير (blob) بناءً على امتداد الملف.
setDataFromString(string)Blobلضبط بيانات الكائن الثنائي الكبير هذا من سلسلة بترميز UTF-8.
setDataFromString(string, charset)Blobلضبط بيانات الكائن الثنائي الكبير (blob) هذا من سلسلة ذات الترميز المحدد.
setName(name)Blobتحدِّد اسم الكائن الثنائي الكبير هذا.

الوثائق التفصيلية

copyBlob()

تعرض نسخة من هذا العنصر الثنائي.

استرجاع الكرة

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


getAs(contentType)

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

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

المَعلمات

الاسمTypeالوصف
contentTypeStringنوع MIME المطلوب التحويل إليه. بالنسبة إلى معظم الكائنات الثنائية الكبيرة، يكون 'application/pdf' هو الخيار الصالح الوحيد. بالنسبة إلى الصور بتنسيق BMP أو GIF أو JPEG أو PNG، يكون أي من 'image/bmp' أو 'image/gif' أو 'image/jpeg' أو 'image/png' صالحًا أيضًا.

استرجاع الكرة

Blob — البيانات في صورة كائن ثنائي كبير (blob).


getBytes()

توفر هذه الدالة تخزين البيانات في الكائن الثنائي الكبير (blob).

استرجاع الكرة

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


getContentType()

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

استرجاع الكرة

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


getDataAsString()

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

استرجاع الكرة

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


getDataAsString(charset)

للحصول على بيانات هذا الكائن الثنائي النطاق كسلسلة ذات الترميز المحدّد.

المَعلمات

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

استرجاع الكرة

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


getHash()

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

استرجاع الكرة

String: تجزئة محتوى SHA1 كسلسلة

التفويض

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

  • https://mail.google.com/

getName()

يحصل على اسم هذه النقطة.

استرجاع الكرة

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


getSize()

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

استرجاع الكرة

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

التفويض

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

  • https://mail.google.com/

isGoogleType()

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

استرجاع الكرة

Boolean - true إذا كان كائن ثنائي النقاط هذا عبارة عن ملف Google Workspace، وfalse إذا لم يكن كذلك.


setBytes(data)

تُستخدَم لإعداد البيانات المخزّنة في الكائن الثنائي الكبير هذا.

المَعلمات

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

استرجاع الكرة

Blob — هذه النقطة الثنائية الكبيرة، للتسلسل.


setContentType(contentType)

لضبط نوع محتوى وحدات البايت في الكائن الثنائي الكبير هذا.

المَعلمات

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

استرجاع الكرة

Blob — هذه النقطة الثنائية الكبيرة، للتسلسل.


setContentTypeFromExtension()

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

استرجاع الكرة

Blob — هذه النقطة الثنائية الكبيرة، للتسلسل.


setDataFromString(string)

لضبط بيانات الكائن الثنائي الكبير هذا من سلسلة بترميز UTF-8.

المَعلمات

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

استرجاع الكرة

Blob — هذه النقطة الثنائية الكبيرة، للتسلسل.


setDataFromString(string, charset)

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

المَعلمات

الاسمTypeالوصف
stringStringبيانات السلسلة.
charsetStringيشير ذلك المصطلح إلى مجموعة الأحرف المطلوب استخدامها لتفسير السلسلة بصفتها وحدات بايت.

استرجاع الكرة

Blob — هذه النقطة الثنائية الكبيرة، للتسلسل.


setName(name)

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

المَعلمات

الاسمTypeالوصف
nameStringالاسم الجديد

استرجاع الكرة

Blob — هذه النقطة الثنائية الكبيرة، للتسلسل.

الطرق المتوقّفة نهائيًا