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

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

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

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

सूची बनाने के लिए, documents.batchUpdate का इस्तेमाल करें और CreateParagraphBulletsRequest डालें. वैल्यू की जानकारी देने के लिए, Range शामिल करें प्रभावित सेल और a BulletGlyphPreset बुलेट पॉइंट का पैटर्न सेट करें.

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

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

CreateParagraphBulletsRequest का इस्तेमाल करके भी बुलेट पॉइंट में बदलाव किया जा सकता है पहले से मौजूद सूची.

नीचे दिया गया कोड सैंपल एक बैच रिक्वेस्ट दिखाता है, जो सबसे पहले दस्तावेज़ की शुरुआत में रखा जाता है और फिर यह डालें. 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()