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

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

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

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

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

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

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

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

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

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