تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

Class Attachment

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

مرفق مواقع، مثل ملف مرفق بصفحة.

تجدُر الإشارة إلى أنّ "المرفق" هو كائن تخزين البيانات الثنائية الكبيرة ويمكن استخدامه في أي مكان يُتوقَّع أن يحتوي على إدخال Blob.

var filesPage = SitesApp.getSite('example.com', 'mysite').getChildByName("files");
var attachments = filesPage.getAttachments();

// DocsList.createFile accepts a blob input. Since an Attachment is just a blob, we can
// just pass it directly to that method
var file = DocsList.createFile(attachments[0]);

الطُرق

الطريقة	نوع الإرجاع	وصف قصير
`getAs(contentType)`	`Blob`	عرض البيانات داخل هذا الكائن على شكل كائن ثنائي كبير تم تحويله إلى نوع المحتوى المحدّد.
`getBlob()`	`Blob`	عرض البيانات داخل هذا الكائن على شكل كائن ثنائي كبير.

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

الطريقة	نوع الإرجاع	وصف قصير
`deleteAttachment()`	`void`	سيتم حذف هذا المرفق.
`getAttachmentType()`	`AttachmentType`	اعرض نوع هذا المرفق (HOSTED أو WEB).
`getContentType()`	`String`	عرض نوع MIME لهذا المرفق.
`getDatePublished()`	`Date`	اعرض تاريخ نشر هذا المرفق لأول مرة.
`getDescription()`	`String`	عرض وصف هذا المرفق.
`getLastUpdated()`	`Date`	اعرض تاريخ آخر تعديل لهذا المرفق.
`getParent()`	`Page`	الحصول على الصفحة الرئيسية لهذا المرفق
`getTitle()`	`String`	عرض عنوان هذا المرفق
`getUrl()`	`String`	إرجاع عنوان URL لتنزيل هذا المرفق.
`setContentType(contentType)`	`Attachment`	يمكنك ضبط نوع MIME لهذا المرفق.
`setDescription(description)`	`Attachment`	يمكنك ضبط وصف هذا المرفق.
`setFrom(blob)`	`Attachment`	يمكنك ضبط البيانات الفعلية لهذا المرفق.
`setParent(parent)`	`Attachment`	يمكنك ضبط الصفحة الرئيسية لهذا المرفق.
`setTitle(title)`	`Attachment`	اضبط عنوان هذا المرفق.
`setUrl(url)`	`Attachment`	لضبط عنوان URL لتنزيل هذا المرفق.

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

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

`getBlob()`

عرض البيانات داخل هذا الكائن على شكل كائن ثنائي كبير.

الإرجاع

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

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

`deleteAttachment()`

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

سيتم حذف هذا المرفق.

var pages = SitesApp.getSite('example.com', 'mysite').getChildren();
var attachments = pages[0].getAttachments();
attachments[0].deleteAttachment();

التفويض

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

https://sites.google.com/feeds

`getAttachmentType()`

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

اعرض نوع هذا المرفق (HOSTED أو WEB).

var pages = SitesApp.getSite('example.com', 'mysite').getChildren();
var attachments = pages[0].getAttachments();
var attType = attachments[0].getAttachmentType();

// This will log "Hosted"
Logger.log(attType);

// Since this returns an AttachmentType and not a String, for the
// purposes of equivalence we want to either do this or cast the
// type to a String
if(attType ==  SitesService.AttachmentType.HOSTED) {
  Logger.log("This is a match");
}

// The above is the same as
if(String(attType) == "Hosted") {
   Logger.log("This is also a match");
}

الإرجاع

AttachmentType — نوع المرفق

التفويض

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

https://sites.google.com/feeds

`getContentType()`

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

عرض نوع MIME لهذا المرفق. تعذّر إرفاق مرفقات الويب.

var pages = SitesApp.getSite('example.com', 'mysite').getChildren();
var attachments = pages[0].getAttachments();
var contentType = attachments[0].getContentType();

الإرجاع

String — نوع MIME للمرفق

التفويض

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

https://sites.google.com/feeds

`getDatePublished()`

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

اعرض تاريخ نشر هذا المرفق لأول مرة.

var pages = SitesApp.getSite('example.com', 'mysite').getChildren();
var attachments = pages[0].getAttachments();
var date = attachments[0].getDatePublished();

الإرجاع

Date — تاريخ النشر الأصلي

التفويض

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

https://sites.google.com/feeds

`getDescription()`

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

عرض وصف هذا المرفق.

var pages = SitesApp.getSite('example.com', 'mysite').getChildren();
var attachments = pages[0].getAttachments();
var description = attachments[0].getDescription();

الإرجاع

String - وصف المرفق

التفويض

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

https://sites.google.com/feeds

`getLastUpdated()`

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

اعرض تاريخ آخر تعديل لهذا المرفق.

var pages = SitesApp.getSite('example.com', 'mysite').getChildren();
var attachments = pages[0].getAttachments();
var date = attachments[0].getLastUpdated();

الإرجاع

Date — تاريخ آخر تعديل

التفويض

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

https://sites.google.com/feeds

`getParent()`

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

الحصول على الصفحة الرئيسية لهذا المرفق

var pages = SitesApp.getSite('example.com', 'mysite').getChildren();
var attachments = pages[0].getAttachments();

// This is equal to pages[0]
var parent = attachments[0].getParent();

الإرجاع

Page: الصفحة الرئيسية

التفويض

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

https://sites.google.com/feeds

`getTitle()`

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

عرض عنوان هذا المرفق

var pages = SitesApp.getSite('example.com', 'mysite').getChildren();
var attachments = pages[0].getAttachments();
var title = attachments[0].getTitle();

الإرجاع

String — عنوان المرفق

التفويض

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

https://sites.google.com/feeds

`getUrl()`

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

إرجاع عنوان URL لتنزيل هذا المرفق.

var pages = SitesApp.getSite('example.com', 'mysite').getChildren();
var attachments = pages[0].getAttachments();
var url = attachments[0].getUrl();

الإرجاع

String: عنوان URL للتنزيل

التفويض

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

https://sites.google.com/feeds

`setContentType(contentType)`

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

يمكنك ضبط نوع MIME لهذا المرفق. تعذّر إرفاق مرفقات الويب.

var pages = SitesApp.getSite('example.com', 'mysite').getChildren();
var attachments = pages[0].getAttachments();
attachments[0].setContentType("text/plain");

المعلمات

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

الإرجاع

Attachment — هذا المرفق للسلسلة

التفويض

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

https://sites.google.com/feeds

`setDescription(description)`

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

يمكنك ضبط وصف هذا المرفق.

var pages = SitesApp.getSite('example.com', 'mysite').getChildren();
var attachments = pages[0].getAttachments();

// This is an example of chaining in action
attachments[0].setTitle("New Title")
              .setDescription("New Description");

المعلمات

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

الإرجاع

Attachment — هذا المرفق للسلسلة

التفويض

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

https://sites.google.com/feeds

`setFrom(blob)`

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

يمكنك ضبط البيانات الفعلية لهذا المرفق. تعذّر إرفاق مرفقات الويب.

var pages = SitesApp.getSite('demositeappsscript').getChildren();
var attachments = pages[0].getAttachments();

// This snippet demonstrates how to create a new text blob and attach it
// to the page
var blob = Utilities.newBlob("This data is now the attachment content");

// We must set a filename since we created the blob from String data
// instead of something like a URL source
blob.setName("attachment.txt");
attachments[0].setTitle("New Title")
              .setDescription("New Description")
              .setContentType("text/plain")
              .setFrom(blob);

المعلمات

الاسم	النوع	الوصف
`blob`	`BlobSource`	البيانات الجديدة

الإرجاع

Attachment — هذا المرفق للسلسلة

التفويض

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

https://sites.google.com/feeds

`setParent(parent)`

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

يمكنك ضبط الصفحة الرئيسية لهذا المرفق.

var pages = SitesApp.getSite('example.com', 'mysite').getChildren();
var attachments = pages[0].getAttachments();
// Sets the parent page to be the next sibling
attachments[0].setParent(pages[1]);

المعلمات

الاسم	النوع	الوصف
`parent`	`Page`	العنصر الرئيسي الجديد

الإرجاع

Attachment — هذا المرفق للسلسلة

التفويض

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

https://sites.google.com/feeds

`setTitle(title)`

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

اضبط عنوان هذا المرفق.

var pages = SitesApp.getSite('example.com', 'mysite').getChildren();
var attachments = pages[0].getAttachments();

// This is an example of chaining in action
attachments[0].setTitle("New Title")
              .setDescription("New Description");

المعلمات

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

الإرجاع

Attachment — هذا المرفق للسلسلة

التفويض

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

https://sites.google.com/feeds

`setUrl(url)`

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

لضبط عنوان URL لتنزيل هذا المرفق. صالح فقط لمرفقات الويب.

var pages = SitesApp.getSite('demositeappsscript').getChildren();
var attachments = pages[0].getAttachments();

attachments[0].setTitle("New Web Attachment")
              .setDescription("New Description")
              .setUrl("http://example.com/files/your_file.txt");

المعلمات

الاسم	النوع	الوصف
`url`	`String`

الإرجاع

Attachment — هذا المرفق للسلسلة

التفويض

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

https://sites.google.com/feeds