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

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

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

पहली इमेज. पैराग्राफ़ को सूची में बदलें.

सूची में से बुलेट निकालें

पैराग्राफ़ की सूची से बुलेट हटाने के लिए, documents.batchUpdate तरीका इस्तेमाल करें और DeleteParagraphBulletsRequest उपलब्ध कराएं. जिन सेल पर असर हुआ है उनकी जानकारी देने के लिए Range शामिल करें.

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

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

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