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`	ترميز الأحرف الذي سيتم استخدامه في ترميز البيانات في هذا الملف الثنائي الكبير (BLOB) كسلسلة.

الإرجاع

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)`

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

المعلمات

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

الإرجاع

Blob: هذه هي مساحة التخزين، ويتم استخدامها في التسلسل.

`setContentType(contentType)`

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

المعلمات

الاسم	النوع	الوصف
`contentType`	`String`	تمثّل هذه السمة نوع المحتوى الجديد.

الإرجاع

Blob: هذه هي مساحة التخزين، ويتم استخدامها في التسلسل.

`setContentTypeFromExtension()`

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

الإرجاع

Blob: هذه هي مساحة التخزين، ويتم استخدامها في التسلسل.

`setDataFromString(string)`

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

المعلمات

الاسم	النوع	الوصف
`string`	`String`	بيانات السلسلة

الإرجاع

‫Blob: هذه هي مساحة التخزين، ويتم استخدامها في التسلسل.

`setDataFromString(string, charset)`

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

المعلمات

الاسم	النوع	الوصف
`string`	`String`	بيانات السلسلة
`charset`	`String`	مجموعة الرموز المراد استخدامها في تفسير السلسلة النصية كبايت.

الإرجاع

Blob: هذه هي مساحة التخزين، ويتم استخدامها في التسلسل.

`setName(name)`

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

المعلمات

الاسم	النوع	الوصف
`name`	`String`	الاسم الجديد

الإرجاع

Blob: هذه هي مساحة التخزين، ويتم استخدامها في التسلسل.

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

`getAllBlobs()`

تمّت إزالة هذا العمود. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.

تعرض هذه الطريقة جميع الكائنات الثنائية الكبيرة التي يتضمّنها هذا الكائن الثنائي الكبير (المركّب على الأرجح).

الإرجاع

‫Blob[]: الكائنات الثنائية الكبيرة المتضمّنة في الكائن الثنائي الكبير

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

الطُرق

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

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

copyBlob()

الإرجاع

getAs(contentType)

المعلمات

الإرجاع

getBytes()

الإرجاع

getContentType()

الإرجاع

getDataAsString()

الإرجاع

getDataAsString(charset)

المعلمات

الإرجاع

getHash()

الإرجاع

التفويض

getName()

الإرجاع

getSize()

الإرجاع

التفويض

isGoogleType()

الإرجاع

setBytes(data)

المعلمات

الإرجاع

setContentType(contentType)

المعلمات

الإرجاع

setContentTypeFromExtension()

الإرجاع

setDataFromString(string)

المعلمات

الإرجاع

setDataFromString(string, charset)

المعلمات

الإرجاع

setName(name)

المعلمات

الإرجاع

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

getAllBlobs()

الإرجاع

Class GmailAttachment

`copyBlob()`

`getAs(contentType)`

`getBytes()`

`getContentType()`

`getDataAsString()`

`getDataAsString(charset)`

`getHash()`

`getName()`

`getSize()`

`isGoogleType()`

`setBytes(data)`

`setContentType(contentType)`

`setContentTypeFromExtension()`

`setDataFromString(string)`

`setDataFromString(string, charset)`

`setName(name)`

`getAllBlobs()`