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

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