این صفحه به‌وسیله ‏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'` نیز معتبر هستند. برای سند Google Docs، `'text/markdown'` نیز معتبر است.

بازگشت

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