Class ListItem

ListItem

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

פריט רשימה של Google Sites - רכיב רשימה מדף רשימה של אתרים.

שיטות שהוצאו משימוש

שיטה	סוג הערך המוחזר	תיאור קצר
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