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。這個
方法會在檔案名稱中加入適當的副檔名,例如「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);
參數
回攻員
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]);
參數
回攻員
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");
參數
回攻員
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");
參數
回攻員
Attachment
:這個鏈結連結
授權
使用這個方法的指令碼需要下列一或多個範圍的授權:
-
https://sites.google.com/feeds
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2024-09-12 (世界標準時間)。
[]
[]
{"lastModified": "\u4e0a\u6b21\u66f4\u65b0\u6642\u9593\uff1a2024-09-12 (\u4e16\u754c\u6a19\u6e96\u6642\u9593)\u3002"}
[null,null,["上次更新時間:2024-09-12 (世界標準時間)。"]]