আপনার প্রয়োজনীয় সঠিক ক্ষেত্রগুলি ফেরত দিতে এবং কর্মক্ষমতা উন্নত করতে, আপনার পদ্ধতি কলে fields
ক্যোয়ারী প্যারামিটার ব্যবহার করুন।
ডিফল্টরূপে, সার্ভার অনুসন্ধান করা সম্পদের জন্য নির্দিষ্ট ক্ষেত্রগুলির একটি সেট ফেরত পাঠায়। উদাহরণস্বরূপ, files.get
পদ্ধতিটি files
রিসোর্সের জন্য শুধুমাত্র id
, name
, এবং mimeType
ফেরত দিতে পারে। permissions.get
পদ্ধতি একটি permissions
সম্পদের জন্য ডিফল্ট ক্ষেত্রের একটি ভিন্ন সেট প্রদান করে।
একটি সার্ভার একটি বৈধ অনুরোধ প্রক্রিয়া করার পরে যাতে 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
withfields=role
orfields=*
. -
files.get
withfields=permissions(role)
orfields=permissions/role
. - নেস্টেড রিসোর্সের সমস্ত ক্ষেত্র বোঝাতে
fields=permissions
সহfiles.get
। -
fields=changes(file(permissions(role)))
সহchanges.list
।
একাধিক ক্ষেত্র পুনরুদ্ধার করতে, একটি কমা দ্বারা পৃথক করা তালিকা ব্যবহার করুন৷ উদাহরণস্বরূপ, fields=files(id,name,createdTime,modifiedTime,size)
সহ files.list
।
একটি উদাহরণ দেখান
অনুরোধ
এই উদাহরণে, আমরা অনুরোধে একটি ক্যোয়ারী প্যারামিটার হিসেবে ফাইল আইডি পাথ প্যারামিটার এবং নেস্টেড পারমিশন রিসোর্সের নির্দিষ্ট ক্ষেত্র সহ একাধিক ক্ষেত্র প্রদান করি। প্রতিক্রিয়া ফাইল আইডির ক্ষেত্রের মান প্রদান করে।
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" } ] }