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\|null`	تعرض هذه السمة نوع المحتوى الخاص بالبايت في كائن التخزين الثنائي الكبير هذا.
`getDataAsString()`	`String`	تعرض هذه الطريقة بيانات الكائن الثنائي الكبير (blob) كسلسلة بترميز UTF-8.
`getDataAsString(charset)`	`String`	تعرض بيانات هذا الكائن الثنائي الكبير كسلسلة باستخدام الترميز المحدّد.
`getHash()`	`String`	تعرض هذه السمة تجزئة SHA1 للمحتوى الخاص بهذا المرفق.
`getName()`	`String\|null`	تعرض هذه السمة اسم الكائن الثنائي الكبير.
`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: نوع محتوى هذه البيانات، إذا كان معروفًا، أو null

`getDataAsString()`

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

الإرجاع

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

`getDataAsString(charset)`

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

المَعلمات

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

الإرجاع

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

`getHash()`

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

الإرجاع

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

التفويض

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

https://mail.google.com/

`getName()`

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

الإرجاع

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

`getSize()`

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

الإرجاع

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

التفويض

https://mail.google.com/

`isGoogleType()`

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

الإرجاع

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

`setBytes(data)`

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