Class ListItem

Листитем

Устарело. Этот класс устарел и не должен использоваться в новых сценариях.

Sites ListItem — элемент списка со страницы списка сайтов.

Устаревшие методы

Метод	Тип возврата	Краткое описание
deleteListItem()	void	Удаляет этот элемент списка.
getDatePublished()	Date	Возвращает дату первой публикации этого элемента списка.
getLastUpdated()	Date	Возвращает дату последнего обновления этого комментария.
getParent()	Page	Получите родительскую страницу этого элемента списка.
getValueByIndex(index)	String	Получите значение этого ListItem для нумерованного столбца.
getValueByName(name)	String	Получите значение этого ListItem для именованного столбца.
setParent(parent)	ListItem	Установите родительскую страницу этого элемента списка.
setValueByIndex(index, value)	ListItem	Установите значение этого ListItem для нумерованного столбца.
setValueByName(name, value)	ListItem	Установите значение этого ListItem для нумерованного столбца.

Устаревшие методы

deleteListItem()

Устарело. Эта функция устарела и не должна использоваться в новых скриптах.

Удаляет этот элемент списка.

// This code sample deletes all list items from a List page
// Running this code sample against a Page that is a standard web page will
// cause getListItems() to throw an exception
var page = SitesApp.getSite('demositeappsscript').getChildByName('mylistpage');
var items = page.getListItems();
for(var i = 0; i < items.length; i++) {
  items[i].deleteListItem();
}

Авторизация

Скрипты, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

---

getDatePublished()

Устарело. Эта функция устарела и не должна использоваться в новых скриптах.

Возвращает дату первой публикации этого элемента списка.

var page = SitesApp.getSite('example.com', 'mysite').getChildByName('mylistpage');
var items = page.getListItems();
var date = items[0].getDatePublished();

Возвращаться

Date — дата оригинальной публикации.

Авторизация

Скрипты, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

---

getLastUpdated()

Устарело. Эта функция устарела и не должна использоваться в новых скриптах.

Возвращает дату последнего обновления этого комментария.

var page = SitesApp.getSite('example.com', 'mysite').getChildByName('mylistpage');
var items = page.getListItems();
var date = items[0].getLastUpdated();

Возвращаться

Date — дата последнего обновления

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

---

getParent()

Устарело. Эта функция устарела и не должна использоваться в новых скриптах.

Получите родительскую страницу этого элемента списка.

var page = SitesApp.getSite('example.com', 'mysite').getChildByName('mylistpage');
var items = page.getListItems();
// parentPage will equal page
var parentPage = items[0].getParent();

Возвращаться

Page — родительская страница

Авторизация

Скрипты, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

---

getValueByIndex(index)

Устарело. Эта функция устарела и не должна использоваться в новых скриптах.

Получите значение этого ListItem для нумерованного столбца.

var page = SitesApp.getSite("demositeappsscript").getChildByName("mylistpage");
var listItem = page.getListItems()[0];

// Remember that rows are 0 indexed. This returns the item in the first column
// of the list. If an index that is greater than the number of columns is used,
// the script will throw an "InvalidArgument: index" exception.
var value = listItem.getValueByIndex(5);

Параметры

Имя	Тип	Описание
index	Integer	столбец, чтобы получить значение

Возвращаться

String — значение этого столбца

Авторизация

Скрипты, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

---

getValueByName(name)

Устарело. Эта функция устарела и не должна использоваться в новых скриптах.

Получите значение этого ListItem для именованного столбца.

var page = SitesApp.getSite("demositeappsscript").getChildByName("mylistpage");
var listItem = page.getListItems()[0];

// Suppose we have a column named "Owner" - this will let us fetch the value
// for the list item
var value = listItem.getValueByName("Owner");
Logger.log(value);

Параметры

Имя	Тип	Описание
name	String	столбец, чтобы получить значение

Возвращаться

String — значение этого столбца

Авторизация

Скрипты, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

---

setParent(parent)

Устарело. Эта функция устарела и не должна использоваться в новых скриптах.

Установите родительскую страницу этого элемента списка.

var page = SitesApp.getSite('example.com', 'mysite').getChildByName('mylistpage');
var secondListPage = SitesApp.getSite('example.com', 'mysite')
                             .getChildByName('secondlistpage');
var items = page.getListItems();

// Returns secondListPage
var parentPage = items[0].setParent(secondListPage).getParent();

Параметры

Имя	Тип	Описание
parent	Page	новый родитель

Возвращаться

ListItem — этот ListItem для цепочки

Авторизация

Скрипты, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

---

setValueByIndex(index, value)

Устарело. Эта функция устарела и не должна использоваться в новых скриптах.

Установите значение этого ListItem для нумерованного столбца. Для столбцов URL значение должно быть тегом привязки XHTML с экранированными объектами XML.

var page = SitesApp.getSite("example.com", "mysite").getChildByName("mylistpage");
var listItem = page.getListItems()[0];
listItem.setValueByIndex(1, 'This is the new value');
listItem.setValueByIndex(2, '<a href="http://www.example.com?a=1&amp;b=2">Example</a>');

Параметры

Имя	Тип	Описание
index	Integer	столбец для установки значения
value	String	новое значение

Возвращаться

ListItem — этот ListItem для цепочки

Авторизация

Скрипты, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

---

setValueByName(name, value)

Устарело. Эта функция устарела и не должна использоваться в новых скриптах.

Установите значение этого ListItem для нумерованного столбца. Для столбцов URL значение должно быть тегом привязки XHTML с экранированными объектами XML.

var page = SitesApp.getSite("demositeappsscript").getChildByName("mylistpage");
var listItem = page.getListItems()[0];
listItem.setValueByName('Owner', 'Eric');
listItem.setValueByName('Page', '<a href="http://www.example.com?a=1&amp;b=2">Example</a>');

Параметры

Имя	Тип	Описание
name	String	столбец для установки значения
value	String	новое значение

Возвращаться

ListItem — этот ListItem для цепочки

Авторизация

Скрипты, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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