ট্যাব দিয়ে কাজ করুন

Google ডক্স API আপনাকে নথির যেকোনো ট্যাব থেকে সামগ্রী অ্যাক্সেস করতে দেয়।

ট্যাব কি?

Google ডক্সে ট্যাব নামে একটি সাংগঠনিক স্তর রয়েছে৷ ডক্স ব্যবহারকারীদের একটি একক নথির মধ্যে এক বা একাধিক ট্যাব তৈরি করতে দেয়, যেমন আজ পত্রকগুলিতে ট্যাব রয়েছে। প্রতিটি ট্যাবের নিজস্ব শিরোনাম এবং আইডি রয়েছে (ইউআরএলে যুক্ত)। একটি ট্যাবে চাইল্ড ট্যাবও থাকতে পারে, যেগুলি অন্য ট্যাবের নীচে নেস্ট করা ট্যাব।

ডকুমেন্ট রিসোর্সে কীভাবে নথির বিষয়বস্তু উপস্থাপন করা হয় তার কাঠামোগত পরিবর্তন

অতীতে, নথিতে ট্যাবের ধারণা ছিল না, তাই Document রিসোর্সে সরাসরি নিম্নলিখিত ক্ষেত্রগুলির মাধ্যমে সমস্ত পাঠ্য বিষয়বস্তু থাকত:

• document.body
• document.headers
• document.footers
• document.footnotes
• document.documentStyle
• document.suggestedDocumentStyleChanges
• document.namedStyles
• document.suggestedNamedStylesChanges
• document.lists
• document.namedRanges
• document.inlineObjects
• document.positionedObjects

ট্যাবগুলির অতিরিক্ত কাঠামোগত অনুক্রমের সাথে, এই ক্ষেত্রগুলি আর শব্দার্থকভাবে নথির সমস্ত ট্যাব থেকে পাঠ্য বিষয়বস্তুকে উপস্থাপন করে না। পাঠ্য-ভিত্তিক বিষয়বস্তু এখন একটি ভিন্ন স্তরে উপস্থাপিত হয়। Google ডক্সে ট্যাব বৈশিষ্ট্য এবং বিষয়বস্তু document.tabs এর মাধ্যমে অ্যাক্সেসযোগ্য, যা Tab অবজেক্টের একটি তালিকা, যার প্রতিটিতে উপরে উল্লিখিত সমস্ত পাঠ্য বিষয়বস্তু ক্ষেত্র রয়েছে৷ পরবর্তী বিভাগগুলি একটি সংক্ষিপ্ত বিবরণ দেয়; ট্যাব JSON উপস্থাপনা আরও বিস্তারিত তথ্য প্রদান করে।

অ্যাক্সেস ট্যাব বৈশিষ্ট্য

tab.tabProperties ব্যবহার করে ট্যাবের বৈশিষ্ট্যগুলি অ্যাক্সেস করুন, যাতে ট্যাবের আইডি, শিরোনাম এবং অবস্থানের মতো তথ্য অন্তর্ভুক্ত থাকে।

একটি ট্যাবের মধ্যে পাঠ্য সামগ্রী অ্যাক্সেস করুন

ট্যাবের মধ্যে প্রকৃত নথির বিষয়বস্তু tab.documentTab হিসাবে প্রকাশ করা হয়েছে। উপরে উল্লিখিত সমস্ত পাঠ্য বিষয়বস্তু ক্ষেত্রগুলি tab.documentTab ব্যবহার করে অ্যাক্সেসযোগ্য। উদাহরণস্বরূপ, document.body ব্যবহার করার পরিবর্তে, আপনার উচিত document.tabs[indexOfTab].documentTab.body ব্যবহার করা।

ট্যাব অনুক্রম

চাইল্ড ট্যাবগুলি এপিআই-এ Tab একটি tab.childTabs ক্ষেত্র হিসাবে উপস্থাপন করা হয়। একটি নথিতে সমস্ত ট্যাব অ্যাক্সেস করার জন্য চাইল্ড ট্যাবগুলির "বৃক্ষ" অতিক্রম করা প্রয়োজন৷ উদাহরণস্বরূপ, একটি ডকুমেন্ট বিবেচনা করুন যাতে একটি ট্যাব অনুক্রম রয়েছে:

Tab 3.1.2 থেকে Body পুনরুদ্ধার করার জন্য, আপনি document.tabs[2].childTabs[0].childTabs[1].documentTab.body অ্যাক্সেস করতে পারবেন। পরবর্তী বিভাগে নমুনা কোড ব্লকগুলি দেখুন, যা একটি নথিতে সমস্ত ট্যাব জুড়ে পুনরাবৃত্তি করার জন্য নমুনা কোড প্রদান করে।

পদ্ধতিতে পরিবর্তন

ট্যাব প্রবর্তনের সাথে, প্রতিটি নথির পদ্ধতিতে কিছু পরিবর্তন রয়েছে যার জন্য আপনাকে আপনার কোড আপডেট করতে হতে পারে।

documents.get

ডিফল্টরূপে, সমস্ত ট্যাবের বিষয়বস্তু ফেরত দেওয়া হয় না। সমস্ত ট্যাব অ্যাক্সেস করতে বিকাশকারীদের তাদের কোড আপডেট করা উচিত। documents.get পদ্ধতি একটি includeTabsContent প্যারামিটার প্রকাশ করে যা সমস্ত ট্যাবের বিষয়বস্তু প্রতিক্রিয়াতে প্রদান করা হয়েছে কিনা তা কনফিগার করতে সক্ষম করে।

• includeTabsContent true তে সেট করা থাকলে, documents.get পদ্ধতিটি document.tabs ফিল্ড পপুলেট সহ একটি Document রিসোর্স ফেরত দেবে। document সরাসরি সমস্ত পাঠ্য ক্ষেত্র (যেমন document.body ) খালি হিসাবে ছেড়ে দেওয়া হবে।
• যদি includeTabsContent প্রদান না করা হয়, তাহলে Document রিসোর্সে (যেমন document.body ) টেক্সট ফিল্ডগুলি শুধুমাত্র প্রথম ট্যাবের কন্টেন্ট দিয়ে পপুলেট করা হবে। document.tabs ক্ষেত্রটি খালি থাকবে এবং অন্যান্য ট্যাবের সামগ্রী ফেরত দেওয়া হবে না৷

documents.create

documents.create পদ্ধতিটি তৈরি করা খালি নথির প্রতিনিধিত্ব করে একটি Document সম্পদ প্রদান করে। প্রত্যাবর্তিত Document রিসোর্স নথির পাঠ্য বিষয়বস্তু ক্ষেত্রের পাশাপাশি document.tabs উভয় ক্ষেত্রেই খালি নথির বিষয়বস্তু পূরণ করবে।

document.batchUpdate

প্রতিটি Request আপডেটটি প্রয়োগ করার জন্য ট্যাবগুলি নির্দিষ্ট করার একটি উপায় রয়েছে৷ ডিফল্টরূপে, যদি একটি ট্যাব নির্দিষ্ট করা না থাকে, Request বেশিরভাগ ক্ষেত্রে নথির প্রথম ট্যাবে প্রয়োগ করা হবে। ReplaceAllTextRequest , DeleteNamedRangeRequest , এবং ReplaceNamedRangeContentRequest তিনটি বিশেষ অনুরোধ যা সব ট্যাবে প্রয়োগ করার পরিবর্তে ডিফল্ট হবে৷

সুনির্দিষ্ট জন্য Request এর ডকুমেন্টেশন পড়ুন.

অভ্যন্তরীণ লিঙ্ক পরিবর্তন

ব্যবহারকারীরা একটি নথিতে ট্যাব, বুকমার্ক এবং শিরোনামের অভ্যন্তরীণ লিঙ্ক তৈরি করতে পারে। ট্যাব বৈশিষ্ট্যের প্রবর্তনের সাথে, Link সংস্থানে link.bookmarkId এবং link.headingId ক্ষেত্রগুলি আর নথির একটি নির্দিষ্ট ট্যাবে বুকমার্ক বা শিরোনাম উপস্থাপন করতে পারে না।

ডেভেলপারদের তাদের কোড আপডেট করা উচিত link.bookmark এবং link.heading ব্যবহার করার জন্য রিড এবং রাইট অপারেশনে। তারা BookmarkLink এবং HeadingLink অবজেক্ট ব্যবহার করে অভ্যন্তরীণ লিঙ্কগুলি প্রকাশ করে, যার প্রত্যেকটিতে বুকমার্ক বা শিরোনামের ID এবং এটি যে ট্যাবটিতে অবস্থিত তার আইডি রয়েছে৷ উপরন্তু, link.tabId ট্যাবের অভ্যন্তরীণ লিঙ্কগুলিকে প্রকাশ করে৷

একটি documents.get প্রতিক্রিয়ার লিঙ্ক বিষয়বস্তু includeTabsContent প্যারামিটারের উপর নির্ভর করে পরিবর্তিত হতে পারে:

• includeTabsContent true সেট করা থাকলে, সমস্ত অভ্যন্তরীণ লিঙ্ক link.bookmark এবং link.heading হিসাবে প্রকাশ করা হবে। উত্তরাধিকার ক্ষেত্র আর ব্যবহার করা হবে না.
• যদি includeTabsContent প্রদান না করা হয়, তাহলে একটি একক ট্যাব সম্বলিত নথিতে, বুকমার্কের যেকোনো অভ্যন্তরীণ লিঙ্ক বা সেই একক ট্যাবের মধ্যে শিরোনামগুলি link.bookmarkId এবং link.headingId হিসাবে প্রকাশ করা অব্যাহত থাকে। একাধিক ট্যাব ধারণকারী নথিতে, অভ্যন্তরীণ লিঙ্কগুলি link.bookmark এবং link.heading হিসাবে উন্মুক্ত করা হবে।

document.batchUpdate এ, যদি লিগ্যাসি ক্ষেত্রগুলির একটি ব্যবহার করে একটি অভ্যন্তরীণ লিঙ্ক তৈরি করা হয়, বুকমার্ক বা শিরোনামটি Request নির্দিষ্ট করা ট্যাব আইডি থেকে বিবেচিত হবে৷ যদি কোনো ট্যাব নির্দিষ্ট করা না থাকে, তাহলে এটি নথির প্রথম ট্যাব থেকে বিবেচিত হবে।

লিঙ্ক JSON প্রতিনিধিত্ব আরো বিস্তারিত তথ্য প্রদান করে.

ট্যাবের জন্য সাধারণ ব্যবহারের নিদর্শন

নিম্নলিখিত কোড নমুনা ট্যাবের সাথে ইন্টারঅ্যাক্ট করার বিভিন্ন উপায় বর্ণনা করে।

নথির সমস্ত ট্যাব থেকে ট্যাব বিষয়বস্তু পড়ুন

বিদ্যমান কোড যা ট্যাব বৈশিষ্ট্যটিকে সমর্থন করার আগে ট্যাবগুলিতে স্থানান্তরিত করা যেতে পারে includeTabsContent প্যারামিটারকে true সেট করে, ট্যাব ট্রি শ্রেণিবিন্যাস অতিক্রম করে এবং Document পরিবর্তে Tab এবং DocumentTab থেকে গেটার পদ্ধতিগুলিকে কল করে। নিম্নলিখিত আংশিক কোড নমুনা একটি নথি থেকে পাঠ্য এক্সট্রাক্ট এ স্নিপেটের উপর ভিত্তি করে। এটি দেখায় কিভাবে একটি নথির প্রতিটি ট্যাব থেকে সমস্ত পাঠ্য বিষয়বস্তু প্রিন্ট করতে হয়। এই ট্যাব ট্রাভার্সাল কোডটি অন্য অনেক ব্যবহারের ক্ষেত্রে অভিযোজিত হতে পারে যা ট্যাবগুলির প্রকৃত গঠন সম্পর্কে চিন্তা করে না।

/** Prints all text contents from all tabs in the document. */
static void printAllText(Docs service, String documentId) throws IOException {
  // Fetch the document with all of the tabs populated, including any nested
  // child tabs.
  Document doc =
      service.documents().get(documentId).setIncludeTabsContent(true).execute();
  List<Tab> allTabs = getAllTabs(doc);

  // Print the content from each tab in the document.
  for (Tab tab: allTabs) {
    // Get the DocumentTab from the generic Tab.
    DocumentTab documentTab = tab.getDocumentTab();
    System.out.println(
        readStructuralElements(documentTab.getBody().getContent()));
  }
}

/**
 * Returns a flat list of all tabs in the document in the order they would
 * appear in the UI (top-down ordering). Includes all child tabs.
 */
private List<Tab> getAllTabs(Document doc) {
  List<Tab> allTabs = new ArrayList<>();
  // Iterate over all tabs and recursively add any child tabs to generate a
  // flat list of Tabs.
  for (Tab tab: doc.getTabs()) {
    addCurrentAndChildTabs(tab, allTabs);
  }
  return allTabs;
}

/**
 * Adds the provided tab to the list of all tabs, and recurses through and
 * adds all child tabs.
 */
private void addCurrentAndChildTabs(Tab tab, List<Tab> allTabs) {
  allTabs.add(tab);
  for (Tab tab: tab.getChildTabs()) {
    addCurrentAndChildTabs(tab, allTabs);
  }
}

/**
 * Recurses through a list of Structural Elements to read a document's text
 * where text may be in nested elements.
 *
 * <p>For a code sample, see
 * <a href="https://developers.google.com/docs/api/samples/extract-text">Extract
 * the text from a document</a>.
 */
private static String readStructuralElements(List<StructuralElement> elements) {
  ...
}

ডকুমেন্টের প্রথম ট্যাব থেকে ট্যাব বিষয়বস্তু পড়ুন

এটি সব ট্যাব পড়ার অনুরূপ।

/** Prints all text contents from the first tab in the document. */
static void printAllText(Docs service, String documentId) throws IOException {
  // Fetch the document with all of the tabs populated, including any nested
  // child tabs.
  Document doc =
      service.documents().get(documentId).setIncludeTabsContent(true).execute();
  List<Tab> allTabs = getAllTabs(doc);

  // Print the content from the first tab in the document.
  Tab firstTab = allTabs.get(0);
  // Get the DocumentTab from the generic Tab.
  DocumentTab documentTab = firstTab.getDocumentTab();
  System.out.println(
      readStructuralElements(documentTab.getBody().getContent()));
}

প্রথম ট্যাব আপডেট করার জন্য একটি অনুরোধ করুন

নিম্নলিখিত আংশিক কোড নমুনা দেখায় কিভাবে একটি Request একটি নির্দিষ্ট ট্যাব লক্ষ্য করতে হয়। এই কোডটি টেক্সট নির্দেশিকা সন্নিবেশ, মুছুন এবং সরান নমুনার উপর ভিত্তি করে।

/** Inserts text into the first tab of the document. */
static void insertTextInFirstTab(Docs service, String documentId)
    throws IOException {
  // Get the first tab's ID.
  Document doc =
      service.documents().get(documentId).setIncludeTabsContent(true).execute();
  Tab firstTab = doc.getTabs().get(0);
  String tabId = firstTab.getTabProperties().getTabId();

  List<Request>requests = new ArrayList<>();
  requests.add(new Request().setInsertText(
      new InsertTextRequest().setText(text).setLocation(new Location()
                                                            // Set the tab ID.
                                                            .setTabId(tabId)
                                                            .setIndex(25))));

  BatchUpdateDocumentRequest body =
      new BatchUpdateDocumentRequest().setRequests(requests);
  BatchUpdateDocumentResponse response =
      docsService.documents().batchUpdate(DOCUMENT_ID, body).execute();
}