ListItemは、リストIDに関連付けられたParagraph
です。 ListItem
には、方程式、脚注、HorizontalRule、InlineDrawing、InlineImage、PageBreak、およびText要素が含まれることがあります。文書構造の詳細については、guide to extending Google Docsを参照してください。
同じリストIDを持つListItemsは同じリストに属し、それに応じて番号が付けられます。指定されたリストのListItemsは、ドキュメント内で隣接する必要はなく、同じ親要素を持つことさえ必要ではありません。同じリストに属する2つのアイテムは、次の例のように、連続した番号付けを維持しながらドキュメント内のどこにでも存在することができます。
var body = DocumentApp.getActiveDocument().getBody();
// Append a new list item to the body.
var item1 = body.appendListItem('Item 1');
// Log the new list item's list ID.
Logger.log(item1.getListId());
// Append a table after the list item.
body.appendTable([
['Cell 1', 'Cell 2']
]);
// Append a second list item with the same list ID. The two items are treated as the same list,
// despite not being consecutive.
var item2 = body.appendListItem('Item 2');
item2.setListId(item1);