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，但不能超过 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，但不能超过 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，但不能超过 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，但不能超过 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 Feed 链接。

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

弃踢回攻

String - gData Feed 链接

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

• 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