Class Page

網頁

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

Google 協作平台中的頁面。

已淘汰的方法

方法	傳回類型	簡短說明
addColumn(name)	Column	在清單中新增資料欄。
addComment(content)	Comment	已淘汰。
addHostedAttachment(blob)	Attachment	在頁面中新增附件。
addHostedAttachment(blob, description)	Attachment	在頁面中新增附件。
addListItem(values)	ListItem	將清單項目新增至清單。
addWebAttachment(title, description, url)	Attachment	在頁面中加入網路附件。
createAnnouncement(title, html)	Page	建立這個網頁的公告。
createAnnouncement(title, html, asDraft)	Page	建立這個網頁的公告。
createAnnouncementsPage(title, name, html)	Page	建立新的公告頁面。
createFileCabinetPage(title, name, html)	Page	建立新的檔案櫃頁面。
createListPage(title, name, html, columnNames)	Page	建立新的清單頁面。
createPageFromTemplate(title, name, template)	Page	使用範本建立新頁面。
createWebPage(title, name, html)	Page	建立新網頁。
deletePage()	void	刪除這個頁面。
getAllDescendants()	Page[]	取得一系列子網頁 (直接和間接網頁)，但上限為 200 頁。
getAllDescendants(options)	Page[]	取得包含選用進階引數的子系頁面陣列。
getAnnouncements()	Page[]	接收這個頁面的公告。
getAnnouncements(optOptions)	Page[]	接收這個頁面的公告。
getAttachments()	Attachment[]	取得這個頁面的附件。
getAttachments(optOptions)	Attachment[]	取得這個頁面的附件。
getAuthors()	String[]	取得網頁作者的電子郵件
getChildByName(name)	Page	取得特定的子頁面。
getChildren()	Page[]	取得子頁面的陣列，上限為 200 頁。
getChildren(options)	Page[]	取得含有選用進階引數的子頁面陣列。
getColumns()	Column[]	取得清單的資料欄。
getComments()	Comment[]	已淘汰。
getComments(optOptions)	Comment[]	已淘汰。
getDatePublished()	Date	返回網頁首次發布的日期。
getHtmlContent()	String	取得網頁的 HTML 內容。
getIsDraft()	Boolean	傳回網頁是否處於草稿模式。
getLastEdited()	Date	傳回上次編輯日期，其中僅包含編輯內容。
getLastUpdated()	Date	傳回上次更新日期，包括移動等非內容變更。
getListItems()	ListItem[]	取得清單項目。
getListItems(optOptions)	ListItem[]	取得清單項目。
getName()	String	傳回網頁名稱。
getPageName()	String	已淘汰。
getPageType()	PageType	傳回這個網頁的類型，做為 SitesApp.PageType 列舉。
getParent()	Page	傳回這個網頁的上層。
getSelfLink()	String	已淘汰。
getTextContent()	String	傳回純文字網頁內容。
getTitle()	String	傳回網頁標題。
getUrl()	String	取得網頁的網址。
isDeleted()	Boolean	傳回網頁是否已刪除。
isTemplate()	Boolean	傳回這個頁面是否為可複製的範本。
publishAsTemplate(name)	Page	將這個頁面發布為可複製的範本。
search(query)	Page[]	取得與搜尋查詢相符的子系網頁陣列，上限為 200 頁。
search(query, options)	Page[]	取得與搜尋查詢相符的子系網頁陣列，以及選用的進階引數。
setHtmlContent(html)	Page	設定網頁的 HTML 內容。
setIsDraft(draft)	Page	設定網頁是否處於草稿模式。
setName(name)	Page	設定這個頁面的名稱。
setParent(parent)	Page	設定這個頁面的上層項目。
setTitle(title)	Page	設定網頁標題。

已淘汰的方法

addColumn(name)

已淘汰。此函式已淘汰，不應在新的指令碼中使用。

在清單中新增資料欄。這項參數僅適用於清單頁面。

var site = SitesApp.getSite("example.com", "mysite");

var page = site.getChildByName("listpage");
// Only valid on List pages. Check for the type like so:
//     if(page.getPageType() == SitesApp.PageType.LIST_PAGE))
var columns = page.addColumn("new-column");

參數

名稱	類型	說明
name	String	新資料欄的名稱

回攻員

Column：新建立的資料欄

擲回

Error — 適用於非清單頁面的網頁

授權

使用這個方法的指令碼必須取得以下一或多個範圍的授權：

• https://sites.google.com/feeds

---

addComment(content)

已淘汰。此函式已淘汰，不應在新的指令碼中使用。

已淘汰，在頁面新增註解。

var site = SitesApp.getSite("example.com", "mysite");
var page = site.getChildren()[0];

page.addComment("This is a comment created automatically by a script using the account " +
                "of the user running the script");

參數

名稱	類型	說明
content	String	留言內容

回攻員

Comment：新建立的註解

授權

使用這個方法的指令碼必須取得以下一或多個範圍的授權：

• https://sites.google.com/feeds

---

addHostedAttachment(blob)

已淘汰。此函式已淘汰，不應在新的指令碼中使用。

在頁面中新增附件。

var site = SitesApp.getSite("example.com", "mysite");
var page = site.getChildren()[0];

// Create a new blob and attach it. Many useful functions also return
// blobs file uploads, URLFetch
var blob = Utilities.newBlob("Here is some data", "text/plain", "data.txt");

// Note that the filename must be unique or this call will fail
page.addHostedAttachment(blob);

參數

名稱	類型	說明
blob	BlobSource	附件資料

回攻員

Attachment：新建立的連結

授權

使用這個方法的指令碼必須取得以下一或多個範圍的授權：

• https://sites.google.com/feeds

---

addHostedAttachment(blob, description)

已淘汰。此函式已淘汰，不應在新的指令碼中使用。

在頁面中新增附件。這個版本的函式可用來提供說明。

var site = SitesApp.getSite("example.com", "mysite");
var page = site.getChildren()[0];

// Create a new blob and attach it. Many useful: functions also return
// blobs file uploads, URLFetch
var blob = Utilities.newBlob("Here is some data", "text/plain", "data.txt");

// Note that the filename must be unique or this call will fail
page.addHostedAttachment(blob, "Some newly created data");

參數

名稱	類型	說明
blob	BlobSource	附件資料
description	String	附件的說明

回攻員

Attachment：新建立的連結

授權

使用這個方法的指令碼必須取得以下一或多個範圍的授權：

• https://sites.google.com/feeds

---

addListItem(values)

已淘汰。此函式已淘汰，不應在新的指令碼中使用。

將清單項目新增至清單。這項參數僅適用於清單頁面。

var site = SitesApp.getSite("example.com", "mysite");

var page = site.getChildByName("listpage");
// Only valid on List pages. Check for the type like so:
//     if(page.getPageType() == SitesApp.PageType.LIST_PAGE))
// Returns only one item
page.addListItem([ "John", "Smith", "123 Main St"]);

參數

名稱	類型	說明
values	String[]	每個資料欄的值

回攻員

ListItem：新建立的 ListItem

授權

使用這個方法的指令碼必須取得以下一或多個範圍的授權：

• https://sites.google.com/feeds

---

addWebAttachment(title, description, url)

已淘汰。此函式已淘汰，不應在新的指令碼中使用。

在頁面中加入網路附件。僅適用於檔案櫃頁面。

網頁附件為連結，實際上並非由 Google 協作平台代管。

var site = SitesApp.getSite("example.com", "mysite");
// fetch the child - this must be a File Cabinet page
// to programmatically check this, do a comparison:
//    if(page.getPageType() == SitesApp.PageType.FILE_CABINET_PAGE)
var page = site.getChildByName("files");
page.addWebAttachment("Google Robots file",
                      "This is Google's robots.txt file",
                      "http://www.google.com/robots.txt");

參數

名稱	類型	說明
title	String	附件標題
description	String	附件的說明
url	String	附加檔案的網址

回攻員

Attachment：新建立的連結

授權

使用這個方法的指令碼必須取得以下一或多個範圍的授權：

• https://sites.google.com/feeds

---

createAnnouncement(title, html)

已淘汰。此函式已淘汰，不應在新的指令碼中使用。

建立這個網頁的公告。僅適用於公告網頁。

var site = SitesApp.getSite("example.com", "mysite");

// This snippet will only work with announcement pages - this is different
// from a page that is an announcement (individual announcements). To check
// if this method can be called:
//    if(page.getPageType() == SitesApp.PageType.ANNOUNCEMENTS_PAGE))
var page = site.getChildByName("news");
page.createAnnouncement("Breaking news!", "<h1>Apps Script rocks!</h1>");

參數

名稱	類型	說明
title	String	網頁標題
html	String	網頁內容

回攻員

Page：新建立的公告

擲回

Error — 適用於非公告頁面

授權

使用這個方法的指令碼必須取得以下一或多個範圍的授權：

• https://sites.google.com/feeds

---

createAnnouncement(title, html, asDraft)

已淘汰。此函式已淘汰，不應在新的指令碼中使用。

建立這個網頁的公告。僅適用於公告網頁。

var site = SitesApp.getSite("example.com", "mysite");

// This snippet will only work with announcement pages - this is different
// from a page that is an announcement (individual announcements). To check
// if this method can be called:
//    if(page.getPageType() == SitesApp.PageType.ANNOUNCEMENTS_PAGE))
var page = site.getChildByName("news");
page.createAnnouncement("Breaking news!",
                        "<h1>Apps Script rocks!</h1>",
                        true);

參數

名稱	類型	說明
title	String	網頁標題
html	String	網頁內容
asDraft	Boolean	是否要將公告設為草稿

回攻員

Page：新建立的公告

擲回

Error — 適用於非公告頁面

授權

使用這個方法的指令碼必須取得以下一或多個範圍的授權：

• https://sites.google.com/feeds

---

createAnnouncementsPage(title, name, html)

已淘汰。此函式已淘汰，不應在新的指令碼中使用。

建立新的公告頁面。請注意，單一上層網站或網頁最多只能有 500 個子頁面。

// This method can be called from both a Site instance
// as well as a Page instance
var site = SitesApp.getSite("example.com", "mysite");
var page = site.getChildren()[0];

site.createAnnouncementsPage("New Announcement",
                             "new-announcement",
                             "<h1>Your announcement goes here</h1>");

page.createAnnouncementsPage("New Announcement",
                             "new-announcement-child",
                             "<h1>Your announcement goes here</h1>");

參數

名稱	類型	說明
title	String	網頁標題
name	String	網頁名稱
html	String	網頁內容

回攻員

Page：新建立的 Page

授權

使用這個方法的指令碼必須取得以下一或多個範圍的授權：

• https://sites.google.com/feeds

---

createFileCabinetPage(title, name, html)

已淘汰。此函式已淘汰，不應在新的指令碼中使用。

建立新的檔案櫃頁面。請注意，單一上層網站或網頁最多只能有 500 個子網頁。

// This method can be called from either a site or a page.
var site = SitesApp.getSite("example.com", "mysite");
var page = site.getChildren()[0];

site.createFileCabinetPage("New File Cabinet",
                           "new-file-cabinet",
                           "<h1>Your HTML here</h1>");

page.createFileCabinetPage("New File Cabinet",
                             "new-file-cabinet-child",
                             "<h1>Your HTML here</h1>");

參數

名稱	類型	說明
title	String	網頁標題
name	String	網頁名稱
html	String	網頁內容

回攻員

Page：新建立的 Page

授權

使用這個方法的指令碼必須取得以下一或多個範圍的授權：

• https://sites.google.com/feeds

---

createListPage(title, name, html, columnNames)

已淘汰。此函式已淘汰，不應在新的指令碼中使用。

建立新的清單頁面。請注意，上層網站或網頁最多只能有 500 個子網頁。

// This method can be called from either a site or a page.
var site = SitesApp.getSite("example.com", "mysite");
var page = site.getChildren()[0];

site.createListPage("New List Page",
                    "new-list-page",
                    "<h1>Your List Page HTML here</h1>",
                    [ "col1", "col2" ]);

page.createListPage("New List Page",
                    "new-list-page-child",
                    "<h1>Your List Page HTML here</h1>",
                    [ "col1", "col2" ]);

參數

名稱	類型	說明
title	String	網頁標題
name	String	網頁名稱
html	String	網頁內容
columnNames	String[]	用於清單的資料欄名稱

回攻員

Page：新建立的 Page

授權

使用這個方法的指令碼必須取得以下一或多個範圍的授權：

• https://sites.google.com/feeds

---

createPageFromTemplate(title, name, template)

已淘汰。此函式已淘汰，不應在新的指令碼中使用。

使用範本建立新頁面。請注意，單一上層網站或網頁最多只能有 500 個子頁面。

// This method can be called from either a site or a page.
var site = SitesApp.getSite("example.com", "mysite");
var template = site.getTemplates()[0];

// If an invalid template is passed, this will throw an "Invalid Argument" error.
site.createPageFromTemplate("ClonedPage", "cloned-page", template);

參數

名稱	類型	說明
title	String	網頁標題
name	String	網頁名稱
template	Page	範本頁面

回攻員

Page：新建立的 Page

授權

使用這個方法的指令碼必須取得以下一或多個範圍的授權：

• https://sites.google.com/feeds

---

createWebPage(title, name, html)

已淘汰。此函式已淘汰，不應在新的指令碼中使用。

建立新網頁。請注意，上層網站或網頁最多只能有 500 個子網頁。

// This method can be called from either a site or a page.
var site = SitesApp.getSite("example.com", "mysite");
var page = site.getChildren()[0];

site.createAnnouncementsPage("New Announcement",
                             "new-announcement",
                             "<h1>Your announcement goes here</h1>");

page.createAnnouncementsPage("New Announcement",
                             "new-announcement-child",
                             "<h1>Your announcement goes here</h1>");

參數

名稱	類型	說明
title	String	網頁標題
name	String	網頁名稱
html	String	網頁內容

回攻員

Page：新建立的 Page

授權

使用這個方法的指令碼必須取得以下一或多個範圍的授權：

• https://sites.google.com/feeds

---

deletePage()

已淘汰。此函式已淘汰，不應在新的指令碼中使用。

刪除這個頁面。

var site = SitesApp.getSite("example.com", "mysite");

// Delete ALL the pages!
var pages = site.getAllDescendants();
for(var i in pages) {
  pages[i].deletePage();
}

授權

使用這個方法的指令碼必須取得以下一或多個範圍的授權：

• https://sites.google.com/feeds

---

getAllDescendants()

已淘汰。此函式已淘汰，不應在新的指令碼中使用。

取得一系列子網頁 (直接和間接網頁)，但上限為 200 頁。

var site = SitesApp.getSite("example.com", "mysite");
var pages = site.getAllDescendants();

回攻員

Page[]：直接和間接子網頁的陣列

授權

使用這個方法的指令碼必須取得以下一或多個範圍的授權：

• https://sites.google.com/feeds

---

getAllDescendants(options)

已淘汰。此函式已淘汰，不應在新的指令碼中使用。

取得包含選用進階引數的子系頁面陣列。

var site = SitesApp.getSite("example.com", "mysite");
var descendants = site.getAllDescendants({
  type: SitesApp.PageType.WEB_PAGE,
  start: 0,
  max: 25,
  includeDrafts: false,
  includeDeleted: true,
  search: "target"
});

for(var i in descendants) {
  Logger.log(descendants[i].getName());
}

參數

名稱	類型	說明
options	Object	下方「進階引數」一節中定義的 JavaScript 物件欄位

進階參數

名稱	類型	說明
type	PageType[]	只取得這類網頁
start	Integer	由此開始結果
max	Integer	結果數量上限 (預設為 200)
includeDrafts	Boolean	是否要包含草稿頁面 (預設為 false)
includeDeleted	Boolean	是否要納入已刪除的網頁 (預設為 false)
search	String	只傳回與這項查詢相符的網頁

回攻員

Page[]：屬於指定類型的直接和間接子網頁陣列

授權

使用這個方法的指令碼必須取得以下一或多個範圍的授權：

• https://sites.google.com/feeds

---

getAnnouncements()

已淘汰。此函式已淘汰，不應在新的指令碼中使用。

接收這個頁面的公告。僅適用於公告網頁。

var site = SitesApp.getSite("example.com", "mysite");

// This snippet will only work with announcement pages - this is different
// from a page that is an announcement (individual announcements). To check
// if this method can be called:
//    if(page.getPageType() == SitesApp.PageType.ANNOUNCEMENTS_PAGE))
var page = site.getChildByName("news");
var announcements = page.getAnnouncements();

for(var i in announcements) {
  Logger.log(announcements[i].getHtmlContent());
}

回攻員

Page[]：公告陣列

擲回

Error — 適用於非公告頁面

授權

使用這個方法的指令碼必須取得以下一或多個範圍的授權：

• https://sites.google.com/feeds

---

getAnnouncements(optOptions)

已淘汰。此函式已淘汰，不應在新的指令碼中使用。

接收這個頁面的公告。僅適用於公告網頁。

var site = SitesApp.getSite("example.com", "mysite");

// This snippet will only work with announcement pages - this is different
// from a page that is an announcement (individual announcements). To check
// if this method can be called:
//    if(page.getPageType() == SitesApp.PageType.ANNOUNCEMENTS_PAGE))
var page = site.getChildByName("news");
var announcements = page.getAnnouncements({ start: 0,
                                            max: 20,
                                            includeDrafts: false,
                                            includeDeleted: false,
                                            search: "Breaking" });

for(var i in announcements) {
  Logger.log(announcements[i].getHtmlContent());
}

參數

名稱	類型	說明
optOptions	Object	包含進階參數的 JavaScript 物件

進階參數

名稱	類型	說明
start	Integer	結果的起始索引
max	Integer	要傳回的結果數量上限 (預設為 (不超過 200 個))
includeDrafts	Boolean	是否要包含草稿頁面 (預設為 false)
includeDeleted	Boolean	是否要納入已刪除的網頁 (預設為 false)
search	String	只傳回與這項查詢相符的網頁

回攻員

Page[]：公告陣列

擲回

Error — 適用於非公告頁面

授權

使用這個方法的指令碼必須取得以下一或多個範圍的授權：

• https://sites.google.com/feeds

---

getAttachments()

已淘汰。此函式已淘汰，不應在新的指令碼中使用。

取得這個頁面的附件。

var site = SitesApp.getSite("example.com", "mysite");
var page = site.getChildren()[0];

var attachments = page.getAttachments();
for(var i in attachments) {
  Logger.log(attachments[i].getTitle());
}

回攻員

Attachment[]：附件陣列

授權

使用這個方法的指令碼必須取得以下一或多個範圍的授權：

• https://sites.google.com/feeds

---

getAttachments(optOptions)

已淘汰。此函式已淘汰，不應在新的指令碼中使用。

取得這個頁面的附件。

var site = SitesApp.getSite("example.com", "mysite");
var page = site.getChildren()[0];

// This returns only one attachment
var attachments = page.getAttachments({ start: 0, max: 1});
for(var i in attachments) {
  Logger.log(attachments[i].getTitle());
}

參數

名稱	類型	說明
optOptions	Object	包含選用參數的 JavaScript 物件

進階參數

名稱	類型	說明
start	Integer	用來開始傳回附件的第一個索引
max	Integer	要傳回的結果數量上限 (預設為 (不超過 200 個))

回攻員

Attachment[]：附件陣列

授權

使用這個方法的指令碼必須取得以下一或多個範圍的授權：

• https://sites.google.com/feeds

---

getAuthors()

已淘汰。此函式已淘汰，不應在新的指令碼中使用。

取得網頁作者的電子郵件

var site = SitesApp.getSite("example.com", "mysite");
var page = site.getChildren()[0];
var authors = page.getAuthors();

for(var i in authors) {
  Logger.log(authors[i]);
}

回攻員

String[]：作者電子郵件地址陣列

授權

使用這個方法的指令碼必須取得以下一或多個範圍的授權：

• https://sites.google.com/feeds

---

getChildByName(name)

已淘汰。此函式已淘汰，不應在新的指令碼中使用。

取得特定的子頁面。

var site = SitesApp.getSite("example.com", "mysite");
var pages = site.getChildByName("childPage");

參數

名稱	類型	說明
name	String	子頁面名稱

回攻員

Page：子頁面

授權

使用這個方法的指令碼必須取得以下一或多個範圍的授權：

• https://sites.google.com/feeds

---

getChildren()

已淘汰。此函式已淘汰，不應在新的指令碼中使用。

取得子頁面的陣列，上限為 200 頁。

var site = SitesApp.getSite("example.com", "mysite");
var pages = site.getChildren();

回攻員

Page[]：一系列直接子網頁

授權

使用這個方法的指令碼必須取得以下一或多個範圍的授權：

• https://sites.google.com/feeds

---

getChildren(options)

已淘汰。此函式已淘汰，不應在新的指令碼中使用。

取得子頁面的陣列，以及選用的進階引數。

var site = SitesApp.getSite("example.com", "mysite");
var childPages = site.getChildren({
  type: SitesApp.PageType.WEB_PAGE,
  start: 0,
  max: 25,
  includeDrafts: false,
  includeDeleted: true,
  search: "target"
});

for(var i in childPages) {
  Logger.log(childPages[i].getName());
}

參數

名稱	類型	說明
options	Object	下方「進階引數」一節中定義的 JavaScript 物件欄位

進階參數

名稱	類型	說明
type	PageType[]	只取得這類網頁
start	Integer	由此開始結果
max	Integer	結果數量上限 (預設為 200)
includeDrafts	Boolean	是否要包含草稿頁面 (預設為 false)
includeDeleted	Boolean	是否要納入已刪除的網頁 (預設為 false)
search	String	只傳回與這項查詢相符的網頁

回攻員

Page[]：特定類型的直接子網頁陣列

授權

使用這個方法的指令碼必須取得以下一或多個範圍的授權：

• https://sites.google.com/feeds

---

getColumns()

已淘汰。此函式已淘汰，不應在新的指令碼中使用。

取得清單的資料欄。這項參數僅適用於清單頁面。

var site = SitesApp.getSite("example.com", "mysite");

var page = site.getChildByName("listpage");
// Only valid on List pages. Check for the type like so:
//     if(page.getPageType() == SitesApp.PageType.LIST_PAGE))
var columns = page.getColumns();

for(var i in columns) {
  Logger.log(columns[i].getName());
}

回攻員

Column[]：Column 執行個體的陣列

擲回

Error — 適用於非清單頁面的網頁

授權

使用這個方法的指令碼必須取得以下一或多個範圍的授權：

• https://sites.google.com/feeds

---

getComments()

已淘汰。此函式已淘汰，不應在新的指令碼中使用。

已淘汰，取得這個頁面的留言。

var site = SitesApp.getSite("example.com", "mysite");
var page = site.getChildren()[0];

var comments = page.getComments();
for(var i in comments) {
  Logger.log(comments[i].getContent());
}

回攻員

Comment[]：Comment 陣列。

授權

使用這個方法的指令碼必須取得以下一或多個範圍的授權：

• https://sites.google.com/feeds

---

getComments(optOptions)

已淘汰。此函式已淘汰，不應在新的指令碼中使用。

已淘汰，取得這個頁面的留言。

var site = SitesApp.getSite("example.com", "mysite");
var page = site.getChildren()[0];

// Return only one comment
var comments = page.getComments({ start:0, max: 1});
for(var i in comments) {
  Logger.log(comments[i].getContent());
}

參數

名稱	類型	說明
optOptions	Object	包含選用參數的 JavaScript 物件

進階參數

名稱	類型	說明
start	Integer	指定第一個索引
max	Integer	要傳回的結果數量上限 (預設為 (不超過 200 個))

回攻員

Comment[]：Comment 陣列。

授權

使用這個方法的指令碼必須取得以下一或多個範圍的授權：

• https://sites.google.com/feeds

---

getDatePublished()

已淘汰。此函式已淘汰，不應在新的指令碼中使用。

傳回網頁首次發布的日期。

var site = SitesApp.getSite("example.com", "mysite");
var page = site.getChildren()[0];
Logger.log(page.getName() + " was published " + page.getDatePublished());

回攻員

Date：原始發布日期

授權

使用這個方法的指令碼必須取得以下一或多個範圍的授權：

• https://sites.google.com/feeds

---

getHtmlContent()

已淘汰。此函式已淘汰，不應在新的指令碼中使用。

取得網頁的 HTML 內容。

var site = SitesApp.getSite("example.com", "mysite");
var page = site.getChildren()[0];
Logger.log(page.getHtmlContent());

回攻員

String：HTML 內容

授權

使用這個方法的指令碼必須取得以下一或多個範圍的授權：

• https://sites.google.com/feeds

---

getIsDraft()

已淘汰。此函式已淘汰，不應在新的指令碼中使用。

傳回網頁是否處於草稿模式。僅適用於公告。

var site = SitesApp.getSite("example.com", "mysite");
var page = site.getChildren()[0];

Logger.log("Is this Announcement Page a draft?", page.getIsDraft());

回攻員

Boolean：是否頁面處於草稿模式

授權

使用這個方法的指令碼必須取得以下一或多個範圍的授權：

• https://sites.google.com/feeds

---

getLastEdited()

已淘汰。此函式已淘汰，不應在新的指令碼中使用。

傳回上次編輯日期，該日期僅包含編輯內容。

var site = SitesApp.getSite("example.com", "mysite");
var page = site.getChildren()[0];
Logger.log(page.getName() + " was last updated " + page.getLastEdited());

回攻員

Date：頁面上次更新的日期，僅包含編輯內容

授權

使用這個方法的指令碼必須取得以下一或多個範圍的授權：

• https://sites.google.com/feeds

---

getLastUpdated()

已淘汰。此函式已淘汰，不應在新的指令碼中使用。

傳回上次更新日期，包括移動等非內容變更。

var site = SitesApp.getSite("example.com", "mysite");
var page = site.getChildren()[0];
Logger.log(page.getName() + " was last updated " + page.getLastUpdated());

回攻員

Date：上次更新非內容變更的日期

授權

使用這個方法的指令碼必須取得以下一或多個範圍的授權：

• https://sites.google.com/feeds

---

getListItems()

已淘汰。此函式已淘汰，不應在新的指令碼中使用。

取得清單項目。這項參數僅適用於清單頁面。

var site = SitesApp.getSite("example.com", "mysite");

var page = site.getChildByName("listpage");
// Only valid on List pages. Check for the type like so:
//     if(page.getPageType() == SitesApp.PageType.LIST_PAGE))
var items = page.getListItems();

for(var i in items) {
  Logger.log(items[i].getValueByName("Status"));
}

回攻員

ListItem[]：ListItem 執行個體的陣列

擲回

Error — 適用於非清單頁面的網頁

授權

使用這個方法的指令碼必須取得以下一或多個範圍的授權：

• https://sites.google.com/feeds

---

getListItems(optOptions)

已淘汰。此函式已淘汰，不應在新的指令碼中使用。

取得清單項目。這項參數僅適用於清單頁面。

var site = SitesApp.getSite("example.com", "mysite");

var page = site.getChildByName("listpage");
// Only valid on List pages. Check for the type like so:
//     if(page.getPageType() == SitesApp.PageType.LIST_PAGE))
// Returns only one item
var items = page.getListItems({ start:0, max: 1 });

for(var i in items) {
  Logger.log(items[i].getValueByName("Status"));
}

參數

名稱	類型	說明
optOptions	Object	選用參數的 JavaScript 物件

進階參數

名稱	類型	說明
start	Integer	開始疊代
max	Integer	要傳回的結果數量上限 (預設為 (不超過 200 個))

回攻員

ListItem[]：ListItem 執行個體的陣列

擲回

Error — 適用於非清單頁面的網頁

授權

使用這個方法的指令碼必須取得以下一或多個範圍的授權：

• https://sites.google.com/feeds

---

getName()

已淘汰。此函式已淘汰，不應在新的指令碼中使用。

傳回網頁名稱。

var site = SitesApp.getSite("example.com", "mysite");
var page = site.getChildren()[0];
Logger.log(page.getName());

回攻員

String：本頁名稱

授權

使用這個方法的指令碼必須取得以下一或多個範圍的授權：

• https://sites.google.com/feeds

---

getPageName()

已淘汰。此函式已淘汰，不應在新的指令碼中使用。

已淘汰，已替換為 getName，以便保持一致。

var site = SitesApp.getSite("example.com", "mysite");
var page = site.getChildren()[0];
Logger.log(page.getPageName());

回攻員

String：本頁名稱

授權

使用這個方法的指令碼必須取得以下一或多個範圍的授權：

• https://sites.google.com/feeds

---

getPageType()

已淘汰。此函式已淘汰，不應在新的指令碼中使用。

將這個網頁的類型傳回 SitesApp.PageType 列舉。

var site = SitesApp.getSite("example.com", "mysite");
var page = site.getChildren()[0];
var pageType = page.getPageType();
if(pageType == SitesApp.PageType.WEB_PAGE) {
   Logger.log(page.getName() + " is a Web Page");
}

回攻員

PageType：PageType 列舉，指出這是網頁、清單、公告或檔案櫃頁面

授權

使用這個方法的指令碼必須取得以下一或多個範圍的授權：

• https://sites.google.com/feeds

---

getParent()

已淘汰。此函式已淘汰，不應在新的指令碼中使用。

傳回這個網頁的上層。

var site = SitesApp.getSite("example.com", "mysite");
var page = site.getChildren()[0];
Logger.log(page.getName() + " parent: " + page.getParent().getName());

回攻員

Page：這個頁面的上層頁面

授權

使用這個方法的指令碼必須取得以下一或多個範圍的授權：

• https://sites.google.com/feeds

---

getSelfLink()

已淘汰。此函式已淘汰，不應在新的指令碼中使用。

已淘汰，傳回這個網頁的 gData 動態饋給連結。

var site = SitesApp.getSite("example.com", "mysite");
var page = site.getChildren()[0];
Logger.log(page.getSelfLink());

回攻員

String：gData 動態饋給連結

授權

使用這個方法的指令碼必須取得以下一或多個範圍的授權：

• https://sites.google.com/feeds

---

getTextContent()

已淘汰。此函式已淘汰，不應在新的指令碼中使用。

傳回純文字網頁內容。

var site = SitesApp.getSite("example.com", "mysite");
var page = site.getChildren()[0];
Logger.log(page.getName() + " content: " + page.getTextContent());

回攻員

String：網頁的純文字內容

授權

使用這個方法的指令碼必須取得以下一或多個範圍的授權：

• https://sites.google.com/feeds

---

getTitle()

已淘汰。此函式已淘汰，不應在新的指令碼中使用。

傳回網頁標題。

var site = SitesApp.getSite("example.com", "mysite");
var page = site.getChildren()[0];
Logger.log(page.getTitle());

回攻員

String：本頁標題

授權

使用這個方法的指令碼必須取得以下一或多個範圍的授權：

• https://sites.google.com/feeds

---

getUrl()

已淘汰。此函式已淘汰，不應在新的指令碼中使用。

取得網頁的網址。

var site = SitesApp.getSite("example.com", "mysite");
var page = site.getChildren()[0];
Logger.log(page.getUrl());

回攻員

String：網頁的網址

授權

使用這個方法的指令碼必須取得以下一或多個範圍的授權：

• https://sites.google.com/feeds

---

isDeleted()

已淘汰。此函式已淘汰，不應在新的指令碼中使用。

傳回網頁是否已刪除。

回攻員

Boolean：網頁是否已刪除

授權

使用這個方法的指令碼必須取得以下一或多個範圍的授權：

• https://sites.google.com/feeds

---

isTemplate()

已淘汰。此函式已淘汰，不應在新的指令碼中使用。

傳回這個頁面是否為可複製的範本。

var site = SitesApp.getSite("example.com", "mysite");
var firstTemplate = site.getTemplates()[0];
if(firstTemplate.isTemplate()) {
  Logger.log("This will always return true");
}

回攻員

Boolean：確認這個頁面是否為範本

授權

使用這個方法的指令碼必須取得以下一或多個範圍的授權：

• https://sites.google.com/feeds

---

publishAsTemplate(name)

已淘汰。此函式已淘汰，不應在新的指令碼中使用。

將這個頁面發布為可複製的範本。

var site = SitesApp.getSite("example.com", "mysite");
var page = site.getChildren()[0];

// Turn this page into a publishable template
page.publishedAsTemplate("template-name");

參數

名稱	類型	說明
name	String	新範本的名稱

回攻員

Page：新發布的範本

授權

使用這個方法的指令碼必須取得以下一或多個範圍的授權：

• https://sites.google.com/feeds

---

search(query)

已淘汰。此函式已淘汰，不應在新的指令碼中使用。

取得與搜尋查詢相符的子系網頁陣列，上限為 200 頁。

var site = SitesApp.getSite("example.com", "mysite");
var matches = site.search("targetText");

for(var i in matches) {
  Logger.log(matches[i].getName());
}

參數

名稱	類型	說明
query	String	要比對的完整文字搜尋查詢

回攻員

Page[]：屬於指定類型的直接和間接子網頁陣列

授權

使用這個方法的指令碼必須取得以下一或多個範圍的授權：

• https://sites.google.com/feeds

---

search(query, options)

已淘汰。此函式已淘汰，不應在新的指令碼中使用。

取得與搜尋查詢相符的子系網頁陣列，以及選用的進階引數。

var site = SitesApp.getSite("example.com", "mysite");
var childPages = site.getChildren({
  type: SitesApp.PageType.WEB_PAGE,
  start: 0,
  max: 25,
  includeDrafts: false,
  includeDeleted: true,
  search: "target"
});

for(var i in childPages) {
  Logger.log(childPages[i].getName());
}

參數

名稱	類型	說明
query	String	要比對的完整文字搜尋查詢
options	Object	下方「進階引數」一節中定義的 JavaScript 物件欄位

進階參數

名稱	類型	說明
type	PageType[]	只取得這類網頁
start	Integer	由此開始結果
max	Integer	結果數量上限 (預設為 200)
includeDrafts	Boolean	是否要包含草稿頁面 (預設為 false)
includeDeleted	Boolean	是否要納入已刪除的網頁 (預設為 false)

回攻員

Page[]：屬於指定類型的直接和間接子網頁陣列

授權

使用這個方法的指令碼必須取得以下一或多個範圍的授權：

• https://sites.google.com/feeds

---

setHtmlContent(html)

已淘汰。此函式已淘汰，不應在新的指令碼中使用。

設定網頁的 HTML 內容。

var site = SitesApp.getSite("example.com", "mysite");
var page = site.getChildren()[0];
page.setHtmlContent("<h1>New Page Content</h1>");

參數

名稱	類型	說明
html	String	新內容

回攻員

Page — 這個頁面 (用於鏈結)

授權

使用這個方法的指令碼必須取得以下一或多個範圍的授權：

• https://sites.google.com/feeds

---

setIsDraft(draft)

已淘汰。此函式已淘汰，不應在新的指令碼中使用。

設定網頁是否處於草稿模式。僅適用於公告。

var site = SitesApp.getSite("example.com", "mysite");
var page = site.getChildren()[0];

// Take the page out of draft mode
page.setIsDraft(false);

參數

名稱	類型	說明
draft	Boolean	新的狀態

回攻員

Page — 這個頁面 (用於鏈結)

授權

使用這個方法的指令碼必須取得以下一或多個範圍的授權：

• https://sites.google.com/feeds

---

setName(name)

已淘汰。此函式已淘汰，不應在新的指令碼中使用。

設定此頁面的名稱。

var site = SitesApp.getSite("example.com", "mysite");
var page = site.getChildren()[0];
page.setName("new-name");

參數

名稱	類型	說明
name	String	新的名稱

回攻員

Page — 這個頁面 (用於鏈結)

授權

使用這個方法的指令碼必須取得以下一或多個範圍的授權：

• https://sites.google.com/feeds

---

setParent(parent)

已淘汰。此函式已淘汰，不應在新的指令碼中使用。

設定這個頁面的上層項目。

var site = SitesApp.getSite("example.com", "mysite");
var child = site.getChildByName("childToBeMoved");
var parent = site.getChildByName("newParent");
child.setParent(parent);

參數

名稱	類型	說明
parent	Page	新的父項

回攻員

Page — 這個頁面 (用於鏈結)

授權

使用這個方法的指令碼必須取得以下一或多個範圍的授權：

• https://sites.google.com/feeds

---

setTitle(title)

已淘汰。此函式已淘汰，不應在新的指令碼中使用。

設定網頁標題。

var site = SitesApp.getSite("example.com", "mysite");
var page = site.getChildren()[0];
page.setTitle("New Title");

參數

名稱	類型	說明
title	String	新標題

回攻員

Page — 這個頁面 (用於鏈結)

授權

使用這個方法的指令碼必須取得以下一或多個範圍的授權：

• https://sites.google.com/feeds