Listelerle çalışma

Google Docs API, düz paragrafların madde işaretli listelere ve paragraflardan madde işaretlerini kaldırabilirsiniz.

Bir paragrafı listeye dönüştürme

Yaygın bir paragraf biçimlendirme işlemi, paragrafları madde işaretli liste'ye dokunun.

Liste oluşturmak için documents.batchUpdate yöntemini kullanarak CreateParagraphBulletsRequest. Bir Range belirtmek için ve bir BulletGlyphPreset tıklayın.

Belirtilen aralıkla çakışan tüm paragraflar madde işaretiyle gösterilir. Belirtilen aralık bir tabloyla çakışıyorsa, madde işaretleri tablo hücrelerine uygulanır. İlgili içeriği oluşturmak için kullanılan iç içe yerleştirme düzeyi, önündeki sekmeler sayılarak belirlenir bölümünü içerir.

Mevcut bir madde işaretinin iç içe yerleştirme seviyesini ayarlayamazsınız. Bunun yerine, madde işaretini silmeniz, önündeki sekmeleri madde işaretini yeniden oluşturabilirsiniz. Daha fazla bilgi için bkz. Kaldırma madde işaretleridir.

Ayrıca, CreateParagraphBulletsRequest kısayolunu kullanarak madde işareti stilini değiştirebilirsiniz: liste ekleyebilirsiniz.

Aşağıdaki kod örneğinde, ilk olarak dokümanın başını yapar ve ardından, dokümandaki emin olmanız gerekir. BulletGlyphPreset, BULLET_ARROW_DIAMOND_DISC Bu, madde işaretli liste bir ok, elmas ve diskle temsil edilir.

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()
Bir paragrafı listeye dönüştürebilirsiniz.
Şekil 1. Bir paragrafı listeye dönüştürün.

Listeden madde işaretlerini kaldırma

Bir paragraf listesinden madde işaretlerini kaldırmak için documents.batchUpdate yöntemini kullanarak DeleteParagraphBulletsRequest. Bir Range belirtmek için sağlayabilir.

Bu yöntem, ne olursa olsun belirli aralıkla çakışan tüm madde işaretlerini siler iç içe yerleştirme seviyesi. İç içe yerleştirme düzeyini görsel olarak korumak için, başına boşluk ekleyin.

Aşağıdaki kod örneğinde, bir paragraf listesi.

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()