Method: spreadsheets.getByDataFilter

প্রদত্ত আইডিতে থাকা স্প্রেডশিটটি ফেরত দেয়। আহ্বানকারীকে অবশ্যই স্প্রেডশিট আইডি উল্লেখ করতে হবে। আরও তথ্যের জন্য, মেটাডেটা পড়া, লেখা এবং অনুসন্ধান দেখুন।

এই পদ্ধতিটি spreadsheets.get থেকে ভিন্ন, কারণ এটি একটি dataFilters প্যারামিটার নির্দিষ্ট করে স্প্রেডশীট ডেটার কোন উপসেটগুলো ফেরত আসবে তা নির্বাচন করার সুযোগ দেয়। একাধিক DataFilters নির্দিষ্ট করা যেতে পারে। এক বা একাধিক ডেটা ফিল্টার নির্দিষ্ট করলে স্প্রেডশীটের সেই অংশগুলো ফেরত আসে যা ফিল্টারগুলোর যেকোনো একটির সাথে মিলে যাওয়া রেঞ্জগুলোর সাথে ছেদ করে।

ডিফল্টরূপে, গ্রিডের ভেতরের ডেটা ফেরত দেওয়া হয় না। আপনি দুটি উপায়ের যেকোনো একটিতে গ্রিড ডেটা অন্তর্ভুক্ত করতে পারেন:

  • HTTP-তে fields URL প্যারামিটার ব্যবহার করে আপনার কাঙ্ক্ষিত ফিল্ডগুলির তালিকা সহ একটি ফিল্ড মাস্ক নির্দিষ্ট করুন।

  • includeGridData প্যারামিটারটি true তে সেট করুন। যদি একটি ফিল্ড মাস্ক সেট করা থাকে, তাহলে includeGridData প্যারামিটারটি উপেক্ষা করা হয়।

বড় স্প্রেডশীটের ক্ষেত্রে, উত্তম অনুশীলন হিসেবে, শুধুমাত্র আপনার প্রয়োজনীয় নির্দিষ্ট ফিল্ডগুলোই পুনরুদ্ধার করুন।

HTTP অনুরোধ

POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}:getByDataFilter

URL-টিতে gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করা হয়েছে।

পথের পরামিতি

প্যারামিটার
spreadsheetId

string

অনুরোধ করার জন্য স্প্রেডশিটটি।

অনুরোধকারী শরীর

অনুরোধের মূল অংশে নিম্নলিখিত কাঠামোসহ ডেটা থাকে:

JSON উপস্থাপনা 
{
  "dataFilters": [
    {
      object (DataFilter)
    }
  ],
  "includeGridData": boolean,
  "excludeTablesInBandedRanges": boolean,
  "commentsViewMode": enum (CommentsViewMode)
}
ক্ষেত্র
dataFilters[]

object ( DataFilter )

স্প্রেডশিট থেকে কোন রেঞ্জগুলো আনা হবে তা নির্বাচন করতে DataFilters ব্যবহার করা হয়।

includeGridData

boolean

গ্রিড ডেটা ফেরত দেওয়া হবে কিনা তার জন্য 'ট্রু' প্যারামিটারটি প্রয়োজন। অনুরোধে কোনো ফিল্ড মাস্ক সেট করা থাকলে এই প্যারামিটারটি উপেক্ষা করা হয়।

excludeTablesInBandedRanges

boolean

ব্যান্ডেড রেঞ্জ থেকে টেবিল বাদ দিতে হলে True। সেট করা না থাকলে False।

commentsViewMode

enum ( CommentsViewMode )

স্প্রেডশিটে প্রয়োগ করার জন্য মন্তব্য দেখার মোড। এর মাধ্যমে মন্তব্য বাদ দিয়ে বা অন্তর্ভুক্ত করে স্প্রেডশিটটি দেখা যায়। যদি কোনো মোড নির্দিষ্ট করা না থাকে, তাহলে COMMENTS_VIEW_MODE_OMITTED ব্যবহৃত হয়।

প্রতিক্রিয়া সংস্থা

সফল হলে, রেসপন্স বডিতে Spreadsheet এর একটি ইনস্ট্যান্স থাকে।

অনুমোদনের পরিধি

নিম্নলিখিত OAuth স্কোপগুলির মধ্যে একটি প্রয়োজন:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/spreadsheets

আরও তথ্যের জন্য, অনুমোদন নির্দেশিকা দেখুন।