सूचियों के साथ काम करना

Google Docs API, सामान्य पैराग्राफ़ को बुलेट वाली सूचियों में बदलने और पैराग्राफ़ से बुलेट हटाने की सुविधा देता है.

पैराग्राफ को सूची में बदलना

पैराग्राफ़ को बुलेट वाली सूची में बदलना, पैराग्राफ़ को फ़ॉर्मैट करने का एक सामान्य तरीका है.

सूची बनाने के लिए, documents.batchUpdate का इस्तेमाल करें और CreateParagraphBulletsRequest डालें. जिन सेल पर असर पड़ा है उन्हें बताने के लिए, Range और बुलेट के पैटर्न को सेट करने के लिए, BulletGlyphPreset शामिल करें.

दी गई रेंज से ओवरलैप होने वाले सभी पैराग्राफ़ में बुलेट लगाए जाते हैं. अगर चुनी गई रेंज किसी टेबल से ओवरलैप होती है, तो बुलेट टेबल सेल में लागू होते हैं. हर पैराग्राफ़ के नेस्टिंग लेवल का पता, हर पैराग्राफ़ के आगे मौजूद लीडिंग टैब की गिनती करके लगाया जाता है.

किसी मौजूदा बुलेट के नेस्टिंग लेवल में बदलाव नहीं किया जा सकता. इसके बजाय, आपको बुलेट को मिटाना होगा, पैराग्राफ़ के आगे लीडिंग टैब सेट करने होंगे, और फिर बुलेट को फिर से बनाना होगा. ज़्यादा जानकारी के लिए, किसी सूची से बिंदु हटाना लेख पढ़ें.

किसी मौजूदा सूची के बुलेट स्टाइल को बदलने के लिए, CreateParagraphBulletsRequest का इस्तेमाल भी किया जा सकता है.

यहां दिया गया कोड सैंपल, एक बैच अनुरोध दिखाता है. यह अनुरोध, सबसे पहले दस्तावेज़ की शुरुआत में टेक्स्ट डालता है. इसके बाद, पहले 50 वर्णों वाले पैराग्राफ़ से एक सूची बनाता है. BulletGlyphPreset में BULLET_ARROW_DIAMOND_DISC का इस्तेमाल किया जाता है. इसका मतलब है कि बुलेट वाली सूची के पहले तीन नेस्टिंग लेवल को ऐरो, डायमंड, और डिस्क से दिखाया जाता है.

JavaPython
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();
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 शामिल करें.

यह तरीका, दी गई रेंज से ओवरलैप होने वाले सभी बुलेट मिटा देता है. इससे कोई फ़र्क़ नहीं पड़ता कि वे नेस्ट किए गए हैं या नहीं. नेस्टिंग लेवल को विज़ुअल तौर पर बनाए रखने के लिए, हर पैराग्राफ़ की शुरुआत में इंडेंटेशन जोड़ा जाता है.

यहां दिया गया कोड सैंपल, एक बैच अनुरोध दिखाता है. यह अनुरोध, पैराग्राफ की सूची से बुलेट पॉइंट मिटाता है.

JavaPython
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();
requests = [
        {
        'deleteParagraphBullets': {
            'range': {
                'startIndex': 1,
                'endIndex':  50,
                'tabId': TAB_ID
            },
        }
    }
]

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