このページは Cloud Translation API によって翻訳されました。

リストを操作する

Google Docs API は、シンプルな段落を箇条書きリストに変換し、段落からの箇条書きの削除も行います

段落をリストに変換する

一般的な段落の書式設定操作では、段落を箇条書きに変換します。選択します。

リストを作成するには、 documents.batchUpdate メソッドを呼び出し、 CreateParagraphBulletsRequest。 Range を追加して、影響を受けた細胞、 BulletGlyphPreset 箇条書きのパターンを設定します

指定した範囲と重複するすべての段落には箇条書きで表示されます。もし範囲が表と重複している場合、表のセル内に箇条書きが適用されます。「各段落のネストレベルは、先頭のタブの数を数えることによって決定されます確認します

既存の箇条書きのネストレベルは変更できません。代わりに、箇条書きを削除し、先頭のタブを箇条書きを再度作成します。詳しくは、削除箇条書きにする。

CreateParagraphBulletsRequest を使用して、表の箇条書きスタイルを変更することもできます。追加することもできます

次のコードサンプルは、最初にドキュメントの先頭の 1 つから始まり、制限します。BulletGlyphPreset は BULLET_ARROW_DIAMOND_DISC は、最初の 3 つのネストレベルを箇条書きは矢印、ひし形、円で表される。

Java

List<Request> requests = new ArrayList<>();
requests.add(new Request().setInsertText(new InsertTextRequest()
        .setText("Item One\n")
        .setLocation(new Location().setIndex(1).setTabId(TAB_ID))));

requests.add(new Request().setCreateParagraphBullets(
        new CreateParagraphBulletsRequest()
                .setRange(new Range()
                        .setStartIndex(1)
                        .setEndIndex(50)
                        .setTabId(TAB_ID))
                .setBulletPreset("BULLET_ARROW_DIAMOND_DISC")));

BatchUpdateDocumentRequest body = new BatchUpdateDocumentRequest().setRequests(requests);
BatchUpdateDocumentResponse response = docsService.documents()
        .batchUpdate(DOCUMENT_ID, body).execute();

Python

requests = [
        {
        'insertText': {
            'location': {
                'index': 1,
                'tabId': TAB_ID
            },
            'text': 'Item One\n',
        }}, {
        'createParagraphBullets': {
            'range': {
                'startIndex': 1,
                'endIndex':  50,
                'tabId': TAB_ID
            },
            'bulletPreset': 'BULLET_ARROW_DIAMOND_DISC',
        }
    }
]

result = service.documents().batchUpdate(
    documentId=DOCUMENT_ID, body={'requests': requests}).execute()

リストから箇条書き記号を削除する

段落リストから箇条書きを削除するには、 documents.batchUpdate メソッドを呼び出し、 DeleteParagraphBulletsRequest。 Range を追加して、表示されます。

このメソッドは、指定した範囲と重複するすべての箇条書きを削除します。指定します。ネストレベルを視覚的に維持するために、インデントが対応する各段落の先頭に配置されます。

次のコードサンプルは、弾丸を削除するバッチリクエストを示しています。段落リストを使用できます。

Java

List<Request> requests = new ArrayList<>();
requests.add(new Request().setDeleteParagraphBullets(
        new DeleteParagraphBulletsRequest()
                .setRange(new Range()
                        .setStartIndex(1)
                        .setEndIndex(50)
                        .setTabId(TAB_ID))));

BatchUpdateDocumentRequest body = new BatchUpdateDocumentRequest().setRequests(requests);
BatchUpdateDocumentResponse response = docsService.documents()
        .batchUpdate(DOCUMENT_ID, body).execute();

Python

requests = [
        {
        'deleteParagraphBullets': {
            'range': {
                'startIndex': 1,
                'endIndex':  50,
                'tabId': TAB_ID
            },
        }
    }
]

result = service.documents().batchUpdate(
    documentId=DOCUMENT_ID, body={'requests': requests}).execute()