Menangani daftar

Google Docs API mendukung konversi paragraf biasa menjadi daftar berbutir dan penghapusan poin dari paragraf.

Mengonversi paragraf menjadi daftar

Operasi pemformatan paragraf yang umum adalah mengonversi paragraf menjadi daftar berbutir.

Untuk membuat daftar, gunakan metode documents.batchUpdate dan berikan CreateParagraphBulletsRequest. Sertakan Range untuk menentukan sel yang terpengaruh dan BulletGlyphPreset untuk menetapkan pola butir.

Semua paragraf yang tumpang-tindih dengan rentang yang diberikan akan diberi poin. Jika rentang yang ditentukan tumpang-tindih dengan tabel, butir akan diterapkan dalam sel tabel. Tingkat sarang setiap paragraf ditentukan dengan menghitung tab utama di depan setiap paragraf.

Anda tidak dapat menyesuaikan tingkat hierarki butir yang ada. Sebagai gantinya, Anda harus menghapus butir, menetapkan tab utama di depan paragraf, lalu membuat butir lagi. Untuk mengetahui informasi selengkapnya, lihat Menghapus butir dari daftar.

Anda juga dapat menggunakan CreateParagraphBulletsRequest untuk mengubah gaya butir untuk daftar yang sudah ada.

Contoh kode berikut menunjukkan permintaan batch yang pertama-tama menyisipkan teks di awal dokumen, lalu membuat daftar dari paragraf yang mencakup 50 karakter pertama. BulletGlyphPreset menggunakan BULLET_ARROW_DIAMOND_DISC yang berarti tiga level bertingkat pertama dari daftar berbutir diwakili oleh panah, berlian, dan disk.

Java

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

      requests.add(new Request().setCreateParagraphBullets(
              new CreateParagraphBulletsRequest()
                      .setRange(new Range()
                              .setStartIndex(1)
                              .setEndIndex(50))
                      .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
                },
                'text': 'Item One\n',
            }}, {
            'createParagraphBullets': {
                'range': {
                    'startIndex': 1,
                    'endIndex':  50
                },
                'bulletPreset': 'BULLET_ARROW_DIAMOND_DISC',
            }
        }
    ]

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

Gambar 1. Mengonversi paragraf menjadi daftar.

Menghapus butir dari daftar

Untuk menghapus butir dari daftar paragraf, gunakan metode documents.batchUpdate dan berikan DeleteParagraphBulletsRequest. Sertakan Range untuk menentukan sel yang terpengaruh.

Metode ini menghapus semua butir yang tumpang-tindih dengan rentang tertentu, terlepas dari tingkat bertingkat. Untuk mempertahankan tingkat penyusunan secara visual, indentasi ditambahkan ke awal setiap paragraf yang sesuai.

Contoh kode berikut menunjukkan permintaan batch yang menghapus butir dari daftar paragraf.

Java

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

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

Python

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

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