Listelerle çalışma

Google Dokümanlar API'si, düz paragrafları madde işaretli listelere dönüştürmeyi ve paragraflardan madde işaretlerini kaldırmayı destekler.

Paragrafı listeye dönüştürme

Yaygın bir paragraf biçimlendirme işlemi, paragrafları madde işaretli listeye dönüştürmektir.

Liste oluşturmak için documents.batchUpdate yöntemini kullanın ve CreateParagraphBulletsRequest sağlayın. Etkilenen hücreleri belirtmek için Range, madde işaretinin kalıbını ayarlamak için BulletGlyphPreset ekleyin.

Belirtilen aralıkla çakışan tüm paragraflar madde işaretli olarak gösterilir. Belirtilen aralık bir tabloyla çakışıyorsa madde işaretleri tablo hücrelerine uygulanır. Her paragrafın iç içe yerleştirme düzeyi, her paragrafın önündeki baştaki sekmeler sayılarak belirlenir.

Mevcut bir madde işaretinin iç içe yerleştirme düzeyini ayarlayamazsınız. Bunun yerine madde işaretini silmeniz, paragrafın önüne girinti sekmelerini yerleştirmeniz ve ardından madde işaretini yeniden oluşturmanız gerekir. Daha fazla bilgi için Listeden madde işaretlerini kaldırma başlıklı makaleyi inceleyin.

Mevcut bir listenin madde işareti stilini değiştirmek için CreateParagraphBulletsRequest simgesini de kullanabilirsiniz.

Aşağıdaki kod örneğinde, önce belgenin başına metin ekleyen, ardından ilk 50 karakteri kapsayan paragraflardan bir liste oluşturan bir toplu istek gösterilmektedir. BulletGlyphPreset kullanır.BULLET_ARROW_DIAMOND_DISC Bu, madde işaretli listenin ilk üç iç içe yerleştirme düzeyinin ok, elmas ve disk ile temsil edildiği anlamına gelir.

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()
Paragrafı listeye dönüştürme
1.şekil Paragrafı listeye dönüştürme

Listeden madde işaretlerini kaldırma

Paragraf listesinden madde işaretlerini kaldırmak için documents.batchUpdate<0x0x0A>yöntemini kullanın ve bir DeleteParagraphBulletsRequest sağlayın. Etkilenen hücreleri belirtmek için Range ekleyin.

Bu yöntem, iç içe yerleştirme düzeyinden bağımsız olarak, belirtilen aralıkla çakışan tüm madde işaretlerini siler. İç içe yerleştirme düzeyini görsel olarak korumak için ilgili her paragrafın başına girinti eklenir.

Aşağıdaki kod örneğinde, bir paragraf listesinden madde işaretlerini silen bir toplu istek gösterilmektedir.

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