Class ListItem

ListItem

Obsoleto. Essa classe foi descontinuada e não deve ser usada em novos scripts.

Um ListItem de sites - um elemento de lista de uma página da Lista de sites.

Métodos obsoletos

Método	Tipo de retorno	Breve descrição
deleteListItem()	void	Exclui este item da lista.
getDatePublished()	Date	Retorna a data em que o item da lista foi publicado pela primeira vez.
getLastUpdated()	Date	Retorna a data em que este comentário foi atualizado pela última vez.
getParent()	Page	Acessa a página mãe desse item da lista.
getValueByIndex(index)	String	Extrai o valor desse ListItem para uma coluna numerada.
getValueByName(name)	String	Extrai o valor desse ListItem para uma coluna nomeada.
setParent(parent)	ListItem	Define a página mãe desse item da lista.
setValueByIndex(index, value)	ListItem	Defina o valor desse ListItem para uma coluna numerada.
setValueByName(name, value)	ListItem	Defina o valor desse ListItem para uma coluna numerada.

Métodos obsoletos

deleteListItem()

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Exclui este item da 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();
}

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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

---

getDatePublished()

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Retorna a data em que o item da lista foi publicado pela primeira vez.

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

Retornar

Date: a data da publicação original

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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

---

getLastUpdated()

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Retorna a data em que este comentário foi atualizado pela última vez.

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

Retornar

Date: a data da última atualização

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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

---

getParent()

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Acessa a página mãe desse item da lista.

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

Retornar

Page: a página principal

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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

---

getValueByIndex(index)

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Extrai o valor desse ListItem para uma coluna 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

Nome	Tipo	Descrição
index	Integer	na coluna para obter o valor

Retornar

String: o valor dessa coluna.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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

---

getValueByName(name)

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Extrai o valor desse ListItem para uma coluna nomeada.

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

Nome	Tipo	Descrição
name	String	na coluna para obter o valor

Retornar

String: o valor dessa coluna.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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

---

setParent(parent)

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Define a página mãe desse item da 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

Nome	Tipo	Descrição
parent	Page	o novo pai

Retornar

ListItem: este ListItem para encadeamento

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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

---

setValueByIndex(index, value)

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Defina o valor desse ListItem para uma coluna numerada. Para colunas de URL, o valor deve ser uma Tag âncora Xcode, com entidades XML com escape.

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

Nome	Tipo	Descrição
index	Integer	na coluna em que é definido o valor
value	String	o novo valor

Retornar

ListItem: este ListItem para encadeamento

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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

---

setValueByName(name, value)

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Defina o valor desse ListItem para uma coluna numerada. Para colunas de URL, o valor deve ser uma Tag âncora Xcode, com entidades XML com escape.

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

Nome	Tipo	Descrição
name	String	na coluna em que é definido o valor
value	String	o novo valor

Retornar

ListItem: este ListItem para encadeamento

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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