Class ListItem

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 – הפריט הזה לשרשרת

הרשאות

לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:

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

---

setValueByIndex(index, value)

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

יש להגדיר את הערך של ListItem בעמודה ממוספרת. בעמודות של כתובות URL, הערך חייב להיות תג עוגן מסוג XHTML, עם ישויות XML שמסומנות בתו בריחה (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>');

פרמטרים

שם	תיאור	התיאור
index	Integer	העמודה כדי להגדיר את הערך
value	String	הערך החדש

החזרות

ListItem – הפריט הזה לשרשרת

הרשאות

לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:

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

---

setValueByName(name, value)

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

יש להגדיר את הערך של ListItem בעמודה ממוספרת. בעמודות של כתובות URL, הערך חייב להיות תג עוגן מסוג XHTML, עם ישויות XML שמסומנות בתו בריחה (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>');

פרמטרים

שם	תיאור	התיאור
name	String	העמודה כדי להגדיר את הערך
value	String	הערך החדש

החזרות

ListItem – הפריט הזה לשרשרת

הרשאות

לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:

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