این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

Class Attachment

منسوخ. این کلاس منسوخ شده است و نباید در اسکریپت های جدید استفاده شود.

یک پیوست سایت مانند یک فایل پیوست شده به یک صفحه.

توجه داشته باشید که یک پیوست یک Blob است و می تواند در هر جایی که ورودی 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`	آدرس دانلود این پیوست را برگردانید.
`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'` نیز معتبر هستند.

برگشت

Blob - داده ها به عنوان یک لکه.

`getBlob()`

داده های داخل این شی را به صورت حباب برگردانید.

برگشت

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 - نوع میم پیوست

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

منسوخ. این تابع منسوخ شده است و نباید در اسکریپت های جدید استفاده شود.

آدرس دانلود این پیوست را برگردانید.

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

برگشت

String - آدرس دانلود

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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`	نوع جدید میم

برگشت

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