本頁面由 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`	以 blob 的形式傳回這個物件中的資料，做為轉換成指定內容類型的 blob。
`getBlob()`	`Blob`	以 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`	設定這個附件的下載網址。

內容詳盡的說明文件

`getAs(contentType)`

以 blob 的形式傳回這個物件中的資料，做為轉換成指定內容類型的 blob。這個方法會在檔案名稱中加入適當的副檔名，例如「myfile.pdf」。不過假設檔案名稱最後一個句點 (如果有) 之後的部分為現有文件所有應替換的副檔名。因此，「ShoppingList.12.25.2014」變成「ShoppingList.12.25.pdf」。

如要查看轉換的每日配額，請參閱 Google 的配額服務。新建立的 Google Workspace 網域可能會暫時受到更嚴格的限制

參數

名稱	類型	說明
`contentType`	`String`	要轉換的 MIME 類型。大多數 blob 的 `'application/pdf'` 是就是唯一有效的選項如為 BMP、GIF、JPEG 或 PNG 格式的圖片，也應採用 `'image/bmp'`、`'image/gif'`、`'image/jpeg'` 或 `'image/png'` 格式有效。如果是 Google 文件，`'text/markdown'` 也是有效的格式。

回攻員

Blob - 做為 blob 的資料。

`getBlob()`

以 blob 的形式傳回這個物件中的資料。

回攻員

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

已淘汰。這個函式已淘汰，不應用於新的指令碼。

傳回這個附件的下載網址。

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

已淘汰。這個函式已淘汰，不應用於新的指令碼。

設定這個附件的下載網址。僅適用於網頁附件。

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