গুগল ডক্স এপিআই নতুন ডকুমেন্টে তালিকা তৈরি করা, বিদ্যমান সাধারণ অনুচ্ছেদকে বুলেটযুক্ত তালিকায় রূপান্তর করা এবং অনুচ্ছেদ থেকে বুলেট অপসারণ করা সমর্থন করে।
একটি নতুন ডকুমেন্টে একটি ক্রমিক নম্বরযুক্ত তালিকা তৈরি করুন
ডকস এপিআই একটি নতুন ডকুমেন্টে টেক্সট সন্নিবেশ করে এবং তারপর একটি একক ব্যাচ অনুরোধের মাধ্যমে সেই টেক্সটে একটি তালিকা স্টাইল প্রয়োগ করে সংখ্যাযুক্ত তালিকা তৈরি করা সমর্থন করে।
একটি নতুন ডকুমেন্টে ক্রমিক নম্বরযুক্ত তালিকা তৈরি করতে:
ডকুমেন্ট তৈরি করতে
documents.createমেথডটি ব্যবহার করুন।ডকুমেন্টে কন্টেন্ট যোগ করতে
documents.batchUpdateমেথডটি ব্যবহার করুন এবং একটিInsertTextRequestদিন। তালিকার আইটেমগুলো আলাদা করতে নিউলাইন ক্যারেক্টার (\n) ব্যবহার করুন।একই ব্যাচ আপডেটে, একটি
CreateParagraphBulletsRequest, টেক্সটের পরিসর নির্দিষ্ট করার জন্য একটিRange, এবং নাম্বারিংয়ের প্যাটার্ন সেট করার জন্য একটিBulletGlyphPresetঅন্তর্ভুক্ত করুন।
নিম্নলিখিত কোড নমুনাটি দেখায় কিভাবে একটি ডকুমেন্ট তৈরি করতে হয় এবং তারপরে একটি সংখ্যাযুক্ত তালিকা হিসাবে তিনটি আইটেম সন্নিবেশ করতে হয়। BulletGlyphPreset তালিকাটিকে ফরম্যাট করার জন্য NUMBERED_DECIMAL_ALPHA_ROMAN ব্যবহার করে। এর মানে হলো, সংখ্যাযুক্ত তালিকার প্রথম তিনটি নেস্টিং লেভেল একটি দশমিক সংখ্যা, একটি ছোট হাতের অক্ষর এবং একটি ছোট হাতের রোমান সংখ্যা দ্বারা উপস্থাপিত হয়।
জাভা
Document doc = new Document().setTitle("New List Document"); doc = docsService.documents().create(doc).execute(); String documentId = doc.getDocumentId(); List<Request> requests = new ArrayList<>(); requests.add(new Request().setInsertText(new InsertTextRequest() .setText("Item 1\nItem 2\nItem 3\n") .setLocation(new Location().setIndex(1).setTabId(<var>TAB_ID</var>)))); requests.add(new Request().setCreateParagraphBullets( new CreateParagraphBulletsRequest() .setRange(new Range() .setStartIndex(1) .setEndIndex(22) .setTabId(<var>TAB_ID</var>)) .setBulletPreset("NUMBERED_DECIMAL_ALPHA_ROMAN"))); BatchUpdateDocumentRequest body = new BatchUpdateDocumentRequest().setRequests(requests); docsService.documents().batchUpdate(documentId, body).execute(); System.out.println("Created document with ID: " + documentId);
পাইথন
title = 'New List Document' body = {'title': title} doc = service.documents().create(body=body).execute() document_id = doc.get('documentId') requests = [ { 'insertText': { 'location': { 'index': 1, 'tabId': <var>TAB_ID</var> }, 'text': 'Item 1\nItem 2\nItem 3\n' } }, { 'createParagraphBullets': { 'range': { 'startIndex': 1, 'endIndex': 22, 'tabId': <var>TAB_ID</var> }, 'bulletPreset': 'NUMBERED_DECIMAL_ALPHA_ROMAN' } } ] result = service.documents().batchUpdate( documentId=document_id, body={'requests': requests}).execute() print(f"Created document with ID: {document_id}")
যে ট্যাবে তালিকার বিষয়বস্তু রয়েছে , সেই ট্যাবের আইডি দিয়ে TAB_ID প্রতিস্থাপন করুন।
একটি অনুচ্ছেদকে তালিকায় রূপান্তর করুন
অনুচ্ছেদ বিন্যাসের একটি সাধারণ প্রক্রিয়া হলো বিদ্যমান অনুচ্ছেদগুলোকে বুলেটযুক্ত তালিকায় রূপান্তর করা।
একটি তালিকা তৈরি করতে, documents.batchUpdate মেথডটি ব্যবহার করুন এবং একটি CreateParagraphBulletsRequest সরবরাহ করুন। প্রভাবিত টেক্সট নির্দিষ্ট করার জন্য একটি Range এবং বুলেটের প্যাটার্ন সেট করার জন্য একটি BulletGlyphPreset অন্তর্ভুক্ত করুন।
প্রদত্ত পরিসরের মধ্যে থাকা সমস্ত অনুচ্ছেদে বুলেট চিহ্ন দেওয়া হয়। যদি নির্দিষ্ট পরিসরটি কোনো টেবিলের সাথে মিলে যায়, তবে বুলেটগুলো টেবিলের সেলগুলোর ভেতরে প্রয়োগ করা হয়। প্রতিটি অনুচ্ছেদের শুরুতে থাকা ট্যাব সংখ্যা গণনা করে তার নেস্টিং লেভেল নির্ধারণ করা হয়।
আপনি বিদ্যমান কোনো বুলেটের নেস্টিং লেভেল পরিবর্তন করতে পারবেন না। এর পরিবর্তে, আপনাকে বুলেটটি মুছে ফেলতে হবে, প্যারাগ্রাফের সামনে লিডিং ট্যাব সেট করতে হবে এবং তারপরে বুলেটটি আবার তৈরি করতে হবে। আরও তথ্যের জন্য, ‘একটি তালিকা থেকে বুলেট অপসারণ’ দেখুন।
বিদ্যমান কোনো তালিকার বুলেট স্টাইল পরিবর্তন করতেও আপনি CreateParagraphBulletsRequest ব্যবহার করতে পারেন।
নিম্নলিখিত কোড নমুনাটি একটি ব্যাচ রিকোয়েস্ট দেখায় যা প্রথমে ডকুমেন্টের শুরুতে টেক্সট সন্নিবেশ করে এবং তারপর প্রথম ৫০টি অক্ষর জুড়ে থাকা প্যারাগ্রাফগুলো থেকে একটি তালিকা তৈরি করে। BulletGlyphPreset টি BULLET_ARROW_DIAMOND_DISC ব্যবহার করে, যার অর্থ হলো বুলেটযুক্ত তালিকার প্রথম তিনটি নেস্টিং লেভেল একটি তীর, একটি ডায়মন্ড এবং একটি ডিস্ক দ্বারা প্রতিনিধিত্ব করা হয়।
জাভা
List<Request> requests = new ArrayList<>(); requests.add(new Request().setInsertText(new InsertTextRequest() .setText("Item One\n") .setLocation(new Location().setIndex(1).setTabId(<var>TAB_ID</var>)))); requests.add(new Request().setCreateParagraphBullets( new CreateParagraphBulletsRequest() .setRange(new Range() .setStartIndex(1) .setEndIndex(50) .setTabId(<var>TAB_ID</var>)) .setBulletPreset("BULLET_ARROW_DIAMOND_DISC"))); BatchUpdateDocumentRequest body = new BatchUpdateDocumentRequest().setRequests(requests); BatchUpdateDocumentResponse response = docsService.documents() .batchUpdate(<var>DOCUMENT_ID</var>, body).execute();
পাইথন
requests = [ { 'insertText': { 'location': { 'index': 1, 'tabId': <var>TAB_ID</var> }, 'text': 'Item One\n', }}, { 'createParagraphBullets': { 'range': { 'startIndex': 1, 'endIndex': 50, 'tabId': <var>TAB_ID</var> }, 'bulletPreset': 'BULLET_ARROW_DIAMOND_DISC', } } ] result = service.documents().batchUpdate( documentId=<var>DOCUMENT_ID</var>, body={'requests': requests}).execute()
TAB_ID-এর জায়গায় তালিকার বিষয়বস্তু ধারণকারী ট্যাবের আইডি দিন, অথবা ডকুমেন্টের প্রথম ট্যাবটিকে ডিফল্ট হিসেবে ব্যবহার করতে এটি বাদ দিন।
একটি তালিকা থেকে বুলেট পয়েন্টগুলো সরান
অনুচ্ছেদ তালিকা থেকে বুলেট অপসারণ করতে, documents.batchUpdate পদ্ধতিটি ব্যবহার করুন এবং একটি DeleteParagraphBulletsRequest সরবরাহ করুন। প্রভাবিত টেক্সট নির্দিষ্ট করার জন্য একটি Range অন্তর্ভুক্ত করুন।
এই পদ্ধতিটি নেস্টিং লেভেল নির্বিশেষে, প্রদত্ত পরিসরের মধ্যে থাকা সমস্ত বুলেট মুছে দেয়। নেস্টিং লেভেল দৃশ্যত বজায় রাখার জন্য, প্রতিটি সংশ্লিষ্ট অনুচ্ছেদের শুরুতে ইনডেন্টেশন যোগ করা হয়।
নিম্নলিখিত কোড নমুনাটি একটি ব্যাচ অনুরোধ দেখায় যা একটি অনুচ্ছেদ তালিকা থেকে বুলেটগুলি মুছে ফেলে।
জাভা
List<Request> requests = new ArrayList<>(); requests.add(new Request().setDeleteParagraphBullets( new DeleteParagraphBulletsRequest() .setRange(new Range() .setStartIndex(1) .setEndIndex(50) .setTabId(<var>TAB_ID</var>)))); BatchUpdateDocumentRequest body = new BatchUpdateDocumentRequest().setRequests(requests); BatchUpdateDocumentResponse response = docsService.documents() .batchUpdate(<var>DOCUMENT_ID</var>, body).execute();
পাইথন
requests = [ { 'deleteParagraphBullets': { 'range': { 'startIndex': 1, 'endIndex': 50, 'tabId': <var>TAB_ID</var> }, } } ] result = service.documents().batchUpdate( documentId=<var>DOCUMENT_ID</var>, body={'requests': requests}).execute()
TAB_ID-এর জায়গায় তালিকার বিষয়বস্তু ধারণকারী ট্যাবের আইডি দিন, অথবা ডকুমেন্টের প্রথম ট্যাবটিকে ডিফল্ট হিসেবে ব্যবহার করতে এটি বাদ দিন।