本頁面由 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。
`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。這個方法會在檔案名稱中加入適當的副檔名，例如「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'` 中的任一個也是有效的格式。

回攻員

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