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

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