Class ListItem

ListItem

Obsoleto. Esta clase dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Un ListItem de Sites: un elemento de lista de una página de lista de Sites.

Métodos obsoletos

Método	Tipo de datos que se muestra	Descripción breve
deleteListItem()	void	Borra este elemento de la lista.
getDatePublished()	Date	Muestra la fecha en que se publicó este elemento de la lista por primera vez.
getLastUpdated()	Date	Muestra la fecha en la que se actualizó este comentario por última vez.
getParent()	Page	Obtén la página superior de este elemento de la lista.
getValueByIndex(index)	String	Obtén el valor de este ListItem para una columna numerada.
getValueByName(name)	String	Obtén el valor de este ListItem para una columna con nombre.
setParent(parent)	ListItem	Establecer la página superior de este elemento de la lista.
setValueByIndex(index, value)	ListItem	Configura el valor de este ListItem para una columna numerada.
setValueByName(name, value)	ListItem	Configura el valor de este ListItem para una columna numerada.

Métodos obsoletos

deleteListItem()

Obsoleto. Esta función dejó de estar disponible y no debería usarse en secuencias de comandos nuevas.

Borra este elemento de la lista.

// 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();
}

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

---

getDatePublished()

Obsoleto. Esta función dejó de estar disponible y no debería usarse en secuencias de comandos nuevas.

Muestra la fecha en que se publicó este elemento de la lista por primera vez.

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

Volver

Date: Es la fecha de la publicación original.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

---

getLastUpdated()

Obsoleto. Esta función dejó de estar disponible y no debería usarse en secuencias de comandos nuevas.

Muestra la fecha en la que se actualizó este comentario por última vez.

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

Volver

Date: la fecha de la última actualización

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

---

getParent()

Obsoleto. Esta función dejó de estar disponible y no debería usarse en secuencias de comandos nuevas.

Obtén la página superior de este elemento de la lista.

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

Volver

Page: Es la página superior.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

---

getValueByIndex(index)

Obsoleto. Esta función dejó de estar disponible y no debería usarse en secuencias de comandos nuevas.

Obtén el valor de este ListItem para una columna numerada.

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);

Parámetros

Nombre	Tipo	Descripción
index	Integer	la columna para obtener el valor de

Volver

String: Es el valor de esa columna.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

---

getValueByName(name)

Obsoleto. Esta función dejó de estar disponible y no debería usarse en secuencias de comandos nuevas.

Obtén el valor de este ListItem para una columna con nombre.

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);

Parámetros

Nombre	Tipo	Descripción
name	String	la columna para obtener el valor de

Volver

String: Es el valor de esa columna.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

---

setParent(parent)

Obsoleto. Esta función dejó de estar disponible y no debería usarse en secuencias de comandos nuevas.

Establecer la página superior de este elemento de la lista.

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();

Parámetros

Nombre	Tipo	Descripción
parent	Page	la madre o el padre nuevo

Volver

ListItem: Es este ListItem para el encadenamiento.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

---

setValueByIndex(index, value)

Obsoleto. Esta función dejó de estar disponible y no debería usarse en secuencias de comandos nuevas.

Configura el valor de este ListItem para una columna numerada. Para las columnas de URL, el valor debe ser un Etiqueta de anclaje XHTML con entidades XML escapadas.

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>');

Parámetros

Nombre	Tipo	Descripción
index	Integer	la columna para establecer el valor de
value	String	el valor nuevo

Volver

ListItem: Es este ListItem para el encadenamiento.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

---

setValueByName(name, value)

Obsoleto. Esta función dejó de estar disponible y no debería usarse en secuencias de comandos nuevas.

Configura el valor de este ListItem para una columna numerada. Para las columnas de URL, el valor debe ser un Etiqueta de anclaje XHTML con entidades XML escapadas.

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>');

Parámetros

Nombre	Tipo	Descripción
name	String	la columna para establecer el valor de
value	String	el valor nuevo

Volver

ListItem: Es este ListItem para el encadenamiento.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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