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