این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

Class ListItem

منسوخ. این کلاس منسوخ شده است و نباید در اسکریپت های جدید استفاده شود.

A 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)`

منسوخ. این تابع منسوخ شده است و نباید در اسکریپت های جدید استفاده شود.

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