此页面由 Cloud Translation API 翻译。

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