নির্দিষ্ট ক্ষেত্র ফেরত দিন, নির্দিষ্ট ক্ষেত্র ফেরত দিন, নির্দিষ্ট ক্ষেত্র ফেরত দিন, নির্দিষ্ট ক্ষেত্র ফেরত দিন

আপনার প্রয়োজনীয় সঠিক ক্ষেত্রগুলি ফেরত দিতে এবং কর্মক্ষমতা উন্নত করতে, আপনার মেথড কলে fields সিস্টেম প্যারামিটার ব্যবহার করুন।

fields প্যারামিটার প্রতিক্রিয়া ফিল্টারিং জন্য একটি FieldMask ব্যবহার করে। ফিল্ড মাস্কগুলি ক্ষেত্রগুলির একটি উপসেট নির্দিষ্ট করতে ব্যবহৃত হয় যা একটি অনুরোধ ফেরত দেওয়া উচিত। আপনি অপ্রয়োজনীয় ডেটার অনুরোধ করবেন না তা নিশ্চিত করার জন্য একটি ফিল্ড মাস্ক ব্যবহার করা ভাল ডিজাইন অনুশীলন, যা অপ্রয়োজনীয় প্রক্রিয়াকরণের সময় এড়াতে সহায়তা করে।

ডিফল্টরূপে, সার্ভার অনুসন্ধান করা সম্পদের জন্য নির্দিষ্ট ক্ষেত্রগুলির একটি সেট প্রদান করে। উদাহরণস্বরূপ, files রিসোর্সে get() পদ্ধতি শুধুমাত্র id , name এবং mimeType প্রদান করতে পারে। permissions সম্পদের get() পদ্ধতি ডিফল্ট ক্ষেত্রের একটি ভিন্ন সেট প্রদান করে।

একটি সার্ভার একটি বৈধ অনুরোধ প্রক্রিয়া করার পরে যাতে fields প্যারামিটার অন্তর্ভুক্ত থাকে, এটি অনুরোধ করা ডেটা সহ একটি HTTP 200 OK স্ট্যাটাস কোড প্রদান করে। যদি ক্ষেত্র প্যারামিটারে একটি ত্রুটি থাকে বা অন্যথায় অবৈধ হয়, সার্ভারটি একটি HTTP 400 Bad Request স্ট্যাটাস কোড প্রদান করে, সাথে একটি ত্রুটি বার্তা উল্লেখ করে যে আপনার ক্ষেত্র নির্বাচনের সাথে কী ভুল হয়েছে৷ উদাহরণস্বরূপ, files.list(fields='files(id,capabilities,canAddChildren)') "অবৈধ ক্ষেত্র নির্বাচন canAddChildren" এর একটি ত্রুটি দেখায়। এই উদাহরণের জন্য সঠিক ক্ষেত্র প্যারামিটার হল files.list(fields='files(id,capabilities/canAddChildren)') ।

fields প্যারামিটার ব্যবহার করে আপনি যে ক্ষেত্রগুলি ফেরত দিতে পারেন তা নির্ধারণ করতে, আপনি যে সংস্থানটি অনুসন্ধান করছেন তার ডকুমেন্টেশন পৃষ্ঠায় যান৷ উদাহরণস্বরূপ, একটি ফাইলের জন্য আপনি কোন ক্ষেত্রগুলি ফেরত দিতে পারেন তা দেখতে, files সংস্থান ডকুমেন্টেশন দেখুন।

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

ক্ষেত্র অনুরোধ প্যারামিটার মান বিন্যাস শিথিলভাবে XPath সিনট্যাক্সের উপর ভিত্তি করে। নিম্নলিখিত fields পরামিতি জন্য বিন্যাস নিয়ম. এই সমস্ত নিয়ম files.get() পদ্ধতির সাথে সম্পর্কিত উদাহরণ ব্যবহার করে।

• একাধিক ক্ষেত্র নির্বাচন করতে একটি কমা-বিভক্ত তালিকা ব্যবহার করুন, যেমন 'name, mimeType' ।

• a/b b করুন যেটি ক্ষেত্র a মধ্যে নেস্ট করা আছে, যেমন 'capabilities/canDownload' । আরও তথ্যের জন্য, নেস্টেড রিসোর্সের ক্ষেত্রগুলি আনুন দেখুন।

• "()" বন্ধনীতে অভিব্যক্তি স্থাপন করে অ্যারে বা বস্তুর নির্দিষ্ট উপ-ক্ষেত্রগুলির একটি সেট অনুরোধ করতে একটি উপ-নির্বাচক ব্যবহার করুন। উদাহরণস্বরূপ, 'permissions(id)' অনুমতি অ্যারের প্রতিটি উপাদানের জন্য শুধুমাত্র অনুমতি আইডি প্রদান করে।

• একটি বস্তুর সমস্ত ক্ষেত্র ফেরত দিতে, ক্ষেত্র নির্বাচনগুলিতে একটি ওয়াইল্ডকার্ড হিসাবে একটি তারকাচিহ্ন ( * ) ব্যবহার করুন। উদাহরণস্বরূপ, 'permissions/permissionDetails/*' অনুমতি প্রতি উপলব্ধ সমস্ত অনুমতি বিবরণ ক্ষেত্র নির্বাচন করে। নোট করুন যে ওয়াইল্ডকার্ড ব্যবহার করার ফলে অনুরোধের উপর নেতিবাচক কর্মক্ষমতা প্রভাব পড়তে পারে।

GET https://www.googleapis.com/drive/v3/files/FILE_ID?fields=name,starred,shared

{
  "name": "File1",
  "starred": false,
  "shared": true
  }
}

একটি নেস্টেড সম্পদের ক্ষেত্রগুলি আনুন৷

যখন একটি ক্ষেত্র অন্য সংস্থানকে নির্দেশ করে, তখন আপনি নির্দিষ্ট করতে পারেন নেস্টেড সংস্থানের কোন ক্ষেত্রগুলি আনতে হবে৷

উদাহরণস্বরূপ, permissions সম্পদের role ক্ষেত্র (নেস্টেড রিসোর্স) পুনরুদ্ধার করতে, নিম্নলিখিত বিকল্পগুলির যে কোনো একটি ব্যবহার করুন:

• permissions.get() with fields=role .
• permissions.get() fields=* সহ সমস্ত permissions ক্ষেত্র দেখাতে।
• files.get() with fields=permissions(role) or fields=permissions/role .
• files.get() সব permissions ক্ষেত্র দেখানোর জন্য fields=permissions সহ।
• fields=changes(file(permissions(role))) সহ changes.list() ।

একাধিক ক্ষেত্র পুনরুদ্ধার করতে, একটি কমা দ্বারা পৃথক করা তালিকা ব্যবহার করুন৷ উদাহরণস্বরূপ, files.list() with fields=files(id,name,createdTime,modifiedTime,size) ।

GET https://www.googleapis.com/drive/v3/files/FILE_ID?fields=name,starred,shared,permissions(kind,type,role)

{
  "name": "File1",
  "starred": false,
  "shared": true,
  "permissions": [
    {
      "kind": "drive#permission",
      "type": "user",
      "role": "owner"
    }
  ]
}

সম্পর্কিত বিষয়

• ত্রুটিগুলি সমাধান করুন
• প্রমাণীকরণ এবং অনুমোদন সংক্রান্ত সমস্যা সমাধান করুন