تمت ترجمة هذه الصفحة بواسطة 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`	عرض البيانات داخل هذا الكائن على شكل كائن ثنائي كبير تم تحويله إلى نوع المحتوى المحدّد.
`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`	تحدِّد هذه السياسة نوع محتوى وحدات البايت في هذا الكائن الثنائي الكبير بناءً على امتداد الملف.
`setDataFromString(string)`	`Blob`	تحدّد هذه السياسة بيانات هذا الكائن الثنائي الكبير (blob) من سلسلة بترميز UTF-8.
`setDataFromString(string, charset)`	`Blob`	تحدّد هذه السياسة بيانات هذا الكائن الثنائي الكبير (blob) من سلسلة تتضمن الترميز المحدد.
`setName(name)`	`Blob`	لتعيين اسم هذا الكائن الثنائي الكبير (blob).

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

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

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

`copyBlob()`

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

الإرجاع

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 — البيانات ككائنات ثنائية كبيرة (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)